Home / Docs / Configure a package

una ita

What it does

In release 0.4.0 no registry is served and no command builds one or a mirror, so the commands and options on this page that read or write a registry have nothing to work with yet. Path dependencies are the dependencies usable in this release (see path dependencies).

una ita is the package manager, part of the una binary. The same binary run under the name ita behaves as una ita: ita lock is una ita lock. No command of this release opens a network connection, and none ever starts another program: a bundle goes through a file, and a submission waits for an https transport.

ita.unauna
ita shop
  version 0.1.0
  edition 0.4

needs
  util from path "deps/util"
    accept name
ita.lockuna
lock 1

solver
  encoding "una-smt-1"
  name "z3"
  version "5.1.0"
  logic "QF_UFLIA"
  steps 5000000
  seed 0

package util 0.2.0
  from path "deps/util"
  digest "sha256:0000000000000000000000000000000000000000000000000000000000000000"
deps/util/ita.unauna
ita util
  version 0.2.0
  edition 0.4
deps/util/src/text.unauna
module text

pub shout(word: Text) -> Text = word
src/shop.unauna
module shop

import util.text (shout)

pub greet() -> Text = shout("hello")

Forms

text
una ita lock [path] [--check [--fresh]] [--dry-run] [--accept-authority <package>]... [--accept-trust <package>@<digest>]... [--accept-key <package>]...
una ita update [<name>...] [--cooldown <hours>] [--now] [--dry-run] [--accept-authority <package>]... [--accept-trust <package>@<digest>]... [--accept-key <package>]...
una ita add <name> [<version>] [--as <local>] [--from <source>] [--now] [--dry-run]
una ita remove <name> [path]
una ita tree [path]
una ita fetch [path]
una ita vendor [path]
una ita verify [path]
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]
una ita unbundle <file> [path]

Examples

Terminal
$ una ita lock
add util 0.2.0 (path deps/util): digest sha256:…; may nothing; uses nothing
wrote ita.lock
$ una ita tree
shop 0.1.0
  util 0.2.0 (path deps/util): may nothing (by shop); uses nothing; trust none

After the dependency's version changes to 0.3.0:

Terminal
$ una ita update --dry-run
change util 0.2.0 -> 0.3.0 (path deps/util): digest sha256:… -> sha256:…; may nothing; uses nothing
--dry-run: nothing written

Edge cases

Diagnostics

The commands report the diagnostics of the files they read: see ita.una, ita.lock and path dependencies. Resolution adds one:

Edition

Edition 0.4 and later, a preview.

Normative source