uv-upx 0.2.0__tar.gz

uv_upx-0.2.0/PKG-INFO

@@ -0,0 +1,186 @@
+Metadata-Version: 2.3
+Name: uv-upx
+Version: 0.2.0
+Summary: Upgrade versions of dependencies in pyproject.toml files in uv-managed projects.
+Keywords: uv,upgrade,dependencies,pyproject.toml,automation,cli
+Author: Alirex
+Author-email: Alirex <alirex.prime@gmail.com>
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: tomlkit>=0.13.3
+Requires-Dist: typer>=0.20.0
+Requires-Python: >=3.14
+Project-URL: Homepage, https://github.com/Alirex/uv_upgrade
+Description-Content-Type: text/markdown
+
+# Uv upgrade
+
+Upgrade dependencies in `pyproject.toml` files with `uv`.
+
+---
+
+# Install
+
+For end-users.
+
+Note: For developers, see the [dev](docs_extra/dev.md) section.
+
+## Uv install or update
+
+You need this for both usage and development.
+
+https://docs.astral.sh/uv/getting-started/installation/
+
+On Windows it can be better to use `Git Bash` terminal.
+
+```bash
+if ! command -v uv &> /dev/null; then
+    curl -LsSf https://astral.sh/uv/install.sh | sh;
+else
+    uv self update;
+fi
+
+uv --version
+```
+
+## Install or update a project for system-wide usage
+
+Run it from any directory, except the project directory.
+
+```shell
+if ! command -v uv-upgrade &> /dev/null; then
+    uv tool install git+https://github.com/Alirex/uv_upgrade
+else
+    uv tool upgrade uv-upx
+fi
+```
+
+Or run with uvx:
+
+```shell
+uvx uv-upx
+```
+
+Dev installation: [see here](docs_extra/dev.md#install-app-system-wide-in-development-mode)
+
+## Check that project in the list
+
+```shell
+uv tool list --show-python
+```
+
+## Remove the project with all data
+
+If you need to remove the project with all data, run this command from the project directory:
+
+```shell
+uv tool uninstall uv-upx
+```
+
+---
+
+# Usage
+
+## Run the tool in the folder with the pyproject.toml
+
+After installation, you can run the tool from any directory.
+
+```shell
+uv-upgrade
+```
+
+Also, you can run it with the `--help` flag with more details.
+
+## Notes
+
+### Uv as a source of truth
+
+Run `uv sync --all-groups --all-extras --all-packages --upgrade`.
+
+Get dependencies versions from `uv.lock`.
+
+Put them in `pyproject.toml` files in related groups.
+
+So, the main responsibility for dependencies resolution is on `uv`.
+
+### Workspace support
+
+It works with workspaces. At least for some basic cases.
+
+### Updates simple dependencies
+
+Updates `>=` dependencies. Like `bla>=2.0.0`.
+
+### Skip pinned versions
+
+It doesn't touch pinned versions. Like `bla==2.0.0`.
+
+### Respect simple ranges
+
+It respects simple dependency ranges. Like `bla>=1.0.0,<2.0.0`.
+
+It moves the lower bound to the new version.
+
+### Respect extras
+
+It respects extras. Like `bla[dev]>=1.0.0;python_version>="3.14"`.
+
+### Skip unhandled constraints
+
+It skips unhandled and complex constraints. Like:
+
+- `bla<=1.0.0`
+- `bla>=2.0.0,!=1.5.0,<3.0.0`
+
+### Style preservation
+
+It preserves comments in the `pyproject.toml` file. Like here:
+
+```toml
+dependencies = [
+    # Better classes and data validation
+    "pydantic>=2.12.5",
+    # TOML parser and writer with preserved formatting
+    "tomlkit>=0.13.3",
+    # CLI app framework
+    "typer>=0.20.0",
+]
+```
+
+### Rollback
+
+If something goes wrong, it rolls back the changes to the `pyproject.toml` and `uv.lock` files.
+
+### Why?
+
+I needed this for my own projects.
+
+I know these issues:
+
+- [Upgrade dependencies in pyproject.toml (uv upgrade)](https://github.com/astral-sh/uv/issues/6692)
+- [What is the intended workflow for updating dependencies with uv?](ttps://github.com/astral-sh/uv/issues/6794)
+
+But I didn't see enough progress.
+
+So, I implemented this tool for my own usage.
+
+Maybe it will be useful for someone else.
+
+### Why not in Rust?
+
+Because it's a temporary Proof-of-Concept.
+
+Maybe it will be replaced by Rust in the future.
+
+It uses type annotations anyway. For simpler migration.
+
+---
+
+# Dev
+
+[Dev](docs_extra/dev.md)
+
+---
+
+# Other similar tools comparison
+
+[Other similar tools comparison](docs_extra/other_similar_tools_comparison.md)

uv_upx-0.2.0/README.md

@@ -0,0 +1,172 @@
+# Uv upgrade
+
+Upgrade dependencies in `pyproject.toml` files with `uv`.
+
+---
+
+# Install
+
+For end-users.
+
+Note: For developers, see the [dev](docs_extra/dev.md) section.
+
+## Uv install or update
+
+You need this for both usage and development.
+
+https://docs.astral.sh/uv/getting-started/installation/
+
+On Windows it can be better to use `Git Bash` terminal.
+
+```bash
+if ! command -v uv &> /dev/null; then
+    curl -LsSf https://astral.sh/uv/install.sh | sh;
+else
+    uv self update;
+fi
+
+uv --version
+```
+
+## Install or update a project for system-wide usage
+
+Run it from any directory, except the project directory.
+
+```shell
+if ! command -v uv-upgrade &> /dev/null; then
+    uv tool install git+https://github.com/Alirex/uv_upgrade
+else
+    uv tool upgrade uv-upx
+fi
+```
+
+Or run with uvx:
+
+```shell
+uvx uv-upx
+```
+
+Dev installation: [see here](docs_extra/dev.md#install-app-system-wide-in-development-mode)
+
+## Check that project in the list
+
+```shell
+uv tool list --show-python
+```
+
+## Remove the project with all data
+
+If you need to remove the project with all data, run this command from the project directory:
+
+```shell
+uv tool uninstall uv-upx
+```
+
+---
+
+# Usage
+
+## Run the tool in the folder with the pyproject.toml
+
+After installation, you can run the tool from any directory.
+
+```shell
+uv-upgrade
+```
+
+Also, you can run it with the `--help` flag with more details.
+
+## Notes
+
+### Uv as a source of truth
+
+Run `uv sync --all-groups --all-extras --all-packages --upgrade`.
+
+Get dependencies versions from `uv.lock`.
+
+Put them in `pyproject.toml` files in related groups.
+
+So, the main responsibility for dependencies resolution is on `uv`.
+
+### Workspace support
+
+It works with workspaces. At least for some basic cases.
+
+### Updates simple dependencies
+
+Updates `>=` dependencies. Like `bla>=2.0.0`.
+
+### Skip pinned versions
+
+It doesn't touch pinned versions. Like `bla==2.0.0`.
+
+### Respect simple ranges
+
+It respects simple dependency ranges. Like `bla>=1.0.0,<2.0.0`.
+
+It moves the lower bound to the new version.
+
+### Respect extras
+
+It respects extras. Like `bla[dev]>=1.0.0;python_version>="3.14"`.
+
+### Skip unhandled constraints
+
+It skips unhandled and complex constraints. Like:
+
+- `bla<=1.0.0`
+- `bla>=2.0.0,!=1.5.0,<3.0.0`
+
+### Style preservation
+
+It preserves comments in the `pyproject.toml` file. Like here:
+
+```toml
+dependencies = [
+    # Better classes and data validation
+    "pydantic>=2.12.5",
+    # TOML parser and writer with preserved formatting
+    "tomlkit>=0.13.3",
+    # CLI app framework
+    "typer>=0.20.0",
+]
+```
+
+### Rollback
+
+If something goes wrong, it rolls back the changes to the `pyproject.toml` and `uv.lock` files.
+
+### Why?
+
+I needed this for my own projects.
+
+I know these issues:
+
+- [Upgrade dependencies in pyproject.toml (uv upgrade)](https://github.com/astral-sh/uv/issues/6692)
+- [What is the intended workflow for updating dependencies with uv?](ttps://github.com/astral-sh/uv/issues/6794)
+
+But I didn't see enough progress.
+
+So, I implemented this tool for my own usage.
+
+Maybe it will be useful for someone else.
+
+### Why not in Rust?
+
+Because it's a temporary Proof-of-Concept.
+
+Maybe it will be replaced by Rust in the future.
+
+It uses type annotations anyway. For simpler migration.
+
+---
+
+# Dev
+
+[Dev](docs_extra/dev.md)
+
+---
+
+# Other similar tools comparison
+
+[Other similar tools comparison](docs_extra/other_similar_tools_comparison.md)

uv_upx-0.2.0/pyproject.toml

@@ -0,0 +1,171 @@
+[project]
+name = "uv-upx"
+version = "0.2.0"
+
+description = "Upgrade versions of dependencies in pyproject.toml files in uv-managed projects."
+readme = "README.md"
+keywords = ["uv", "upgrade", "dependencies", "pyproject.toml", "automation", "cli"]
+
+license_files = ["LICENSE.txt"]
+
+authors = [
+    { name = "Alirex", email = "alirex.prime@gmail.com" }
+]
+
+requires-python = ">=3.14"
+dependencies = [
+    # Better classes and data validation
+    "pydantic>=2.12.5",
+    # TOML parser and writer with preserved formatting
+    "tomlkit>=0.13.3",
+    # CLI app framework
+    "typer>=0.20.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/Alirex/uv_upgrade"
+
+
+[dependency-groups]
+dev = [
+    # [typing]-[BEGIN]
+    # Static type checker
+    "mypy>=1.19.0",
+    # [typing]-[END]
+    # [testing]-[BEGIN]
+    "pytest>=9.0.2",
+    "pytest-benchmark>=5.2.3",
+    # [testing]-[END]
+    # Extra checker. Used by Zed.
+    "basedpyright>=1.36.0",
+    # Task runner
+    "poethepoet>=0.38.0",
+    # Dead code checker
+    "vulture>=2.14",
+    # Code complexity checker
+    "radon>=6.0.1",
+]
+
+[project.scripts]
+uv-upgrade = "uv_upx:main"
+
+[build-system]
+requires = ["uv_build>=0.9.15,<0.10.0"]
+build-backend = "uv_build"
+
+[tool.poe.tasks]
+pca= [
+    {cmd = "prek run --all-files"},
+]
+
+# Run with: poe metrics or uv run poe metrics
+# Check code quality: dead code, complexity, and maintainability
+metrics = [
+    {cmd = "vulture . --min-confidence 80 --exclude .venv,build,dist,docs,scripts,tests"},
+    {cmd = "radon cc . -a -nb"},
+    {cmd = "radon mi . -nb"}
+]
+
+# Run with: poe quality or uv run poe quality
+# Full quality check: format, lint, type check, and metrics
+quality = [
+    {cmd = "ruff format ."},
+    {cmd = "ruff check . --fix"},
+    {cmd = "basedpyright --level error"},
+    {cmd = "vulture . --min-confidence 80 --exclude .venv,build,dist,docs,scripts,tests"},
+    {cmd = "radon cc . -a -nb"}
+]
+
+
+[tool.pytest.ini_options]
+addopts = "--strict-markers"
+
+[tool.mypy]
+#plugins = [
+#    "pydantic.mypy",
+#]
+
+strict = true
+
+[tool.ruff]
+line-length = 120
+fix = true
+unsafe-fixes = true
+show-fixes = true
+
+extend-exclude = [
+]
+
+[tool.ruff.lint]
+extend-select = [
+    "ALL",
+]
+extend-ignore = [
+    # Missing docstring.
+    "D1",
+    # flake8-future-annotations.
+    "FA",
+    # Missing type annotation for self and cls.
+    "ANN1",
+    # f-strings to format logging messages.
+    "G004",
+    # Consider {expression} instead of string join.
+    "FLY002",
+    # TODOs
+    # Author.
+    "TD002",
+    # Link to issue
+    "TD003",
+    # Line contains a TODO or related comment
+    "FIX",
+    # Args and kwargs are not used and not annotated
+    "ANN002",
+    "ANN003",
+    # Commented code
+    "ERA001",
+    # empty-comment
+    "PLR2044",
+    #
+    #
+    # print used.
+    "T201",
+]
+
+task-tags = [
+    "TODO",
+    "FIXME",
+    "HACK",
+    "XXX",
+    "[",
+]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+# https://betterprogramming.pub/3-different-docstring-formats-for-python-d27be81e0d68
+
+[tool.ruff.lint.flake8-comprehensions]
+allow-dict-calls-with-keyword-arguments = true
+
+
+[tool.ruff.lint.extend-per-file-ignores]
+"__init__.py" = [
+    # Unused import.
+    "F401",
+]
+
+"test_*.py" = [
+    # Allow `assert` statements in tests.
+    "S101",
+]
+
+[tool.ruff.lint.flake8-type-checking]
+runtime-evaluated-base-classes = [
+    "pydantic.BaseModel",
+]
+runtime-evaluated-decorators = [
+    "pydantic.validate_call",
+    "app.command",
+]
+
+[tool.basedpyright]
+typeCheckingMode = "strict"

uv_upx-0.2.0/src/uv_upx/__init__.py

@@ -0,0 +1,5 @@
+from .main import main
+
+__all__ = [
+    "main",
+]

uv_upx-0.2.0/src/uv_upx/__main__.py

@@ -0,0 +1,4 @@
+from uv_upx.main import main
+
+if __name__ == "__main__":
+    main()

uv_upx-0.2.0/src/uv_upx/cli/main.py

@@ -0,0 +1,37 @@
+import pathlib  # noqa: TC003
+from typing import Annotated
+
+import typer
+
+from uv_upx.services.normalize_and_check_path_to_pyproject import normalize_and_check_path_to_project_root
+from uv_upx.services.run_updater import run_updater
+
+app = typer.Typer(
+    pretty_exceptions_enable=False,
+)
+
+
+@app.command()
+def run(
+    *,
+    project_root_path: Annotated[
+        pathlib.Path | None,
+        typer.Option(
+            "--project",
+            "-p",
+            help="Path to project root directory. Use current working directory if not specified.",
+        ),
+    ] = None,
+    #
+    dry_run: Annotated[bool, typer.Option("--dry-run", help="Show changes without writing file")] = False,
+    #
+    verbose: Annotated[bool, typer.Option("--verbose", help="Show more output")] = False,
+) -> None:
+    """Update pyproject.toml dependencies to latest PyPI releases."""
+    path = normalize_and_check_path_to_project_root(project_root_path)
+
+    run_updater(
+        project_root_path=path,
+        dry_run=dry_run,
+        verbose=verbose,
+    )

uv_upx-0.2.0/src/uv_upx/logging_custom/__init__.py

@@ -0,0 +1,5 @@
+from .init_logging import init_logging
+
+__all__ = [
+    "init_logging",
+]

uv_upx-0.2.0/src/uv_upx/logging_custom/init_logging.py

@@ -0,0 +1,8 @@
+import logging
+
+
+def init_logging() -> None:
+    logging.basicConfig(
+        level=logging.DEBUG,
+        format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
+    )

uv_upx-0.2.0/src/uv_upx/main.py

@@ -0,0 +1,7 @@
+from uv_upx.cli.main import app
+from uv_upx.logging_custom import init_logging
+
+
+def main() -> None:
+    init_logging()
+    app()

uv_upx-0.2.0/src/uv_upx/models/dependency_parsed.py

@@ -0,0 +1,36 @@
+from pydantic import BaseModel
+
+from uv_upx.services.get_deps_from_project import DependencyName
+
+
+class VersionConstraint(BaseModel):
+    operator: str
+    version: str
+
+
+class DependencyParsed(BaseModel):
+    # https://peps.python.org/pep-0508/
+
+    dependency_name: DependencyName
+    """Dependency name (e.g., requests)"""
+
+    extras: list[str] | None
+    """Extras (e.g., [dev])"""
+
+    version_constraints: list[VersionConstraint]
+    """Version constraints (e.g., >=1.2.3, ==4.5.6)"""
+
+    marker: str | None
+    """Environment marker (after ;)"""
+
+    def get_full_spec(self) -> str:
+        parts: list[str] = [self.dependency_name]
+        if self.extras:
+            extras_str = ",".join(self.extras)
+            parts.append(f"[{extras_str}]")
+        if self.version_constraints:
+            vc_strs = [f"{vc.operator}{vc.version}" for vc in self.version_constraints]
+            parts.append(",".join(vc_strs))
+        if self.marker:
+            parts.append(f"; {self.marker}")
+        return "".join(parts)

uv_upx-0.2.0/src/uv_upx/services/get_all_pyprojects.py

@@ -0,0 +1,62 @@
+import pathlib
+from typing import Any, cast
+
+from pydantic import BaseModel, ConfigDict
+from tomlkit import TOMLDocument
+
+from uv_upx.services.get_pyproject_paths_by_globs import get_pyproject_paths_by_globs
+from uv_upx.services.normalize_and_check_path_to_pyproject import get_and_check_path_to_pyproject
+from uv_upx.services.save_load_toml import load_toml
+
+
+class PyProjectWrapper(BaseModel):
+    path: pathlib.Path
+    data: TOMLDocument
+
+    model_config = ConfigDict(
+        arbitrary_types_allowed=True,
+    )
+
+
+class PyProjectsRegistry(BaseModel):
+    items: list[PyProjectWrapper]
+
+
+def get_all_pyprojects(
+    project_root_path: pathlib.Path,
+) -> PyProjectsRegistry:
+    """Find all pyproject.toml files in the project tree.
+
+    Use `workspaces` from uv.
+    """
+    items: list[PyProjectWrapper] = []
+
+    root_pyproject_path = get_and_check_path_to_pyproject(project_root_path)
+    root_pyproject_data = load_toml(root_pyproject_path)
+    items.append(PyProjectWrapper(path=root_pyproject_path, data=root_pyproject_data))
+
+    # Get workspaces_config
+    # https://docs.astral.sh/uv/concepts/projects/workspaces/
+
+    # Example:
+    # [tool.uv.workspace]
+    # members = ["packages/*"]
+    # exclude = ["packages/seeds"]
+
+    # TODO: (?) Improve this place for efficiency
+
+    workspaces_config: dict[str, Any] = root_pyproject_data.get("tool", {}).get("uv", {}).get("workspace", {})  # pyright: ignore[reportUnknownVariableType, reportUnknownMemberType]
+    members_i_relative_glob_based: list[str] = cast("list[str]", workspaces_config.get("members", []))  # pyright: ignore[reportUnknownVariableType, reportUnknownMemberType]
+    exclude_i_relative_glob_based: list[str] = cast("list[str]", workspaces_config.get("exclude", []))  # pyright: ignore[reportUnknownVariableType, reportUnknownMemberType]
+
+    # Use glob-based pattern matching to find all pyproject.toml files in the workspace
+    members_paths_set = get_pyproject_paths_by_globs(project_root_path, members_i_relative_glob_based)
+    exclude_paths_set = get_pyproject_paths_by_globs(project_root_path, exclude_i_relative_glob_based)
+
+    result_paths_set = members_paths_set - exclude_paths_set
+
+    for path in result_paths_set:
+        data = load_toml(path)
+        items.append(PyProjectWrapper(path=path, data=data))
+
+    return PyProjectsRegistry(items=items)