python-update-checker 0.6__py3-none-any.whl → 0.7__py3-none-any.whl

puc/dependencies.py

@@ -4,6 +4,7 @@
 
 import subprocess
 import re
+import logging
 from packaging.requirements import Requirement
 from packaging.markers import Variable, MarkerList
 from packaging.version import parse as parse_version
@@ -12,9 +13,9 @@ from .logging import logger
 
 def get_latest_version(
     package: str,
-    exclude_newer: None | str = None,
-    exclude_newer_package: None | str = None,
-    constraint_file: None | str = None,
+    exclude_newer: str | None = None,
+    exclude_newer_package: str | None = None,
+    constraint_file: str | None = None,
     python_platform: str | None = None,
     python_version: str | None = None,
 ) -> str:
@@ -28,12 +29,15 @@ def get_latest_version(
         "compile",
         "-",
         "--color=never",
-        "--quiet",
         "--no-deps",
         "--no-header",
         "--no-annotate",
         "--no-progress",
     ]
+    if logger.getEffectiveLevel() <= logging.DEBUG:
+        cmd.append("--verbose")
+    else:
+        cmd.append("--quiet")
     if exclude_newer:
         cmd.extend(("--exclude-newer", exclude_newer))
     if exclude_newer_package:
@@ -122,9 +126,9 @@ def get_min_python_version_from_req(pkg_req: Requirement) -> str | None:
 
 def parse_requirement(
     line: str,
-    exclude_newer: None | str = None,
-    constraint_file: None | str = None,
-) -> None | str | Requirement:
+    exclude_newer: str | None = None,
+    constraint_file: str | None = None,
+) -> str | Requirement | None:
     """Parse one line of a requirements.txt file."""
     line = line.strip()
     if not line or line.startswith("#"):

puc/pyprojecttoml.py

@@ -5,6 +5,7 @@
 import subprocess
 import os
 import tomllib
+import logging
 from packaging.utils import canonicalize_name
 from packaging.requirements import Requirement
 
