3 The raco planet Command-Line Tool
The raco planet command-line tool allows a command-line interface to the most commonly-performed PLaneT tasks. It is invoked from the command line as
raco planet subcommand arg ...
where subcommand is a subcommand from the following list, and arg is a sequence of arguments determined by that subcommand:
- create: create a PLaneT archive from a directory 
- install: download and install a given package 
- remove: remove the specified package from the local cache 
- show: list the packages installed in the local cache 
- clearlinks: clear the linkage table, allowing upgrades 
- fileinject: install a local file to the planet cache 
- link: create a development link 
- unlink: remove development link associated with the given package 
- fetch: download a package file without installing it 
- url: get a URL for the given package 
- open: unpack the contents of the given package 
- structure: display the structure of a given .plt archive 
- print: display a file within of the given .plt archive 
Each of these commands is described in more detail below. All the functionality of the command-line tool is also provided with a programmatic interface by the "util.rkt" library.
3.1 create
- -f, --force: force a package to be created even if its info.rkt file contains errors. 
3.2 install
3.3 remove
- -e, --erase: also remove the package’s distribution file from the uninstalled-package cache 
3.4 show
- -p, --packages: show packages only (default) 
- -l, --linkage: show linkage table only 
- -a, --all: show packages and linkage 
3.5 clearlinks
3.6 fileinject
3.7 link
3.8 unlink
- -q, --quiet: don’t signal an error on nonexistent links 
3.9 fetch
3.10 url
This is never necessary for normal use of planet, but may be helpful in some circumstances for retrieving packages.
3.11 open
This command is not necessary for normal use of planet. It is intended to allow you to inspect package contents offline without needing to install the package.
3.12 structure
This command does not unpack or install the named .plt file.
3.13 print
Print the contents of the file named by <path>, which must be a relative path within the PLaneT archive named by <plt-file>, to the standard output port.
This command does not unpack or install the named .plt file.