Factor-packman:pkg-install

From Zen/-/ackers

The pkg-install command is used to install a package from a local/remote source.

The pkg-install word has the following signature:

   pkg-install ( pkg-name seq -- )

   :: pkg-name: the name of the package to install as a string.
   :: seq: a sequence (list) of options to be used by the pkg-install word.

When used to install a package from a remote source, this command searches the remote package repositories for the requested package, and when found, it automatically downloads the package from the remote repo. After the package has been downloaded, it is automatically verified and the verification result is displayed to the user. The user is then prompted if he/she would like to install the package (even if the verification failed). If the user says YES, the source files are extracted from the package and placed in the correct place in the user's installed factor implementation. The downloaded package tarball is kept in the local package cache (unless this behaviour is was overridden by the appropriate command switch). The package tarball is cached to allow for a situation where the user tampers with an existing library and if he breaks it, he can simply re-install the package without the need to download it again.

The package manager also allows the user to download a package tarball manually and then use the *pkg-install* command to install the package. This copies the downloaded package to the local cache and installs the package in the Factor implementation.