# CodeFlare SDK
[![Python application](https://github.com/project-codeflare/codeflare-sdk/actions/workflows/unit-tests.yml/badge.svg?branch=main)](https://github.com/project-codeflare/codeflare-sdk/actions/workflows/unit-tests.yml)
![coverage badge](./coverage.svg)
An intuitive, easy-to-use python interface for batch resource requesting, access, job submission, and observation. Simplifying the developer's life while enabling access to high-performance compute resources, either in the cloud or on-prem.
For guided demos and basics walkthroughs, check out the following links:
- Guided demo notebooks available [here](https://github.com/project-codeflare/codeflare-sdk/tree/main/demo-notebooks/guided-demos), and copies of the notebooks with [expected output](https://github.com/project-codeflare/codeflare-sdk/tree/main/demo-notebooks/guided-demos/notebook-ex-outputs) also available
- these demos can be copied into your current working directory when using the `codeflare-sdk` by using the `codeflare_sdk.copy_demo_nbs()` function
- Additionally, we have a [video walkthrough](https://www.youtube.com/watch?v=U76iIfd9EmE) of these basic demos from June, 2023
Full documentation can be found [here](https://project-codeflare.github.io/codeflare-sdk/index.html)
## Installation
Can be installed via `pip`: `pip install codeflare-sdk`
## Development
Please see our [CONTRIBUTING.md](./CONTRIBUTING.md) for detailed instructions.
## Release Instructions
### Automated Releases
It is possible to use the Release Github workflow to do the release. This is generally the process we follow for releases
### Manual Releases
The following instructions apply when doing release manually. This may be required in instances where the automation is failing.
- Check and update the version in "pyproject.toml" file.
- Commit all the changes to the repository.
- Create Github release (<https://docs.github.com/en/repositories/releasing-projects-on-github/managing-releases-in-a-repository#creating-a-release>).
- Build the Python package. `poetry build`
- If not present already, add the API token to Poetry.
`poetry config pypi-token.pypi API_TOKEN`
- Publish the Python package. `poetry publish`
- Trigger the [Publish Documentation](https://github.com/project-codeflare/codeflare-sdk/actions/workflows/publish-documentation.yaml) workflow
Raw data
{
"_id": null,
"home_page": "https://github.com/project-codeflare/codeflare-sdk",
"name": "codeflare-sdk",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.9",
"maintainer_email": null,
"keywords": "codeflare, python, sdk, client, batch, scale",
"author": "Michael Clifford",
"author_email": "mcliffor@redhat.com",
"download_url": "https://files.pythonhosted.org/packages/c3/74/8fa34ca4a504dfc95978803eebefd976a5704a5c85f66b47882bb04b4c67/codeflare_sdk-0.26.0.tar.gz",
"platform": null,
"description": "# CodeFlare SDK\n\n[![Python application](https://github.com/project-codeflare/codeflare-sdk/actions/workflows/unit-tests.yml/badge.svg?branch=main)](https://github.com/project-codeflare/codeflare-sdk/actions/workflows/unit-tests.yml)\n![coverage badge](./coverage.svg)\n\nAn intuitive, easy-to-use python interface for batch resource requesting, access, job submission, and observation. Simplifying the developer's life while enabling access to high-performance compute resources, either in the cloud or on-prem.\n\nFor guided demos and basics walkthroughs, check out the following links:\n\n- Guided demo notebooks available [here](https://github.com/project-codeflare/codeflare-sdk/tree/main/demo-notebooks/guided-demos), and copies of the notebooks with [expected output](https://github.com/project-codeflare/codeflare-sdk/tree/main/demo-notebooks/guided-demos/notebook-ex-outputs) also available\n- these demos can be copied into your current working directory when using the `codeflare-sdk` by using the `codeflare_sdk.copy_demo_nbs()` function\n- Additionally, we have a [video walkthrough](https://www.youtube.com/watch?v=U76iIfd9EmE) of these basic demos from June, 2023\n\nFull documentation can be found [here](https://project-codeflare.github.io/codeflare-sdk/index.html)\n\n## Installation\n\nCan be installed via `pip`: `pip install codeflare-sdk`\n\n## Development\n\nPlease see our [CONTRIBUTING.md](./CONTRIBUTING.md) for detailed instructions.\n\n## Release Instructions\n\n### Automated Releases\n\nIt is possible to use the Release Github workflow to do the release. This is generally the process we follow for releases\n\n### Manual Releases\n\nThe following instructions apply when doing release manually. This may be required in instances where the automation is failing.\n\n- Check and update the version in \"pyproject.toml\" file.\n- Commit all the changes to the repository.\n- Create Github release (<https://docs.github.com/en/repositories/releasing-projects-on-github/managing-releases-in-a-repository#creating-a-release>).\n- Build the Python package. `poetry build`\n- If not present already, add the API token to Poetry.\n`poetry config pypi-token.pypi API_TOKEN`\n- Publish the Python package. `poetry publish`\n- Trigger the [Publish Documentation](https://github.com/project-codeflare/codeflare-sdk/actions/workflows/publish-documentation.yaml) workflow\n\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Python SDK for codeflare client",
"version": "0.26.0",
"project_urls": {
"Homepage": "https://github.com/project-codeflare/codeflare-sdk",
"Repository": "https://github.com/project-codeflare/codeflare-sdk"
},
"split_keywords": [
"codeflare",
" python",
" sdk",
" client",
" batch",
" scale"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "560b35ea3b52015f6a8cf117f1d67784672e535974c09af598bfe07d0d31d3c8",
"md5": "afeede3d7e3c4b4b4e3ca6fcb627c27c",
"sha256": "9762b637f6bdb0f551c5f440a26c64ea20886f587111f3d9f8381a92aca5934e"
},
"downloads": -1,
"filename": "codeflare_sdk-0.26.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "afeede3d7e3c4b4b4e3ca6fcb627c27c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.9",
"size": 130166,
"upload_time": "2025-01-21T12:07:55",
"upload_time_iso_8601": "2025-01-21T12:07:55.719575Z",
"url": "https://files.pythonhosted.org/packages/56/0b/35ea3b52015f6a8cf117f1d67784672e535974c09af598bfe07d0d31d3c8/codeflare_sdk-0.26.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c3748fa34ca4a504dfc95978803eebefd976a5704a5c85f66b47882bb04b4c67",
"md5": "edb860378eccd842ac6bfe2f0618a56b",
"sha256": "51f8974e313f7d5a62c2a1811cef84852a7deb955d7f894f712d3089e7307983"
},
"downloads": -1,
"filename": "codeflare_sdk-0.26.0.tar.gz",
"has_sig": false,
"md5_digest": "edb860378eccd842ac6bfe2f0618a56b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.9",
"size": 81650,
"upload_time": "2025-01-21T12:07:57",
"upload_time_iso_8601": "2025-01-21T12:07:57.219759Z",
"url": "https://files.pythonhosted.org/packages/c3/74/8fa34ca4a504dfc95978803eebefd976a5704a5c85f66b47882bb04b4c67/codeflare_sdk-0.26.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-21 12:07:57",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "project-codeflare",
"github_project": "codeflare-sdk",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "codeflare-sdk"
}