pload 0.3.0

A simple command line tool for python virtual env management.

pload

A Minimalist Python Virtual Environment Management Tool, support powershell, bash, zsh, fishshell.

[!WARNING] This is project is under development yet. You can try it carefully if you are interested in it.

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

Basic Installation

pip install pload

Shell Autocompletion (Optional)

Add to your shell configuration (~/.bashrc or ~/.zshrc):

eval "$(register-python-argcomplete pload)"

Command Reference

Core Operations

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

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]

4. Environment Activation

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

Advanced Operations

Environment Copy (Work in Progress)

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

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

Common Issues

Q: Environment activation failure

Solution: Verify environment exists in target location:

pload list --expression "<env_name>"

Q: Missing Python versions

Solution: Install required versions through pyenv first:

pyenv install 3.8.10

Q: Local environment detection

Solution: Ensure .venv directory exists in current path before activation

Development Contribution

1. Clone repository
2. Create feature branch
3. Implement changes with test cases
4. Submit pull request

# Development setup
python setup.py develop

License

Apache License 2.0, Copyright 2025 Yunming Hu.