# kishu
Intelligent checkpointing framework for Python-based machine learning and scientific computing.
Under development as part of a research project at the University of Illinois at Urbana-Champaign.
`kishu` contains core Kishu components: a Jupyter instrument and a library of Kishu commands. Main user interface is Kishu's command line interface (CLI): `kishu`.
# Installation
Install from PyPI.
```
pip install kishu
```
## Development
Installing Kishu in the editable mode.
```bash
make install
```
Formatting source code.
```bash
make fmt
```
Linting source code (e.g., definitions, type checking).
```bash
make lint
```
Running all unit tests. It generates a coverage report at `./htmlcov/index.html`.
```bash
make test
```
Running PyTest with benchmarks.
```bash
pytest --run-benchmark
```
# Deployment
The following command will upload this project to pypi (https://pypi.org/project/kishu/).
```
bash upload2pypi.sh
```
Raw data
{
"_id": null,
"home_page": null,
"name": "kishu",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "kishu, elastic, dart, python, jupyter, notebook, server, lab, cli, web, gui, extension",
"author": null,
"author_email": "Yongjoo Park <yongjoo@g.illinois.edu>, Supawit Chockchowwat <supawit2@illinois.edu>, Zhaoheng Li <zl20@illinois.edu>",
"download_url": "https://files.pythonhosted.org/packages/41/e4/2d38dca8e2dcfcdbc9676840177e2fe0bf0aff777f6a1fb0373b49398dcf/kishu-0.3.0.tar.gz",
"platform": null,
"description": "# kishu\n\nIntelligent checkpointing framework for Python-based machine learning and scientific computing.\nUnder development as part of a research project at the University of Illinois at Urbana-Champaign.\n\n`kishu` contains core Kishu components: a Jupyter instrument and a library of Kishu commands. Main user interface is Kishu's command line interface (CLI): `kishu`.\n\n\n# Installation\n\nInstall from PyPI.\n```\npip install kishu\n```\n\n## Development\n\nInstalling Kishu in the editable mode.\n\n```bash\nmake install\n```\n\nFormatting source code.\n\n```bash\nmake fmt\n```\n\nLinting source code (e.g., definitions, type checking).\n\n```bash\nmake lint\n```\n\nRunning all unit tests. It generates a coverage report at `./htmlcov/index.html`.\n```bash\nmake test\n```\n\nRunning PyTest with benchmarks.\n```bash\npytest --run-benchmark\n```\n\n# Deployment\n\nThe following command will upload this project to pypi (https://pypi.org/project/kishu/).\n\n```\nbash upload2pypi.sh\n```\n",
"bugtrack_url": null,
"license": "License not determined",
"summary": "Intelligent Python Checkpointing",
"version": "0.3.0",
"project_urls": {
"repository": "https://github.com/illinoisdata/kishu"
},
"split_keywords": [
"kishu",
" elastic",
" dart",
" python",
" jupyter",
" notebook",
" server",
" lab",
" cli",
" web",
" gui",
" extension"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "35f1b3b2c3736a86fa60bd476f47b7ed39103ead42cc397ba327b0a3341680d4",
"md5": "0a7d231d3f8c38bf4c2b39f772339bfc",
"sha256": "cfa42261eed22e6ad8a397afe3e7cd88ce799ff3320dd07e31ac70266a903a55"
},
"downloads": -1,
"filename": "kishu-0.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0a7d231d3f8c38bf4c2b39f772339bfc",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 69264,
"upload_time": "2024-12-19T22:48:39",
"upload_time_iso_8601": "2024-12-19T22:48:39.635826Z",
"url": "https://files.pythonhosted.org/packages/35/f1/b3b2c3736a86fa60bd476f47b7ed39103ead42cc397ba327b0a3341680d4/kishu-0.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "41e42d38dca8e2dcfcdbc9676840177e2fe0bf0aff777f6a1fb0373b49398dcf",
"md5": "e5623edc590d56f9b92a194c06442f62",
"sha256": "8e15dde61993e9d637b7fc86d481701deb3b9a3d133bde839b9f4156db873a25"
},
"downloads": -1,
"filename": "kishu-0.3.0.tar.gz",
"has_sig": false,
"md5_digest": "e5623edc590d56f9b92a194c06442f62",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 2491898,
"upload_time": "2024-12-19T22:48:46",
"upload_time_iso_8601": "2024-12-19T22:48:46.304973Z",
"url": "https://files.pythonhosted.org/packages/41/e4/2d38dca8e2dcfcdbc9676840177e2fe0bf0aff777f6a1fb0373b49398dcf/kishu-0.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-19 22:48:46",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "illinoisdata",
"github_project": "kishu",
"github_not_found": true,
"lcname": "kishu"
}