|Logo|
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/en/latest/
- Slack: https://cppalliance.org/slack/ (#conan channel)
- 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 extensions points allows for great power and flexibility.
- Large and active community, especially in Github (https://github.com/conan-io/conan) and Slack (https://cpplang-inviter.cppalliance.org/ #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.
+-------------------------+-------------------------+
| **develop** | **Code Climate** |
+=========================+=========================+
| |Build Status Develop| | |Develop climate| |
+-------------------------+-------------------------+
Setup
=====
Please read https://docs.conan.io/en/latest/installation.html to know how to
install and start using Conan. TL;DR:
.. code-block::
$ pip install conan
Install a development version
-----------------------------
You can run **Conan** client and server in Windows, MacOS, and Linux.
- **Install pip following** `pip docs`_.
- **Clone Conan repository:**
.. code-block:: 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**
.. code-block:: bash
$ cd conan-io && sudo pip install -e .
If you are in Windows, using ``sudo`` is not required.
- **You are ready, try to run Conan:**
.. code-block::
$ conan --help
Consumer commands
install Installs the requirements specified in a recipe (conanfile.py or conanfile.txt).
config Manages Conan configuration.
get Gets a file or list a directory of a given reference or package.
info Gets information about the dependency graph of a recipe.
search Searches package recipes and binaries in the local cache or a remote. Unless a
remote is specified only the local cache is searched.
Creator commands
new Creates a new package recipe template with a 'conanfile.py' and optionally,
'test_package' testing files.
create Builds a binary package for a recipe (conanfile.py).
upload Uploads a recipe and binary packages to a remote.
export Copies the recipe (conanfile.py & associated files) to your local cache.
export-pkg Exports a recipe, then creates a package from local source and build folders.
test Tests a package consuming it from a conanfile.py with a test() method.
Package development commands
source Calls your local conanfile.py 'source()' method.
build Calls your local conanfile.py 'build()' method.
package Calls your local conanfile.py 'package()' method.
editable Manages editable packages (packages that reside in the user workspace, but are
consumed as if they were in the cache).
workspace Manages a workspace (a set of packages consumed from the user workspace that
belongs to the same project).
Misc commands
profile Lists profiles in the '.conan/profiles' folder, or shows profile details.
remote Manages the remote list and the package recipes associated with a remote.
user Authenticates against a remote with user/pass, caching the auth token.
imports Calls your local conanfile.py or conanfile.txt 'imports' method.
copy Copies conan recipes and packages to another user/channel.
remove Removes packages or binaries matching pattern from local cache or remote.
alias Creates and exports an 'alias package recipe'.
download Downloads recipe and binaries to the local cache, without using settings.
inspect Displays conanfile attributes, like name, version, and options. Works locally,
in local cache and remote.
help Shows help for a specific command.
lock Generates and manipulates lock files.
frogarian Conan The Frogarian
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 advise on how to write tests for Conan.
Running the tests
=================
Using tox
---------
.. code-block:: bash
$ python -m tox
It will install the needed requirements and launch `pytest` skipping some heavy and slow tests.
If you want to run the full test suite:
.. code-block:: bash
$ python -m tox -e full
Without tox
-----------
**Install python requirements**
.. code-block:: bash
$ python -m pip install -r conans/requirements.txt
$ python -m pip install -r conans/requirements_server.txt
$ python -m pip install -r conans/requirements_dev.txt
If you are not 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.
.. code-block:: bash
$ export PYTHONPATH=$PYTHONPATH:$(pwd)
On Windows it would be (while being in the Conan root directory):
.. code-block:: bash
$ set PYTHONPATH=.
Ensure that your ``cmake`` has version 2.8 or later. You can see the
version with the following command:
.. code-block:: bash
$ cmake --version
The appropriate values of ``CONAN_COMPILER`` and ``CONAN_COMPILER_VERSION`` depend on your
operating system and your requirements.
These should work for the GCC from ``build-essential`` on Ubuntu 14.04:
.. code-block:: bash
$ export CONAN_COMPILER=gcc
$ export CONAN_COMPILER_VERSION=4.8
These should work for OS X:
.. code-block:: bash
$ export CONAN_COMPILER=clang
$ export CONAN_COMPILER_VERSION=3.5
You can run the actual tests like this:
.. code-block:: bash
$ python -m pytest .
There are a couple of test attributes defined, as ``slow`` that you can use
to filter the tests, and do not execute them:
.. code-block:: bash
$ python -m pytest . -m "not slow"
A few minutes later it should print ``OK``:
.. code-block:: bash
............................................................................................
----------------------------------------------------------------------
Ran 146 tests in 50.993s
OK
To run specific tests, you can specify the test name too, something like:
.. code-block:: 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``.
.. code-block:: 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:
.. code-block:: 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>`__
.. |Build Status Develop| image:: https://ci.conan.io/buildStatus/icon?job=ConanTestSuite/develop
:target: https://ci.conan.io/job/ConanTestSuite/job/develop/
.. |Develop climate| image:: https://api.codeclimate.com/v1/badges/081b53e570d5220b34e4/maintainability.svg
:target: https://codeclimate.com/github/conan-io/conan/maintainability
.. |Logo| image:: https://conan.io/img/jfrog_conan_logo.png
.. _`pip docs`: https://pip.pypa.io/en/stable/installation/
Raw data
{
"_id": null,
"home_page": "https://conan.io",
"name": "conan-zbuild",
"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/23/01/646a815b1d786de119e34e861104c88972f61c4f341b4baa58927383aa8d/conan_zbuild-1.65.0.tar.gz",
"platform": null,
"description": "|Logo|\n\nConan\n=====\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/en/latest/\n- Slack: https://cppalliance.org/slack/ (#conan channel)\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 extensions points allows for great power and flexibility.\n- Large and active community, especially in Github (https://github.com/conan-io/conan) and Slack (https://cpplang-inviter.cppalliance.org/ #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\n\n+-------------------------+-------------------------+\n| **develop** | **Code Climate** |\n+=========================+=========================+\n| |Build Status Develop| | |Develop climate| |\n+-------------------------+-------------------------+\n\n\nSetup\n=====\n\nPlease read https://docs.conan.io/en/latest/installation.html to know how to\ninstall and start using Conan. TL;DR:\n\n.. code-block::\n\n $ pip install conan\n\n\nInstall a development version\n-----------------------------\n\nYou can run **Conan** client and server in Windows, MacOS, and Linux.\n\n- **Install pip following** `pip docs`_.\n\n- **Clone Conan repository:**\n\n .. code-block:: bash\n\n $ git clone https://github.com/conan-io/conan.git conan-io\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 .. code-block:: bash\n\n $ cd conan-io && sudo pip install -e .\n\n If you are in Windows, using ``sudo`` is not required.\n\n- **You are ready, try to run Conan:**\n\n .. code-block::\n\n $ conan --help\n\n Consumer commands\n install Installs the requirements specified in a recipe (conanfile.py or conanfile.txt).\n config Manages Conan configuration.\n get Gets a file or list a directory of a given reference or package.\n info Gets information about the dependency graph of a recipe.\n search Searches package recipes and binaries in the local cache or a remote. Unless a\n remote is specified only the local cache is searched.\n Creator commands\n new Creates a new package recipe template with a 'conanfile.py' and optionally,\n 'test_package' testing files.\n create Builds a binary package for a recipe (conanfile.py).\n upload Uploads a recipe and binary packages to a remote.\n export Copies the recipe (conanfile.py & associated files) to your local cache.\n export-pkg Exports a recipe, then creates a package from local source and build folders.\n test Tests a package consuming it from a conanfile.py with a test() method.\n Package development commands\n source Calls your local conanfile.py 'source()' method.\n build Calls your local conanfile.py 'build()' method.\n package Calls your local conanfile.py 'package()' method.\n editable Manages editable packages (packages that reside in the user workspace, but are\n consumed as if they were in the cache).\n workspace Manages a workspace (a set of packages consumed from the user workspace that\n belongs to the same project).\n Misc commands\n profile Lists profiles in the '.conan/profiles' folder, or shows profile details.\n remote Manages the remote list and the package recipes associated with a remote.\n user Authenticates against a remote with user/pass, caching the auth token.\n imports Calls your local conanfile.py or conanfile.txt 'imports' method.\n copy Copies conan recipes and packages to another user/channel.\n remove Removes packages or binaries matching pattern from local cache or remote.\n alias Creates and exports an 'alias package recipe'.\n download Downloads recipe and binaries to the local cache, without using settings.\n inspect Displays conanfile attributes, like name, version, and options. Works locally,\n in local cache and remote.\n help Shows help for a specific command.\n lock Generates and manipulates lock files.\n frogarian Conan The Frogarian\n \n Conan commands. Type \"conan <command> -h\" for help\n\nContributing 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 advise on how to write tests for Conan.\n\nRunning the tests\n=================\n\nUsing tox\n---------\n\n.. code-block:: bash\n\n $ python -m tox\n\nIt will install the needed requirements and launch `pytest` skipping some heavy and slow tests.\nIf you want to run the full test suite:\n\n.. code-block:: bash\n\n $ python -m tox -e full\n\nWithout tox\n-----------\n\n**Install python requirements**\n\n.. code-block:: bash\n\n $ python -m pip install -r conans/requirements.txt\n $ python -m pip install -r conans/requirements_server.txt\n $ python -m pip install -r conans/requirements_dev.txt\n\nIf you are not 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.. code-block:: bash\n\n $ export PYTHONPATH=$PYTHONPATH:$(pwd)\n\nOn Windows it would be (while being in the Conan root directory):\n\n.. code-block:: bash\n\n $ set PYTHONPATH=.\n\nEnsure that your ``cmake`` has version 2.8 or later. You can see the\nversion with the following command:\n\n.. code-block:: bash\n\n $ cmake --version\n\nThe appropriate values of ``CONAN_COMPILER`` and ``CONAN_COMPILER_VERSION`` depend on your\noperating system and your requirements.\n\nThese should work for the GCC from ``build-essential`` on Ubuntu 14.04:\n\n.. code-block:: bash\n\n $ export CONAN_COMPILER=gcc\n $ export CONAN_COMPILER_VERSION=4.8\n\nThese should work for OS X:\n\n.. code-block:: bash\n\n $ export CONAN_COMPILER=clang\n $ export CONAN_COMPILER_VERSION=3.5\n\nYou can run the actual tests like this:\n\n.. code-block:: bash\n\n $ python -m pytest .\n\n\nThere are a couple of test attributes defined, as ``slow`` that you can use\nto filter the tests, and do not execute them:\n\n.. code-block:: bash\n\n $ python -m pytest . -m \"not slow\"\n\nA few minutes later it should print ``OK``:\n\n.. code-block:: bash\n\n ............................................................................................\n ----------------------------------------------------------------------\n Ran 146 tests in 50.993s\n\n OK\n\nTo run specific tests, you can specify the test name too, something like:\n\n.. code-block:: bash\n\n $ python -m pytest conans/test/unittests/client/cmd/export_test.py::ExportTest::test_export_warning -s\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.. code-block:: bash\n\n $ python -m pytest . -m artifactory_ready\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.. code-block:: bash\n\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``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\nLicense\n-------\n\n`MIT LICENSE <./LICENSE.md>`__\n\n.. |Build Status Develop| image:: https://ci.conan.io/buildStatus/icon?job=ConanTestSuite/develop\n :target: https://ci.conan.io/job/ConanTestSuite/job/develop/\n\n.. |Develop climate| image:: https://api.codeclimate.com/v1/badges/081b53e570d5220b34e4/maintainability.svg\n :target: https://codeclimate.com/github/conan-io/conan/maintainability\n\n.. |Logo| image:: https://conan.io/img/jfrog_conan_logo.png\n\n\n.. _`pip docs`: https://pip.pypa.io/en/stable/installation/\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Conan C/C++ package manager",
"version": "1.65.0",
"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": "26ed8661e07214362a6934275b651fc266ca3245e2a8078fcd48d7a7c5f95e7c",
"md5": "7698588b98f34227acd827e3ce848f4f",
"sha256": "d3006b749b40b24b65a02735981ae88e5a1d847f9f739ef2c37ec868edf2714a"
},
"downloads": -1,
"filename": "conan_zbuild-1.65.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7698588b98f34227acd827e3ce848f4f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 923829,
"upload_time": "2024-09-10T06:13:53",
"upload_time_iso_8601": "2024-09-10T06:13:53.735771Z",
"url": "https://files.pythonhosted.org/packages/26/ed/8661e07214362a6934275b651fc266ca3245e2a8078fcd48d7a7c5f95e7c/conan_zbuild-1.65.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2301646a815b1d786de119e34e861104c88972f61c4f341b4baa58927383aa8d",
"md5": "d358c3bd2c51291a1ae29b352dc6af99",
"sha256": "e0505654be0e6709976dc01f06d51eec33d397d8a0909ff447ec9e3965e7118d"
},
"downloads": -1,
"filename": "conan_zbuild-1.65.0.tar.gz",
"has_sig": false,
"md5_digest": "d358c3bd2c51291a1ae29b352dc6af99",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 790041,
"upload_time": "2024-09-10T06:13:59",
"upload_time_iso_8601": "2024-09-10T06:13:59.161479Z",
"url": "https://files.pythonhosted.org/packages/23/01/646a815b1d786de119e34e861104c88972f61c4f341b4baa58927383aa8d/conan_zbuild-1.65.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-10 06:13:59",
"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-zbuild"
}
JSON
