ITW Python Builder

Standardized Django deployment pipeline with Docker, testing, SonarQube integration, automatic changelog generation, and code quality enforcement.

Features

Automated deployment with semantic versioning
Docker/Podman-based build and push pipeline
Automated testing with coverage
SonarQube static code analysis
Pylint linting with SonarQube integration
Quality gates - deploy only when tests pass
Automatic changelog generation from commit trailers
Support for local and production pipelines
Global CLI tool
Automatic venv detection per project

Installation

pip install itw-python-builder

Install globally (outside any project venv). The itw command becomes available system-wide.

Quick Start

Navigate to your Django project directory (must have a .venv or venv):
Initialize versioning:

itw tag-init

Run local pipeline:

itw pipelinelocal

Deploy to staging:

itw incrementrc

Deploy to production:

itw incrementpatch

Available Commands

Deployment Commands

itw incrementpatch — Increment patch version and deploy
itw incrementminor — Increment minor version and deploy
itw incrementmajor — Increment major version and deploy
itw incrementrc — Increment release candidate (staging)
itw release — Promote RC to stable release (master)

Local Development Commands

itw pipelinelocal — Run full local pipeline (lint → test → analyze → build)
itw lintlocal — Run pylint with human-readable output
itw lint — Run pylint and generate SonarQube report files
itw buildlocal — Build Docker image locally
itw testlocal — Run tests locally
itw analyzelocal — Run SonarQube analysis locally
itw changelog — Generate changelog manually
itw tag-init — Initialize version tagging

Skip Pipeline

itw incrementpatch --skip-pipeline

Virtual Environment Detection

itw is installed globally but automatically detects the project's virtual environment (.venv or venv) in the current directory. Tasks that need Python/Django dependencies (test, lint, analyze) activate the venv automatically — no need to manually activate it.

If no venv is found, those tasks will error with a clear message. Tasks that only use git (like changelog, tag-init, buildlocal) work without a venv.

Linting

The pipeline runs pylint automatically on every deployment and generates report files for SonarQube. The .pylintrc configuration is shipped with the package — no config files needed in your project.

# Review issues with human-readable output
itw lintlocal

# Generate report files for SonarQube
itw lint

Add this to your sonar-project.properties:

sonar.python.pylint.reportPaths=pylint-report.txt

Changelog Generation

Changelog entries are generated automatically on every deployment based on commit messages. To categorize a commit, add a Changelog: trailer to the commit body:

add user authentication

Changelog: added

Available categories: added, fixed, changed, deprecated, removed, security, performance, tests, docs, refactor

Commits without a trailer appear under Other Changes. The CHANGELOG.md file is committed and pushed automatically with each deployment.

Requirements

Python 3.10+
Podman
Git
SonarQube server

Configuration

Environment Variables

Add to your project .env:

SONAR_HOST_URL=https://your-sonar-server
SONAR_TOKEN=your-token
GIT_DEPTH=0

Project Files Required

Git repository with develop, staging, and master branches
VERSION file in project root
Dockerfile
sonar-project.properties

License

MIT

Metadata

Release files for itw-python-builder 0.2.13

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for itw-python-builder 0.2.13
File	Size	Uploaded
itw_python_builder-0.2.13.tar.gz	40.7 kB	Aug 7, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for itw-python-builder 0.2.13
File	Interpreter	ABI	Platform	Reset
itw_python_builder-0.2.13-py3-none-any.whl 43.4 kB Aug 7, 2026	Python 3	none	any	Details

Total release size: 84.1 kB

Release files / itw_python_builder-0.2.13.tar.gz

Download URL	itw_python_builder-0.2.13.tar.gz
Size	40.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`acf0d0592cb1721c62f65434529fec65afa90054883cc8c36a5021a25d4ffb68`
BLAKE2b-256 checksum How to use checksums	`a679d991f426ffd3dce291d6c6ec675e257c30d094bbfd8125c4ea19da3cf763`
Upload date	Aug 7, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.13`

Release files / itw_python_builder-0.2.13-py3-none-any.whl

Download URL	itw_python_builder-0.2.13-py3-none-any.whl
Size	43.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`fb8b511eb7e9ecf9ce068702a85eb0a00883f292e2652f42dffdfe0bdd87205a`
BLAKE2b-256 checksum How to use checksums	`199686cb52f8ad3f7590d8d68aa9738eddfa31d7dd1ba70ebd3816a287d4fde7`
Upload date	Aug 7, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.13`