kiara plugin: (develop)
Development utilities for kiara.
- Documentation: https://DHARPA-Project.github.io/kiara_plugin.develop
- Code: https://github.com/DHARPA-Project/kiara_plugin.develop
kiara
: https://dharpa.org/kiara.documentation
TODO
- Python (version >= 3.8)
- pip, virtualenv
- git
- make (on Linux / Mac OS X -- optional)
If you only want to work on the modules, and not the core Kiara codebase, follow the instructions below. Otherwise, please check the notes on how to setup a Kiara development environment under (TODO).
The recommended way to setup a development environment is to use pixi. Check out their install instructions.
Once you have pixi
installed, you need to initialize the environment once:
pixi run install-dev-env
You also need to do this whenever a depdendency of this plugin is updated (for example the core kiara
package).
Once that is done, you can enter the environment with:
pixi shell
This will start a sub-shell with the virtual environment activated, and all dependencies of the plugin package installed. To confirm it works, you can run any kiara
command:
kiara --version
# or
kiara operation list
# or
...
...
Once you are finished with your development session, you can exit the sub-shell as you would normally do in such cases:
exit
Alternatively, you can also run the kiara
executable directly, it is located in .pixi/env/bin/kiara
. So either adapt your PATH
variable, or do something like:
.pixi/env/bin/kiara operation list
In most cases it's recommended to use a pixi shell though.
The included pixi.toml
file includes some useful tasks that help with development:
pixi run pre-commit-check
: runs a set of checks against all filespixi run tests
: runs the unit testspixi run mypy
: run mypy checks
This project is MPL v2.0 licensed, for the license text please check the LICENSE file in this repository.