Metadata-Version: 2.1
Name: kiara-plugin.develop
Version: 0.1.dev28+g2bf80e3
Summary: A set of modules (and pipelines) for Kiara.
Home-page: https://github.com/DHARPA-Project/kiara_plugin.develop
Author: Markus Binsteiner
Author-email: markus@frkl.io
License: MPL-2.0
Platform: any
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: diskcache (>=5.4.0)
Requires-Dist: httpx (>=0.23.0)
Requires-Dist: kiara (>=0.4.21)
Requires-Dist: kiara-plugin.core-types (>=0.4.11)
Requires-Dist: pydantic-to-typescript (>=1.0.9)
Provides-Extra: all
Provides-Extra: all_dev
Requires-Dist: flake8 (>=3.8.4) ; extra == 'all_dev'
Requires-Dist: types-pkg-resources ; extra == 'all_dev'
Requires-Dist: wheel ; extra == 'all_dev'
Requires-Dist: mkdocstrings-python-legacy ; extra == 'all_dev'
Requires-Dist: coveralls (>=3.2.0) ; extra == 'all_dev'
Requires-Dist: types-python-dateutil ; extra == 'all_dev'
Requires-Dist: watchgod (>=0.6) ; extra == 'all_dev'
Requires-Dist: mkdocs-awesome-pages-plugin (>=2.5.0) ; extra == 'all_dev'
Requires-Dist: pytest-cov (>=2.11.1) ; extra == 'all_dev'
Requires-Dist: mkdocs-literate-nav (>=0.4.0) ; extra == 'all_dev'
Requires-Dist: icecream (>=2.1.0) ; extra == 'all_dev'
Requires-Dist: mkdocs-macros-plugin (<0.6.0,>=0.5.0) ; extra == 'all_dev'
Requires-Dist: pip-licenses (>=3.3.0) ; extra == 'all_dev'
Requires-Dist: pre-commit (>=2.9.3) ; extra == 'all_dev'
Requires-Dist: cruft (>=2.6.0) ; extra == 'all_dev'
Requires-Dist: ipython ; extra == 'all_dev'
Requires-Dist: pytest (>=6.2.2) ; extra == 'all_dev'
Requires-Dist: mkdocs-section-index (>0.3.0) ; extra == 'all_dev'
Requires-Dist: black ; extra == 'all_dev'
Requires-Dist: mike (>=1.0.1) ; extra == 'all_dev'
Requires-Dist: setup-cfg-fmt (>=1.16.0) ; extra == 'all_dev'
Requires-Dist: mypy (>=0.800) ; extra == 'all_dev'
Requires-Dist: pp-ez (>=0.2.0) ; extra == 'all_dev'
Requires-Dist: mkdocs-material (>=8.0.0) ; extra == 'all_dev'
Requires-Dist: tox (>=3.21.2) ; extra == 'all_dev'
Requires-Dist: mkdocs-gen-files (>=0.3.1) ; (python_version >= "3.7") and extra == 'all_dev'
Provides-Extra: dev_all
Requires-Dist: flake8 (>=3.8.4) ; extra == 'dev_all'
Requires-Dist: types-pkg-resources ; extra == 'dev_all'
Requires-Dist: wheel ; extra == 'dev_all'
Requires-Dist: mkdocstrings-python-legacy ; extra == 'dev_all'
Requires-Dist: coveralls (>=3.2.0) ; extra == 'dev_all'
Requires-Dist: types-python-dateutil ; extra == 'dev_all'
Requires-Dist: watchgod (>=0.6) ; extra == 'dev_all'
Requires-Dist: mkdocs-awesome-pages-plugin (>=2.5.0) ; extra == 'dev_all'
Requires-Dist: pytest-cov (>=2.11.1) ; extra == 'dev_all'
Requires-Dist: mkdocs-literate-nav (>=0.4.0) ; extra == 'dev_all'
Requires-Dist: icecream (>=2.1.0) ; extra == 'dev_all'
Requires-Dist: mkdocs-macros-plugin (<0.6.0,>=0.5.0) ; extra == 'dev_all'
Requires-Dist: pip-licenses (>=3.3.0) ; extra == 'dev_all'
Requires-Dist: pre-commit (>=2.9.3) ; extra == 'dev_all'
Requires-Dist: cruft (>=2.6.0) ; extra == 'dev_all'
Requires-Dist: ipython ; extra == 'dev_all'
Requires-Dist: pytest (>=6.2.2) ; extra == 'dev_all'
Requires-Dist: mkdocs-section-index (>0.3.0) ; extra == 'dev_all'
Requires-Dist: black ; extra == 'dev_all'
Requires-Dist: mike (>=1.0.1) ; extra == 'dev_all'
Requires-Dist: setup-cfg-fmt (>=1.16.0) ; extra == 'dev_all'
Requires-Dist: mypy (>=0.800) ; extra == 'dev_all'
Requires-Dist: pp-ez (>=0.2.0) ; extra == 'dev_all'
Requires-Dist: mkdocs-material (>=8.0.0) ; extra == 'dev_all'
Requires-Dist: tox (>=3.21.2) ; extra == 'dev_all'
Requires-Dist: mkdocs-gen-files (>=0.3.1) ; (python_version >= "3.7") and extra == 'dev_all'
Provides-Extra: dev_documentation
Requires-Dist: icecream (>=2.1.0) ; extra == 'dev_documentation'
Requires-Dist: mike (>=1.0.1) ; extra == 'dev_documentation'
Requires-Dist: mkdocs-awesome-pages-plugin (>=2.5.0) ; extra == 'dev_documentation'
Requires-Dist: mkdocs-literate-nav (>=0.4.0) ; extra == 'dev_documentation'
Requires-Dist: mkdocs-macros-plugin (<0.6.0,>=0.5.0) ; extra == 'dev_documentation'
Requires-Dist: mkdocs-material (>=8.0.0) ; extra == 'dev_documentation'
Requires-Dist: mkdocs-section-index (>0.3.0) ; extra == 'dev_documentation'
Requires-Dist: mkdocstrings-python-legacy ; extra == 'dev_documentation'
Requires-Dist: mkdocs-gen-files (>=0.3.1) ; (python_version >= "3.7") and extra == 'dev_documentation'
Provides-Extra: dev_testing
Requires-Dist: coveralls (>=3.2.0) ; extra == 'dev_testing'
Requires-Dist: flake8 (>=3.8.4) ; extra == 'dev_testing'
Requires-Dist: mypy (>=0.800) ; extra == 'dev_testing'
Requires-Dist: pytest (>=6.2.2) ; extra == 'dev_testing'
Requires-Dist: pytest-cov (>=2.11.1) ; extra == 'dev_testing'
Requires-Dist: tox (>=3.21.2) ; extra == 'dev_testing'
Requires-Dist: types-pkg-resources ; extra == 'dev_testing'
Requires-Dist: types-python-dateutil ; extra == 'dev_testing'
Provides-Extra: dev_utils
Requires-Dist: black ; extra == 'dev_utils'
Requires-Dist: cruft (>=2.6.0) ; extra == 'dev_utils'
Requires-Dist: flake8 (>=3.8.4) ; extra == 'dev_utils'
Requires-Dist: ipython ; extra == 'dev_utils'
Requires-Dist: pip-licenses (>=3.3.0) ; extra == 'dev_utils'
Requires-Dist: pp-ez (>=0.2.0) ; extra == 'dev_utils'
Requires-Dist: pre-commit (>=2.9.3) ; extra == 'dev_utils'
Requires-Dist: setup-cfg-fmt (>=1.16.0) ; extra == 'dev_utils'
Requires-Dist: watchgod (>=0.6) ; extra == 'dev_utils'
Requires-Dist: wheel ; extra == 'dev_utils'

