common-python-tasks 0.7.0__py3-none-any.whl → 0.9.0__py3-none-any.whl

common_python_tasks/__init__.py

@@ -11,6 +11,15 @@ __all__ = ["TaskCollection"]
 def tasks(
     include_tags: "Sequence[str] | None" = None, exclude_tags: "Sequence[str]" = tuple()
 ) -> dict:
+    """Return the task collection filtered by the requested tags.
+
+    Args:
+        include_tags: Tags that selected tasks must have. Defaults to `common`.
+        exclude_tags: Tags that selected tasks must not have.
+
+    Returns:
+        The filtered Poe task collection configuration.
+    """
     from .tasks import tasks as task_collection
 
     if include_tags is None and not exclude_tags:

common_python_tasks/__main__.py

@@ -9,6 +9,19 @@ from .tasks import tasks
 __all__ = ["get_available_tasks", "print_available_tasks"]
 
 
+def _is_package_task(task_name: str) -> bool:
+    task_config = tasks()["tasks"].get(task_name)
+    if not isinstance(task_config, dict):
+        return False
+
+    script = task_config.get("script")
+    if not isinstance(script, str) or ":" not in script:
+        return False
+
+    module_name, _ = script.split(":", 1)
+    return module_name.startswith("common_python_tasks.")
+
+
 def get_available_tasks(internal: bool = False) -> list[str]:
     """Return available task names for this package.
 
@@ -21,7 +34,7 @@ def get_available_tasks(internal: bool = False) -> list[str]:
     return [
         task_name
         for task_name in tasks()["tasks"]
-        if internal or not task_name.startswith("_")
+        if _is_package_task(task_name) and (internal or not task_name.startswith("_"))
     ]
 
 
@@ -49,8 +62,11 @@ def _get_task_docstring(task_name: str) -> str | None:
 
     module_name, func_name = script.split(":", 1)
 
-    module = importlib.import_module(module_name)
-    func = getattr(module, func_name)
+    try:
+        module = importlib.import_module(module_name)
+        func = getattr(module, func_name)
+    except (ImportError, AttributeError):
+        return None
 
     doc = inspect.getdoc(func)
     if not doc:

common_python_tasks/data/fastapi/compose-base.yml.j2

@@ -9,8 +9,7 @@ x-common-environment: &common-environment
 x-common-build-args: &common-build-args
   PACKAGE_NAME: ${PACKAGE_NAME}
   PYTHON_VERSION: ${PYTHON_VERSION}
-  PACKAGE_MANAGER: ${PACKAGE_MANAGER}
-  PACKAGE_MANAGER_VERSION: ${PACKAGE_MANAGER_VERSION}
+  UV_VERSION: ${UV_VERSION}
 
 services:
   api:

common_python_tasks/data/fastapi/compose-db.yml.j2

@@ -8,8 +8,7 @@ x-common-environment: &common-environment
 x-common-build-args: &common-build-args
   PACKAGE_NAME: ${PACKAGE_NAME}
   PYTHON_VERSION: ${PYTHON_VERSION}
-  PACKAGE_MANAGER: ${PACKAGE_MANAGER}
-  PACKAGE_MANAGER_VERSION: ${PACKAGE_MANAGER_VERSION}
+  UV_VERSION: ${UV_VERSION}
   WORKDIR_PATH: ${WORKDIR_PATH}
 
 services:

common_python_tasks/data/fastapi/compose-debug.yml.j2

@@ -22,7 +22,7 @@ services:
           path: ./src/${PACKAGE_UNDERSCORE_NAME}
           target: /${PACKAGE_UNDERSCORE_NAME}
         - action: rebuild
-          path: poetry.lock
+          path: uv.lock
     ports:
       - mode: ingress
         target: 5678

common_python_tasks/data/generic/.dockerignore

@@ -1,7 +1,7 @@
 *
 !dist/*.whl
 !pyproject.toml
-!poetry.lock
+!uv.lock
 !README.md
 !LICENSE
 

common_python_tasks/data/generic/Dockerfile.j2

@@ -7,33 +7,10 @@ ARG PYTHON_VERSION=3
 # See https://hub.docker.com/_/python for available variants
 ARG PYTHON_VARIANT=slim
 ARG WORKDIR_PATH=/workspace
-{% set package_manager = PACKAGE_MANAGER|default('poetry') %}
 
 FROM python:${PYTHON_VERSION} AS builder
 
 ARG PACKAGE_VERSION
-
-{% if package_manager == 'poetry' %}
-ARG POETRY_VERSION
-ARG POETRY_DYNAMIC_VERSIONING_PLUGIN_VERSION
-ARG POETRY_PLUGIN_EXPORT_VERSION
-
-# Bypass VCS-based version detection: use the host-computed version directly.
-# This avoids requiring a .git directory in the build context and prevents
-# false dirty-version detection from a partial working tree.
-ENV POETRY_DYNAMIC_VERSIONING_BYPASS=${PACKAGE_VERSION}
-
-# Install Poetry and required Poetry plugins for package build
-RUN --mount=type=cache,target=/root/.cache/pip,id=pip-cache{{ CACHE_ID_SUFFIX }} \
-    sh -c 'set -eu; \
-    poetry_spec="poetry"; \
-    if [ -n "${POETRY_VERSION:-}" ]; then poetry_spec="poetry==$POETRY_VERSION"; fi; \
-    dynamic_spec="poetry-dynamic-versioning[plugin]"; \
-    if [ -n "${POETRY_DYNAMIC_VERSIONING_PLUGIN_VERSION:-}" ]; then dynamic_spec="poetry-dynamic-versioning[plugin]==$POETRY_DYNAMIC_VERSIONING_PLUGIN_VERSION"; fi; \
-    export_spec="poetry-plugin-export"; \
-    if [ -n "${POETRY_PLUGIN_EXPORT_VERSION:-}" ]; then export_spec="poetry-plugin-export==$POETRY_PLUGIN_EXPORT_VERSION"; fi; \
-    pip install --root-user-action=ignore "$poetry_spec" "$dynamic_spec" "$export_spec"'
-{% else %}
 ARG UV_VERSION
 
 # Bypass VCS-based version detection: use the host-computed version directly.
@@ -48,7 +25,6 @@ RUN --mount=type=cache,target=/root/.cache/pip,id=pip-cache{{ CACHE_ID_SUFFIX }}
     else \
         pip install --root-user-action=ignore uv; \
     fi'
-{% endif %}
 
 # Build package
 WORKDIR /tmp/build
@@ -56,24 +32,15 @@ COPY . /tmp/build/
 
 {% if HAS_DEBUG_DEPS %}
 # Export debug requirements when the project defines a debug dependency group
-{% if package_manager == 'poetry' %}
-RUN --mount=type=cache,target=/root/.cache/pip,id=pip-cache{{ CACHE_ID_SUFFIX }} \
-    poetry export --only debug --without-hashes -f requirements.txt --output requirements-debug.txt
-{% else %}
 RUN --mount=type=cache,target=/root/.cache/uv,id=uv-cache{{ CACHE_ID_SUFFIX }} \
     uv export --group debug --no-hashes --format requirements-txt --output-file requirements-debug.txt
 {% endif %}
-{% endif %}
 
-# Build the wheel, caching the package-manager cache directory to speed up subsequent builds.
+# Build the wheel, caching the uv cache directory to speed up subsequent builds.
 # If running this in a CI system, you must be using a persistent builder to take
 # advantage of the cache mount, and you should configure your CI to persist the
 # cache directory between builds
-{% if package_manager == 'poetry' %}
-RUN --mount=type=cache,target=/root/.cache/pypoetry,id=pypoetry-cache{{ CACHE_ID_SUFFIX }} poetry build --format=wheel
-{% else %}
 RUN --mount=type=cache,target=/root/.cache/uv,id=uv-cache{{ CACHE_ID_SUFFIX }} uv build --wheel
-{% endif %}
 
 FROM python:${PYTHON_VERSION}-${PYTHON_VARIANT} AS runtime
 ARG WORKDIR_PATH=/workspace
@@ -93,17 +60,17 @@ ENV {{ env_var }}
 {%- endif %}
 
 ENV DEBIAN_FRONTEND=noninteractive
-{% if APT_PACKAGES %}
+{% if CONTAINER_APT_PACKAGES %}
 # Install optional runtime apt packages selected by Python-side template rendering
 RUN --mount=type=cache,target=/var/cache/apt,id=apt-cache{{ CACHE_ID_SUFFIX }} \
     --mount=type=cache,target=/var/lib/apt/lists,sharing=locked,id=apt-lists{{ CACHE_ID_SUFFIX }} \
-    apt-get update && apt-get install -y --no-install-recommends {{ APT_PACKAGES }}
+    apt-get update && apt-get install -y --no-install-recommends {{ CONTAINER_APT_PACKAGES }}
 {% endif %}
-{% if DEPS_IMAGE %}
+{% if CONTAINER_DEPS_IMAGE %}
 
 # Pull external dependencies from the pre-built deps image
-ARG DEPS_IMAGE
-COPY --from={{ DEPS_IMAGE }} /tmp/deps /tmp/deps
+ARG CONTAINER_DEPS_IMAGE
+COPY --from={{ CONTAINER_DEPS_IMAGE }} /tmp/deps /tmp/deps
 {% endif %}
 {% if CONTAINER_DEPS_MOVE_SCRIPT %}
 RUN set -eux; \

common_python_tasks/data/generic/ruff.toml

@@ -1,6 +1,2 @@
 line-length = 88
-extend-exclude = [".dist", ".poetry", "build"]
-
-[lint]
-select = ["E4", "E7", "E9", "F", "I", "W"]
-ignore = ["W191"]
+extend-exclude = [".dist", "build"]