common-python-tasks 0.4.0__tar.gz → 0.4.1__tar.gz

common_python_tasks-0.4.1/.gitignore

@@ -0,0 +1,216 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#   Usually these files are written by a python script from a template
+#   before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+# Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+poetry.lock
+# poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+# pdm.lock
+# pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+# pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# Redis
+*.rdb
+*.aof
+*.pid
+
+# RabbitMQ
+mnesia/
+rabbitmq/
+rabbitmq-data/
+
+# ActiveMQ
+activemq-data/
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#   JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#   be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#   and can be added to the global gitignore or merged into this file.  For a more nuclear
+#   option (not recommended) you can uncomment the following to ignore the entire idea folder.
+# .idea/
+
+# Abstra
+#   Abstra is an AI-powered process automation framework.
+#   Ignore directories containing user credentials, local state, and settings.
+#   Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#   Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#   that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#   and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#   you could uncomment the following to ignore the entire vscode folder
+# .vscode/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# Streamlit
+.streamlit/secrets.toml

common_python_tasks-0.4.1/.poetry/plugins/poetry_dynamic_versioning-1.10.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 Matthew T. Kennerly (mtkennerly)
+
+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.

common_python_tasks-0.4.1/.poetry/plugins/poetry_plugin_export-1.10.0.dist-info/licenses/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2022 Sébastien Eustace
+
+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.

{common_python_tasks-0.4.0 → common_python_tasks-0.4.1}/PKG-INFO

@@ -1,12 +1,13 @@
 Metadata-Version: 2.4
 Name: common-python-tasks
-Version: 0.4.0
+Version: 0.4.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
+Project-URL: Issues, http://github.com/ci-sourcerer/common-python-tasks/issues
+Author-email: Joseph Asbury <ci_sourcerer@yahoo.com>
 License-Expression: MIT
 License-File: LICENSE
-Author: Joseph Asbury
-Author-email: ci_sourcerer@yahoo.com
-Requires-Python: >=3.11,<4.0
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
@@ -15,23 +16,21 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Build Tools
-Requires-Dist: autoflake (>=2.3.1,<3.0.0)
-Requires-Dist: black (>=26.3.1,<27.0.0)
-Requires-Dist: docker (>=7.1.0,<8.0.0)
-Requires-Dist: dunamai (>=1.25.0,<2.0.0)
-Requires-Dist: flake8 (>=7.3.0,<8.0.0)
-Requires-Dist: git-cliff (>=2.12.0,<3.0.0)
-Requires-Dist: isort (>=8.0.1,<9.0.0)
-Requires-Dist: jinja2 (>=3.1.6,<4.0.0)
-Requires-Dist: packaging (>=26.2,<27.0)
-Requires-Dist: poethepoet-tasks (>=0.3.0,<0.4.0)
-Requires-Dist: pytest (>=9.0.3,<10.0.0)
-Requires-Dist: pytest-cov (>=7.0.0,<8.0.0)
-Requires-Dist: requests (>=2.34.2,<3.0.0)
-Requires-Dist: tomlkit (>=0.13.3,<0.14.0)
-Project-URL: Homepage, http://github.com/ci-sourcerer/common-python-tasks
-Project-URL: Issues, http://github.com/ci-sourcerer/common-python-tasks/issues
-Project-URL: Source, http://github.com/ci-sourcerer/common-python-tasks.git
+Requires-Python: <4.0,>=3.11
+Requires-Dist: autoflake<3.0.0,>=2.3.1
+Requires-Dist: black<27.0.0,>=26.3.1
+Requires-Dist: docker<8.0.0,>=7.1.0
+Requires-Dist: dunamai<2.0.0,>=1.25.0
+Requires-Dist: flake8<8.0.0,>=7.3.0
+Requires-Dist: git-cliff<3.0.0,>=2.12.0
+Requires-Dist: isort<9.0.0,>=8.0.1
+Requires-Dist: jinja2<4.0.0,>=3.1.6
+Requires-Dist: packaging<27.0,>=26.2
+Requires-Dist: poethepoet-tasks<0.4.0,>=0.3.0
+Requires-Dist: pytest-cov<8.0.0,>=7.0.0
+Requires-Dist: pytest<10.0.0,>=9.0.3
+Requires-Dist: requests<3.0.0,>=2.34.2
+Requires-Dist: tomlkit<0.14.0,>=0.13.3
 Description-Content-Type: text/markdown
 
 # Common Python Tasks
