Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.0.9] - 2025-10-25

`uv` Backend (Experimental): Added UvPackageManager to interact with uv. It supports creating virtual environments, installing/uninstalling packages, and running ephemeral tools with uv tool run (uvx). Accessible via get_uv_manager.
`ensure_requirements` Function: New synchronous (ensure_requirements) and asynchronous (async_ensure_requirements) functions to idempotently install dependencies from a requirements.txt file. It intelligently parses the file, handles pip options, and only installs what’s missing or outdated.
Automatic Venv Creation: The PackageManager can now automatically create a virtual environment if the venv_path provided during initialization does not exist.
`get_current_package_version` Alias: Added as a more explicit alias for get_installed_version.
Verbose Output Control: Added a verbose parameter to most installation and uninstallation functions to allow streaming pip output directly to the console for better debugging.

`ensure_packages` Enhancement: Now supports an advanced dictionary format for conditional VCS (Git) installations, allowing installation from a repository only if a specific version requirement is not met.
Improved Command Execution: The internal _run_command method in PackageManager has been improved with better cross-platform command quoting, encoding handling (forcing UTF-8), and more detailed error logging.
Asynchronous Command Execution: AsyncPackageManager._run_command now supports verbose output streaming and has been made more robust.

Refactored core logic into PackageManager class. Module-level functions now wrap methods of a default instance.
is_installed now accepts an optional version_specifier argument.
install_if_missing now uses version_specifier instead of separate version and enforce_version arguments (old arguments are deprecated but handled with warnings).
`ensure_packages` now accepts both a dictionary and a list of requirement strings. (New)
Added `verbose` parameter to installation/uninstallation functions to control direct output. (New)
Improved internal command execution and error handling.
Updated dependencies (packaging, ascii_colors).
Switched build system to use pyproject.toml with setuptools.
Minimum Python version raised to 3.8.

ensure_packages function for efficiently checking and installing/updating a dictionary of requirements.
dry_run parameter added to most installation/uninstallation functions.
Asynchronous API (async_package_manager module) with AsyncPackageManager, async_install, async_install_if_missing, async_check_vulnerabilities.
check_vulnerabilities function using pip-audit (requires pipmaster[audit]).
get_pip_manager factory function to get PackageManager instances for specific environments.
get_package_info function to run pip show.
install_or_update and install_or_update_multiple convenience functions.
Placeholders for future uv and conda backend support.
More robust logging using ascii_colors.
Comprehensive documentation generated with Sphinx.
GitHub Actions workflow for building and deploying documentation.
Development dependencies ([dev] extra) including pytest, pytest-asyncio, ruff, mypy, sphinx.

Refactored core logic into PackageManager class. Module-level functions now wrap methods of a default instance.
is_installed now accepts an optional version_specifier argument.
install_if_missing now uses version_specifier instead of separate version and enforce_version arguments (old arguments are deprecated but handled with warnings).
Improved internal command execution and error handling.
Updated dependencies (packaging, ascii_colors).
Switched build system to use pyproject.toml with setuptools.
Minimum Python version raised to 3.8.

is_version_higher (use is_version_compatible with >=).
is_version_exact (use is_version_compatible with ==).
install_if_missing parameters version and enforce_version (use version_specifier).

Initial release with basic install, is_installed, get_installed_version, uninstall functions.