pload

Warning

• This is project is under development yet. You can try it carefully if you are interested in it.
• Pyenv is required for this project for Python management.

A Minimalist Python Virtual Environment Management Tool, support:

• powershell
• bash
• zsh
• fishshell
• cmd(TODO)

# Overview

pload is a command-line utility designed for efficient management of Python virtual environments. It supports both global environment management and local project-specific environments, with regex pattern matching and pyenv integration capabilities.

# Installation

Installation from sdist(wheel not support.)

pip install --no-binary :all: pload

Shell Autocompletion (Optional)

Warning

TODO: Manually add complete file for pload.

# Usage

1. Create Global Environment

pload new --version <python_version> [--message <description>] [--channel <pip_channel>] [--requirements <packages>...]

Example:

pload new -v 3.8.10 -m data_analysis -r numpy pandas
# Creates: 3.8.10-data_analysis

Warning

TODO: Support pload.toml to manage all packages, env & ...

2. Initialize Local Environment

pload init --version <python_version> [--channel <pip_channel>] [--requirements <packages>...]

Example:

pload init -v 3.9.5  # Creates .venv in current directory

3. Environment Management

# Remove environments
pload rm --envs <env_names>...  # Explicit names
pload rm --expression <regex>   # Pattern matching

# List environments
pload list [--expression <regex>] [--version]

Warning

Because of the inner parameter parser for powershell, you should use '--v' for short of '--version'. For example:

pload list --v

And short for --envs is also replaced by -n due to this.

4. Environment Activation

pload <global_env_name>  # Activate global environment
pload .                 # Activate local .venv

Note

This part is completed by scripts under '$home/venvs/scripts'.

5. Environment Copy (TODO)

pload cp --from <source_env> --to <target_env>

Warning

TODO ... But actually a perfect solution for this function is not raised yet.

# Feature Details

@ Global Environment Management

• Stores environments in ~/.pload/venvs
• Automatic version-message naming convention
• Supports batch operations using regular expressions

@ Local Environment Integration

• Creates .venv directories in project folders
• Compatible with existing virtual environments

@ Python Version Management

• Requires pyenv for version control
• Lists available Python versions via pload list --version

# License

Apache License 2.0, Copyright 2025 Yunming Hu.