<picture>
<!-- These are also used for https://github.com/conan-io/.github/blob/main/profile/README.md -->
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/conan-io/conan/develop2/.github/conan2-logo-for-dark.svg">
<source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/conan-io/conan/develop2/.github/conan2-logo-for-light.svg">
<img alt="JFrog | Conan 2.0 Logo" src="https://raw.githubusercontent.com/conan-io/conan/develop2/.github/conan2-logo-with-bg.svg">
</picture>
# Conan
Decentralized, open-source (MIT), C/C++ package manager.
- Homepage: https://conan.io/
- Github: https://github.com/conan-io/conan
- Docs: https://docs.conan.io
- Slack: https://cpplang.slack.com (#conan channel. Please, click [here](https://join.slack.com/t/cpplang/shared_invite/zt-1snzdn6rp-rOUxF3166oz1_11Tr5H~xg) to get an invitation)
- Twitter: https://twitter.com/conan_io
Conan is a package manager for C and C++ developers:
- It is fully decentralized. Users can host their packages on their servers, privately. Integrates with Artifactory and Bintray.
- Portable. Works across all platforms, including Linux, OSX, Windows (with native and first-class support, WSL, MinGW),
Solaris, FreeBSD, embedded and cross-compiling, docker, WSL
- Manage binaries. It can create, upload and download binaries for any configuration and platform,
even cross-compiling, saving lots of time in development and continuous integration. The binary compatibility can be configured
and customized. Manage all your artifacts in the same way on all platforms.
- Integrates with any build system, including any proprietary and custom one. Provides tested support for major build systems
(CMake, MSBuild, Makefiles, Meson, etc).
- Extensible: Its Python-based recipes, together with extension points allow for great power and flexibility.
- Large and active community, especially in GitHub (https://github.com/conan-io/conan) and Slack (https://cppalliance.org/slack/ #conan channel).
This community also creates and maintains packages in ConanCenter and Bincrafters repositories in Bintray.
- Stable. Used in production by many companies, since 1.0 there is a commitment not to break package recipes and documented behavior.
This is the **developer/maintainer** documentation. For user documentation, go to https://docs.conan.io
| **develop2** |
|-------------------------|
| [](https://ci.conan.io/blue/organizations/jenkins/ConanTestSuitev2/activity) |
## Setup
You can run Conan from source in Windows, MacOS, and Linux:
- **Install pip following** [pip docs](https://pip.pypa.io/en/stable/installation/).
- **Clone Conan repository:**
```bash
$ git clone https://github.com/conan-io/conan.git conan-io
```
> **Note**: repository directory name matters, some directories are known to be problematic to run tests (e.g. `conan`). `conan-io` directory name was tested and guaranteed to be working.
- **Install in editable mode**
```bash
$ cd conan-io && sudo pip install -e .
```
If you are in Windows, using ``sudo`` is not required. Some Linux distros won't allow you to put Python packages in editable mode in the root Python installation, and creating a virtual environment ``venv`` first, is mandatory.
- **You are ready, try to run Conan:**
```bash
$ conan --help
Consumer commands
install Installs the requirements specified in a recipe (conanfile.py or conanfile.txt).
...
Conan commands. Type "conan <command> -h" for help
```
## Contributing to the project
Feedback and contribution are always welcome in this project.
Please read our [contributing guide](https://github.com/conan-io/conan/blob/develop/.github/CONTRIBUTING.md).
Also, if you plan to contribute, please add some testing for your changes. You can read the [Conan
tests guidelines section](https://github.com/conan-io/conan/blob/develop/conans/test/README.md) for
some advice on how to write tests for Conan.
### Running the tests
**Install Python requirements**
```bash
$ python -m pip install -r conans/requirements_server.txt
$ python -m pip install -r conans/requirements_dev.txt
```
If you are not on Windows and you are not using a Python virtual environment, you will need to run these
commands using `sudo`.
Before you can run the tests, you need to set a few environment variables first.
```bash
$ export PYTHONPATH=$PYTHONPATH:$(pwd)
```
On Windows it would be (while being in the Conan root directory):
```bash
$ set PYTHONPATH=.
```
Conan test suite defines and configures some required tools (CMake, Ninja, etc) in the
``conftest.py`` and allows to define a custom ``conftest_user.py``.
Some specific versions, like cmake>=3.15 are necessary.
You can run the tests like this:
```bash
$ python -m pytest .
```
A few minutes later it should print ``OK``:
```bash
............................................................................................
----------------------------------------------------------------------
Ran 146 tests in 50.993s
OK
```
To run specific tests, you can specify the test name too, something like:
```bash
$ python -m pytest conans/test/unittests/client/cmd/export_test.py::ExportTest::test_export_warning -s
```
The `-s` argument can be useful to see some output that otherwise is captured by *pytest*.
Also, you can run tests against an instance of Artifactory. Those tests should add the attribute
`artifactory_ready`.
```bash
$ python -m pytest . -m artifactory_ready
```
Some environment variables have to be defined to run them. For example, for an
Artifactory instance that is running on the localhost with default user and password configured, the
variables could take the values:
```bash
$ export CONAN_TEST_WITH_ARTIFACTORY=1
$ export ARTIFACTORY_DEFAULT_URL=http://localhost:8081/artifactory
$ export ARTIFACTORY_DEFAULT_USER=admin
$ export ARTIFACTORY_DEFAULT_PASSWORD=password
```
`ARTIFACTORY_DEFAULT_URL` is the base URL for the Artifactory repo, not one for a specific
repository. Running the tests with a real Artifactory instance will create repos on the fly so please
use a separate server for testing purposes.
## License
[MIT LICENSE](LICENSE.md)
Raw data
{
"_id": null,
"home_page": "https://conan.io",
"name": "conan",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": null,
"keywords": "C/C++, package, libraries, developer, manager, dependency, tool, c, c++, cpp",
"author": "JFrog LTD",
"author_email": "luism@jfrog.com",
"download_url": "https://files.pythonhosted.org/packages/8a/53/87dcedec3db555a6b760c9acf4e28e204ed124dd583181ea45fe87cd775a/conan-2.2.3.tar.gz",
"platform": null,
"description": "<picture>\n <!-- These are also used for https://github.com/conan-io/.github/blob/main/profile/README.md -->\n <source media=\"(prefers-color-scheme: dark)\" srcset=\"https://raw.githubusercontent.com/conan-io/conan/develop2/.github/conan2-logo-for-dark.svg\">\n <source media=\"(prefers-color-scheme: light)\" srcset=\"https://raw.githubusercontent.com/conan-io/conan/develop2/.github/conan2-logo-for-light.svg\">\n <img alt=\"JFrog | Conan 2.0 Logo\" src=\"https://raw.githubusercontent.com/conan-io/conan/develop2/.github/conan2-logo-with-bg.svg\">\n</picture>\n\n# Conan\n\nDecentralized, open-source (MIT), C/C++ package manager.\n\n- Homepage: https://conan.io/\n- Github: https://github.com/conan-io/conan\n- Docs: https://docs.conan.io\n- Slack: https://cpplang.slack.com (#conan channel. Please, click [here](https://join.slack.com/t/cpplang/shared_invite/zt-1snzdn6rp-rOUxF3166oz1_11Tr5H~xg) to get an invitation)\n- Twitter: https://twitter.com/conan_io\n\n\nConan is a package manager for C and C++ developers:\n\n- It is fully decentralized. Users can host their packages on their servers, privately. Integrates with Artifactory and Bintray.\n- Portable. Works across all platforms, including Linux, OSX, Windows (with native and first-class support, WSL, MinGW),\n Solaris, FreeBSD, embedded and cross-compiling, docker, WSL\n- Manage binaries. It can create, upload and download binaries for any configuration and platform,\n even cross-compiling, saving lots of time in development and continuous integration. The binary compatibility can be configured\n and customized. Manage all your artifacts in the same way on all platforms.\n- Integrates with any build system, including any proprietary and custom one. Provides tested support for major build systems\n (CMake, MSBuild, Makefiles, Meson, etc).\n- Extensible: Its Python-based recipes, together with extension points allow for great power and flexibility.\n- Large and active community, especially in GitHub (https://github.com/conan-io/conan) and Slack (https://cppalliance.org/slack/ #conan channel).\n This community also creates and maintains packages in ConanCenter and Bincrafters repositories in Bintray.\n- Stable. Used in production by many companies, since 1.0 there is a commitment not to break package recipes and documented behavior.\n\n\nThis is the **developer/maintainer** documentation. For user documentation, go to https://docs.conan.io\n\n\n| **develop2** |\n|-------------------------|\n| [](https://ci.conan.io/blue/organizations/jenkins/ConanTestSuitev2/activity) |\n\n\n\n## Setup\n\nYou can run Conan from source in Windows, MacOS, and Linux:\n\n- **Install pip following** [pip docs](https://pip.pypa.io/en/stable/installation/).\n\n- **Clone Conan repository:**\n\n ```bash\n $ git clone https://github.com/conan-io/conan.git conan-io\n ```\n\n > **Note**: repository directory name matters, some directories are known to be problematic to run tests (e.g. `conan`). `conan-io` directory name was tested and guaranteed to be working.\n\n- **Install in editable mode**\n\n ```bash\n $ cd conan-io && sudo pip install -e .\n ```\n\n If you are in Windows, using ``sudo`` is not required. Some Linux distros won't allow you to put Python packages in editable mode in the root Python installation, and creating a virtual environment ``venv`` first, is mandatory.\n\n- **You are ready, try to run Conan:**\n\n ```bash\n $ conan --help\n\n Consumer commands\n install Installs the requirements specified in a recipe (conanfile.py or conanfile.txt).\n ...\n\n Conan commands. Type \"conan <command> -h\" for help\n ```\n\n## Contributing to the project\n\n\nFeedback and contribution are always welcome in this project.\nPlease read our [contributing guide](https://github.com/conan-io/conan/blob/develop/.github/CONTRIBUTING.md).\nAlso, if you plan to contribute, please add some testing for your changes. You can read the [Conan\ntests guidelines section](https://github.com/conan-io/conan/blob/develop/conans/test/README.md) for\nsome advice on how to write tests for Conan.\n\n### Running the tests\n\n\n**Install Python requirements**\n\n```bash\n$ python -m pip install -r conans/requirements_server.txt\n$ python -m pip install -r conans/requirements_dev.txt\n```\n\nIf you are not on Windows and you are not using a Python virtual environment, you will need to run these\ncommands using `sudo`.\n\nBefore you can run the tests, you need to set a few environment variables first.\n\n```bash\n$ export PYTHONPATH=$PYTHONPATH:$(pwd)\n```\n\nOn Windows it would be (while being in the Conan root directory):\n\n```bash\n$ set PYTHONPATH=.\n```\n\nConan test suite defines and configures some required tools (CMake, Ninja, etc) in the\n``conftest.py`` and allows to define a custom ``conftest_user.py``.\nSome specific versions, like cmake>=3.15 are necessary.\n\n\nYou can run the tests like this:\n\n```bash\n$ python -m pytest .\n```\n\nA few minutes later it should print ``OK``:\n\n```bash\n............................................................................................\n----------------------------------------------------------------------\nRan 146 tests in 50.993s\n\nOK\n```\n\nTo run specific tests, you can specify the test name too, something like:\n\n```bash\n$ python -m pytest conans/test/unittests/client/cmd/export_test.py::ExportTest::test_export_warning -s\n```\n\nThe `-s` argument can be useful to see some output that otherwise is captured by *pytest*.\n\nAlso, you can run tests against an instance of Artifactory. Those tests should add the attribute\n`artifactory_ready`.\n\n```bash\n$ python -m pytest . -m artifactory_ready\n```\n\nSome environment variables have to be defined to run them. For example, for an\nArtifactory instance that is running on the localhost with default user and password configured, the\nvariables could take the values:\n\n```bash\n$ export CONAN_TEST_WITH_ARTIFACTORY=1\n$ export ARTIFACTORY_DEFAULT_URL=http://localhost:8081/artifactory\n$ export ARTIFACTORY_DEFAULT_USER=admin\n$ export ARTIFACTORY_DEFAULT_PASSWORD=password\n```\n\n`ARTIFACTORY_DEFAULT_URL` is the base URL for the Artifactory repo, not one for a specific\nrepository. Running the tests with a real Artifactory instance will create repos on the fly so please\nuse a separate server for testing purposes.\n\n## License\n\n[MIT LICENSE](LICENSE.md)",
"bugtrack_url": null,
"license": "MIT",
"summary": "Conan C/C++ package manager",
"version": "2.2.3",
"project_urls": {
"Documentation": "https://docs.conan.io",
"Homepage": "https://conan.io",
"Source": "https://github.com/conan-io/conan",
"Tracker": "https://github.com/conan-io/conan/issues"
},
"split_keywords": [
"c/c++",
" package",
" libraries",
" developer",
" manager",
" dependency",
" tool",
" c",
" c++",
" cpp"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8a5387dcedec3db555a6b760c9acf4e28e204ed124dd583181ea45fe87cd775a",
"md5": "6ef7e3d5f1c71beaec75a2119915050c",
"sha256": "8968d6f235255b688f2d7391168fe348b36ba9759ed0c3bcaf49f0cc74bcf60d"
},
"downloads": -1,
"filename": "conan-2.2.3.tar.gz",
"has_sig": false,
"md5_digest": "6ef7e3d5f1c71beaec75a2119915050c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 425441,
"upload_time": "2024-04-17T15:52:06",
"upload_time_iso_8601": "2024-04-17T15:52:06.099466Z",
"url": "https://files.pythonhosted.org/packages/8a/53/87dcedec3db555a6b760c9acf4e28e204ed124dd583181ea45fe87cd775a/conan-2.2.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-17 15:52:06",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "conan-io",
"github_project": "conan",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "conan"
}
JSON
