pload 1.2.0b1

Declarative environment beta

This beta packages the redesigned environment-reproduction workflow for fresh
end-to-end testing on macOS, Linux, and Windows.

Highlights

• A clean, portable pload.toml describes user intent; pload keeps exact
  resolution data in .pload_lock.toml and executable acquisition choices in
  .pload_plan.toml.
• pload plan performs metadata-only analysis and never downloads wheel
  bodies. pload apply executes the saved plan exactly and stops instead of
  silently changing routes.
• Plans can reuse verified pload/pip/uv cache wheels, compatible installed
  environments, local repositories, SSH repositories, or exact index URLs.
• pload apply --local materializes the environment as project-local .venv.
• Apply output now uses adaptive Rich progress rows with real measured bytes
  for downloads, cache verification, local/SSH copies, and environment copies.
• Interactive planning shows only dependencies requested in pload.toml;
  transitive dependencies are resolved and routed automatically.
• pload remote add explicitly publishes selected package artifacts to a
  configured local or SSH repository.

Important beta boundary

This release replaces the discarded unreleased export/restore transport
prototype. Existing 1.2.0a1 declarative files should be regenerated with
pload describe, pload plan, and pload apply before relying on them.

Install or upgrade

pload-install --yes --package-spec "pload==1.2.0b1"

For a first installation, follow the bootstrap instructions in the README.

Validation

• 139 tests across Python 3.8, 3.10, 3.12, and the current Python release on
  Ubuntu, macOS, and Windows
• Bootstrap installer smoke tests on all three operating systems
• CodeQL and package metadata checks

pload 1.0.0

Changelog

1.0.0 - 2026-09-24

Added

• First stable release of the relocatable runtime and virtual-environment
  manager.
• README instructions for upgrading installer-managed, pipx, and bootstrap-
  virtual-environment installations.

Fixed

• Use the modern PEP 621 license metadata and production/stable classifier so
  package builds no longer emit setuptools deprecation warnings.

0.9.6 - 2026-09-24

Changed

• Keep USAGE centered without an arrow marker.
• Render arrow-marked section headings as standalone left-aligned lines, with
  a blank line between each heading and its table for easier scanning.

0.9.5 - 2026-09-24

Changed

• Left-align arrow-marked help section titles and give each two blank lines
  above and one below.

0.9.4 - 2026-09-24

Changed

• Remove the redundant usage: prefix inside the dedicated ▶ USAGE panel.

0.9.3 - 2026-09-24

Changed

• Put the emphasized, highlighted usage panel directly below each help title.
• Add colored ▶ markers to table-section titles and space the welcome screen's
  Simple usage and Global options tables apart.

0.9.2 - 2026-09-24

Added

• Make bare pload new open a colored guided environment-creation flow.

Fixed

• Make shell integration delegate bare pload to the executable so the welcome
  screen still appears in new terminal sessions.
• Change the --message short option from -d to -m, leaving -d solely
  for detailed help.
• Show global directory options only on pload -h and the welcome screen,
  instead of repeating them under every subcommand.

0.9.1 - 2026-09-24

Changed

• Remove the legacy --message/-m name-suffix option.
• Use --message/-d as the single description option; --description is no
  longer accepted.
• Generate simple unique names such as python-3.12, python-3.12-2 when
  --name is omitted.
• Display Python runtime IDs and aliases in separate columns.

0.9.0 - 2026-09-24

Added

• Assign stable pyN IDs and readable source-v<version> aliases to distinct
  discovered Python executable paths.
• Resolve py1, uv-v3.12.8, and py1:uv-v3.12.8 when creating environments
  or querying pload python path.
• Persist Python discovery records separately from the virtual-environment
  registry.

Changed

• pload python list now shows ID/alias, version, source, and path together.

0.8.9 - 2026-09-24

Changed

• Rewrite the README around the current installer, configuration, Python
  discovery, environment IDs, help system, and no-argument welcome screen.
• Add a contents section and current macOS visual examples near the relevant
  workflows.

0.8.8 - 2026-09-24

Added

• Running pload without arguments now opens a welcome screen with ASCII art,
  simple usage examples, and links to concise and detailed help.

0.8.7 - 2026-09-24

Added

• Add an ASCII welcome screen after installation with copyable next steps and
  the selected launcher and data paths.
• Add macOS-style scalable terminal screenshots to the README for installation
  and environment-list examples.

Changed

• Expand the README with visual examples so the first-run experience is easier
  to understand before installing.

0.8.6 - 2026-09-24

Changed

• Add a complete, highlighted usage: line at the top of every brief help
  screen.
• Show the command spelling actually used, including aliases, in that usage
  line.

0.8.5 - 2026-09-24

Changed

• Reuse the first available environment ID after an environment is removed.
• Display environments newest-first by creation time, with ID order only as a
  deterministic tie-breaker.

0.8.4 - 2026-09-24

Changed

• Make every brief -h view list all positional arguments and options with
  concise descriptions.
• Show global options alongside command-specific options.
• Keep -d focused on examples, explanations, effects, and failure behavior.

0.8.3 - 2026-09-24

Added

• Add pload cfg set KEY VALUE for changing one setting without reinstalling.
• Add pload cfg -t to reopen the colored interactive setup wizard later.
• Reuse the same guided configuration flow during initial installation and
  later reconfiguration.

0.8.2 - 2026-09-24

Changed

