Home / Docs / Command line

una ita

Release v0.4.0

The package manager of edition 0.4: dependencies, ita.una and ita.lock.

text
una ita [OPTIONS] <COMMAND>

Commands

Command What it does
una ita remove Remove a need from ita.una, then write the lock
una ita tree Print the program's packages, with their ceilings, authority and trust
una ita lock Write ita.lock for the package, or check it with --check
una ita update Raise the named needs, or all, and write the lock, for the package in the current directory
una ita add Add a need to ita.una and write the lock, for the package in the current directory
una ita fetch Fetch each locked registry package into Itaoca, verified, with its provenance
una ita vendor Copy each locked registry package from Itaoca into vendor/ita/, with its provenance
una ita verify Verify each locked registry package again, in vendor/ita/ and in Itaoca
una ita publish Check, build, sign and send a release of the package to the registry it names
una ita yank Yank a release of the package: new resolutions skip it, and existing locks keep it
una ita audit Check each locked registry package for yanks, advisories and key changes (U7014)
una ita watch Print the new entries of an owner's chains, and any promise its registry broke
una ita bundle Write each locked registry package, with its provenance, into one file
una ita unbundle Verify a bundle against the lock, and store its packages in Itaoca

Options

Option What it does Default
--json Print machine output as JSON on stdout, and nothing else on stdout
--color <WHEN> When to use colors in human output. Values: never: Never use colors; auto: Use colors when the output is a terminal; always: Always use colors. auto

Specification

The normative rules, from spec/13 §5:

Command Meaning
una ita <command> (v0.4, ADR 0122) The package manager of edition 0.4: lock, update, add, remove, tree, fetch, vendor, verify, publish, yank, audit, watch, bundle and unbundle; the binary run as ita is una ita (spec/30 §6)

Help text

As una ita --help prints it at v0.4.0:

text
The package manager of edition 0.4: dependencies, `ita.una` and `ita.lock`

Usage: una ita [OPTIONS] <COMMAND>

Commands:
  remove    Remove a need from ita.una, then write the lock
  tree      Print the program's packages, with their ceilings, authority and trust
  lock      Write `ita.lock` for the package, or check it with --check
  update    Raise the named needs, or all, and write the lock, for the package in the current directory
  add       Add a need to ita.una and write the lock, for the package in the current directory
  fetch     Fetch each locked registry package into Itaoca, verified, with its provenance
  vendor    Copy each locked registry package from Itaoca into vendor/ita/, with its provenance
  verify    Verify each locked registry package again, in vendor/ita/ and in Itaoca
  publish   Check, build, sign and send a release of the package to the registry it names
  yank      Yank a release of the package: new resolutions skip it, and existing locks keep it
  audit     Check each locked registry package for yanks, advisories and key changes (U7014)
  watch     Print the new entries of an owner's chains, and any promise its registry broke
  bundle    Write each locked registry package, with its provenance, into one file
  unbundle  Verify a bundle against the lock, and store its packages in Itaoca

Options:
      --json
          Print machine output as JSON on stdout, and nothing else on stdout

      --color <WHEN>
          When to use colors in human output

          Possible values:
          - never:  Never use colors
          - auto:   Use colors when the output is a terminal
          - always: Always use colors

          [default: auto]

  -h, --help
          Print help (see a summary with '-h')
View the Markdown