Home / Docs / Specification / 30. Packages and dependencies

30.6 Commands

Release v0.4.0

With --json, each command of una ita prints one una.ita/1 document (rule 1). una --json ita lock of a package whose ita.una adds the path dependency util (§12 rule 6) prints:

json
{
  "schema": "una.ita/1",
  "command": "lock",
  "written": ["ita.lock"],
  "changes": [
    {
      "change": "add",
      "package": "util",
      "origin": "path deps/util",
      "version_from": null,
      "version_to": "0.2.0",
      "digest_from": null,
      "digest_to": "sha256:628a11aacf38c392c3224401a087d357fbee26abf719488dfdaec055872f1764",
      "ceiling_from": "",
      "ceiling_to": "",
      "trusted_from": [],
      "trusted_to": [],
      "consented_from": null,
      "consented_to": null,
      "authority": []
    }
  ],
  "diagnostics": [],
  "error": null
}
  1. una ita. The package manager is the command una ita of the una binary. The same binary invoked under the name ita (its argv[0] basename, ita or ita.exe) behaves as una ita: ita lock is una ita lock. With --json, each command prints one document, una.ita/1: schema first, then command, written (the files it wrote) and diagnostics; a command that resolves (lock, update, add, remove) also gives changes, the review of §10 rule 8, after written, and error last, the reason it failed outside its diagnostics, such as a file it could not write, or null, and tree gives root and packages in place of written (§12 rule 9). The exit code is 1 when a diagnostic is an error, and 2 for a usage error, such as a directory without ita.una.
  2. Commands of this release. una ita lock [--check [--fresh]] [--dry-run] [--accept-authority <package>]… [--accept-trust <package>@<digest>]… [--accept-key <package>]… [path] (§4 rule 4, §10 rules 7 and 8, §12 rule 6, §13 rule 2, §14 rule 8); una ita update [<name>…] [--cooldown <hours>] [--now] [--dry-run] [--accept-authority <package>]… [--accept-trust <package>@<digest>]… [--accept-key <package>]… and una ita add <name> [<version>] [--as <local>] [--from <source>] [--now] [--dry-run], on the package in the current directory (§10 rules 9 and 10); una ita tree [path] and una ita remove <name> [path] (§12 rule 9); una ita fetch [path] (§14 rule 9); una ita vendor [path] (§9 rule 8); una ita verify [path] (§10 rule 11); una ita publish [path], una ita yank <version> [path], una ita audit [path], una ita watch <owner> [<name>…] [--from <source>], una ita bundle <file> [path] and una ita unbundle <file> [path] (§15). una ita key joins later.
  3. No network, no other program. No command of this release opens a network connection: a registry is read from a local mirror directory (§14 rule 1), a submission to an https:// source stops before anything is sent (§15 rule 1), and a bundle goes through a file. Itá never starts another program.