common-python-tasks 0.13.0__tar.gz → 0.13.1__tar.gz

{common_python_tasks-0.13.0 → common_python_tasks-0.13.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: common-python-tasks
-Version: 0.13.0
+Version: 0.13.1
 Summary: Opinionated Poe the Poet tasks for Python package development.
 Project-URL: Homepage, http://github.com/ci-sourcerer/common-python-tasks
 Project-URL: Source, http://github.com/ci-sourcerer/common-python-tasks.git
@@ -42,7 +42,7 @@ Read the [complete documentation](https://common-python-tasks.ci-sourcerer.com/)
 Add the package as a development dependency.
 
 ```shell
-uv add --dev common-python-tasks==0.13.0
+uv add --dev common-python-tasks==0.13.1
 ```
 
 Expose the default task set in `pyproject.toml`.
@@ -74,7 +74,6 @@ include_script = "common_python_tasks:tasks(include_tags=['common', 'docs', 'con
 | `common` | Formatting, linting, testing, packaging, and releases |
 | `docs` | Build and serve Zensical documentation |
 | `containers` | Build, run, inspect, and publish container images |
-| `fastapi` | Run the FastAPI and PostgreSQL development stack |
 
 Documentation projects can build locally or start a development server.
 

{common_python_tasks-0.13.0 → common_python_tasks-0.13.1}/README.md

@@ -9,7 +9,7 @@ Read the [complete documentation](https://common-python-tasks.ci-sourcerer.com/)
 Add the package as a development dependency.
 
 ```shell
-uv add --dev common-python-tasks==0.13.0
+uv add --dev common-python-tasks==0.13.1
 ```
 
 Expose the default task set in `pyproject.toml`.
@@ -41,7 +41,6 @@ include_script = "common_python_tasks:tasks(include_tags=['common', 'docs', 'con
 | `common` | Formatting, linting, testing, packaging, and releases |
 | `docs` | Build and serve Zensical documentation |
 | `containers` | Build, run, inspect, and publish container images |
-| `fastapi` | Run the FastAPI and PostgreSQL development stack |
 
 Documentation projects can build locally or start a development server.
 

{common_python_tasks-0.13.0 → common_python_tasks-0.13.1}/docs/configuration.md

@@ -70,19 +70,6 @@ Container variables are read by the host-side tasks unless their description exp
 | `CONTAINER_DEPS_MOVE_SCRIPT` | Inline script that distributes copied dependency artifacts and takes precedence over mappings |
 | `CONTAINER_DEPS_MOVE_SCRIPT_PATH` | Host path to a dependency move script; takes precedence over the inline script and mappings |
 
-## Development-stack settings
-
-Set `COMPOSE_TYPE=fastapi` to use the bundled FastAPI stack. Add PostgreSQL with `COMPOSE_ADDONS=db`.
-
-```toml
-[tool.poe.env]
-COMPOSE_TYPE = "fastapi"
-COMPOSE_ADDONS = "db"
-API_PORT = "8080"
-DB_PORT = "5432"
-```
-
-`COMPOSE_FILE` replaces automatic compose-file selection. `COMPOSE_OVERLAY_FILES` appends project-specific overlays to the automatically selected files.
 
 ## Diagnostics
 

{common_python_tasks-0.13.0 → common_python_tasks-0.13.1}/docs/getting-started.md

@@ -36,7 +36,7 @@ Use `exclude_tags` when a project wants nearly every group.
 
 ```toml
 [tool.poe]
-include_script = "common_python_tasks:tasks(exclude_tags=['fastapi'])"
+include_script = "common_python_tasks:tasks(exclude_tags=['containers'])"
 ```
 
 Calling `tasks()` with no arguments selects only `common`. Passing an explicit empty `include_tags` sequence selects every task unless an exclusion removes it.

{common_python_tasks-0.13.0 → common_python_tasks-0.13.1}/docs/index.md

@@ -18,7 +18,6 @@ Tasks are organized by tags, so each project can select only the workflows it ne
 | `common` | Formatting, linting, testing, packaging, and releases |
 | `docs` | Build and locally serve Zensical documentation |
 | `containers` | Build, run, inspect, and publish container images |
-| `fastapi` | Run a local FastAPI and PostgreSQL development stack |
 
 The default task collection exposes the `common` group. Optional groups are enabled through the package's `include_script` expression.
 

{common_python_tasks-0.13.0 → common_python_tasks-0.13.1}/docs/tasks/index.md

@@ -10,7 +10,6 @@ The task reference is divided by workflow. Each category page includes a table l
 | [Documentation](documentation.md) | Build and locally serve a Zensical site |
 | [Packaging and releases](packaging-and-releases.md) | Build, version, publish, and release packages |
 | [Container images](container-images.md) | Build, run, inspect, and publish images |
-| [Development stacks](development-stacks.md) | Operate the FastAPI and PostgreSQL Compose stack |
 
 Individual task reference pages are also available in the sidebar under the "reference" section.
 

{common_python_tasks-0.13.0 → common_python_tasks-0.13.1}/docs/tasks/packaging-and-releases.md

@@ -10,12 +10,14 @@ Publish targets and release hooks are described in [Configuration](../configurat
 
 | Task | Description |
 | - | - |
+| [`update-dependencies`](reference/update-dependencies.md) | Update project dependencies with uv. |
 | [`publish-package`](reference/publish-package.md) | Publish the package to the PyPI server. |
 | [`publish-github-release`](reference/publish-github-release.md) | Publish or update a GitHub Release for the current repository. |
-| [`update-dependencies`](reference/update-dependencies.md) | Update project dependencies with uv. |
 | [`build-package`](reference/build-package.md) | Build the package (wheel and sdist). |
 | [`bump-version`](reference/bump-version.md) | Bump the project version. |
 | [`changelog`](reference/changelog.md) | Print the changelog for the current version based on git history and git-cliff. |
 | [`release`](reference/release.md) | Run a full release flow for package and containers. |
 
 <!-- end-generated-task-reference -->
+
+Automatic releases default to a patch bump when no version bump is inferred, including when there are no new commits. Empty generated release notes use “No conventional commit messages found.” No synthetic commits are created for version inference.

{common_python_tasks-0.13.0 → common_python_tasks-0.13.1}/pyproject.toml

@@ -38,13 +38,11 @@ Source = "http://github.com/ci-sourcerer/common-python-tasks.git"
 Issues = "http://github.com/ci-sourcerer/common-python-tasks/issues"
 
 [tool.poe]
-include_script = "common_python_tasks:tasks(exclude_tags=['containers', 'fastapi'])"
+include_script = "common_python_tasks:tasks(exclude_tags=['containers'])"
 
 [tool.poe.tasks]
 update-docs-references = { cmd = "python -m scripts.update_docs_tasks_reference" }
 check-docs-references = { cmd = "python -m scripts.update_docs_tasks_reference --check" }
-update-docs-tasks-reference = { cmd = "python -m scripts.update_docs_tasks_reference" }
-check-docs-tasks-reference = { cmd = "python -m scripts.update_docs_tasks_reference --check" }
 
 [tool.poe.env]
 PYTHONPATH = "src"

{common_python_tasks-0.13.0 → common_python_tasks-0.13.1}/scripts/docs_tasks_reference.py

@@ -17,7 +17,6 @@ TASK_CATEGORY_FILES = {
     "documentation": Path("docs/tasks/documentation.md"),
     "packaging-and-releases": Path("docs/tasks/packaging-and-releases.md"),
     "container-images": Path("docs/tasks/container-images.md"),
-    "development-stacks": Path("docs/tasks/development-stacks.md"),
 }
 DOCKERFILE_REFERENCE_FILE = Path("docs/tasks/container-images.md")
 DOCKERFILE_TEMPLATE_FILES = (
@@ -36,8 +35,6 @@ def _get_task_category(task_name: str) -> str:
     tags = get_task_tags(task_name) or []
     if "docs" in tags:
         return "documentation"
-    if "web" in tags or "database" in tags:
-        return "development-stacks"
     if task_name == "release":
         return "packaging-and-releases"
     if "containers" in tags:

common_python_tasks-0.13.1/src/common_python_tasks/_task_registry.py

@@ -0,0 +1,163 @@
+import contextvars
+import inspect
+import logging
+import os
+import shlex
+from collections.abc import Callable
+from functools import partial, wraps
+from pathlib import Path
+from typing import ClassVar
+
+from poethepoet_tasks import TaskCollection
+
+
+class _ColoredFormatter(logging.Formatter):
+    COLORS: ClassVar = {
+        "WARNING": "\033[93m",
+        "ERROR": "\033[91m",
+        "CRITICAL": "\033[91m",
+        "RESET": "\033[0m",
+    }
+
+    def format(self, record: logging.LogRecord) -> str:
+        log_color = self.COLORS.get(record.levelname, "")
+        record.levelname = f"\033[1m{log_color}{record.levelname}{self.COLORS['RESET'] if log_color else ''}\033[0m"
+        return super().format(record)
+
+
+LOGGER = logging.getLogger("common_python_tasks")
+handler = logging.StreamHandler()
+handler.setFormatter(_ColoredFormatter("[%(asctime)s] %(levelname)s: %(message)s"))
+LOGGER.addHandler(handler)
+LOGGER.setLevel(
+    {
+        "DEBUG": logging.DEBUG,
+        "INFO": logging.INFO,
+        "WARNING": logging.WARNING,
+        "ERROR": logging.ERROR,
+        "CRITICAL": logging.CRITICAL,
+    }[os.getenv("COMMON_PYTHON_TASKS_LOG_LEVEL", "INFO").upper()]
+)
+
+
+tasks = TaskCollection(
+    envfile=[
+        f
+        for f in [
+            ".env.defaults",
+            "project.properties",
+            ".env",
+        ]
+        if Path(f).exists()
+    ]
+)
+
+_task_call_depth: contextvars.ContextVar[int] = contextvars.ContextVar(
+    "common_python_tasks_task_call_depth", default=0
+)
+
+_original_script = tasks.script
+
+
+def _make_var_positional_task_args_optional(
+    func: callable, resolved_task_name: str
+) -> None:
+    var_positional_arg_names = {
+        param.name
+        for param in inspect.signature(func).parameters.values()
+        if param.kind == inspect.Parameter.VAR_POSITIONAL
+    }
+    if not var_positional_arg_names:
+        return
+
+    for task_config in tasks._tasks.get(resolved_task_name, []):
+        for arg_config in task_config.options.get("args", []):
+            if arg_config.get("name") in var_positional_arg_names:
+                arg_config["required"] = False
+
+
+def _wrap_task_function(func: callable, task_name: str | None) -> callable:
+    resolved_task_name = task_name or func.__name__.replace("_", "-").lower()
+    var_positional_arg_names = [
+        param.name
+        for param in inspect.signature(func).parameters.values()
+        if param.kind == inspect.Parameter.VAR_POSITIONAL
+    ]
+
+    @wraps(func)
+    def wrapped(*args, **kwargs):
+        for arg_name in var_positional_arg_names:
+            if arg_name not in kwargs:
+                continue
+            values = kwargs.pop(arg_name)
+            if values is None:
+                continue
+            if isinstance(values, list | tuple):
+                args = (*args, *values)
+            else:
+                args = (*args, values)
+
+        if var_positional_arg_names and (
+            poe_extra_args := os.environ.pop("POE_EXTRA_ARGS", None)
+        ):
+            args = (*args, *shlex.split(poe_extra_args))
+
+        current_depth = _task_call_depth.get()
+        if current_depth > 0:
+            LOGGER.log(
+                (
+                    logging.INFO
+                    if not resolved_task_name.startswith("_")
+                    else logging.DEBUG
+                ),
+                "Running task %s",
+                resolved_task_name,
+            )
+        token = _task_call_depth.set(current_depth + 1)
+        try:
+            return func(*args, **kwargs)
+        finally:
+            _task_call_depth.reset(token)
+
+    return wrapped
+
+
+def _script(
+    func: Callable | None = None,
+    task_name: str | None = None,
+    help: str | None = None,
+    task_args: bool = True,
+    options: dict | None = None,
+    tags: tuple[str, ...] | None = None,
+):
+
+    if tags is None:
+        tags = ()
+
+    if func is None:
+        return partial(
+            _script,
+            task_name=task_name,
+            help=help,
+            task_args=task_args,
+            options=options,
+            tags=tags,
+        )
+
+    resolved_task_name = task_name or func.__name__.replace("_", "-").lower()
+    wrapped = _wrap_task_function(func, resolved_task_name)
+    decorated = _original_script(
+        wrapped,
+        task_name=resolved_task_name,
+        help=help,
+        task_args=task_args,
+        options=options,
+        tags=tags,
+    )
+    _make_var_positional_task_args_optional(wrapped, resolved_task_name)
+    return decorated
+
+
+tasks.script = _script
+
+NO_PROMPT_ENV_VAR = "COMMON_PYTHON_TASKS_NO_PROMPT"