@@ -53,7 +52,7 @@ curl -sSL https://api.github.com/repos/ci-sourcerer/common-python-tasks/contents
 To install a specific release, set the environment variable `COMMON_PYTHON_TASKS_VERSION`.
 
 ```shell
-COMMON_PYTHON_TASKS_VERSION=0.4.0 \
+COMMON_PYTHON_TASKS_VERSION=0.4.1 \
   sh -c "$(curl -sSL https://api.github.com/repos/ci-sourcerer/common-python-tasks/contents/scripts/add-common-python-tasks.sh | jq -r '.content' | base64 -d)"
 ```
 
@@ -61,7 +60,7 @@ This will complete the following steps.
 
 1. Add the latest version of `common-python-tasks` to your `pyproject.toml` dependencies
 2. Configure Poe the Poet to expose the default common task set
-3. Install the package using Poetry
+3. Install dependencies for your project
 
 **Always review scripts before running them!** Even though I believe I write good software, it's best practice to verify any script you download from the Internet.
 
@@ -74,7 +73,7 @@ There's no real reason to run the automated script; I just like automating every
     ```toml
     [project]
     dependencies = [
-        "common-python-tasks==0.4.0"  # Always pin to a specific version
+        "common-python-tasks==0.4.1"  # Always pin to a specific version
     ]
 
     [tool.poe]
@@ -84,6 +83,8 @@ There's no real reason to run the automated script; I just like automating every
 2. Install the package
 
     ```shell
+    uv sync
+    # or, for Poetry workflows
     poetry install
     ```
 
@@ -196,9 +197,24 @@ The `fastapi` stack includes a service for your FastAPI application. It uses the
 
 Your project must meet the following requirements.
 
-- Use Poetry for dependency management
-- Have a `pyproject.toml` file at the root
-- Have a package name (automatically inferred from `project.name` in `pyproject.toml` or set via `PACKAGE_NAME` environment variable)
+- Uses Poetry or uv for dependency management
+- Uses Poe the Poet for task management
+- Has `poetry-dynamic-versioning` or `uv-dynamic-versioning` as a dependency
+- Has a `pyproject.toml` file at the root
+- Has a package name (automatically inferred from `project.name` in `pyproject.toml` or set via `PACKAGE_NAME` environment variable)
+
+### Package manager backend selection
+
+Packaging-related tasks (`build-package`, `publish-package`, release tagging/version resolution, and related container build metadata) support both Poetry and uv.
+
+Backend selection uses this precedence.
+
+1. `COMMON_PYTHON_TASKS_PACKAGE_MANAGER`
+2. `COMMON_PYTHON_TASKS_BUILD_TOOL`
+3. `PACKAGE_MANAGER`
+4. Auto-discovery (`auto`) based on installed tools and project metadata
+
+Supported values are `poetry`, `uv`, and `auto`.
 
 ### Configuration precedence
 
@@ -227,7 +243,9 @@ The following environment variables configure the paths to configuration files.
 The following environment variables configure package and container behavior.
 
 - `PACKAGE_NAME`: Overrides the package name; the default comes from `pyproject.toml`
-- `POETRY_VERSION`: Overrides the Poetry version for container builds
+- `COMMON_PYTHON_TASKS_PACKAGE_MANAGER`: Selects package manager backend (`poetry`, `uv`, or `auto`)
+- `COMMON_PYTHON_TASKS_BUILD_TOOL`: Alias for `COMMON_PYTHON_TASKS_PACKAGE_MANAGER`
+- `PACKAGE_MANAGER`: Alias for `COMMON_PYTHON_TASKS_PACKAGE_MANAGER`
 - `CONTAINER_REGISTRY_USERNAME`: Specifies the container registry username for image tagging; the default is the current local user
 - `CONTAINER_REGISTRY_URL`: Specifies the registry URL (default: `docker.io/{username}`)
 - `CONTAINER_BUILD_ARGS`: Provides additional Docker build arguments in `KEY=VALUE:OTHER=VALUE` format
@@ -289,8 +307,8 @@ By default, `tasks()` exposes the common task set. You can still include or excl
 ```toml
 [project]
 name = "simple-cli-tool"
-version = "0.4.0"
-dependencies = ["common-python-tasks==0.4.0"]
+version = "0.4.1"
+dependencies = ["common-python-tasks==0.4.1"]
 
 [tool.poe]
 include_script = "common_python_tasks:tasks()"