@@ -14,16 +15,17 @@ from .dependencies import (
     get_python_platform_from_req,
     get_min_python_version_from_req,
     check_requirement,
+    is_newer_version,
 )
 
 
 def handle_pyproject_toml(
     pyproject_path: str,
-    command: None | str = None,
+    command: str | None = None,
     packages=None,
-    exclude_newer: None | str = None,
-    exclude_newer_package: None | str = None,
-    constraint_file: None | str = None,
+    exclude_newer: str | None = None,
+    exclude_newer_package: str | None = None,
+    constraint_file: str | None = None,
     color: bool = True,
 ) -> int:
     """Check or update pinned dependencies of a pyproject.toml file.
@@ -96,13 +98,13 @@ def update_pyproject_dependencies(
     dependencies: list[str | dict],
     project_dir: str,
     projectname: str,
-    group: None | str = None,
+    group: str | None = None,
     optional=False,
-    command: None | str = None,
+    command: str | None = None,
     packages=None,
-    exclude_newer: None | str = None,
-    exclude_newer_package: None | str = None,
-    constraint_file: None | str = None,
+    exclude_newer: str | None = None,
+    exclude_newer_package: str | None = None,
+    constraint_file: str | None = None,
     color: bool = True,
 ) -> int:
     """Update given dependency list of a pyproject.toml file."""
@@ -140,6 +142,10 @@ def update_pyproject_dependencies(
         spec = next(s for s in pkg_req.specifier)
         if latest_version is not None and latest_version != spec.version:
             updatable += 1
+            if not is_newer_version(spec.version, latest_version):
+                logger.warning(
+                    f"{pkg_req.name} latest version {latest_version} is older than specified version {spec.version}"
+                )
             version = (
                 colorize_updated_version(spec.version, latest_version)
                 if color
@@ -160,7 +166,7 @@ def update_pyproject_pkg(
     dependency: str,
     package: str,
     projectdir: str,
-    group: None | str = None,
+    group: str | None = None,
     optional: bool = False,
 ) -> None:
     """Update one package in pyproject.toml."""
@@ -169,11 +175,15 @@ def update_pyproject_pkg(
         "add",
         "--project",
         projectdir,
-        "--quiet",
         "--frozen",
         "--color=never",
-        f"--upgrade-package={package}",
+        "--upgrade-package",
+        package,
     ]
+    if logger.getEffectiveLevel() <= logging.DEBUG:
+        command.append("--verbose")
+    else:
+        command.append("--quiet")
     if optional and group:
         command.append("--optional")
         command.append(group)

puc/requirementstxt.py

@@ -14,6 +14,7 @@ from .dependencies import (
     get_python_platform_from_req,
     get_min_python_version_from_req,
     parse_requirement,
+    is_newer_version,
 )
 
 
@@ -23,11 +24,11 @@ max_rec_level = 5
 
 def handle_requirements_txt(
     requirements_txt_path: str,
-    command: None | str = None,
+    command: str | None = None,
     packages=None,
-    exclude_newer: None | str = None,
-    exclude_newer_package: None | str = None,
-    constraint_file: None | str = None,
+    exclude_newer: str | None = None,
+    exclude_newer_package: str | None = None,
+    constraint_file: str | None = None,
     color: bool = True,
     rec_level: int = 0,
     handled_files: list[str] | None = None,
@@ -91,6 +92,10 @@ def handle_requirements_txt(
                     output.write(line)
                 elif latest_version is not None and latest_version != spec.version:
                     updatable += 1
+                    if not is_newer_version(spec.version, latest_version):
+                        logger.warning(
+                            f"{pkg_req.name} latest version {latest_version} is older than specified version {spec.version}"
+                        )
                     version = (
                         colorize_updated_version(spec.version, latest_version)
                         if color

puc/uvlock.py

@@ -16,11 +16,11 @@ from .dependencies import (
 
 def handle_uv_lock(
     uvlock_path: str,
-    command: None | str = None,
+    command: str | None = None,
     packages=None,
-    exclude_newer: None | str = None,
-    exclude_newer_package: None | str = None,
-    constraint_file: None | str = None,
+    exclude_newer: str | None = None,
+    exclude_newer_package: str | None = None,
+    constraint_file: str | None = None,
     color: bool = True,
 ) -> int:
     """Check or update pinned dependencies of a uv.lock file."""
@@ -69,11 +69,11 @@ def update_uvlock_dependency(
     package,
     version,
     project_dir: str,
-    command: None | str = None,
+    command: str | None = None,
     packages=None,
-    exclude_newer: None | str = None,
-    exclude_newer_package: None | str = None,
-    constraint_file: None | str = None,
+    exclude_newer: str | None = None,
+    exclude_newer_package: str | None = None,
+    constraint_file: str | None = None,
     color: bool = True,
 ) -> int:
     """Update uv lock dependency."""
@@ -114,7 +114,7 @@ def update_uvlock_dependency(
 def update_uvlock_pkg(
     package: str,
     projectdir: str,
-    exclude_newer: None | str = None,
+    exclude_newer: str | None = None,
 ) -> None:
     """Update one package in pyproject.toml."""
     command = [
@@ -124,7 +124,8 @@ def update_uvlock_pkg(
         projectdir,
         "--quiet",
         "--color=never",
-        f"--upgrade-package={package}",
+        "--upgrade-package",
+        package,
     ]
     if exclude_newer:
         command.extend(

{python_update_checker-0.6.dist-info → python_update_checker-0.7.dist-info}/METADATA

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: python-update-checker
-Version: 0.6
+Version: 0.7
 License-Expression: GPL-3.0-only
+Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
-Classifier: Development Status :: 4 - Beta
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.11
@@ -16,21 +16,25 @@ Requires-Dist: packaging>=26.1
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 
-python-update-checker
-======================
+# python-update-checker
+
 Python-update-checker (puc) checks or updates pinned dependencies
 in `pyproject.toml`, `requirements.txt` or `uv.lock` files.
 
-See https://github.com/astral-sh/uv/issues/6794 for a discussion
-about different pinning strategies.
+If you are developing an application you should pin all dependencies.
+When developing a library, only development dependencies should be pinned.
+Since puc updates pinned dependencies, it is mostly suitable
+when developing applications.
 
+See [https://github.com/astral-sh/uv/issues/6794] for a discussion
+about different pinning strategies.
 
-Features
----------
+## Features
 
 * updates pinned dependencies, ignores unpinned dependencies
 * supports pyproject.toml, uv.lock and requirements.txt formats
-* supports `[project.dependencies]`, `[project.optional-dependencies]` and `[dependency-groups]` in pyproject.toml
+* supports `[project.dependencies]`, `[project.optional-dependencies]`
+  and `[dependency-groups]` in pyproject.toml
 * supports recursive references (-r) in requirements.txt formats
 * can run in check only mode, ie. it checks if updates are available
 * limit updates to specific packages
@@ -39,11 +43,18 @@ Features
 * (limited) support for environment markers, ie. `"pywin32==311; os_name=='nt'"`
 * runs on Linux, MacOS and Windows platforms
 
+## Quickstart
+
+```bash
+
+uvx --from python-update-checker puc --exclude-newer "1 day" update pyproject.toml
+uv sync
+```
 
-Examples
----------
+## Examples
 
 ```bash
+
 $ # check all pinned packages for updates in pyproject.toml
 $ puc check pyproject.toml
 puc INFO: check pyproject file pyproject.toml
@@ -55,6 +66,8 @@ $ puc --exclude-newer="7 days" update pyproject.toml
 puc INFO: update pyproject file pyproject.toml
 puc INFO: updating 'ty==0.0.29' --> 0.0.31
 puc INFO: Wrote 1 updated package version(s) to pyproject.toml
+$ # update the project environment after upgrading pyproject.toml
+$ uv sync
 
 $ # check all pinned packages for updates in requirements.txt
 $ puc check requirements.txt
@@ -65,52 +78,49 @@ puc WARNING: found update 'Django==5.2.0' --> 6.0.4
 $ # update only the django package version in requirements.txt
 $ # limit updates to django versions less than 6
 $ puc --package="Django" --constraints="Django<6" update requirements.txt
-INFO: update requirements file requirements.txt
-INFO: updating 'Django==5.2.0' --> 5.2.13
-INFO: Wrote 1 updated package version(s) to requirements.txt
+puc INFO: update requirements file requirements.txt
+puc INFO: updating 'Django==5.2.0' --> 5.2.13
+puc INFO: Wrote 1 updated package version(s) to requirements.txt
 ```
 
-Script behaviour
------------------
+## Script behaviour
 
 The exit code of `puc check` is non-zero when updates are available.
 
 Checking a `pyproject.toml` or `uv.lock`file with `puc` should be done
 from the directory of the `pyproject.toml` file,
-especially if your project relies on a [project directory](https://docs.astral.sh/uv/concepts/projects/layout/) (for example to define additional package indexes in pyproject.toml).
+especially if your project relies on a [project directory](https://docs.astral.sh/uv/concepts/projects/layout/)
+(for example to define additional package indexes in pyproject.toml).
 
 After updating versions in pyproject.toml, run `uv lock --upgrade` to update
-the transitive dependencies in `uv.lock`.
-
-Pinned dependencies are packages with `==` or `===` constraints and no wildcards in the version.
+the transitive dependencies in `uv.lock` and `uv sync` to update your
+virtual environment.
 
+Pinned dependencies are packages with `==` or `===` constraints
+and no wildcards in the version.
 
-Installation
--------------
+## Installation
 
 1) Install [python uv](https://docs.astral.sh/uv/getting-started/installation/)
-2) Install puc with `uv pip install python-update-checker`.
+2) Install puc with `uv pip install python-update-checker`
+  or run with `uvx --from python-update-checker puc ...`
 
-
-
-Architecture
--------------
+## Architecture
 
 Dependencies are
 
 * [uv](https://docs.astral.sh/uv/):
   The uv binary must be available for the script to call.  
   puc uses `echo "package" | uv pip compile -` to get latest package versions.  
-  puc uses `uv add "package==<version>"` to update pyproject.toml dependencies.
+  puc uses `uv add "package==<version>"` to update pyproject.toml
+  dependencies and `uv lock --upgrade-package` to update uv.lock dependencies.
 
 * [packaging](https://packaging.pypa.io/):
   Parses dependencies with the packaging.requirements.Requirement class.
 
 puc needs Python >= 3.11 since it uses the tomllib Python module.
 
-
-Limitations
-------------
+## Limitations
 
 * No support for custom dependency formats in pyproject.toml
   (eg. `[tool.poetry.dependencies]`).

python_update_checker-0.7.dist-info/RECORD

@@ -0,0 +1,11 @@
+puc/__init__.py,sha256=QCJeo6rsztgAeIuufaaId2f-x_XYLjs4UywOPp4w7ks,67
+puc/cli.py,sha256=mzbs7TZsuI0_PgRgIAzHRxmKDa02cBrLjtn7qTE2wwQ,7417
+puc/dependencies.py,sha256=4XLPiCnulGVT29bVB6Blkh9irjUGxfChP01YqqofYTw,6717
+puc/logging.py,sha256=VBojYqr7-l-aLeNqrBqTJyHuEINzdBx1CObQg5XiC-k,2222
+puc/pyprojecttoml.py,sha256=pJxA9oZoxiiB7b06yr0hub7um1A1eyrKf7WgPf1KBEU,6905
+puc/requirementstxt.py,sha256=xzEKVmWvZVbIQt9lZ0hVykOapn8xX24a7FixX1dY4lU,5076
+puc/uvlock.py,sha256=O_y3iwJ4pfq0wtrDYJoOdmAHn2XY71N0Iql0ycrRoW0,4160
+python_update_checker-0.7.dist-info/WHEEL,sha256=y6e-a5KI2W-qDAJKfh9Xr81bin8NgUdfWgz3VSXXpe4,80
+python_update_checker-0.7.dist-info/entry_points.txt,sha256=mQuGfBukyjyo7ssOHSIycAlRdQkrA1ewAth6tsV_T60,38
+python_update_checker-0.7.dist-info/METADATA,sha256=5rmVjEA_PA4so2oFay-ZbrocnMn7TlYWZQ_cxe1yGxE,4883
+python_update_checker-0.7.dist-info/RECORD,,

{python_update_checker-0.6.dist-info → python_update_checker-0.7.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: uv 0.11.14
+Generator: uv 0.12.9
 Root-Is-Purelib: true
 Tag: py3-none-any

python_update_checker-0.6.dist-info/RECORD

@@ -1,11 +0,0 @@
-puc/__init__.py,sha256=QCJeo6rsztgAeIuufaaId2f-x_XYLjs4UywOPp4w7ks,67
-puc/cli.py,sha256=mzbs7TZsuI0_PgRgIAzHRxmKDa02cBrLjtn7qTE2wwQ,7417
-puc/dependencies.py,sha256=RySjC6TLJVypWBQpiW-7RmoKm1qGbb_4eR-3C3UtEkw,6597
-puc/logging.py,sha256=VBojYqr7-l-aLeNqrBqTJyHuEINzdBx1CObQg5XiC-k,2222
-puc/pyprojecttoml.py,sha256=EgcJrKU4oz5sa16PyARKacjSL9AJt7xaXkv8lOVk4OA,6515
-puc/requirementstxt.py,sha256=Tv6-b14ko9HLmaYRanqtH7y0WSXUxNi8I5QqzbbjbyY,4788
-puc/uvlock.py,sha256=NCrottrNvId2Klwt4eI9Gi8ZIVQ_3pEC_uYLM-nqDW4,4154
-python_update_checker-0.6.dist-info/WHEEL,sha256=fWriCkzqm-pffF5af4gJC9iI5FMFaJTuN9UxxxzOmdY,81
-python_update_checker-0.6.dist-info/entry_points.txt,sha256=mQuGfBukyjyo7ssOHSIycAlRdQkrA1ewAth6tsV_T60,38
-python_update_checker-0.6.dist-info/METADATA,sha256=bEEB2OTxGN15FAeGv-JY57FT_nXkVerT1dfxQd8Sa2s,4350
-python_update_checker-0.6.dist-info/RECORD,,