Skip to main content

lab-env

Test Docs License Python Ruff

lab-env is a command-line toolkit for consistent research computing environments on macOS and Linux. It keeps personal host configuration outside the installed package and provides diagnostics without connecting to remote systems or changing shell startup files.

lab-env provides personal TOML configuration, shared and user-defined hosts, SSH and resumable rsync commands, local diagnostics, and managed Bash/Zsh shell integration. Shell setup preserves existing dotfiles and can be previewed before installation.

Installation

Python 3.11 or newer is supported. For an isolated command-line installation, use pipx:

pipx install lab-env

For development from a checkout:

python -m pip install -e ".[dev]"

Quick Start

lab --help
lab init
lab hosts
lab doctor
lab connect HOST
lab pull HOST REMOTE_PATH [LOCAL_PATH]
lab push HOST LOCAL_PATH REMOTE_PATH
lab tecplot export figure.lay
lab shell preview
lab shell install
lab shell status

After lab shell install, the legacy-compatible shortcut exports PNG images at 2000 pixels wide by default:

lay2pic figure.lay

By default, configuration is stored at ~/.config/lab-env/config.toml. XDG_CONFIG_HOME is honored when set. Use an explicit path for testing or multiple environments:

lab --config ./example.toml init
lab --config ./example.toml doctor

lab init refuses to overwrite an existing file. lab shell install is the only current command that modifies shell startup configuration. Preview the exact paths and managed block first with lab shell preview.

Documentation

The user guide is available at uahypersonics.github.io/lab-env. Development and contribution instructions are in CONTRIBUTING.md.

License

lab-env is distributed under the GNU General Public License v3.0 or later.

Metadata

Release files for lab-env 0.0.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for lab-env 0.0.7
File Size Uploaded Provenance
lab_env-0.0.7.tar.gz 52.3 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for lab-env 0.0.7
File Interpreter ABI Platform
lab_env-0.0.7-py3-none-any.whl Python 3 none any Details

Total release size: 94.6 kB

Release files / lab_env-0.0.7.tar.gz

Download URL lab_env-0.0.7.tar.gz
Size 52.3 kB
Tags Source
SHA-256 checksum
How to use checksums
de93990c810a3010ef5d2283d12962101b1368161a2df4590c621f4080c808ad
BLAKE2b-256 checksum
How to use checksums
97de4d4ec4c4f0e65edf13c9b5e598e9db801d9fb0d672d094981736765c7370
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 30, 2026.

Transparency log

Release files / lab_env-0.0.7-py3-none-any.whl

Download URL lab_env-0.0.7-py3-none-any.whl
Size 42.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
28c8cd4d3aa66e72c0caa462cc12f842cb331d34975f4f1f412cb1e4c3e42e56
BLAKE2b-256 checksum
How to use checksums
533abcb55da077855a2246256637307c3036fcb571e74724c9b00d0837ef6c28
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 30, 2026.

Transparency log

Security for lab-env 0.0.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for lab_env-0.0.7.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 30, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page