Project Management

(bundle-install bundle &opt no-deps)

Install a bundle from a git repository.

(curl & args)

Make a call to curl

(do-rule target)

Evaluate a given rule in a one-off manner.

(download-bundle url bundle-type &opt tag shallow)

Download the package source (using git) to the local cache. Return the path to the downloaded or cached soure code.

(download-git-bundle bundle-dir url tag shallow)

Download a git bundle from a remote respository

(download-tar-bundle bundle-dir url &opt force-gz)

Download a dependency from a tape archive. The archive should have exactly one top level directory that contains the contents of the project.

(git & args)

Make a call to git.

(import-rules path &opt base-env)

Import another file that defines more rules. This ruleset is merged into the current ruleset.

(load-lockfile &opt filename)

Load packages from a lockfile.

(load-project-meta &opt path)

Load the metadata from a project.janet file without doing a full evaluation of the project.janet file. Returns a struct with the project metadata. Raises an error if no metadata found.

(make-jpm-env &opt base-env)

Create an environment that is preloaded with jpm symbols.

(make-lockfile &opt filename)

(out-of-tree-config path &opt options)

Create an out of tree build configuration. This lets a user have a debug or release build, as well as other configuration on a one time basis. This works by creating a new directory with a project.janet that loads in the original project.janet file with some settings changed.

(post-deps & body)

Run code at the top level if jpm dependencies are installed. Build code that imports dependencies should be wrapped with this macro, as project.janet needs to be able to run successfully even without dependencies installed.

(require-jpm path &opt base-env)

Require a jpm file project file. This is different from a normal require in that code is loaded in the jpm environment.

(resolve-bundle bundle)

Convert any bundle string/table to the normalized table form.

(tar & args)

Make a call to tar.

(update-git-bundle bundle-dir tag shallow)

Fetch latest tag version from remote repository

(update-installed)

Update all previously installed packages to their latest versions.