Skip to content
jennifer-languagePublic

About

jennifer vendor console - package manager

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

jvc - jennifer vendor console

jvc is the package manager for the Jennifer language, written in Jennifer. It reads a manifest, resolves a dependency graph against a deck repository, vendors the result, and pins it so a fresh checkout rebuilds the same tree.

  • Packages are called decks. The manifest is deck.toml; the resolved set is pinned in camcorder.lock.
  • A deck has a scoped name such as @jennifer/routeros, is vendored into vendor/, and is imported as import "@jennifer/routeros/";. Bare names (ansi, http) are bundled or local modules, not decks.
  • jvc is the client. The deck repository is a separate project, and it owns the client specification that jvc implements.

Install

The quickest way needs only jennifer and git: jvc installs itself from a clone.

git clone https://github.com/jennifer-language/jvc.git /tmp/jvc
/tmp/jvc/bin/jvc app install https://github.com/jennifer-language/jvc
rm -rf /tmp/jvc

Or from a release:

sudo apt install ./jvc_0.2.0_all.deb          # Debian / Ubuntu
sudo pacman -U jvc-0.2.0-1-any.pkg.tar.zst    # Arch
tar xzf jvc-0.2.0.tar.gz                      # anywhere else

Each artifact has a sidecar .sha256. All need jennifer 0.26.0 or later. See Installing jvc.

Quick start

jvc add "@jennifer/routeros" "^0.1.0"     # add a requirement
jvc install                               # install what camcorder.lock pins
jvc update                                # advance to the newest allowed
jvc publish                               # gate, then publish a tag

jvc help lists every verb. See the quick start.

Documentation

Published at https://jvc.jennifer-lang.dev/. The pages in docs/ are a Grimoire book, built by grimoire build --config grimoire.toml. The site shows main until the first release; from then on it shows the latest release.

Introduction the vocabulary, the three shapes, the layout
Installing jvc from a clone, packages, completions, building the artifacts
Quick start the path through the verbs
The jvc CLI every verb and flag, in full
The deck manifest the format, as a guide
Deck manifest specification the normative reference
Working on jvc tests, conventions, CI
Status what is implemented, and what is not

Tests

for t in src/*_test.j; do jennifer test "$t"; done
jennifer lint src/*.j bin/jvc

Every module has a white-box *_test.j overlay beside it. The launcher is a thin adapter; the logic and the tests live in src/.

License

LGPL-3.0-only.

About

jennifer vendor console - package manager

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors