A DFS (depth-first search) package manager with one shared global store (~/.carne, no node_modules), built on pkg/datpkgr. It installs from both git and npm-style sources.
🔗Commands
carne pkg init [dir]carne pkg install <spec>carne pkg remove <name> [ver]carne pkg update [name]carne pkg listcarne pkg develop <path>carne pkg prunecarne pkg refreshcarne pkg publish [opts]🔗Scaffolding a package
carne pkg init # wizard in the current directory (must be empty)carne pkg init <dir> # wizard into ./<dir>/ (created when missing)carne pkg init -Y [dir] # skip the wizard, scaffold with defaultsThe wizard asks for the package name (lowercase, validated before anything is written), a semver version, description, author (defaults to the git user name), license and keywords. -Y / --yes takes the git author, 0.1.0, MIT and ["carne"] keywords with no prompts; without it, stdin must be a TTY. An existing package.json is never overwritten.
The scaffold writes:
package.json— name, version, description, license, keywords,mainindex.js— a documentedhellostartertests/<name>.test.js— astd/teststarter, found bycarne test
See the Testing page for the test runner and matchers.
🔗Installing from git
carne pkg install <git-url>carne pkg install gh:user/repo#v1Supported sources include https:// URLs, git+/git:// transports, git@ and .git URLs, plus forge aliases (gh:, github:, gl:, cb:, srht:). A #ref suffix pins a branch or tag.
The cloned repo must contain a valid package.json at its root.
🔗Installing from the registry
carne pkg install <name>[@range]carne pkg install npm:name@rangeResolved through the public registry at openpeeps/carnepkgs (source carne, cached at ~/.carne/registries/carne.json; carne pkg refresh re-downloads it).
🔗Package imports
Installed packages load through require("pkg/<name>") as CommonJS:
const demo = require("pkg/carne_demo_pkg");console.log(demo.hello("ada")); // hi adaA @version suffix pins an installed version (require("pkg/greet@0.1.0")), and pkg/<name>/sub/path reaches inside a package. ./... requires work between package files.
Only CommonJS v1 is supported: ESM (import/export) packages fail with a clear error, as do packages with no loadable entry.