| Name | fabrictestbed-extensions JSON |
| Version |
1.9.1
JSON |
| download |
| home_page | None |
| Summary | FABRIC Python Client Library and CLI Extensions |
| upload_time | 2025-08-11 17:32:38 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.9 |
| license | None |
| 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 interacting 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": null,
"name": "fabrictestbed-extensions",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": null,
"author": null,
"author_email": "Paul Ruth <pruth@renci.org>, Komal Thareja <kthare10@renci.org>",
"download_url": "https://files.pythonhosted.org/packages/75/e9/5813ca70fe9931dd47e998a03bf744a04d0c9293be0c79676965ac7aa7e4/fabrictestbed_extensions-1.9.1.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 interacting 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\n\n",
"bugtrack_url": null,
"license": null,
"summary": "FABRIC Python Client Library and CLI Extensions",
"version": "1.9.1",
"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": null,
"digests": {
"blake2b_256": "3138c6d316244ea5566f7acc5c3bb823a32418cd8b12265297852d4e84a52772",
"md5": "3d3fab1b726980e25592296af5606413",
"sha256": "009d16dc55a5f632d3441348a6374fbb6694ac5457f74f6e0cfc11b7342719df"
},
"downloads": -1,
"filename": "fabrictestbed_extensions-1.9.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3d3fab1b726980e25592296af5606413",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 426668,
"upload_time": "2025-08-11T17:32:37",
"upload_time_iso_8601": "2025-08-11T17:32:37.004165Z",
"url": "https://files.pythonhosted.org/packages/31/38/c6d316244ea5566f7acc5c3bb823a32418cd8b12265297852d4e84a52772/fabrictestbed_extensions-1.9.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "75e95813ca70fe9931dd47e998a03bf744a04d0c9293be0c79676965ac7aa7e4",
"md5": "6874b45fe1b427965c80de7729122f4e",
"sha256": "5e2f51c61e72ad8ba3f6ed2e8b986bdcaa968630f22896571390c423836e6b11"
},
"downloads": -1,
"filename": "fabrictestbed_extensions-1.9.1.tar.gz",
"has_sig": false,
"md5_digest": "6874b45fe1b427965c80de7729122f4e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 446189,
"upload_time": "2025-08-11T17:32:38",
"upload_time_iso_8601": "2025-08-11T17:32:38.888670Z",
"url": "https://files.pythonhosted.org/packages/75/e9/5813ca70fe9931dd47e998a03bf744a04d0c9293be0c79676965ac7aa7e4/fabrictestbed_extensions-1.9.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-11 17:32:38",
"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"
}