@@ -302,7 +320,7 @@ Available tasks: common defaults such as `format`, `lint`, `test`, and `build`.
 
 ```toml
 [project]
-dependencies = ["common-python-tasks==0.4.0"]
+dependencies = ["common-python-tasks==0.4.1"]
 
 [tool.poe]
 include_script = "common_python_tasks:tasks(include_tags=['common', 'containers'])"
@@ -318,7 +336,7 @@ Available tasks: All tasks including `build-image` and `push-image`.
 
 ```toml
 [project]
-dependencies = ["common-python-tasks==0.4.0"]
+dependencies = ["common-python-tasks==0.4.1"]
 
 [tool.poe]
 include_script = "common_python_tasks:tasks()"
@@ -367,7 +385,7 @@ COMMON_PYTHON_TASKS_LOG_LEVEL=DEBUG poe test
 Make sure your `pyproject.toml` contains the following.
 
 - A correct package name in `[project]`
-- A package location defined with this configuration: `[tool.poetry] packages = [{ include = "your_package", from = "src" }]`
+- Package discovery settings required by your chosen build backend (for Poetry projects, this is commonly `[tool.poetry] packages = [{ include = "your_package", from = "src" }]`)
 
 ### Stack fails to start or services won't connect
 
@@ -401,9 +419,9 @@ If `SECRET_KEY` or `DB_PASS` aren't auto-generated:
 
 The standard Python Dockerfile incorporates several intentional design choices.
 
-- Multi-stage build: The build stage installs Poetry and builds a wheel while the runtime stage installs only the wheel to keep the final image slim and reproducible
-- Pip and Poetry cache mounts: Speed up iterative builds without bloating the final image
-- Explicit inputs through build args: `PYTHON_VERSION`, `POETRY_VERSION`, `PACKAGE_NAME`, `AUTHORS`, `GIT_COMMIT`, and `CUSTOM_ENTRYPOINT` make image metadata and behavior predictable and auditable
+- Multi-stage build: The build stage installs the selected package manager backend (Poetry or uv) and builds a wheel while the runtime stage installs only the wheel to keep the final image slim and reproducible
+- Pip and package-manager cache mounts: Speed up iterative builds without bloating the final image
+- Explicit inputs through build args: `PYTHON_VERSION`, `PACKAGE_MANAGER`, `PACKAGE_MANAGER_VERSION`, `PACKAGE_NAME`, `AUTHORS`, `GIT_COMMIT`, and `CUSTOM_ENTRYPOINT` make image metadata and behavior predictable and auditable
 - Optional debug stage: Exports and installs the `debug` dependency group only when present, without failing otherwise, and is not part of the default final image
 - Stable package path: Creates symlinks to the installed package so entrypoints and consumers have a consistent `/pkg` and `/_$PACKAGE_NAME` path regardless of wheel layout. This ensures that the package can be imported and executed from a known location and supports the less common case of reading files directly from the package path
 - Safe entrypoint selection: The default entrypoint resolves the console script matching the package name, while `CUSTOM_ENTRYPOINT` allows an override at build time and keeps runtime behavior predictable
@@ -413,7 +431,6 @@ The standard Python Dockerfile incorporates several intentional design choices.
 
 - This project dogfoods itself; it uses `common-python-tasks` for its own development. **That said, you must set the environment variable `PYTHONPATH=src` when running tasks locally to ensure you are using the local version of the package instead of the installed version**
 - `RELEASE_UPDATE_CHANGELOG` is enabled by default for releases and prepends a tagged section into `CHANGELOG.md` before the release tag is created. Set it to a falsy value if you prefer to manage changelog commits yourself.
-- `RELEASE_PRE_SCRIPT` and `RELEASE_POST_SCRIPT` hooks may not be necessary for most users, as this package promotes the use of `poetry-dynamic-versioning` and `git-cliff` to automate versioning and changelog generation based on git history. One advanced use case for the `RELEASE_PRE_SCRIPT` hook is to edit another file before release, such as a README that references the current stable version number. This allows you to keep the README up to date with the latest version without hardcoding it.
+- `RELEASE_PRE_SCRIPT` and `RELEASE_POST_SCRIPT` hooks may not be necessary for most users, as this package promotes dynamic versioning and `git-cliff` to automate versioning and changelog generation based on git history. One advanced use case for the `RELEASE_PRE_SCRIPT` hook is to edit another file before release, such as a README that references the current stable version number. This allows you to keep the README up to date with the latest version without hardcoding it.
 - Contributions welcome! Open an issue/discussion to discuss changes before submitting a PR. I do not claim to have all the answers, and you can help determine the future of low-code solutions for Python. I am very interested in your feedback as I don't want to work in a vacuum
 - Alpha status: Expect breaking changes between minor versions until 1.0.0
