poetry-plugin-lock-filter 0.1.0__tar.gz

poetry_plugin_lock_filter-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 RealDioBrando
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

poetry_plugin_lock_filter-0.1.0/PKG-INFO

@@ -0,0 +1,216 @@
+Metadata-Version: 2.4
+Name: poetry-plugin-lock-filter
+Version: 0.1.0
+Summary: Poetry plugin and CLI for creating marker-specific lock files
+Author: RealDioBrando
+License: MIT License
+        
+        Copyright (c) 2026 RealDioBrando
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/RealDioBrando/poetry-plugin-lock-filter
+Project-URL: Issues, https://github.com/RealDioBrando/poetry-plugin-lock-filter/issues
+Keywords: poetry,plugin,lock,markers,platform
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: packaging>=24.2
+Requires-Dist: poetry<3,>=2.1
+Requires-Dist: tomlkit>=0.11
+Dynamic: license-file
+
+# poetry-plugin-lock-filter
+
+A Poetry 2.x plugin and standalone CLI for creating **marker-specific lock files**.
+
+Poetry writes a universal `poetry.lock` that contains every marker branch. Installation evaluates those markers at runtime, but the lock file itself remains broad. This project post-processes a Poetry lock file and keeps only packages whose markers match a selected target environment.
+
+## Why
+
+Given dependencies such as:
+
+```toml
+[tool.poetry.dependencies]
+linux-only = { version = "1.0", markers = "sys_platform == 'linux'" }
+windows-only = { version = "2.0", markers = "sys_platform == 'win32'" }
+```
+
+Poetry 2.4.1 writes both packages to `poetry.lock`, even when only one branch is active on the current machine.
+
+`poetry install` selects the correct packages, but tools that read `poetry.lock` directly often see both branches. This plugin produces a clean, target-specific lock file without changing the original.
+
+## Features
+
+- Poetry plugin command: `poetry filter-lock`
+- Standalone command: `poetry-lock-filter`
+- Presets for common target environments
+- Repeated `--env KEY=VALUE` overrides
+- Main-group filtering by default
+- Optional-package exclusion by default
+- Dependency pruning so retained packages only reference retained dependencies
+- JSON report output
+- Original `poetry.lock` is preserved by default
+
+## Installation
+
+Install as a Poetry plugin:
+
+```bash
+poetry self add git+https://github.com/RealDioBrando/poetry-plugin-lock-filter.git
+```
+
+Or install it as a normal Python package:
+
+```bash
+pip install git+https://github.com/RealDioBrando/poetry-plugin-lock-filter.git
+```
+
+## Poetry plugin usage
+
+Run inside a Poetry project:
+
+```bash
+poetry filter-lock
+```
+
+This reads the project’s `poetry.lock` and writes:
+
+```text
+poetry.target.lock
+```
+
+The default target environment is:
+
+```text
+Linux
+aarch64
+CPython 3.11
+```
+
+## Standalone usage
+
+```bash
+poetry-lock-filter \
+  --project /path/to/project \
+  --output poetry.target.lock \
+  --preset linux-aarch64-cp311
+```
+
+If `--project` is omitted, the command uses the current directory.
+
+## Target presets
+
+- `current`
+- `linux-aarch64-cp311`
+- `linux-x86_64-cp311`
+- `windows-x86_64-cp311`
+
+Override individual environment markers:
+
+```bash
+poetry filter-lock \
+  --preset linux-aarch64-cp311 \
+  --env python_version=3.11 \
+  --env platform_machine=aarch64
+```
+
+Use `--preset current` to filter for the machine running the command.
+
+## Options
+
+```text
+--output PATH            Output lock file; default poetry.target.lock
+--preset NAME            Target environment preset
+--env KEY=VALUE          Override a marker environment value; repeatable
+--group NAME             Dependency group to retain; default main
+--include-optional       Keep optional packages
+--report PATH            Write a JSON filtering report
+--no-check               Do not require a fresh lock file
+```
+
+The standalone command also supports:
+
+```text
+--project PATH           Poetry project directory
+--lock PATH              Explicit lock file path
+```
+
+## Example report
+
+```json
+{
+  "status": "success",
+  "input": "poetry.lock",
+  "output": "poetry.target.lock",
+  "group": "main",
+  "target_environment": {
+    "python_version": "3.11",
+    "sys_platform": "linux",
+    "platform_machine": "aarch64"
+  },
+  "included_packages": ["linux-only"],
+  "excluded_packages": [
+    {
+      "package": "windows-only",
+      "reason": "marker",
+      "marker": "sys_platform == \"win32\""
+    }
+  ]
+}
+```
+
+## Dependency pruning
+
+The filter also removes dependency references from retained packages when the referenced package was excluded.
+
+For example, if `linux-only` depends on `linux-helper`, and both match the target environment, both are retained. If `linux-only` has a Windows-only dependency, that dependency edge is removed from the filtered lock.
+
+## Compatibility
+
+- Python 3.11 or newer
+- Poetry 2.1 or newer
+- Poetry lock format 2.1 or newer
+
+## Development
+
+```bash
+python -m venv .venv
+.venv/bin/python -m pip install -e .[dev]
+.venv/bin/python -m unittest discover -s tests -v
+```
+
+## License
+
+MIT
+
+
+## Related projects
+
+- [poetry-plugin-export](https://github.com/python-poetry/poetry-plugin-export) exports a Poetry lock file to requirements formats, but does not create a marker-filtered lock file.
+- [poetry-lock-package](https://github.com/bneijt/poetry-lock-package) turns a lock file into a pinned package, but does not filter packages by environment markers.
+- [ofiuco](https://github.com/oxidase/ofiuco) provides Bazel rules for cross-platform Poetry lock files, but is not a Poetry plugin or standalone marker filter.

poetry_plugin_lock_filter-0.1.0/README.md

@@ -0,0 +1,170 @@
+# poetry-plugin-lock-filter
+
+A Poetry 2.x plugin and standalone CLI for creating **marker-specific lock files**.
+
+Poetry writes a universal `poetry.lock` that contains every marker branch. Installation evaluates those markers at runtime, but the lock file itself remains broad. This project post-processes a Poetry lock file and keeps only packages whose markers match a selected target environment.
+
+## Why
+
+Given dependencies such as:
+
+```toml
+[tool.poetry.dependencies]
+linux-only = { version = "1.0", markers = "sys_platform == 'linux'" }
+windows-only = { version = "2.0", markers = "sys_platform == 'win32'" }
+```
+
+Poetry 2.4.1 writes both packages to `poetry.lock`, even when only one branch is active on the current machine.
+
+`poetry install` selects the correct packages, but tools that read `poetry.lock` directly often see both branches. This plugin produces a clean, target-specific lock file without changing the original.
+
+## Features
+
+- Poetry plugin command: `poetry filter-lock`
+- Standalone command: `poetry-lock-filter`
+- Presets for common target environments
+- Repeated `--env KEY=VALUE` overrides
+- Main-group filtering by default
+- Optional-package exclusion by default
+- Dependency pruning so retained packages only reference retained dependencies
+- JSON report output
+- Original `poetry.lock` is preserved by default
+
+## Installation
+
+Install as a Poetry plugin:
+
+```bash
+poetry self add git+https://github.com/RealDioBrando/poetry-plugin-lock-filter.git
+```
+
+Or install it as a normal Python package:
+
+```bash
+pip install git+https://github.com/RealDioBrando/poetry-plugin-lock-filter.git
+```
+
+## Poetry plugin usage
+
+Run inside a Poetry project:
+
+```bash
+poetry filter-lock
+```
+
+This reads the project’s `poetry.lock` and writes:
+
+```text
+poetry.target.lock
+```
+
+The default target environment is:
+
+```text
+Linux
+aarch64
+CPython 3.11
+```
+
+## Standalone usage
+
+```bash
+poetry-lock-filter \
+  --project /path/to/project \
+  --output poetry.target.lock \
+  --preset linux-aarch64-cp311
+```
+
+If `--project` is omitted, the command uses the current directory.
+
+## Target presets
+
+- `current`
+- `linux-aarch64-cp311`
+- `linux-x86_64-cp311`
+- `windows-x86_64-cp311`
+
+Override individual environment markers:
+
+```bash
+poetry filter-lock \
+  --preset linux-aarch64-cp311 \
+  --env python_version=3.11 \
+  --env platform_machine=aarch64
+```
+
+Use `--preset current` to filter for the machine running the command.
+
+## Options
+
+```text
+--output PATH            Output lock file; default poetry.target.lock
+--preset NAME            Target environment preset
+--env KEY=VALUE          Override a marker environment value; repeatable
+--group NAME             Dependency group to retain; default main
+--include-optional       Keep optional packages
+--report PATH            Write a JSON filtering report
+--no-check               Do not require a fresh lock file
+```
+
+The standalone command also supports:
+
+```text
+--project PATH           Poetry project directory
+--lock PATH              Explicit lock file path
+```
+
+## Example report
+
+```json
+{
+  "status": "success",
+  "input": "poetry.lock",
+  "output": "poetry.target.lock",
+  "group": "main",
+  "target_environment": {
+    "python_version": "3.11",
+    "sys_platform": "linux",
+    "platform_machine": "aarch64"
+  },
+  "included_packages": ["linux-only"],
+  "excluded_packages": [
+    {
+      "package": "windows-only",
+      "reason": "marker",
+      "marker": "sys_platform == \"win32\""
+    }
+  ]
+}
+```
+
+## Dependency pruning
+
+The filter also removes dependency references from retained packages when the referenced package was excluded.
+
+For example, if `linux-only` depends on `linux-helper`, and both match the target environment, both are retained. If `linux-only` has a Windows-only dependency, that dependency edge is removed from the filtered lock.
+
+## Compatibility
+
+- Python 3.11 or newer
+- Poetry 2.1 or newer
+- Poetry lock format 2.1 or newer
+
+## Development
+
+```bash
+python -m venv .venv
+.venv/bin/python -m pip install -e .[dev]
+.venv/bin/python -m unittest discover -s tests -v
+```
+
+## License
+
+MIT
+
+
+## Related projects
+
+- [poetry-plugin-export](https://github.com/python-poetry/poetry-plugin-export) exports a Poetry lock file to requirements formats, but does not create a marker-filtered lock file.
+- [poetry-lock-package](https://github.com/bneijt/poetry-lock-package) turns a lock file into a pinned package, but does not filter packages by environment markers.
+- [ofiuco](https://github.com/oxidase/ofiuco) provides Bazel rules for cross-platform Poetry lock files, but is not a Poetry plugin or standalone marker filter.

poetry_plugin_lock_filter-0.1.0/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "poetry-plugin-lock-filter"
+version = "0.1.0"
+description = "Poetry plugin and CLI for creating marker-specific lock files"
+readme = "README.md"
+license = { file = "LICENSE" }
+authors = [{ name = "RealDioBrando" }]
+requires-python = ">=3.11"
+dependencies = [
+  "packaging>=24.2",
+  "poetry>=2.1,<3",
+  "tomlkit>=0.11",
+]
+keywords = ["poetry", "plugin", "lock", "markers", "platform"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Software Development :: Build Tools",
+]
+
+[project.urls]
+Homepage = "https://github.com/RealDioBrando/poetry-plugin-lock-filter"
+Issues = "https://github.com/RealDioBrando/poetry-plugin-lock-filter/issues"
+
+[project.entry-points."poetry.application.plugin"]
+filter-lock = "poetry_plugin_lock_filter.plugin:FilterLockApplicationPlugin"
+
+[project.scripts]
+poetry-lock-filter = "poetry_plugin_lock_filter.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

poetry_plugin_lock_filter-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

poetry_plugin_lock_filter-0.1.0/src/poetry_plugin_lock_filter/__init__.py

@@ -0,0 +1,3 @@
+"""poetry-plugin-lock-filter."""
+
+__version__ = "0.1.0"

poetry_plugin_lock_filter-0.1.0/src/poetry_plugin_lock_filter/__main__.py

@@ -0,0 +1,6 @@
+"""Allow `python -m poetry_plugin_lock_filter`."""
+
+from poetry_plugin_lock_filter.cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

poetry_plugin_lock_filter-0.1.0/src/poetry_plugin_lock_filter/cli.py

@@ -0,0 +1,94 @@
+"""Standalone command-line interface for marker-specific Poetry lock filtering."""
+
+from __future__ import annotations
+
+import argparse
+import json
+from pathlib import Path
+
+from poetry_plugin_lock_filter.core import (
+    PRESETS,
+    LockFilterError,
+    build_environment,
+    filter_lock_file,
+    write_report,
+)
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="poetry-lock-filter",
+        description="Create a marker-specific Poetry lock file.",
+    )
+    parser.add_argument("--project", type=Path, default=Path.cwd())
+    parser.add_argument("--lock", type=Path)
+    parser.add_argument("--output", type=Path)
+    parser.add_argument(
+        "--preset",
+        choices=sorted(PRESETS),
+        default="linux-aarch64-cp311",
+    )
+    parser.add_argument(
+        "--env",
+        action="append",
+        default=[],
+        metavar="KEY=VALUE",
+        help="override a marker environment value; repeatable",
+    )
+    parser.add_argument("--group", default="main")
+    parser.add_argument("--include-optional", action="store_true")
+    parser.add_argument("--report", type=Path)
+    return parser
+
+
+def _parse_environment_overrides(values: list[str]) -> dict[str, str]:
+    overrides: dict[str, str] = {}
+    for value in values:
+        key, separator, environment_value = value.partition("=")
+        if not separator or not key.strip():
+            raise argparse.ArgumentTypeError(
+                f"Expected KEY=VALUE environment override, got {value!r}"
+            )
+        overrides[key.strip()] = environment_value
+    return overrides
+
+
+def _resolve(path: Path, project: Path) -> Path:
+    return path if path.is_absolute() else project / path
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = build_parser()
+    args = parser.parse_args(argv)
+    project = args.project.resolve()
+
+    try:
+        overrides = _parse_environment_overrides(args.env)
+        lock = args.lock.resolve() if args.lock else (project / "poetry.lock").resolve()
+        output = (
+            _resolve(args.output, project)
+            if args.output
+            else project / "poetry.target.lock"
+        )
+        report_path = _resolve(args.report, project) if args.report else None
+
+        environment = build_environment(args.preset, overrides)
+        report = filter_lock_file(
+            lock,
+            output,
+            environment,
+            group=args.group,
+            include_optional=args.include_optional,
+        )
+    except (LockFilterError, argparse.ArgumentTypeError) as error:
+        parser.exit(1, f"ERROR: {error}\n")
+
+    if report_path is not None:
+        write_report(report_path, report)
+
+    print(json.dumps(report, indent=2, ensure_ascii=False))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())