• Add consistent short aliases for every long CLI option, including new -n.
• Keep already-clear commands spelled out: new and python install no longer
  accept command aliases.
• Update practical help examples and alias tables to match the command surface.

0.8.1 - 2026-09-24

Changed

• Replace formal -h -d argument summaries with task-oriented guides that
  include copyable examples, expected output, on-disk effects, failure
  behavior, and safety notes for every command.
• Expand pload-install -h -d into a walkthrough of the numbered prompts,
  resulting directory layout, shell changes, and non-interactive setup.

0.8.0 - 2026-09-24

Added

• Short command aliases including ls, n, i, py, p, and cfg.
• Compact, colored quick help with -h and full Rich-formatted help with
  -h -d, for both pload and pload-install.
• A terminal-aware spinner while virtual environments are being created.

Changed

• Shell integration recognizes every short and long command alias.
• Spinner animations automatically fall back to stable log lines when output
  is redirected or running in CI.

0.7.0 - 2026-09-24

Added

• Persistent monotonic IDs (v1, v2, ...) and descriptions for environments.
• Activation, path lookup, and removal by environment ID.
• Rich, colored tables for environment and Python-runtime listings.
• USTC and Alibaba Cloud PyPI presets alongside official PyPI and Tsinghua.
• Detailed, colored, numbered choices in the guided installer.

Changed

• pload list now shows ID, name, Python version, description, and path.
• Existing managed environments are registered automatically on first use.

0.6.2 - 2026-09-24

Fixed

• Make the selected package index override ambient pip index, extra-index, and
  no-index environment variables during private-runtime installation.
• Store the official PyPI URL explicitly when the official source is selected.

0.6.1 - 2026-09-24

Fixed

• Report the version actually installed in the private runtime after an
  in-place upgrade, instead of the older installer process version.

0.6.0 - 2026-09-23

Added

• Cross-platform Python discovery across the operating system, PATH, uv,
  pyenv, Conda, mise, asdf, Homebrew, and the Windows Python Launcher.
• Source and resolved executable columns in pload python list.
• pload python list --filter TYPE... with comma-separated, space-separated,
  and compatibility alias support.

Changed

• Version-based environment creation can use any discovered interpreter, not
  only uv, pyenv, or a versioned command already on PATH.
• Requested minor versions are verified instead of falling back to an
  unrelated python3 executable.

0.5.0 - 2026-09-23

Added

• Guided pload-install setup for the data, executable, environment, Python,
  cache, package-index, and shell-integration locations.
• A private pload runtime plus stable bin/pload launcher that is independent
  from project virtual environments.
• uv-backed pload python install, list, and path commands.
• Official, USTC, custom HTTPS, local file://, and custom-download-metadata
  options for managed Python runtimes.
• Persistent PLOAD_HOME/config.json configuration and pload config show.
• Expanded top-level and command-specific help with practical examples.

Changed

• uv-managed Python is preferred over pyenv when a requested version is
  available; pyenv remains a compatible fallback.
• Shell integration calls the stable pload launcher directly.

0.4.1 - 2026-09-23

Fixed

• Automatically reuse a populated legacy ~/venvs root when no explicit path
  is configured, so upgrading from 0.3 does not hide existing environments.

0.4.0 - 2026-09-23

Added

• Fully relocatable data, environment, and state roots through CLI options and
  PLOAD_HOME, PLOAD_VENVS_DIR, and PLOAD_STATE_DIR.
• Independent --project-dir and --venv-dir options for local environments.
• Explicit-path environment creation and interpreter selection.
• Side-effect-free shell integration for Bash, Zsh, Fish, and PowerShell.
• Automated tests and multi-platform continuous integration.

Changed

• pyenv is optional; the current interpreter is used when no version is given.
• Packaging uses pyproject.toml and builds both wheels and source archives.
• Package installation no longer edits shell profiles.
• Expected failures now return concise messages instead of Python tracebacks.

Fixed

• Missing color method during dependency installation.
• Crashes when pyenv, state files, or environment directories do not exist.
• Hard-coded Homebrew and home-directory paths.
• Inconsistent project metadata and license declaration.

pload 0.9.6

Keep USAGE centered without an arrow and render arrow-marked headings as standalone left-aligned lines with readable spacing.

pload 0.9.5

Left-align arrow-marked help titles and apply two blank lines above and one below each section.

pload 0.9.4

Remove the redundant usage: prefix inside the dedicated ▶ USAGE panel.

pload 0.9.3

Help layout

• Put highlighted usage directly below the title panel.
• Mark section titles with colored right arrows.
• Add breathing room between Simple usage and Global options on the welcome screen.

pload 0.9.2

Highlights

• Run pload new with no options for guided environment creation.
• Restore the bare pload welcome screen after shell initialization.
• Use --message/-m; -d remains detailed help only.
• Keep global storage options on the welcome screen and root help only.

pload 0.9.1

Removed legacy message-based naming; --message/-d is now the description option, auto-names are simple and unique, and Python IDs and aliases are displayed in separate columns.

pload 0.9.0

Highlights

• Python discovery now assigns stable pyN IDs and readable aliases.
• Use py1, uv-v3.12.8, or py1:uv-v3.12.8 with pload new --version and pload python path.
• pload python list shows ID/alias, version, source, and path.

pload 0.8.9

Highlights

• Rewritten README with a contents section and current command workflows.
• Updated installation, configuration, Python discovery, environment, help, and isolation documentation.
• Added current macOS visual examples and removed outdated behavior descriptions.