Skip to content

lip install

Usage

Bash
1
2
lip install [options] <requirement specifiers>
lip install [options] <tooth files>

Description

Install a tooth from:

  • tooth repositories via Goproxy.
  • local standalone tooth files.

For the tooth repository, you can specific the version by add suffix like @1.2.3 or @1.2.0-beta.3. However, when another version is installed and you run lip without --upgrade or --force-reinstall flag, lip will not install the specific version.

Only letters, numbers, dashes, underlines, dots, slashes [A-Za-z0-9-_./] and one @ are allowed in requirement specifiers.

If you have set environment variable GOPROXY, lip will access tooth repositories via it. Otherwise, lip will choose the default Goproxy https://goproxy.io.

Overview

lip install has several stages:

  1. Identify the base requirements. The user supplied arguments are processed here.
  2. Fetch teeth and resolve dependencies. Dependencies will be resolved as soon as teeth are fetched.
  3. Install the teeth (and uninstall anything being upgraded)

Note that lip install prefers to leave the installed version as-is unless --upgrade is specified.

Argument Handling

When looking at the items to be installed, lip checks what type of item each is, in the following order:

  1. Local tooth file.
  2. Tooth repository, which can be accessed via Goproxy.

Satisfying Requirements

Once lip has the set of requirements to satisfy, it chooses which version of each requirement to install using the simple rule that the latest stable version that satisfies the given constraints will be installed. If no stable version is available, lip will choose the latest pre-release version.

Installation Order

lip installs dependencies before their dependents, i.e. in “topological order”. When encountering a cycle in the dependency graph, lip will refuse to install teeth. All developers should avoid any cycle in the dependency graph.

This dependency graph will be maintained by lip. When uninstalling some packages, lip will check the graph to ensure that all dependents uninstalled. If not, lip will ask you whether to uninstall them or cancel the procedure.

Pre-release Versions

You can install any pre-release versions by specifying the version. And teeth can declare pre-release versions as their dependencies. However, when teeth use any type of range version match or wildcard, lip will ignore pre-release versions.

Options

  • -h, --help

Show help.

  • --upgrade

Upgrade the specified tooth to the newest available version. If a version is specified and it is newer, upgrade to that version. The handling of dependencies depends on the upgrade-strategy used. When upgrading, lip will first uninstall the old version and then install the new version.

  • --force-reinstall

Reinstall the tooth even if they are already up-to-date. When reinstalling, lip will first uninstall the tooth and then install it. If version specified, lip will install the version, otherwise the newest version.

  • -y, --yes

Assume yes to all prompts and run non-interactively.

  • --no-dependencies

Do not install dependencies. Also bypass prerequisite checks.

Examples

Install from tooth repositories:

Bash
1
2
lip install example.com/some_user/some_tooth         # Latest version
lip install example.com/some_user/[email protected]   # Specific version

Upgrade an already installed tooth:

Bash
1
lip install --upgrade example.com/some_user/some_tooth

Force reinstall a tooth:

Bash
1
lip install --force-reinstall example.com/some_user/some_tooth

Install from a local tooth:

Bash
1
2
lip install example.tth
lip install ./example/example.tth