-

{common_python_tasks-0.4.0 → common_python_tasks-0.4.1}/README.md

@@ -17,7 +17,7 @@ curl -sSL https://api.github.com/repos/ci-sourcerer/common-python-tasks/contents
 To install a specific release, set the environment variable `COMMON_PYTHON_TASKS_VERSION`.
 
 ```shell
-COMMON_PYTHON_TASKS_VERSION=0.4.0 \
+COMMON_PYTHON_TASKS_VERSION=0.4.1 \
   sh -c "$(curl -sSL https://api.github.com/repos/ci-sourcerer/common-python-tasks/contents/scripts/add-common-python-tasks.sh | jq -r '.content' | base64 -d)"
 ```
 
@@ -25,7 +25,7 @@ This will complete the following steps.
 
 1. Add the latest version of `common-python-tasks` to your `pyproject.toml` dependencies
 2. Configure Poe the Poet to expose the default common task set
-3. Install the package using Poetry
+3. Install dependencies for your project
 
 **Always review scripts before running them!** Even though I believe I write good software, it's best practice to verify any script you download from the Internet.
 
@@ -38,7 +38,7 @@ There's no real reason to run the automated script; I just like automating every
     ```toml
     [project]
     dependencies = [
-        "common-python-tasks==0.4.0"  # Always pin to a specific version
+        "common-python-tasks==0.4.1"  # Always pin to a specific version
     ]
 
     [tool.poe]
@@ -48,6 +48,8 @@ There's no real reason to run the automated script; I just like automating every
 2. Install the package
 
     ```shell
+    uv sync
+    # or, for Poetry workflows
     poetry install
     ```
 
@@ -160,9 +162,24 @@ The `fastapi` stack includes a service for your FastAPI application. It uses the
 
 Your project must meet the following requirements.
 
-- Use Poetry for dependency management
-- Have a `pyproject.toml` file at the root
-- Have a package name (automatically inferred from `project.name` in `pyproject.toml` or set via `PACKAGE_NAME` environment variable)
+- Uses Poetry or uv for dependency management
+- Uses Poe the Poet for task management
+- Has `poetry-dynamic-versioning` or `uv-dynamic-versioning` as a dependency
+- Has a `pyproject.toml` file at the root
+- Has a package name (automatically inferred from `project.name` in `pyproject.toml` or set via `PACKAGE_NAME` environment variable)
+
+### Package manager backend selection
+
+Packaging-related tasks (`build-package`, `publish-package`, release tagging/version resolution, and related container build metadata) support both Poetry and uv.
+
+Backend selection uses this precedence.
+
+1. `COMMON_PYTHON_TASKS_PACKAGE_MANAGER`
+2. `COMMON_PYTHON_TASKS_BUILD_TOOL`
+3. `PACKAGE_MANAGER`
+4. Auto-discovery (`auto`) based on installed tools and project metadata
+
+Supported values are `poetry`, `uv`, and `auto`.
 
 ### Configuration precedence
 
@@ -191,7 +208,9 @@ The following environment variables configure the paths to configuration files.
 The following environment variables configure package and container behavior.
 
 - `PACKAGE_NAME`: Overrides the package name; the default comes from `pyproject.toml`
-- `POETRY_VERSION`: Overrides the Poetry version for container builds
+- `COMMON_PYTHON_TASKS_PACKAGE_MANAGER`: Selects package manager backend (`poetry`, `uv`, or `auto`)
+- `COMMON_PYTHON_TASKS_BUILD_TOOL`: Alias for `COMMON_PYTHON_TASKS_PACKAGE_MANAGER`
+- `PACKAGE_MANAGER`: Alias for `COMMON_PYTHON_TASKS_PACKAGE_MANAGER`
 - `CONTAINER_REGISTRY_USERNAME`: Specifies the container registry username for image tagging; the default is the current local user
 - `CONTAINER_REGISTRY_URL`: Specifies the registry URL (default: `docker.io/{username}`)
 - `CONTAINER_BUILD_ARGS`: Provides additional Docker build arguments in `KEY=VALUE:OTHER=VALUE` format
@@ -253,8 +272,8 @@ By default, `tasks()` exposes the common task set. You can still include or excl
 ```toml
 [project]
 name = "simple-cli-tool"
