Name | kiara-plugin.core-types JSON |
Version |
0.5.1
JSON |
| download |
home_page | None |
Summary | Core data types for kiara. |
upload_time | 2024-04-18 08:45:12 |
maintainer | None |
docs_url | None |
author | None |
requires_python | >=3.8 |
license | MPL-2.0 |
keywords |
kiara
|
VCS |
|
bugtrack_url |
|
requirements |
No requirements were recorded.
|
Travis-CI |
No Travis.
|
coveralls test coverage |
No coveralls.
|
[![PyPI status](https://img.shields.io/pypi/status/kiara_plugin.core_types.svg)](https://pypi.python.org/pypi/kiara_plugin.core_types/)
[![PyPI version](https://img.shields.io/pypi/v/kiara_plugin.core_types.svg)](https://pypi.python.org/pypi/kiara_plugin.core_types/)
[![PyPI pyversions](https://img.shields.io/pypi/pyversions/kiara_plugin.core_types.svg)](https://pypi.python.org/pypi/kiara_plugin.core_types/)
[![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.core_types/goto?ref=develop)
[![Coverage Status](https://coveralls.io/repos/github/DHARPA-Project/kiara_plugin.core_types/badge.svg?branch=develop)](https://coveralls.io/github/DHARPA-Project/kiara_plugin.core_types?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: (core-types)
Core data types for kiara.
- Documentation: [https://DHARPA-Project.github.io/kiara_plugin.core_types](https://DHARPA-Project.github.io/kiara_plugin.core_types)
- Code: [https://github.com/DHARPA-Project/kiara_plugin.core_types](https://github.com/DHARPA-Project/kiara_plugin.core_types)
- `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).
#### Using `pixi` (recommended)
The recommended way to setup a development environment is to use [pixi](https://github.com/prefix-dev/pixi). Check out [their install instructions](https://github.com/prefix-dev/pixi#installation).
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.
### Using pre-defined development-related tasks
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 files
- `pixi run tests`: runs the unit tests
- `pixi run mypy`: run mypy checks
## Copyright & license
This project is MPL v2.0 licensed, for the license text please check the [LICENSE](/LICENSE) file in this repository.
Raw data
{
"_id": null,
"home_page": null,
"name": "kiara-plugin.core-types",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "kiara",
"author": null,
"author_email": "Markus Binsteiner <markus@frkl.io>",
"download_url": "https://files.pythonhosted.org/packages/9b/f9/45167f2dd8efcbc06e406c5397f1d983eb4d05f5bc21a71f721da6764e07/kiara_plugin_core_types-0.5.1.tar.gz",
"platform": null,
"description": "[![PyPI status](https://img.shields.io/pypi/status/kiara_plugin.core_types.svg)](https://pypi.python.org/pypi/kiara_plugin.core_types/)\n[![PyPI version](https://img.shields.io/pypi/v/kiara_plugin.core_types.svg)](https://pypi.python.org/pypi/kiara_plugin.core_types/)\n[![PyPI pyversions](https://img.shields.io/pypi/pyversions/kiara_plugin.core_types.svg)](https://pypi.python.org/pypi/kiara_plugin.core_types/)\n[![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.core_types/goto?ref=develop)\n[![Coverage Status](https://coveralls.io/repos/github/DHARPA-Project/kiara_plugin.core_types/badge.svg?branch=develop)](https://coveralls.io/github/DHARPA-Project/kiara_plugin.core_types?branch=develop)\n[![Code style](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/ambv/black)\n\n# [**kiara**](https://dharpa.org/kiara.documentation) plugin: (core-types)\n\nCore data types for kiara.\n\n - Documentation: [https://DHARPA-Project.github.io/kiara_plugin.core_types](https://DHARPA-Project.github.io/kiara_plugin.core_types)\n - Code: [https://github.com/DHARPA-Project/kiara_plugin.core_types](https://github.com/DHARPA-Project/kiara_plugin.core_types)\n - `kiara`: [https://dharpa.org/kiara.documentation](https://dharpa.org/kiara.documentation)\n\n## Description\n\nTODO\n\n## Development\n\n### Requirements\n\n- Python (version >= 3.8)\n- pip, virtualenv\n- git\n- make (on Linux / Mac OS X -- optional)\n\n\n### Prepare development environment\n\nIf you only want to work on the modules, and not the core *Kiara* codebase, follow the instructions below. Otherwise, please\ncheck the notes on how to setup a *Kiara* development environment under (TODO).\n\n#### Using `pixi` (recommended)\n\nThe recommended way to setup a development environment is to use [pixi](https://github.com/prefix-dev/pixi). Check out [their install instructions](https://github.com/prefix-dev/pixi#installation).\n\nOnce you have `pixi` installed, you need to initialize the environment once:\n\n```\npixi run install-dev-env\n```\n\nYou also need to do this whenever a depdendency of this plugin is updated (for example the core `kiara` package).\n\nOnce that is done, you can enter the environment with:\n\n```\npixi shell\n```\n\nThis 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:\n\n```\nkiara --version\n# or\nkiara operation list\n# or\n...\n...\n```\n\nOnce you are finished with your development session, you can exit the sub-shell as you would normally do in such cases:\n\n```\nexit\n```\n\nAlternatively, 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:\n\n```\n.pixi/env/bin/kiara operation list\n```\n\nIn most cases it's recommended to use a pixi shell though.\n\n\n### Using pre-defined development-related tasks\n\nThe included `pixi.toml` file includes some useful tasks that help with development:\n\n- `pixi run pre-commit-check`: runs a set of checks against all files\n- `pixi run tests`: runs the unit tests\n- `pixi run mypy`: run mypy checks\n\n## Copyright & license\n\nThis project is MPL v2.0 licensed, for the license text please check the [LICENSE](/LICENSE) file in this repository.\n",
"bugtrack_url": null,
"license": "MPL-2.0",
"summary": "Core data types for kiara.",
"version": "0.5.1",
"project_urls": {
"documentation": "https://DHARPA-Project.github.io/kiara_plugin.core_types",
"homepage": "https://github.com/DHARPA-Project/kiara_plugin.core_types",
"repository": "https://github.com/DHARPA-Project/kiara_plugin.core_types"
},
"split_keywords": [
"kiara"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1deb002b4cb6f70de51ef0e8be6d03aebdd84e8159a91779bfce2886a9b0f796",
"md5": "23803a4383d6ad18946a2effe8ab1f11",
"sha256": "6a4067dde28007e149d732d912bcbe2638c4305772a3c352b137d3cb59b8c214"
},
"downloads": -1,
"filename": "kiara_plugin.core_types-0.5.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "23803a4383d6ad18946a2effe8ab1f11",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 26877,
"upload_time": "2024-04-18T08:45:10",
"upload_time_iso_8601": "2024-04-18T08:45:10.189819Z",
"url": "https://files.pythonhosted.org/packages/1d/eb/002b4cb6f70de51ef0e8be6d03aebdd84e8159a91779bfce2886a9b0f796/kiara_plugin.core_types-0.5.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9bf945167f2dd8efcbc06e406c5397f1d983eb4d05f5bc21a71f721da6764e07",
"md5": "b9027f2b1c5c8782650ced53e8044b4e",
"sha256": "71a0847164aeecbcd6945d2a0fac05d3877e4dafa58deccfe2c85d0f949edf61"
},
"downloads": -1,
"filename": "kiara_plugin_core_types-0.5.1.tar.gz",
"has_sig": false,
"md5_digest": "b9027f2b1c5c8782650ced53e8044b4e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 45122,
"upload_time": "2024-04-18T08:45:12",
"upload_time_iso_8601": "2024-04-18T08:45:12.056104Z",
"url": "https://files.pythonhosted.org/packages/9b/f9/45167f2dd8efcbc06e406c5397f1d983eb4d05f5bc21a71f721da6764e07/kiara_plugin_core_types-0.5.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-18 08:45:12",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "DHARPA-Project",
"github_project": "kiara_plugin.core_types",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "kiara-plugin.core-types"
}