LinuxCommandLibrary

conda-package

Create conda packages

TLDR

Get conda package from file

$ conda package [[-w|--which]] [path/to/file]
copy

Remove all untracked files
$ conda package [[-r|--reset]
copy

Display all untracked files
$ conda package [[-u|--untracked]]
copy

Designate package name of the package being created
$ conda package --pkg-name [name]
copy

Designate package version of the package being created
$ conda package --pkg-version [version]
copy

Designate package build number of the package being created
$ conda package --pkg-build [build_number]
copy

SYNOPSIS

conda-package COMMAND [OPTIONS] [ARGUMENTS]
anaconda-package COMMAND [OPTIONS] [ARGUMENTS]

PARAMETERS

--help, -h
    Displays the help message for the main command or a specific subcommand.

--version
    Shows the version of the anaconda-client package currently installed.

upload
    Publishes one or more local Conda package files (.tar.bz2 or .conda) to an Anaconda repository or channel. This command often requires authentication.

download
    Retrieves a specified Conda package from an Anaconda repository to the local filesystem.

verify
    Performs integrity checks and validates the structure and metadata of a local Conda package file.

list
    Displays the file manifest (a list of all files contained) within a local Conda package without extracting it.

info
    Shows detailed metadata, build configuration, and other relevant information for a local Conda package file.

DESCRIPTION

conda-package is a powerful command-line utility, typically provided as an alias or part of the anaconda-client suite, designed to interact with Conda packages at a fundamental level. Its primary purpose is to manage the lifecycle of built packages, allowing users to inspect, verify, and crucially, upload them to various Conda channels, such as Anaconda Cloud or private repositories.

While conda build handles the creation of packages from source code, conda-package focuses on post-build operations, facilitating distribution and quality assurance. It enables developers, data scientists, and CI/CD pipelines to publish their custom environments and libraries, ensuring their availability and integrity within the Conda ecosystem. The command supports both the older .tar.bz2 and newer .conda package formats.

CAVEATS

The conda-package command is an alias for anaconda-package and requires the anaconda-client package to be installed in your environment. It is not used for building packages from source code (that's handled by conda build). Uploading packages typically requires authentication (e.g., via anaconda login or API tokens) and appropriate permissions on the target Anaconda repository.

COMMON USE CASES

Uploading Packages: After building a package with conda build, use conda-package upload my_package.tar.bz2 to publish it to a channel.
Inspecting Packages: Use conda-package list my_package.conda or conda-package info my_package.tar.bz2 to examine contents without extracting.
Verifying Integrity: conda-package verify my_package.conda ensures the package is structurally sound before distribution.

AUTHENTICATION FOR UPLOADS

To upload packages, conda-package typically requires authentication with an Anaconda repository. This is usually managed by logging in via the main anaconda command: anaconda login, which stores credentials, or by using environment variables for API tokens (e.g., ANACONDA_TOKEN).

HISTORY

conda-package is an integral part of the anaconda-client project, which was developed by Anaconda, Inc. to complement the Conda package manager. Its emergence was driven by the need for a robust and programmatic way to manage, distribute, and interact with Conda packages beyond simple installation. The command has evolved with the Conda ecosystem, adapting to new package formats (like .conda files) and improving workflows for package maintainers and CI/CD systems, solidifying its role in publishing packages to both public and private Conda channels.

SEE ALSO

conda(1), conda-build(1), anaconda(1)

Copied to clipboard