| Name | fabrictestbed-extensions JSON |
| Version |
1.6.4
JSON |
| download |
| home_page | |
| Summary | FABRIC Python Client Library and CLI Extensions |
| upload_time | 2024-03-05 18:11:18 |
| maintainer | |
| docs_url | None |
| author | |
| requires_python | >=3.9 |
| license | |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# fabrictestbed-extensions
[![pypi-badge]][pypy] [![api-docs-badge]][api-docs]
This is the implementation of a Python library, otherwise known as
"FABlib", for intereacting with [FABRIC][fabric] testbed.
Your first encounter with FABlib might be through FABRIC project's
[JupyterHub instance][fabric-jupyter], where FABlib is pre-installed
for you. You will be presented with many examples of interacting with
FABRIC testbed and FABlib usage when you log in there. Those [notebook
sources][fabric-jupyter-examples] can be found on GitHub as well.
If you want to interact with FABRIC from Jupyter or a Python project
on your local development environment, that is possible too. See
[Install the FABRIC Python API][fablib-install] and the notes below
for details.
FABlib API docs can be found [here][fablib-api-rtd]. If you have
questions about FABRIC or FABlib usage, please ask them in FABRIC
[forums].
## Installing FABlib
You can install released versions of FABlib from PyPI:
```console
$ pip install fabrictestbed-extensions
```
If you need the current development version of FABlib, install it from
the git repository:
```console
$ pip install git+https://github.com/fabric-testbed/fabrictestbed-extensions@main
```
Note that installing FABlib using either methods will also install a
number of dependencies, so you might want to install FABlib in a
virtual environment. Your favorite tool for managing virtual
environments ([venv], [virtualenv], or [virtualenvwrapper]) should
work. FABRIC team tends to favor virtualenvwrapper.
## Using FABlib
Once installed, you can use FABlib in your Python projects:
```python
from fabrictestbed_extensions.fablib.fablib import FablibManager as fablib_manager
try:
fablib = fablib_manager()
fablib.show_config()
except Exception as e:
print(f"Exception: {e}")
```
Please note that some [configuration] is required for this to work.
## Contributing to FABlib
We welcome contributions in the form of bug reports, feature requests,
code patches, documentation updates, etc. If you have ideas that can
help FABlib, please review the [guidelines] first.
<!-- URLs -->
[pypy]: https://pypi.org/project/fabrictestbed-extensions/
[pypi-badge]: https://img.shields.io/pypi/v/fabrictestbed-extensions (PyPI)
[api-docs]: https://fabric-fablib.readthedocs.io/en/latest/?badge=latest
[api-docs-badge]: https://readthedocs.org/projects/fabric-fablib/badge/?version=latest (Documentation Status)
[fabric]: https://fabric-testbed.net/
[forums]: https://learn.fabric-testbed.net/forums/
[fablib-api-rtd]: https://fabric-fablib.readthedocs.io/en/latest/
[venv]: https://docs.python.org/3/library/venv.html
[virtualenv]: https://virtualenv.pypa.io/en/latest/
[virtualenvwrapper]: https://virtualenvwrapper.readthedocs.io/en/latest/
[fabric-jupyter]: https://jupyter.fabric-testbed.net/
[fabric-jupyter-examples]: https://github.com/fabric-testbed/jupyter-examples
[fablib-install]: https://learn.fabric-testbed.net/knowledge-base/install-the-python-api/
[configuration]: https://fabric-fablib.readthedocs.io/en/latest/#configuring-fablib
[guidelines]: ./CONTRIBUTING.md
Raw data
{
"_id": null,
"home_page": "",
"name": "fabrictestbed-extensions",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "",
"keywords": "",
"author": "",
"author_email": "Paul Ruth <pruth@renci.org>, Komal Thareja <kthare10@renci.org>",
"download_url": "https://files.pythonhosted.org/packages/e5/2f/f6e7dee0fd80e7575206c004d378fa6bdd5c46599535375a1c3d792c5795/fabrictestbed_extensions-1.6.4.tar.gz",
"platform": null,
"description": "# fabrictestbed-extensions\n\n[![pypi-badge]][pypy] [![api-docs-badge]][api-docs]\n\nThis is the implementation of a Python library, otherwise known as\n\"FABlib\", for intereacting with [FABRIC][fabric] testbed.\n\nYour first encounter with FABlib might be through FABRIC project's\n[JupyterHub instance][fabric-jupyter], where FABlib is pre-installed\nfor you. You will be presented with many examples of interacting with\nFABRIC testbed and FABlib usage when you log in there. Those [notebook\nsources][fabric-jupyter-examples] can be found on GitHub as well.\n\nIf you want to interact with FABRIC from Jupyter or a Python project\non your local development environment, that is possible too. See\n[Install the FABRIC Python API][fablib-install] and the notes below\nfor details.\n\nFABlib API docs can be found [here][fablib-api-rtd]. If you have\nquestions about FABRIC or FABlib usage, please ask them in FABRIC\n[forums].\n\n## Installing FABlib\n\nYou can install released versions of FABlib from PyPI:\n\n```console\n$ pip install fabrictestbed-extensions\n```\n\nIf you need the current development version of FABlib, install it from\nthe git repository:\n\n```console\n$ pip install git+https://github.com/fabric-testbed/fabrictestbed-extensions@main\n```\n\nNote that installing FABlib using either methods will also install a\nnumber of dependencies, so you might want to install FABlib in a\nvirtual environment. Your favorite tool for managing virtual\nenvironments ([venv], [virtualenv], or [virtualenvwrapper]) should\nwork. FABRIC team tends to favor virtualenvwrapper.\n\n\n## Using FABlib\n\nOnce installed, you can use FABlib in your Python projects:\n\n```python\nfrom fabrictestbed_extensions.fablib.fablib import FablibManager as fablib_manager\n\ntry:\n fablib = fablib_manager()\n fablib.show_config()\nexcept Exception as e:\n print(f\"Exception: {e}\")\n```\n\nPlease note that some [configuration] is required for this to work.\n\n## Contributing to FABlib\n\nWe welcome contributions in the form of bug reports, feature requests,\ncode patches, documentation updates, etc. If you have ideas that can\nhelp FABlib, please review the [guidelines] first.\n\n\n<!-- URLs -->\n\n[pypy]: https://pypi.org/project/fabrictestbed-extensions/\n[pypi-badge]: https://img.shields.io/pypi/v/fabrictestbed-extensions (PyPI)\n\n[api-docs]: https://fabric-fablib.readthedocs.io/en/latest/?badge=latest\n[api-docs-badge]: https://readthedocs.org/projects/fabric-fablib/badge/?version=latest (Documentation Status)\n\n[fabric]: https://fabric-testbed.net/\n[forums]: https://learn.fabric-testbed.net/forums/\n\n[fablib-api-rtd]: https://fabric-fablib.readthedocs.io/en/latest/\n\n[venv]: https://docs.python.org/3/library/venv.html\n[virtualenv]: https://virtualenv.pypa.io/en/latest/\n[virtualenvwrapper]: https://virtualenvwrapper.readthedocs.io/en/latest/\n\n[fabric-jupyter]: https://jupyter.fabric-testbed.net/\n[fabric-jupyter-examples]: https://github.com/fabric-testbed/jupyter-examples\n[fablib-install]: https://learn.fabric-testbed.net/knowledge-base/install-the-python-api/\n\n[configuration]: https://fabric-fablib.readthedocs.io/en/latest/#configuring-fablib\n\n[guidelines]: ./CONTRIBUTING.md\n\n",
"bugtrack_url": null,
"license": "",
"summary": "FABRIC Python Client Library and CLI Extensions",
"version": "1.6.4",
"project_urls": {
"ChangeLog": "https://github.com/fabric-testbed/fabrictestbed-extensions/blob/main/CHANGELOG.md",
"Documentation": "https://fabric-fablib.readthedocs.io/",
"Homepage": "https://fabric-testbed.net/",
"Sources": "https://github.com/fabric-testbed/fabrictestbed-extensions"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "97a78a72ec501bc3a364fb2e1c2988ce8397c31c155a0ccbd9efcb262c2c97b4",
"md5": "b610d134d0c905b0d68a4c5d669a94d7",
"sha256": "bf88613d0610b31a675136161104a2ef1bfa7ee54f4750dccd8f2fb3a8c6a22f"
},
"downloads": -1,
"filename": "fabrictestbed_extensions-1.6.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b610d134d0c905b0d68a4c5d669a94d7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 382352,
"upload_time": "2024-03-05T18:11:15",
"upload_time_iso_8601": "2024-03-05T18:11:15.864401Z",
"url": "https://files.pythonhosted.org/packages/97/a7/8a72ec501bc3a364fb2e1c2988ce8397c31c155a0ccbd9efcb262c2c97b4/fabrictestbed_extensions-1.6.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e52ff6e7dee0fd80e7575206c004d378fa6bdd5c46599535375a1c3d792c5795",
"md5": "df10fe07f734c2493d1891004a90f4e3",
"sha256": "ca05a280d4cba0fc164db84e7a554bf05f315509a8a14d6768ba8d84247b1485"
},
"downloads": -1,
"filename": "fabrictestbed_extensions-1.6.4.tar.gz",
"has_sig": false,
"md5_digest": "df10fe07f734c2493d1891004a90f4e3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 402094,
"upload_time": "2024-03-05T18:11:18",
"upload_time_iso_8601": "2024-03-05T18:11:18.448765Z",
"url": "https://files.pythonhosted.org/packages/e5/2f/f6e7dee0fd80e7575206c004d378fa6bdd5c46599535375a1c3d792c5795/fabrictestbed_extensions-1.6.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-05 18:11:18",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "fabric-testbed",
"github_project": "fabrictestbed-extensions",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "fabrictestbed-extensions"
}
