cruiz

Conan recipe user interface

Written by Mark Final.

Documentation

See the documentation at Read The Docs.

Prerequisites

• Intel x86_64 platforms:
  • Windows 10+
  • Linux (CentOS 7.5+/Ubuntu 18+)
  • macOS (11.0+)
• Apple Silicon platforms:
  • macOS (11.0+)
• Python 3.8-3.12
• Conan 1.x (from 1.17.1 onwards) and 2.x (from 2.0.14 onwards)

All other Python dependencies are installed when the package is installed.

In order to use the dependency graph visualisation, an additional installation of GraphViz is required from https://graphviz.org/download/. Assign the installed location to the preferences.

Conan versions

Cruiz does not depend directly on the Conan package in its UI. Instead, it uses child processes to run Conan APIs, which are dependent on the Conan version installed.

Cruiz does not support multiple Conan versions simultaneously in the same process. Instead, the UI dynamically changes by detecting the Conan version installed at startup. You will therefore see a slightly different UI depending on which Conan you have. Note the Conan version detected is shown on the status bar in the bottom right corner of the UI.

Getting started

If you have cloned this repository, you will need:

1. A Python 3 environment. Make a virtual env if necessary. python3 -m venv <folder to be the env>

   • Activate the virtual env with either:
     • source <folder to be the env>/bin/activate (Linux/macOSX)
     • <folder to be the env>\Scripts\activate.bat (Windows cmd)
     • source <folder to be the env>\Scripts\activate (Windows bash)

2. Ensure latest pip and wheel are being used. python -m pip install -U pip wheel

3. Install cruiz and its dependencies

   • From your local clone:
     • pip install -r requirements.txt
     • pip install --no-build-isolation -e .

4. Run from any directory

   • From your Python environment shell, cruiz or python -m cruiz

Step 3 will need to be re-run when the Python dependencies, or the resource files used, change.

Linting

Install linting dependencies with pip install -r requirements_dev.txt.

cruiz uses tox to automate linting. Use tox -e lint.

flake8 is used for lint checks, specifically using black as the formatter.

mypy is used for static type checking and validating type annotations.

Python 3.10+ is highly recommended to run the linting steps.

VisualStudio Code

If using VSCode, a settings file for this Git repository is provided. To enable linting and formatting in the IDE though, you need to install the following extensions:

• https://marketplace.visualstudio.com/items?itemName=ms-python.black-formatter
• https://marketplace.visualstudio.com/items?itemName=ms-python.flake8
• https://marketplace.visualstudio.com/items?itemName=ms-python.mypy-type-checker

Making Python packages

python setup.py sdist for a source distribution. Note that pip installing from a source distribution, or from an archive of the source tree, is not currently supported.

pip wheel --no-deps . for a wheel.

Acknowledgements

Many thanks to Foundry and its developers for support, inspiration, and testing in making cruiz.