| Name | kiara-plugin.streamlit JSON |
| Version |
0.5.1
JSON |
| download |
| home_page | |
| Summary | Streamlit UI and widgets for kiara |
| upload_time | 2023-11-16 14:33:04 |
| maintainer | |
| docs_url | None |
| author | |
| requires_python | >=3.8 |
| license | MPL-2.0 |
| keywords |
kiara
streamlit
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
[](https://pypi.python.org/pypi/kiara_plugin.streamlit/)
[](https://pypi.python.org/pypi/kiara_plugin.streamlit/)
[](https://pypi.python.org/pypi/kiara_plugin.streamlit/)
[](https://actions-badge.atrox.dev/DHARPA-Project/kiara_plugin.streamlit/goto?ref=develop)
[](https://coveralls.io/github/DHARPA-Project/kiara_plugin.streamlit?branch=develop)
[](https://github.com/ambv/black)
# [**kiara**](https://dharpa.org/kiara.documentation) plugin: (streamlit)
Streamlit UI and widgets for kiara
- Documentation: [https://DHARPA-Project.github.io/kiara_plugin.streamlit](https://DHARPA-Project.github.io/kiara_plugin.streamlit)
- Code: [https://github.com/DHARPA-Project/kiara_plugin.streamlit](https://github.com/DHARPA-Project/kiara_plugin.streamlit)
- `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.streamlit.git
cd kiara_plugin.streamlit
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.streamlit.git
cd kiara_plugin.streamlit
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 streamlit_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.streamlit
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 AGPL v3 licensed, for the license text please check the [LICENSE](/LICENSE) file in this repository.
Copyright (c) 2023, Markus Binsteiner
Raw data
{
"_id": null,
"home_page": "",
"name": "kiara-plugin.streamlit",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "kiara,streamlit",
"author": "",
"author_email": "Markus Binsteiner <markus@frkl.io>",
"download_url": "https://files.pythonhosted.org/packages/47/bc/f8ce95b0d50a6635d180f2ec378f1c74a94b98b2ccc698e1ce7d719be2ce/kiara_plugin.streamlit-0.5.1.tar.gz",
"platform": null,
"description": "[](https://pypi.python.org/pypi/kiara_plugin.streamlit/)\n[](https://pypi.python.org/pypi/kiara_plugin.streamlit/)\n[](https://pypi.python.org/pypi/kiara_plugin.streamlit/)\n[](https://actions-badge.atrox.dev/DHARPA-Project/kiara_plugin.streamlit/goto?ref=develop)\n[](https://coveralls.io/github/DHARPA-Project/kiara_plugin.streamlit?branch=develop)\n[](https://github.com/ambv/black)\n\n# [**kiara**](https://dharpa.org/kiara.documentation) plugin: (streamlit)\n\nStreamlit UI and widgets for kiara\n\n - Documentation: [https://DHARPA-Project.github.io/kiara_plugin.streamlit](https://DHARPA-Project.github.io/kiara_plugin.streamlit)\n - Code: [https://github.com/DHARPA-Project/kiara_plugin.streamlit](https://github.com/DHARPA-Project/kiara_plugin.streamlit)\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#### Linux & Mac OS X (using make)\n\nFor *NIX-like operating system, setting up a development environment is relatively easy:\n\n```console\ngit clone https://github.com/DHARPA-Project/kiara_plugin.streamlit.git\ncd kiara_plugin.streamlit\npython3 -m venv .venv\nsource .venv/bin/activate\nmake init\n```\n\n#### Windows (or manual pip install)\n\nIt'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.\nOne 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.\n\nOnce that is done, `cd` into a directory where you want this project folder to live, and do:\n\n```console\n# make sure your virtual env is activated!!!\ngit clone https://github.com/DHARPA-Project/kiara_plugin.streamlit.git\ncd kiara_plugin.streamlit\npip install --extra-index-url https://pypi.fury.io/dharpa/ -U -e .[all_dev]\n```\n\n#### Try it out\n\nAfter this is done, you should be able to run the included example module via:\n\n```console\nkiara run streamlit_example text_1=\"xxx\" text_2=\"yyy\"\n...\n...\n```\n\n### Re-activate the development environment\n\nThe 'prepare' step from above only has to be done once. After that, to re-enable your virtual environment,\nyou'll need to navigate to the directory again (wherever that is, in your case), and run the ``source`` command from before again:\n\n```console\ncd path/to/kiara_plugin.streamlit\nsource .venv/bin/activate # if it isn't activated already, for example by the Anaconda navigator\nkiara --help # or whatever, point is, kiara should be available for you now,\n```\n\n### ``make`` targets (Linux & Mac OS X)\n\n- ``init``: init development project (install project & dev dependencies into virtualenv, as well as pre-commit git hook)\n- ``update-dependencies``: update development dependencies (mainly the core ``kiara`` package from git)\n- ``flake``: run *flake8* tests\n- ``mypy``: run mypy tests\n- ``test``: run unit tests\n- ``docs``: create static documentation pages (under ``build/site``)\n- ``serve-docs``: serve documentation pages (incl. auto-reload) for getting direct feedback when working on documentation\n- ``clean``: clean build directories\n\nFor details (and other, minor targets), check the ``Makefile``.\n\n\n### Running tests\n\n``` console\n> make test\n# or\n> make coverage\n```\n\n\n## Copyright & license\n\nThis project is AGPL v3 licensed, for the license text please check the [LICENSE](/LICENSE) file in this repository.\nCopyright (c) 2023, Markus Binsteiner\n",
"bugtrack_url": null,
"license": "MPL-2.0",
"summary": "Streamlit UI and widgets for kiara",
"version": "0.5.1",
"project_urls": {
"documentation": "https://DHARPA-Project.github.io/kiara_plugin.streamlit",
"homepage": "https://github.com/DHARPA-Project/kiara_plugin.streamlit",
"repository": "https://github.com/DHARPA-Project/kiara_plugin.streamlit"
},
"split_keywords": [
"kiara",
"streamlit"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8fcc86dba54f34826c7c555c164170ec5209cfe1abe9e6be1292df2401886607",
"md5": "ea4c9a8bc6d53b5648de261ef9837612",
"sha256": "3181b8f0179d284677db50da79e770b27eb36c97bc58b4c9c06dcb413e70449b"
},
"downloads": -1,
"filename": "kiara_plugin.streamlit-0.5.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ea4c9a8bc6d53b5648de261ef9837612",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 79767,
"upload_time": "2023-11-16T14:33:03",
"upload_time_iso_8601": "2023-11-16T14:33:03.436681Z",
"url": "https://files.pythonhosted.org/packages/8f/cc/86dba54f34826c7c555c164170ec5209cfe1abe9e6be1292df2401886607/kiara_plugin.streamlit-0.5.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "47bcf8ce95b0d50a6635d180f2ec378f1c74a94b98b2ccc698e1ce7d719be2ce",
"md5": "a127f5fa61affd40732a336c4f1f3e0d",
"sha256": "f4fc2e23c1503d94dfadeddb2b976abdaf4b7b90e04b79d2503c04100983dcd3"
},
"downloads": -1,
"filename": "kiara_plugin.streamlit-0.5.1.tar.gz",
"has_sig": false,
"md5_digest": "a127f5fa61affd40732a336c4f1f3e0d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 92115,
"upload_time": "2023-11-16T14:33:04",
"upload_time_iso_8601": "2023-11-16T14:33:04.798505Z",
"url": "https://files.pythonhosted.org/packages/47/bc/f8ce95b0d50a6635d180f2ec378f1c74a94b98b2ccc698e1ce7d719be2ce/kiara_plugin.streamlit-0.5.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-11-16 14:33:04",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "DHARPA-Project",
"github_project": "kiara_plugin.streamlit",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "kiara-plugin.streamlit"
}
