Metadata-Version: 2.4
Name: conda-build
Version: 25.4.2
Summary: tools for building conda packages
Project-URL: changelog, https://github.com/conda/conda-build/blob/main/CHANGELOG.md
Project-URL: documentation, https://docs.conda.io/projects/conda-build/en/stable/
Project-URL: repository, https://github.com/conda/conda-build
Author-email: "Anaconda, Inc." <conda@continuum.io>
License: Except where noted below, conda is released under the following terms:
        
        (c) 2012 Continuum Analytics, Inc. / http://continuum.io
        All Rights Reserved
        
        Redistribution and use in source and binary forms, with or without
        modification, are permitted provided that the following conditions are met:
            * Redistributions of source code must retain the above copyright
              notice, this list of conditions and the following disclaimer.
            * Redistributions in binary form must reproduce the above copyright
              notice, this list of conditions and the following disclaimer in the
              documentation and/or other materials provided with the distribution.
            * Neither the name of Continuum Analytics, Inc. nor the
              names of its contributors may be used to endorse or promote products
              derived from this software without specific prior written permission.
        
        THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
        ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
        WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
        DISCLAIMED. IN NO EVENT SHALL CONTINUUM ANALYTICS BE LIABLE FOR ANY
        DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
        (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
        LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
        ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
        (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
        SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
        
        
        Exceptions
        ==========
        
        versioneer.py is Public Domain
License-File: AUTHORS.md
License-File: LICENSE
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Requires-Python: >=3.9
Requires-Dist: beautifulsoup4
Requires-Dist: chardet
Requires-Dist: conda-package-handling>=2.2.0
Requires-Dist: conda>=23.7.0
Requires-Dist: evalidate<3,>=2
Requires-Dist: filelock
Requires-Dist: frozendict>=2.4.2
Requires-Dist: jinja2
Requires-Dist: jsonschema>=4.19
Requires-Dist: libarchive-c
Requires-Dist: menuinst>=2
Requires-Dist: packaging
Requires-Dist: pkginfo
Requires-Dist: psutil
Requires-Dist: pytz
Requires-Dist: pyyaml
Requires-Dist: requests
Requires-Dist: tomli; python_version < '3.11'
Requires-Dist: tqdm
Description-Content-Type: text/markdown

[tests-badge]: https://img.shields.io/github/actions/workflow/status/conda/conda-build/tests.yml?branch=main&event=schedule&logo=github&label=tests
[codecov-badge]: https://img.shields.io/codecov/c/github/conda/conda-build/main?logo=codecov
[codspeed-badge]: https://img.shields.io/endpoint?url=https://codspeed.io/badge.json
[release-badge]: https://img.shields.io/github/v/release/conda/conda?logo=github
[anaconda-badge]: https://img.shields.io/conda/vn/anaconda/conda-build?logo=anaconda
[conda-forge-badge]: https://img.shields.io/conda/vn/conda-forge/conda-build?logo=conda-forge
[calver-badge]: https://img.shields.io/badge/calver-YY.MM.MICRO-22bfda.svg

# `conda-build`

[![GitHub Scheduled Tests][tests-badge]](https://github.com/conda/conda-build/actions/workflows/tests.yml?query=branch%3Amain+event%3Aschedule)
[![Codecov Status][codecov-badge]](https://codecov.io/gh/conda/conda-build/branch/main)
[![CodSpeed Performance Benchmarks][codspeed-badge]](https://codspeed.io/conda/conda-build)
[![CalVer Versioning][calver-badge]](https://calver.org)
<br>
[![GitHub Release][release-badge]](https://github.com/conda/conda-build/releases)
[![Anaconda Package][anaconda-badge]](https://anaconda.org/anaconda/conda-build)
[![conda-forge Package][conda-forge-badge]](https://anaconda.org/conda-forge/conda-build)

## 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 <RECIPE_DIR>
```

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/<USERNAME>
```

(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.
