fabrictestbed-extensions
This is the implementation of a Python library, otherwise known as "FABlib", for interacting with FABRIC testbed.
Your first encounter with FABlib might be through FABRIC project's JupyterHub instance, 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 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 and the notes below for details.
FABlib API docs can be found here. 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:
$ 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.
NOTE: This package has been tested and verified to work with Python versions 3.11 through 3.14.
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}")
Please note that some configuration is required for this to work.
Command-Line Interface
FABlib includes a CLI tool (fabric-cli) that is automatically installed
with the package. It provides commands for token management, slice
operations, resource queries, user info, and environment setup — all from
the terminal.
Quick start
# One-time setup: creates tokens, SSH keys, ssh_config, and fabric_rc
$ fabric-cli configure setup
# List your slices
$ fabric-cli slices list
# Check available testbed sites
$ fabric-cli resources sites
Configuration
The CLI resolves settings from (highest to lowest priority):
- Command-line options (
--cmhost,--location, etc.) - Environment variables (
FABRIC_CREDMGR_HOST,FABRIC_TOKEN_LOCATION, etc.) - Config file at
~/work/fabric_config/fabric_rc - Built-in defaults
Commands
fabric-cli configure setup
Interactive first-time setup. Creates the config directory, obtains a
token via browser-based CILogon authentication, generates bastion and
sliver SSH keys, and writes ssh_config and fabric_rc files. Re-run
to refresh expired tokens automatically; use --overwrite to regenerate
everything.
When --config-dir is specified, all files are read from and written to
that directory. An existing fabric_rc in the directory is used for
configuration; default paths outside the directory are not consulted.
$ fabric-cli configure setup
$ fabric-cli configure setup --config-dir ~/my_fabric_config --overwrite
fabric-cli tokens
Manage FABRIC identity tokens.
$ fabric-cli tokens create # Create a new token (opens browser)
$ fabric-cli tokens create --no-browser # Print URL instead of opening browser
$ fabric-cli tokens create --location ~/my_tokens/id_token.json # Save to custom path
$ fabric-cli tokens refresh # Refresh an existing token
$ fabric-cli tokens revoke # Revoke a token
fabric-cli slices
List, inspect, renew, and delete slices.
$ fabric-cli slices list # List active slices
$ fabric-cli slices list --all # Include Dead and Closing slices
$ fabric-cli slices show --name MySlice # Show slice details
$ fabric-cli slices delete --name MySlice # Delete a slice
$ fabric-cli slices renew --name MySlice --days 7 # Extend lease by 7 days
$ fabric-cli slices nodes --name MySlice # List nodes in a slice
$ fabric-cli slices networks --name MySlice # List networks in a slice
$ fabric-cli slices interfaces --name MySlice # List interfaces in a slice
$ fabric-cli slices slivers --name MySlice # List slivers in a slice
fabric-cli resources
Query testbed resources.
$ fabric-cli resources sites # List all sites with usage bars
$ fabric-cli resources sites --site TACC # Show details for a specific site
$ fabric-cli resources hosts # List all hosts
$ fabric-cli resources hosts --site TACC # Filter hosts by site
$ fabric-cli resources links # List inter-site network links
$ fabric-cli resources facility-ports # List facility ports
fabric-cli user
Query user and project information.
$ fabric-cli user info # Show current user info
$ fabric-cli user projects # List your projects
Common options
Most commands accept the following options:
| Option | Description |
|---|---|
--cmhost |
Credential Manager host |
--ochost |
Orchestrator host |
--location |
Path to token JSON file |
--projectid |
Project UUID |
--scope |
Token scope (cf, mf, or all) |
--json |
Output raw JSON instead of formatted text |
Help
Use --help on any command or subcommand for full usage details:
$ fabric-cli --help
$ fabric-cli slices --help
$ fabric-cli tokens create --help
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.
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
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file fabrictestbed_extensions-2.0.7.tar.gz.
File metadata
- Download URL: fabrictestbed_extensions-2.0.7.tar.gz
- Upload date:
- Size: 498.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
python-requests/2.32.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f5992d1258f7957fff2a15ef81b49b1474cf16aad561776c33f607eb6c6396ab
|
|
| MD5 |
144719ef0e840c1e44b86c5d28ddbcca
|
|
| BLAKE2b-256 |
96412c32baa247a2111b8dfd4096ca5530af5a1d396e3e1654f98f1dcefe2a43
|
File details
Details for the file fabrictestbed_extensions-2.0.7-py3-none-any.whl.
File metadata
- Download URL: fabrictestbed_extensions-2.0.7-py3-none-any.whl
- Upload date:
- Size: 521.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
python-requests/2.32.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9756c1e214f8724ba4de48d111fb4adaed44715d681986dcc282047cd7f9cba2
|
|
| MD5 |
63752718ecbc04d1afcbcb7b17d91dea
|
|
| BLAKE2b-256 |
96490de265bca9779d53b06874aa071eb25800081aad8b0101a5533e4aa4c932
|
