Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/metaxal/quickscript-extra

Scripts for Quickscript
https://github.com/metaxal/quickscript-extra

drracket racket

Last synced: 5 days ago
JSON representation

Scripts for Quickscript

Awesome Lists containing this project

README 

        
# Quickscript Extra



Some scripts for [Quickscript](https://github.com/Metaxal/quickscript).



## 1. Installation



In DrRacket, in `File|Package manager|Source`, enter

`quickscript-extra`.



Or, on the command line, type: `raco pkg install quickscript-extra`.



If DrRacket is already running, click on `Scripts|Manage scripts|Compile

scripts and reload menu`.



## 2. Scripts



* **abstract-variable**: Create a variable from the selected expression

  [video](https://www.youtube.com/watch?v=qgjAZd4eBBY)



* **add-menu**: \(Example\) Shows how to dynamically add a menu to

  DrRacket.



* **all-tabs**: Have a menu that displays all open tabs in DrRacket.



* **author-date**: Insert text snippets with author, date, time, and

  licence.



* **backup-file**: Copies the current file in the ’backups’ subdirectory

  with a time stamp



* **bookmarks**: Quickly navigate between lines and headlines



* **color-chooser**: Pick a color in the palette and insert it in

  DrRacket’s current file.



* **color-theme**: Display information about the current color theme.



* **complete-word**: Word completion from a given user dictionary



* **current-file-example**: \(Example\) Displays the current file and

  the current selected string in a message box.



* **def-signatures**: Displays the signature of the procedure under the

  cursor (like DrRacket’s blue box but works also when the file does not

  compile).



* **dynamic-abbrev**: Cyclic word completion using the words of the

  current file.



* **enter-submod**: Easily enter a submodule (main, test, drracket,

  etc.) in the interaction window.



* **extract-function**: Extracts a block of code out of its context and

  generates a function and a call

  [video](https://www.youtube.com/watch?v=XinMxDLZ7Zw)



* **filepath-to-clipboard**: Write the path of the current file in the

  clipboard.



* **git**: Some git commands (linux only). Currently meant as a demo.



* **goto-line**: Jump to a given line number in the current editor.



* **gui-tools**: Code snippets for racket/gui widgets. Meant as a demo.



* **indent-table**: Indent rows on double-space-separated columns

  [video](https://www.youtube.com/watch?v=KJjVREsgnvA)



* **insert-pict**: \(Example\) Insert a ‘pict‘ at the current position.



* **number-tabs**: \(Example\) displays the number of opened tabs in a

  message box.



* **open-collect-file**: Open a file in DrRacket, starting in racket’s

  collections base path.



* **open-dir**: Open the system’s file browser in the current directory.



* **open-terminal**: Open a terminal in the directory of the current

  file.



* **pasterack**: Opens Pasterack in the browser.



* **persistent-counter**: \(Example\) Shows how the ‘\#:persistent‘

  property works.



* **provided-by**: Displays a list of modules that ‘provide‘ the

  procedure under the cursor.



* **regexp-replace**: Replace patterns in the selected text using

  regular expressions.



* **reorder-tabs**: \(Example\) Move DrRacket’s tabs around.



* **reverse-selection**: \(Example\) The simplest script example:

  reverse the selected string.



* **sections**: Surrounds the selected text by comments ASCII frames.



* **sort-lines**: Sorts the selected lines in (anti-)alphabetical order.



* **surround-selection**: \(Example\) Surround the selected text with

  various characters.



* **tweet**: \(Example\) Tweet the current selection. See the script

  file for configuration details.



* **url2script**: Fetches a quickscript at a given url and adds it to

  the library.



## 3. url2script



The `url2script` script is special: it allows you to easily fetch

single-file quickscripts from anywhere on the internet by providing the

url to the raw code. It is actually a little smarter than that because

it understands non-raw urls from [github

gists](https://gist.github.com), [gitlab

snippets](https://gitlab.com/snippets), [pastebin](https://pastebin.com)

and [pasterack](http://pasterack.org).



Some single-file scripts can be found on the [Racket

wiki](https://github.com/racket/racket/wiki/Quickscript-Scripts-for-DrRacket).



A script previously fetched with url2script can also be easily updated

by first opening it via `Scrits|Manage|Open script…` then clicking on

`Scripts|url2script|Update current script`.



When a script is fetched by `url2script`, a `"url2script-info"`

submodule is automatically added (unless one already exists) with

information about the filename in which the script is to be saved (or

has been saved), and the original url of the script. The latter is used

for updating the script as described above. The submodule looks like

this:



```racket

(module url2script-info racket/base                             

 (provide url filename)                                         

 (define filename "the-default-filename-to-save-the-script.rkt")

 (define url "https://url.of.the/script.rkt"))                  

```



If you want to publish a single-file quickscript without making a

package, consider adding this submodule so as to provide a default

filename (otherwise the user who fetches your script will have to type

one themselves, and may be unsure what name to pick).



Also consider adding a permissive license. We recommend a dual license

Apache 2.0 / MIT:



```racket

;;; Copyright                          

;;; License: [Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0) or                   

;;;          [MIT license](http://opensource.org/licenses/MIT) at your option.                                                               

```



Scripts fetched by `url2script` are added to the default script

directory. They can be modified as desired (as long as the license

permits it)



## 4. Customizing



Scripts can be selectively deactivated from the library

\(`Scripts|Manage scripts|Library`).



If you change the source code of a script installed from the

`quickscript-extra` package \(or from any package containing

quickscripts\), you will lose all your modifications when the package is

updated. To avoid this, you can use Quickscript’s [shadow

scripts](https://docs.racket-lang.org/quickscript/index.html?q=quickscripts#%28part._.Shadow_scripts%29):

The shadow script calls the original script without modifying it, and

can be modified to your taste without being modified when the original

script is updated.



In particular, if you want to change the default label, menu path or

keybinding of a script installed from `quickscript-extra`, go to

`Scripts|Manage|Library…`, select the `quickscript-extra` directory,

then the script you want, and click on `Shadow`. This opens a new

(shadow) script that calls the original script where you can change what

you want.



Note that the shadowed script is deactivated so as to avoid duplicate

menu entries and keybindings.