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.