-version = "0.4.0"
-dependencies = ["common-python-tasks==0.4.0"]
+version = "0.4.1"
+dependencies = ["common-python-tasks==0.4.1"]
 
 [tool.poe]
 include_script = "common_python_tasks:tasks()"
@@ -266,7 +285,7 @@ Available tasks: common defaults such as `format`, `lint`, `test`, and `build`.
 
 ```toml
 [project]
-dependencies = ["common-python-tasks==0.4.0"]
+dependencies = ["common-python-tasks==0.4.1"]
 
 [tool.poe]
 include_script = "common_python_tasks:tasks(include_tags=['common', 'containers'])"
@@ -282,7 +301,7 @@ Available tasks: All tasks including `build-image` and `push-image`.
 
 ```toml
 [project]
-dependencies = ["common-python-tasks==0.4.0"]
+dependencies = ["common-python-tasks==0.4.1"]
 
 [tool.poe]
 include_script = "common_python_tasks:tasks()"
@@ -331,7 +350,7 @@ COMMON_PYTHON_TASKS_LOG_LEVEL=DEBUG poe test
 Make sure your `pyproject.toml` contains the following.
 
 - A correct package name in `[project]`
-- A package location defined with this configuration: `[tool.poetry] packages = [{ include = "your_package", from = "src" }]`
+- Package discovery settings required by your chosen build backend (for Poetry projects, this is commonly `[tool.poetry] packages = [{ include = "your_package", from = "src" }]`)
 
 ### Stack fails to start or services won't connect
 
@@ -365,9 +384,9 @@ If `SECRET_KEY` or `DB_PASS` aren't auto-generated:
 
 The standard Python Dockerfile incorporates several intentional design choices.
 
-- Multi-stage build: The build stage installs Poetry and builds a wheel while the runtime stage installs only the wheel to keep the final image slim and reproducible
-- Pip and Poetry cache mounts: Speed up iterative builds without bloating the final image
-- Explicit inputs through build args: `PYTHON_VERSION`, `POETRY_VERSION`, `PACKAGE_NAME`, `AUTHORS`, `GIT_COMMIT`, and `CUSTOM_ENTRYPOINT` make image metadata and behavior predictable and auditable
+- Multi-stage build: The build stage installs the selected package manager backend (Poetry or uv) and builds a wheel while the runtime stage installs only the wheel to keep the final image slim and reproducible
+- Pip and package-manager cache mounts: Speed up iterative builds without bloating the final image
+- Explicit inputs through build args: `PYTHON_VERSION`, `PACKAGE_MANAGER`, `PACKAGE_MANAGER_VERSION`, `PACKAGE_NAME`, `AUTHORS`, `GIT_COMMIT`, and `CUSTOM_ENTRYPOINT` make image metadata and behavior predictable and auditable
 - Optional debug stage: Exports and installs the `debug` dependency group only when present, without failing otherwise, and is not part of the default final image
 - Stable package path: Creates symlinks to the installed package so entrypoints and consumers have a consistent `/pkg` and `/_$PACKAGE_NAME` path regardless of wheel layout. This ensures that the package can be imported and executed from a known location and supports the less common case of reading files directly from the package path
 - Safe entrypoint selection: The default entrypoint resolves the console script matching the package name, while `CUSTOM_ENTRYPOINT` allows an override at build time and keeps runtime behavior predictable
@@ -377,6 +396,6 @@ The standard Python Dockerfile incorporates several intentional design choices.
 
 - This project dogfoods itself; it uses `common-python-tasks` for its own development. **That said, you must set the environment variable `PYTHONPATH=src` when running tasks locally to ensure you are using the local version of the package instead of the installed version**
 - `RELEASE_UPDATE_CHANGELOG` is enabled by default for releases and prepends a tagged section into `CHANGELOG.md` before the release tag is created. Set it to a falsy value if you prefer to manage changelog commits yourself.
