FABRIC Python Client Library and CLI Extensions
Project description
fabrictestbed-extensions
This repository contains implementation of a Python API for intereacting with FABRIC testbed, otherwise known as "FABlib".
Installing FABlib
You can install released versions of FABlib from PyPI:
$ pip install fabrictestbed-extensions
If you need the current development version of FABlib, install it from the git repository:
$ 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:
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}")
Your first encounter with FABlib however might be through FABRIC project's JupyterHub instance. You will be presented with many examples on FABlib usage when you log in there. The notebook sources can be found on GitHub as well.
Since FABlib 1.4, API docs can be found here. Older API docs are here.
If you want to interact with FABRIC from Jupyter installed on your computer, see: Install the FABRIC Python API.
Testing FABlib
Run tests with pytest:
$ pip install -e .[test]
$ pytest
Building Python packages
Do not do python setup.py sdist bdist_wheel. Instead, do:
$ pip install build
$ python -m build
Following that, upload to PyPi using:
$ twine upload dist/*
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file fabrictestbed-extensions-1.4.1.tar.gz.
File metadata
- Download URL: fabrictestbed-extensions-1.4.1.tar.gz
- Upload date:
- Size: 358.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/29.0 requests/2.25.1 requests-toolbelt/0.9.1 urllib3/1.26.5 tqdm/4.54.1 importlib-metadata/3.7.3 keyring/21.5.0 rfc3986/1.4.0 colorama/0.4.4 CPython/3.9.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 4782525a43ad61673dd06b1a14ef6ffbd1db2cfc92bcb7e5e0843adf42cd321c |
|
| MD5 | a343ddb59a60f3b4834435e29da3ffae |
|
| BLAKE2b-256 | f1c9d186b196437ef9a139173aedcfa2f08792606d421ae31ee9a87755efe599 |
File details
Details for the file fabrictestbed_extensions-1.4.1-py3-none-any.whl.
File metadata
- Download URL: fabrictestbed_extensions-1.4.1-py3-none-any.whl
- Upload date:
- Size: 388.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/29.0 requests/2.25.1 requests-toolbelt/0.9.1 urllib3/1.26.5 tqdm/4.54.1 importlib-metadata/3.7.3 keyring/21.5.0 rfc3986/1.4.0 colorama/0.4.4 CPython/3.9.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | e99bbaf76108f543badc6ec05b18586ce8f5fb0cf1d61873a8ded5652c412118 |
|
| MD5 | 2018e0e8655d8466c0a428b062ef1dec |
|
| BLAKE2b-256 | e175ac00e247df379eb838f9079301fb7b05a29d3aa7f277343e681e2713f246 |
