Changelog¶

Note

Until the Python API has stabilised, venvstacks is using ZeroVer (starting from 0.1.0).

Refer to Version Numbering for additional details on the way releases are versioned.

Unreleased¶

See the fragment files in the changelog.d directory.

Framework layers may now specify frameworks to depend on one or more framework layers instead of depending directly on a runtime layer. Framework dependencies must form a directed acyclic graph (DAG), and framework layers must be defined after any framework layers they depend on (proposed in #18, implemented in PR #119).
Application layers may now specify runtime to depend directly on a a runtime layer with no intervening framework layers (added as part of resolving #18).
All layers may now specify dynlib_exclude to indicate dynamic libraries which should not be symbolically linked into the share/venv/dynlib/ environment subfolder on Linux and macOS (added as part of resolving #38).

To enable loading of shared objects from other environment layers, framework and application environments on Linux and macOS now run Python via a suitably capable shell environment (bash on Linux, zsh on macOS) that can be expected to be consistently installed (changed in #38).

Extension modules on Linux and macOS that rely on shared objects published by their dependencies (for example, PyTorch depending on CUDA libraries) now work correctly even if those dependencies are installed in a lower environment layer. See How does dynamic linking work across layers? for additional details (resolved in #38).

The build and lock subcommands accept a new --reset-lock CLI option. This multi-use option requests that any previously created layer lock file be removed before locking the selected layers (thus ignoring any previous version pins or artifact hashes). This option uses the same wildcard pattern matching as the --include option. Only layers that are locked by the given command will have their previous lock files removed, as excluded layers will be excluded from both locking and having their lock files reset (added in #22).
"win_arm64" and "linux_aarch64" are now accepted as target platforms. ARM64/Aarch64 refer to the same CPU architecture, but Python reports it differently depending on the OS, and this is reflected in their respective platform tags (added in #107).

A Python API instability FutureWarning is now emitted at runtime (added while resolving #22).
The previous BuildEnvironment.get_unmatched_patterns() method has been replaced by the new BuildEnvironment.filter_layers() method, which returns both the matching layer names and the unmatched patterns (changed in #22).
BuildEnvironment.select_layers() now accepts an iterable of environment names rather than an iterable of filter patterns to be matched (changed in #22).

--only-binary ":all:" is now passed when locking the layers in addition to being passed when creating the layer environments. This avoids emitting requirements that can’t be installed (resolved in #102).
Remove directories from /bin when building layers (resolved in PR #103)

Fix Typer 0.14.0+ incompatibility when setting app name (reported by Rugved Somwanshi in #96).

Setting versioned = True in a layer definition will now append a lock version number to the layer name that automatically increments each time the locked requirements change for that layer (layer@1, layer@2, etc). Refer to Layer names and versioning for details on when the versioned and unversioned layer names are used (implemented in #24).
Added documentation for the Environment Stack File Formats (part of #78).
Added python_implementation to the published layer metadata (part of #78).
Added bound_to_implementation to the published layer metadata (part of #78).

Enabled rendered previews for documentation PRs (requested in #43).
Enabled link validity checks when rendering documentation (requested in #62).
Renamed EnvironmentExportRequest to LayerExportRequest (part of #33).
Exposed LayerSpecBase, LayeredSpecBase as public classes (part of #33).
Exposed LayerEnvBase, LayeredEnvBase as public classes (part of #33).
Added leading underscores to several private functions and methods (part of #33).
Added docstrings to all remaining public functions and methods (part of #33).
Updated docs to actively discourage using @ in layers names (part of #78).
Renamed fully_versioned_name runtime layer specification field to python_implementation (part of #78).
Renamed runtime_name to runtime_layer in the layer metadata (to align with the required_layers field), and simplified it to always refer to the runtime layer’s install target name (part of #78).

Post-installation scripts for layered environments now work correctly even when run with a Python installation other than the expected base runtime (resolved in #66)

Update docs URL to https://venvstacks.lmstudio.ai
Add OpenGraph metadata to docs landing page
Resolved several broken links in the documentation
Documentation is now marked as being unversioned (it is published directly from the main branch)

Included project URLs in project metadata
Added installation instructions to README.md
Linked to main documentation from README.md
Improved the content split between the project overview page and the top level docs landing page