pixi upgrade

About

Checks if there are newer versions of the dependencies and upgrades them in the lockfile and manifest file

Note

The pixi upgrade command will update only versions, except when you specify the exact package name (pixi upgrade numpy).

Then it will remove all fields, apart from:

• build field containing a wildcard *
• channel
• file_name
• url
• subdir.

Usage

pixi upgrade [OPTIONS] [PACKAGES]...

Arguments

• <PACKAGES>

  The packages to upgrade
  May be provided more than once.

Config Options

• --tls-no-verify

  Do not verify the TLS certificate of the server

• --auth-file <AUTH_FILE>

  Path to the file containing the authentication token

• --pypi-keyring-provider <PYPI_KEYRING_PROVIDER>

  Specifies whether to use the keyring to look up credentials for PyPI
  options: disabled, subprocess

• --concurrent-solves <CONCURRENT_SOLVES>

  Max concurrent solves, default is the number of CPUs

• --concurrent-downloads <CONCURRENT_DOWNLOADS>

  Max concurrent network requests, default is 50

Update Options

• --no-install

  Don't modify the environment, only modify the lock-file

• --revalidate

  Run the complete environment validation. This will reinstall a broken environment

• --no-lockfile-update

  Don't update lockfile, implies the no-install as well

• --frozen

  Install the environment as defined in the lockfile, doesn't update lockfile if it isn't up-to-date with the manifest file
  env: PIXI_FROZEN

• --locked

  Check if lockfile is up-to-date before installing the environment, aborts when lockfile isn't up-to-date with the manifest file
  env: PIXI_LOCKED

• --feature (-f) <FEATURE>

  The feature to update
  default: default

• --exclude <EXCLUDE>

  The packages which should be excluded
  May be provided more than once.

• --json

  Output the changes in JSON format

• --dry-run (-n)

  Only show the changes that would be made, without actually updating the manifest, lock file, or environment

Global Options

• --manifest-path <MANIFEST_PATH>

  The path to pixi.toml, pyproject.toml, or the workspace directory

Description

Checks if there are newer versions of the dependencies and upgrades them in the lockfile and manifest file.

pixi upgrade loosens the requirements for the given packages, updates the lock file and the adapts the manifest accordingly.

Examples

pixi upgrade # (1)!
pixi upgrade numpy # (2)!
pixi upgrade numpy pandas # (3)!
pixi upgrade --manifest-path ~/myworkspace/pixi.toml numpy # (4)!
pixi upgrade --feature lint python # (5)!
pixi upgrade --json # (6)!
pixi upgrade --dry-run # (7)!

1. This will upgrade all packages to the latest version.
2. This will upgrade the numpy package to the latest version.
3. This will upgrade the numpy and pandas packages to the latest version.
4. This will upgrade the numpy package to the latest version in the manifest file at the given path.
5. This will upgrade the python package in the lint feature.
6. This will upgrade all packages and output the result in JSON format.
7. This will show the packages that would be upgraded without actually upgrading them in the lockfile or manifest.