Metadata-Version: 2.1
Name: bincrafters_conventions
Version: 1.2.1
Summary: Bincrafters script to apply Conan conventions and update CI jobs
Home-page: https://github.com/bincrafters/bincrafters-conventions
Author: Bincrafters
Author-email: bincrafters@gmail.com
License: MIT
Keywords: conan,C/C++,package,libraries,developer,manager,dependency,tool,c,c++,cpp,convention,updates
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Description-Content-Type: text/markdown
License-File: LICENSE.md
Requires-Dist: requests>=2.22.0
Requires-Dist: GitPython>=3.0.4
Requires-Dist: conan<2.0.0,>=1.53.0
Provides-Extra: test
Requires-Dist: pytest>=5.2.2; extra == "test"
Requires-Dist: pytest_cov>=2.8.1; extra == "test"
Requires-Dist: codecov>=2.1.10; extra == "test"

![Build status](https://github.com/bincrafters/bincrafters-conventions/workflows/conventions/badge.svg)
[![Codecov](https://codecov.io/gh/bincrafters/bincrafters-conventions/branch/main/graph/badge.svg)](https://codecov.io/gh/bincrafters/bincrafters-conventions)
[![Pypi Download](https://img.shields.io/badge/download-pypi-blue.svg)](https://pypi.python.org/pypi/bincrafters-conventions)

# Bincrafters Conventions

## A Script to update Conan projects following Conan conventions

This project contains scripts to update recipes, CI files, to
update Conan conventions in general and to perform some linting.

### INSTALL

You can install `bincrafters-conventions` via `pip` like this:

    $ pip install bincrafters_conventions

Minimum Python version: `3.8`

### RUN

> 💡 Bincrafters Conventions is a command line tool.
> 
> Execute `bincrafters-conventions --help` to see all options.
> 
> `bincrafters-conventions` has also the alias `bcon` for convince.


#### EXAMPLES

To update **ALL** Conan projects on GitHub for https://github.com/bincrafters

    $ bcon --remote=bincrafters

To update **ONLY** one project on GitHub https://github.com/bincrafters/conan-conversion

    $ bcon --remote=bincrafters/conan-double-conversion

To **AVOID** to execute push command after to update

    $ bcon --remote=bincrafters/conan-libusb --dry-run

To filter **PROJECTS** by pattern

    $ bcon --remote=bincrafters --project-pattern bincrafters/conan-*

To filter **BRANCHES** by pattern

    $ bcon --remote=bincrafters --branch-pattern stable/*

or

    $ bcon --remote=bincrafters/conan-libzip --branch-pattern stable/*

To update and check **LOCAL** everything

    $ bcon
    
To check **LOCAL** everything

    $ bcon --check

To apply Conan conventions in a local file:

    $ bcon --conanfile=conanfile.py

To update AppVeyor file:

    $ bcon --appveryorfile=appveyor.yml


### Testing and Development

If you want to install `bincrafters-conventions` via a local git clone

    pip install --user -U .

To install extra packages required to test

    pip install .[test]

To run all unit test + code coverage, execute:

    cd tests
    pytest -v --cov=bincrafters_conventions


### LICENSE

[MIT](LICENSE.md)