[![PyPI status](https://img.shields.io/pypi/status/kiara_plugin.develop.svg)](https://pypi.python.org/pypi/kiara_plugin.develop/)
[![PyPI version](https://img.shields.io/pypi/v/kiara_plugin.develop.svg)](https://pypi.python.org/pypi/kiara_plugin.develop/)
[![PyPI pyversions](https://img.shields.io/pypi/pyversions/kiara_plugin.develop.svg)](https://pypi.python.org/pypi/kiara_plugin.develop/)
[![Build Status](https://img.shields.io/endpoint.svg?url=https%3A%2F%2Factions-badge.atrox.dev%2FDHARPA-Project%2Fkiara%2Fbadge%3Fref%3Ddevelop&style=flat)](https://actions-badge.atrox.dev/DHARPA-Project/kiara_plugin.develop/goto?ref=develop)
[![Coverage Status](https://coveralls.io/repos/github/DHARPA-Project/kiara_plugin.develop/badge.svg?branch=develop)](https://coveralls.io/github/DHARPA-Project/kiara_plugin.develop?branch=develop)
[![Code style](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/ambv/black)

# [**kiara**](https://dharpa.org/kiara.documentation) plugin: (develop)

Development utilities for kiara.

 - Documentation: [https://DHARPA-Project.github.io/kiara_plugin.develop](https://DHARPA-Project.github.io/kiara_plugin.develop)
 - Code: [https://github.com/DHARPA-Project/kiara_plugin.develop](https://github.com/DHARPA-Project/kiara_plugin.develop)
 - `kiara`: [https://dharpa.org/kiara.documentation](https://dharpa.org/kiara.documentation)

## Description

TODO

## Development

### Requirements

- Python (version >= 3.8)
- pip, virtualenv
- git
- make (on Linux / Mac OS X -- optional)


### Prepare development environment

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).

#### Linux & Mac OS X (using make)

For *NIX-like operating system, setting up a development environment is relatively easy:

```console
git clone https://github.com/DHARPA-Project/kiara_plugin.develop.git
cd kiara_plugin.develop
python3 -m venv .venv
source .venv/bin/activate
make init
```

#### Windows (or manual pip install)

It's impossible to lay out all the ways Python can be installed on a machine, and virtual- (or conda-)envs can be created, so I'll assume you know how to do this.
One simple way is to install the [Anaconda (individual edition)](https://docs.anaconda.com/anaconda/install/index.html), then use the Anaconda navigator to create a new environment, install the 'git' package in it (if your system does not already have it), and use the 'Open Terminal' option of that environment to start up a terminal that has that virtual-/conda-environment activated.

Once that is done, `cd` into a directory where you want this project folder to live, and do:

```console
# make sure your virtual env is activated!!!
git clone https://github.com/DHARPA-Project/kiara_plugin.develop.git
cd kiara_plugin.develop
pip install --extra-index-url https://pypi.fury.io/dharpa/ -U -e .[all_dev]
```

#### Try it out

After this is done, you should be able to run the included example module via:

```console
kiara run develop_example text_1="xxx" text_2="yyy"
...
...
```

### Re-activate the development environment

The 'prepare' step from above only has to be done once. After that, to re-enable your virtual environment,
you'll need to navigate to the directory again (wherever that is, in your case), and run the ``source`` command from before again:

```console
cd path/to/kiara_plugin.develop
source .venv/bin/activate  # if it isn't activated already, for example by the Anaconda navigator
kiara --help  # or whatever, point is, kiara should be available for you now,
```

### ``make`` targets (Linux & Mac OS X)

- ``init``: init development project (install project & dev dependencies into virtualenv, as well as pre-commit git hook)
- ``update-dependencies``: update development dependencies (mainly the core ``kiara`` package from git)
- ``flake``: run *flake8* tests
- ``mypy``: run mypy tests
- ``test``: run unit tests
- ``docs``: create static documentation pages (under ``build/site``)
- ``serve-docs``: serve documentation pages (incl. auto-reload) for getting direct feedback when working on documentation
- ``clean``: clean build directories

For details (and other, minor targets), check the ``Makefile``.


### Running tests

``` console
> make test
# or
> make coverage
```


## Copyright & license

This project is MPL v2.0 licensed, for the license text please check the [LICENSE](/LICENSE) file in this repository.