-- `RELEASE_PRE_SCRIPT` and `RELEASE_POST_SCRIPT` hooks may not be necessary for most users, as this package promotes the use of `poetry-dynamic-versioning` and `git-cliff` to automate versioning and changelog generation based on git history. One advanced use case for the `RELEASE_PRE_SCRIPT` hook is to edit another file before release, such as a README that references the current stable version number. This allows you to keep the README up to date with the latest version without hardcoding it.
+- `RELEASE_PRE_SCRIPT` and `RELEASE_POST_SCRIPT` hooks may not be necessary for most users, as this package promotes dynamic versioning and `git-cliff` to automate versioning and changelog generation based on git history. One advanced use case for the `RELEASE_PRE_SCRIPT` hook is to edit another file before release, such as a README that references the current stable version number. This allows you to keep the README up to date with the latest version without hardcoding it.
 - Contributions welcome! Open an issue/discussion to discuss changes before submitting a PR. I do not claim to have all the answers, and you can help determine the future of low-code solutions for Python. I am very interested in your feedback as I don't want to work in a vacuum
 - Alpha status: Expect breaking changes between minor versions until 1.0.0

{common_python_tasks-0.4.0 → common_python_tasks-0.4.1}/pyproject.toml

@@ -32,8 +32,7 @@ dependencies = [
     "packaging (>=26.2,<27.0)",
     "requests (>=2.34.2,<3.0.0)",
 ]
-dynamic = []
-version = "0.4.0"
+dynamic = ["version"]
 
 [project.urls]
 Homepage = "http://github.com/ci-sourcerer/common-python-tasks"
@@ -48,23 +47,25 @@ PYTHONPATH = "src"
 RELEASE_UPDATE_CHANGELOG = "1"
 RELEASE_PRE_SCRIPT = "RELEASE_SCRIPT_PHASE=pre python scripts/release_script.py"
 
-[tool.poetry.requires-plugins]
-poetry-dynamic-versioning = { version = ">=1.0.0,<2.0.0", extras = ["plugin"] }
-poetry-plugin-export = { version = ">=1.9.0,<2.0.0" }
+[tool.hatch.version]
+source = "uv-dynamic-versioning"
 
-[tool.poetry]
-packages = [{ include = "common_python_tasks", from = "src" }]
-include = ["src/common_python_tasks/data/*"]
-# This is set by poetry-dynamic-versioning
+[tool.hatch.build.targets.wheel]
+packages = ["src/common_python_tasks"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/common_python_tasks", "scripts", "README.md", "LICENSE"]
 
 [dependency-groups]
 debug = ["debugpy (>=1.8.16,<2.0.0)"]
 
 [build-system]
-requires = ["poetry-core>=2.0.0", "poetry-dynamic-versioning>=1.0.0,<2.0.0"]
-build-backend = "poetry.core.masonry.api"
+requires = ["hatchling>=1.27.0", "uv-dynamic-versioning>=0.14.0"]
+build-backend = "hatchling.build"
 
-[tool.poetry-dynamic-versioning]
-enable = false
+[tool.uv-dynamic-versioning]
 style = "pep440"
 dirty = true
+
+[tool.uv]
+package = true

common_python_tasks-0.4.1/scripts/add-common-python-tasks.sh

@@ -0,0 +1,35 @@
+#!/bin/sh
+
+# This script adds the common-python-tasks package to the current project
+# and updates the pyproject.toml file to include the requested tasks.
+
+set -e
+
+pkg="common-python-tasks"
+if [ -n "$COMMON_PYTHON_TASKS_VERSION" ]; then
+    ver="$COMMON_PYTHON_TASKS_VERSION"
+else
+    searchOutput=$(poetry search "$pkg")
+    if [ "$searchOutput" = "No matching packages were found." ]; then
+        printf 'Package %s not found\n' "$pkg" >&2
+        exit 1
+    fi
+    ver=$(printf "%s" "$searchOutput" | awk -v p="$pkg" '$1==p{print $2}' | tail -n1)
+fi
+if [ -n "$ver" ]; then
+    poetry add --group dev "$pkg==$ver" || exit 1
+else
+    printf 'Error parsing version for %s\n' "$pkg" >&2
+    exit 1
+fi
+
+script=$([ -n "$TAGS_TO_INCLUDE" ] && python -c "import sys; tags = sys.argv[1].split(); print('common_python_tasks:tasks(include_tags='+repr(tags)+')')" "$TAGS_TO_INCLUDE" || echo "common_python_tasks:tasks()")
+cat >>pyproject.toml <<EOF
+
+[tool.poe]
+include_script = "$script"
+
+EOF
+
+printf "\n\033[1;32mCommon Python tasks added to project.\033[0m\n\n\033[1mAvailable tasks:\033[0m\n"
+poe --help --ansi | awk '/Configured tasks:/ {flag=1; next} flag'