Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/conda/conda-build

Commands and tools for building conda packages
https://github.com/conda/conda-build

conda conda-build package-management

Last synced: 3 months ago
JSON representation

Commands and tools for building conda packages

Awesome Lists containing this project

README

        

[ci-tests-badge]: https://github.com/conda/conda-build/actions/workflows/tests.yml/badge.svg
[codecov-badge]: https://img.shields.io/codecov/c/github/conda/conda-build/main.svg?label=coverage
[release-badge]: https://img.shields.io/github/release/conda/conda-build.svg

# `conda-build`

[![CI Tests (GitHub Actions)][ci-tests-badge]](https://github.com/conda/conda-build/actions/workflows/tests.yml)
[![Codecov Status][codecov-badge]](https://codecov.io/gh/conda/conda-build/branch/main)
[![latest release version][release-badge]](https://github.com/conda/conda/releases)

## Installation

```bash
# Display information about current conda install
$ conda info

# Install conda-build in the base env
$ conda install -n base conda-build
```

## Building Your Own Packages

You can easily build your own packages for `conda`, and upload them to
[anaconda.org](https://anaconda.org), a free service for hosting packages for `conda`, as
well as other package managers. To build a package, create a recipe. See
[AnacondaRecipes](https://github.com/AnacondaRecipes) and [conda-forge](https://github.com/conda-forge) for many example recipes, and
[`conda-build` documentation](https://docs.conda.io/projects/conda-build/en/latest/index.html) on how to build
recipes.

To upload to [anaconda.org](https://anaconda.org), create an account. Then, install the `anaconda-client`
and login

```bash
$ conda install anaconda-client
$ anaconda login
```

Then, after you build your recipe

```bash
$ conda build
```

you will be prompted to upload to [anaconda.org](https://anaconda.org).

To add your [anaconda.org](https://anaconda.org) channel, or the channel of others to `conda` so that `conda install`
will find and install their packages, run

```bash
$ conda config --add channels https://conda.anaconda.org/
```

(replacing `USERNAME` with the user name of the person whose channel you want
to add).

## Gotchas/FAQ

* `OSError: [Errno 36] File name too long:` - This error has been seen on Linux computers with encrypted folders. The solution is to install `miniconda` or `anaconda` to a location that is not encrypted. This error occurs because the encrypted form of the path that `conda-build` creates can be too long.

## Getting Help

- [Documentation](https://docs.conda.io/projects/conda-build/en/latest)
- [Twitter](https://twitter.com/condaproject)
- [Slack](https://conda.slack.com)
- [Bug Reports/Feature Requests](https://github.com/conda/conda-build/issues)
- [Installer/Package Issues](https://github.com/ContinuumIO/anaconda-issues/issues)

## Contributing

Contributions to conda-build are welcome. See the [contributing](CONTRIBUTING.md) documentation
for instructions on setting up a development environment.