Thank you for your comment

Beau­tiful Racket / tuto­rials

Extend a data format: jsonic

To set up our project as a package from the outset, we simplify the recipe we used in bf:

  1. We create a direc­tory for our package. Since we want to invoke our inter­preter as #lang jsonic, we’ll call our package direc­tory jsonic. We can create this direc­tory anywhere conve­nient on the filesystem.

  2. Then we use Racket’s command-line program raco to install our (still empty) package. In a terminal window, we cd into our new jsonic direc­tory and do raco pkg install:

    cd path/to/jsonic
    raco pkg install
    1
2
    > cd path/to/jsonic
> raco pkg install
    copy to clipboard

    This will trigger a flurry of status messages along these lines:

    Linking current directory as a package
    raco setup: version: 8.15.0.8
    raco setup: platform: x86_64-macosx [3m]
    raco setup: installation name: development
    raco setup: variants: 3m
    ···
    raco setup: --- building documentation ---
    raco setup: --- installing collections ---
    raco setup: --- post-installing collections ---
    >
     1
 2
 3
 4
 5
 6
 7
 8
 9
10
    Linking current directory as a package
raco setup: version: 8.15.0.8
raco setup: platform: x86_64-macosx [3m]
raco setup: installation name: development
raco setup: variants: 3m
···
raco setup: --- building documentation ---
raco setup: --- installing collections ---
raco setup: --- post-installing collections ---
>
    copy to clipboard

That’s it. We now have a jsonic direc­tory for our project, installed so that Racket recog­nizes it as a package. This means that if we invoke #lang jsonic, or refer to a module like (require jsonic/reader), Racket will know where to find it.

Now we can start adding our source files.

← prev next →