CS 135 DrTools

DrRacket Tools for CS 135 course at UWaterloo

Disclaimers

• The authors are NOT responsible for any issues using any part of this repository will cause you. ALWAYS back up your files, preferences and code!
• Though it may not be necessary in all cases, DrRacket should be restarted after most customizations to allow all changes to take effect.

Acknowledgements

• Autocomplete was adapted from complete-word in Quickscript Extra
• Keybindings was adapted from Racket-lang.org documentation

Contributors

• Creator and Maintainer: Raymond Li (https://Raymond.Li)
• Co-creator: Kaustubh Prabhakar (https://KaustubhPrabhakar.tech)
• Contributors: Thomas Park, Devon Mack, Kaifee Haque

Installation

There are 2 parts of this package that you can install. By following the steps below, you will get autocomplete and additional keybindings. To install the preferences, follow the installation section under Racket Preferences. Default Racket keybindings will continue to work after installation.

1. Go to File > Install Package... from the menubar.
2. Put cs135-drtools in the input field beside Package Source:, and click Install.
3. Restart DrRacket.

Tools

Autocomplete

• Ctrl+Space trigger (Will NOT work in comments!) just hit enter and remove the newline after completion, we're working on making these work in comments)
• Completion for the following:

Usage:

1. Type a shortcut
2. Press Ctrl+Space
3. The shortcut will be replaced with generated code

Keybindings

• Works out of the box after installing the package
• Note: No commonly-used original keybindings are overwritten. (i.e. The DrRacket default keybindings still do what they used to. This package simply adds more.)
• Provides the following keybindings:

Racket Preferences

• Dark mode based on Monokai v2.1
• [ (left square bracket) will automatically determine the right bracket for you (no need to Shift+9 anymore!) and insert a close bracket for you as well
• In addition to the notable ones mentioned here, all the features we found useful have been enabled. The default language for new files is set to Beginning Student Custom, the starting language for CS 135 at UWaterloo. This may change as we progress through the course, or it may not.

Installation

• !Important! BACK UP your existing preferences file FIRST, just in case you don't like ours.
• Unix: Download racket-prefs.rktd to $HOME/.racket and reload DrRacket
• Windows: Download racket-prefs.rktd to %appdata%\Racket (paste that into the File Explorer location bar and hit enter) and reload DrRacket
• Mac OS: Download racket-prefs.rktd to your preferences folder, rename the file to org.racket-lang.prefs.rktd, and reload DrRacket. You might find these links helpful:
  • https://www.syniumsoftware.com/support-article/how-do-i-navigate-to-the-preferences-folder
  • https://discussions.apple.com/thread/5804600

Additional Tips

Installing the drcomplete raco package (not part of this package) will provide automated completion of variables and functions. You can install drcomplete the same way you installed cs135-drtools. After restarting DrRacket, click Edit > Enable Automatic Autocompletion (last item) in the menubar to enable it, if it isn't already enabled.

We accept Pull Requests! If you have a template or shortcut you think is useful and should be added, contribute to our repo on GitHub!