itw-python-builder 0.2.13__py3-none-any.whl → 0.2.15__py3-none-any.whl

itw_python_builder/task_utils.py

@@ -1,9 +1,13 @@
 import re
+import unicodedata
 from difflib import SequenceMatcher
+from urllib.parse import quote
 
 from itw_python_builder.utils import _gitlab_api_call
 
 SIMILARITY_THRESHOLD = 0.95
+GITLAB_PAGE_SIZE = 100
+_RE_DIGITS = re.compile(r'\d+')
 
 DATE_PLACEHOLDER = 'YYYY-MM-DD'
 
@@ -48,7 +52,12 @@ def log_info(msg: str) -> None:
 
 
 def _normalize_title(value: str) -> str:
-    return ' '.join((value or '').lower().split())
+    collapsed = ' '.join((value or '').lower().split())
+    return unicodedata.normalize('NFC', collapsed)
+
+
+def _digit_tokens(value: str) -> list:
+    return _RE_DIGITS.findall(value or '')
 
 
 def is_similar(left: str, right: str, threshold: float = SIMILARITY_THRESHOLD) -> bool:
@@ -59,19 +68,64 @@ def is_similar(left: str, right: str, threshold: float = SIMILARITY_THRESHOLD) -
         return False
     if a == b:
         return True
+    if _digit_tokens(a) != _digit_tokens(b):
+        return False
     return SequenceMatcher(None, a, b).ratio() >= threshold
 
 
 def find_similar(value: str, items: list, key: str = 'title', threshold: float = SIMILARITY_THRESHOLD):
-    """Return the first item whose `key` is ~threshold similar to `value`, else None."""
+    """Return an exact normalized match if one exists, else the first ~threshold match."""
+    target = _normalize_title(value)
+    fuzzy = None
     for item in items:
-        if is_similar(value, item.get(key, ''), threshold):
+        other = item.get(key, '')
+        if target and target == _normalize_title(other):
             return item
-    return None
+        if fuzzy is None and is_similar(value, other, threshold):
+            fuzzy = item
+    return fuzzy
+
+
+def _gitlab_api_list(api_host: str, endpoint: str, token: str) -> list:
+    """GET a GitLab collection, following pages until a short page is returned."""
+    joiner = '&' if '?' in endpoint else '?'
+    page = 1
+    collected = []
+    while True:
+        chunk = _gitlab_api_call(
+            api_host,
+            f'{endpoint}{joiner}per_page={GITLAB_PAGE_SIZE}&page={page}',
+            token,
+        )
+        if not isinstance(chunk, list):
+            raise RuntimeError(
+                f'GitLab API GET {endpoint} expected a list, got {type(chunk).__name__}'
+            )
+        collected.extend(chunk)
+        if len(chunk) < GITLAB_PAGE_SIZE:
+            break
+        page += 1
+    return collected
+
+
+def _issue_milestone_title(issue: dict) -> str:
+    milestone = issue.get('milestone') or {}
+    if isinstance(milestone, dict):
+        return (milestone.get('title') or '').strip()
+    return ''
+
+
+def _is_duplicate_issue(issue: dict, title: str, milestone: str = None) -> bool:
+    """True when titles match and the issue is in the target milestone or has none."""
+    if not is_similar(title, issue.get('title', '')):
+        return False
+    existing = _issue_milestone_title(issue)
+    if milestone:
+        return (not existing) or is_similar(milestone, existing)
+    return not existing
 
 
 def _list_group_projects(api_host: str, group_path: str, token: str) -> list:
-    from urllib.parse import quote
     encoded = quote(group_path, safe='')
     return _gitlab_api_call(
         api_host,
@@ -113,27 +167,51 @@ def create_gitlab_issue(api_host: str, project_id: int, payload: dict, token: st
 
 
 def get_project_by_path(api_host: str, project_path: str, token: str) -> dict:
-    from urllib.parse import quote
     encoded = quote(project_path, safe='')
     return _gitlab_api_call(api_host, f'/projects/{encoded}', token)
 
 
 def find_project_milestone(api_host: str, project_id: int, title: str, token: str):
-    results = _gitlab_api_call(
+    """Find a project or ancestor-group milestone by title."""
+    encoded = quote(title, safe='')
+    base = f'/projects/{project_id}/milestones?include_ancestors=true'
+    exact = _gitlab_api_list(api_host, f'{base}&title={encoded}', token)
+    match = find_similar(title, exact)
+    if match:
+        return match
+    searched = _gitlab_api_list(api_host, f'{base}&search={encoded}', token)
+    return find_similar(title, searched)
+
+
+def _list_issues_for_milestone(api_host: str, project_id: int, milestone: str, token: str) -> list:
+    encoded = quote(milestone, safe='') if milestone else 'None'
+    return _gitlab_api_list(
         api_host,
-        f'/projects/{project_id}/milestones?per_page=100',
+        f'/projects/{project_id}/issues?milestone={encoded}',
         token,
     )
-    return find_similar(title, results)
 
 
 def find_project_issue(api_host: str, project_id: int, title: str, token: str, milestone: str = None):
-    """Look for a ~matching title within this milestone ('None' = the no-milestone bucket)."""
-    from urllib.parse import quote
-    endpoint = f'/projects/{project_id}/issues?per_page=100'
-    endpoint += f'&milestone={quote(milestone, safe="") if milestone else "None"}'
-    results = _gitlab_api_call(api_host, endpoint, token)
-    return find_similar(title, results)
+    """Look for a ~matching title in this milestone, or among issues with no milestone."""
+    encoded = quote(title, safe='')
+    searched = _gitlab_api_list(
+        api_host,
+        f'/projects/{project_id}/issues?search={encoded}&in=title',
+        token,
+    )
+    for item in searched:
+        if _is_duplicate_issue(item, title, milestone):
+            return item
+
+    for item in _list_issues_for_milestone(api_host, project_id, milestone, token):
+        if _is_duplicate_issue(item, title, milestone):
+            return item
+    if milestone:
+        for item in _list_issues_for_milestone(api_host, project_id, None, token):
+            if _is_duplicate_issue(item, title, milestone):
+                return item
+    return None
 
 
 def create_project_milestone(

itw_python_builder/tasks.py

@@ -29,6 +29,8 @@ from itw_python_builder.utils import (
     TOKEN_CACHE_PATH,
     maybe_override_release_version,
     ensure_gitlab_token,
+    tag_exists,
+    latest_staging_rc,
 )
 from itw_python_builder.task_utils import (
     resolve_pm_repo,
@@ -453,9 +455,11 @@ def push(ctx: Context):
 
 
 def buildimage(ctx: Context):
+    token = load_cached_token()
+    username = get_gitlab_username(ctx)
     current_branch = get_current_branch(ctx)
     container_registry_path = generate_image_path(ctx, current_branch)
-    ctx.run(f'podman build . --tag={container_registry_path}')
+    ctx.run(f'podman build --build-arg GITLAB_USERNAME={username} --build-arg GITLAB_TOKEN={token} --tag={container_registry_path} .')
 
 
 def pushimage(ctx: Context):
@@ -499,16 +503,24 @@ def tag_build_push(ctx: Context, version: Version, skip_pipeline: bool = False,
 
 @task(name='tag-init')
 def taginit(ctx: Context) -> None:
-    """Initialize version tagging"""
-    check_branch(ctx)
-    version = Version(0, 0, 1, 1)
+    """Initialize version tagging — release candidate on staging, release on master."""
+    production = check_branch(ctx)
+    if production:
+        version = latest_staging_rc(ctx)
+        log_info(f'Latest release candidate on staging: {version}')
+        version.reset_release_candidate(release=True)
+    else:
+        version = Version(0, 0, 1, 1)
+    if tag_exists(ctx, version):
+        raise RuntimeError(f'Tag {version} already exists — nothing to initialize.')
     tag(ctx, version)
     save_version(version)
+    log_green(f'Initialized {version} on {get_current_branch(ctx)}')
 
 
 def _ensure_unique_tag(ctx: Context, version: Version) -> None:
     """If the tag already exists, auto-increment RC (RC tags) or patch (release tags)."""
-    while ctx.run(f'git rev-parse -q --verify "refs/tags/{version}"', warn=True, hide=True).ok:
+    while tag_exists(ctx, version):
         if version.release_candidate == 0:
             print(f"[itw] Tag {version} already exists, auto-incrementing patch...")
             version.increment_patch(release=True)

itw_python_builder/utils.py

@@ -254,6 +254,51 @@ def get_latest_tag(ctx: Context) -> Version:
     return Version.parse(tags[0])
 
 
+STAGING_REFS = ('staging', 'origin/staging')
+
+
+def ref_exists(ctx: Context, ref: str) -> bool:
+    return ctx.run(f'git rev-parse -q --verify "{ref}"', warn=True, hide=True).ok
+
+
+def tag_exists(ctx: Context, version: Version) -> bool:
+    return ctx.run(f'git rev-parse -q --verify "refs/tags/{version}"', warn=True, hide=True).ok
+
+
+def list_rc_tags(ctx: Context, ref: str) -> list:
+    result = ctx.run(f'git tag --list "v.*-rc*" --merged {ref}', hide=True)
+    versions = []
+    for line in result.stdout.splitlines():
+        line = line.strip()
+        if not line:
+            continue
+        try:
+            versions.append(Version.parse(line))
+        except ValueError:
+            continue
+    return versions
+
+
+def latest_staging_rc(ctx: Context) -> Version:
+    """Highest release candidate reachable from staging."""
+    ctx.run('git fetch origin --tags', warn=True, hide=True)
+    refs = [ref for ref in STAGING_REFS if ref_exists(ctx, ref)]
+    if not refs:
+        raise RuntimeError(
+            'No staging branch found locally or on origin, so there is no release '
+            'candidate to promote. Run `itw tag-init` on staging first.'
+        )
+    versions = []
+    for ref in refs:
+        versions.extend(list_rc_tags(ctx, ref))
+    if not versions:
+        raise RuntimeError(
+            f'No release candidate tag found on {" or ".join(refs)}. '
+            'Run `itw tag-init` on staging first.'
+        )
+    return max(versions, key=lambda v: (v.major, v.minor, v.patch, v.release_candidate))
+
+
 def _update_package_json_version(version: Version) -> None:
     """Update the top-level `version` in package.json (preserves key order)."""
     pkg_path = os.path.join(os.getcwd(), 'package.json')

itw_python_builder-0.2.15.dist-info/METADATA

@@ -0,0 +1,338 @@
+Metadata-Version: 2.4
+Name: itw_python_builder
+Version: 0.2.15
+Summary: Standardized Django deployment pipeline with Docker, testing, and SonarQube integration
+Author-email: IT-Works <contact@it-works.io>
+License: MIT
+Project-URL: Homepage, https://git.it-works.io/
+Project-URL: Repository, https://git.it-works.io/
+Project-URL: Issues, https://git.it-works.io/
+Keywords: django,deployment,docker,ci-cd,sonarqube
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: invoke>=2.0.0
+Requires-Dist: pylint>=3.0.0
+Requires-Dist: pylint-django>=2.5.0
+Requires-Dist: python-decouple>=3.8
+Requires-Dist: requests>=2.28.0
+Dynamic: license-file
+
+# ITW Python Builder
+
+Standardized Django and Angular deployment pipeline with Docker, testing, SonarQube integration, automatic changelog generation, GitLab issue creation, and code quality enforcement.
+
+## Features
+
+- Automated deployment with semantic versioning
+- Docker/Podman-based build and push pipeline (backend)
+- Angular build, packaging and upload to the GitLab Package Registry (frontend)
+- Angular SSR scaffolding and SSR builds
+- 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
+- Automatic `CHANGELOG.md` creation and propagation to `staging`/`develop`
+- GitLab issue creation from a markdown file
+- Cached GitLab authentication
+- Support for local and production pipelines
+- Global CLI tool
+- Automatic venv detection per project
+
+## Installation
+```bash
+pip install itw-python-builder
+```
+
+Install globally (outside any project venv). The `itw` command becomes available system-wide.
+
+Check the installed version:
+```bash
+itw --version
+```
+
+## Quick Start
+
+1. Navigate to your project directory (Django projects must have a `.venv` or `venv`):
+
+2. Authenticate with GitLab:
+```bash
+itw login
+```
+
+3. Initialize versioning — run it on `staging` first, then on `master`:
+```bash
+git checkout staging && itw tag-init   # creates v.0.0.1-rc1
+git checkout master  && itw tag-init   # promotes the latest staging RC to -release
+```
+
+4. Run local pipeline:
+```bash
+itw pipelinelocal
+```
+
+5. Deploy to staging:
+```bash
+itw incrementrc
+```
+
+6. Deploy to production:
+```bash
+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)
+
+### Authentication Commands
+
+- `itw login` — Capture and cache a GitLab token (backend also logs into the container registry)
+- `itw logout` — Forget the cached token and log out of the container registry
+
+### GitLab Issue Commands
+
+- `itw task-init` — Create a `TASK.md` template in the current directory
+- `itw task --file=TASK.md` — Create GitLab issues from a markdown file
+
+### 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 test` — Run tests with coverage
+- `itw analyze` — Run SonarQube analysis
+- `itw changelog` — Generate changelog manually
+- `itw tag-init` — Initialize version tagging (see below)
+- `itw ssr-init` — Scaffold Angular SSR (one-time, frontend only)
+
+### Version Initialization
+
+`itw tag-init` is branch-aware and must be run from `staging` or `master`:
+
+- On **staging** it creates the first release candidate, `v.0.0.1-rc1`.
+- On **master** it reads the latest `-rc` tag reachable from `staging` (local or `origin/staging`, after fetching tags) and creates that same version as a release. For example `v.0.0.2-rc10` on staging becomes `v.0.0.2-release` on master.
+
+The `VERSION` file is written with the tag that was created. The command stops with a clear error when there is no staging branch, no release candidate to promote, or when the tag already exists.
+
+### Skip Pipeline
+```bash
+itw incrementpatch --skip-pipeline
+```
+
+### Run a Subset of Tests
+```bash
+# Django: an app or a single test module
+itw test --target=users
+itw test --target=users.test_views
+
+# Angular: a directory or a spec name
+itw test --target=core
+itw test --target=core.service
+```
+
+### SSR Builds
+
+Frontend projects scaffolded with `itw ssr-init` build through the SSR npm scripts when `--ssr` is passed:
+```bash
+itw incrementrc --ssr
+itw incrementpatch --ssr
+```
+
+## 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.
+```bash
+# Review issues with human-readable output
+itw lintlocal
+
+# Generate report files for SonarQube
+itw lint
+
+# Use a custom pylint configuration
+itw lint --pylintrc=.pylintrc
+```
+
+Add this to your `sonar-project.properties`:
+```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.
+
+If `CHANGELOG.md` does not exist in the current directory it is created automatically — including when there are no new commits since the last tag, so the deployment never fails on a missing file.
+
+### Changelog Propagation
+
+After a successful deployment the changelog is synced forward through a temporary git worktree:
+
+- from `master` → `staging` and `develop`
+- from `staging` → `develop`
+
+Propagation is skipped when the working tree is not clean or when there is nothing new to sync.
+
+## GitLab Issue Creation
+
+Create GitLab issues from a markdown file instead of the web UI.
+
+Generate the template:
+```bash
+itw task-init
+```
+
+Then fill it in and run:
+```bash
+itw task --file=TASK.md
+```
+
+`task-init` refuses to overwrite an existing `TASK.md`.
+
+### Template
+
+```markdown
+<!-- OPTIONAL -->
+/glab_host 
+/glab_username 
+/glab_token 
+
+<!-- REQUIRED -->
+/title 
+
+<!-- OPTIONAL -->
+/repo 
+/milestone 
+/milestone-start YYYY-MM-DD
+/milestone-end YYYY-MM-DD
+/assignee 
+/label 
+/estimate 
+/due YYYY-MM-DD
+
+<!-- OPTIONAL -->
+## Acceptance Criteria
+- [ ] 
+- [ ] 
+## Acceptance Criteria
+
+<!-- OPTIONAL -->
+## Comment
+
+## Comment
+```
+
+Every key except `/title` is optional. Leaving a key empty is allowed — empty keys are simply not sent to GitLab. The date keys keep the `YYYY-MM-DD` format in the template and are treated as empty until you replace them.
+
+Any text outside the directives becomes the issue description. Create several issues from one file by separating the blocks with a line containing only `===`.
+
+### Directives
+
+| Directive | Description |
+| --- | --- |
+| `/glab_host` | GitLab host to authenticate against |
+| `/glab_username` | GitLab username |
+| `/glab_token` | GitLab personal access token |
+| `/title` | Issue title (required) |
+| `/repo` | Target project path |
+| `/milestone` | Milestone title |
+| `/milestone-start` | Milestone start date, used only when the milestone is created |
+| `/milestone-end` | Milestone due date, used only when the milestone is created |
+| `/assignee` | Username to assign the issue to |
+| `/label` | Comma-separated labels |
+| `/estimate` | Time estimate (e.g. `3h`) |
+| `/due` | Issue due date |
+
+### Authentication
+
+Either provide all three of `/glab_host`, `/glab_username` and `/glab_token`, or none of them. Providing only some of them is an error.
+
+When no credentials are given, `itw` uses the `.git` directory in the current folder to detect the GitLab host and project, and the token cached by `itw login`.
+
+### Target Repository
+
+With no `/repo`, the target is resolved by walking the current repository's namespace upward looking for a `_pm` project. If several are found you are prompted to pick one.
+
+With `/repo`, leading and trailing slashes are stripped automatically, and full URLs or SSH remotes are accepted:
+
+```
+/repo /tools/itw_python_builder/          → tools/itw_python_builder
+/repo https://git.it-works.io/tools/x.git → tools/x
+/repo git@git.it-works.io:tools/x.git     → tools/x
+```
+
+### Milestones, Labels and Duplicates
+
+Milestones, labels and issue titles are matched with a shared fuzzy comparison at 95% similarity, so small differences in spacing or casing still count as a match. Digit runs must be identical (`java 38` does not match `java 37`). The threshold is a single constant (`SIMILARITY_THRESHOLD` in `task_utils.py`) if you need to tune it.
+
+- **Milestone** — an existing project or parent-group milestone with the same title is reused; otherwise it is created (with the start/end dates when both are given).
+- **Label** — a similar existing label is linked and logged in white; a new one is created and logged in green. An empty `/label` is never sent to GitLab.
+- **Duplicate issues** — before creating, the target project is searched by title. A match in the same milestone, or an unassigned issue with the same title, is treated as a duplicate and skipped.
+
+### Acceptance Criteria and Comments
+
+The `## Acceptance Criteria` section must be opened and closed with the same header. When omitted or left with empty checkboxes, a default checklist is applied.
+
+The `## Comment` section, opened and closed the same way, is posted as a note on the issue after it is created.
+
+## Requirements
+
+- Python 3.10+
+- Podman
+- Git
+- SonarQube server
+- Node.js and npm (frontend projects)
+
+## 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 (backend) or `package.json` (frontend)
+- `Dockerfile` (backend)
+- `sonar-project.properties`
+
+## License
+
+MIT

{itw_python_builder-0.2.13.dist-info → itw_python_builder-0.2.15.dist-info}/RECORD

@@ -3,18 +3,18 @@ itw_python_builder/__init__.py,sha256=0HwEqonfK8w1kx80BOX80fvxSL8ov1hmUD2Zi4SU75
 itw_python_builder/cli.py,sha256=UKnswr7vzLC6SnB5YgxWu8ZLbOe8WGStdUHCgkzkyqM,939
 itw_python_builder/notify.py,sha256=Rv1RA9QdDo00bvjMMSDq-oQh2pjDmjjj97yzzhgiwpM,3011
 itw_python_builder/ssr_tasks.py,sha256=TqkuGLH9XJqDkTPBuRnFAKJywYqvdf0lSlSMXtVPM5Y,15730
-itw_python_builder/task_utils.py,sha256=qohNLpIaodGmm9-FOOPL697Q3QZrrQkcK63AKhJcKZY,12683
-itw_python_builder/tasks.py,sha256=rnhUmJOH6mvoSOIN8-O7LhAEAinmIboaq27dbbMZ4h0,33043
-itw_python_builder/utils.py,sha256=exgIMPN5lsxMfW2XeRdqbF9vzresyAEEQ3evMwYx5K0,19766
+itw_python_builder/task_utils.py,sha256=VGTjuWxcMxCOXDc2yGKrqN5Y6lyffCYN5KHbP1VY85U,15347
+itw_python_builder/tasks.py,sha256=_I-hbfHzA7JRkleX7MkmxKi3lLzcrxTh8MIqgQzbCpQ,33617
+itw_python_builder/utils.py,sha256=wKNJM64Vl3O3KbyTSNYu6RelhWgmlapGOUGUokap9Pk,21294
 itw_python_builder/version.py,sha256=RCSKNU4eblCP38-PH5hT6qMDKOyQq5YGCoT2mgpfZkE,3165
 itw_python_builder/_pyruntime/sitecustomize.py,sha256=cjTrKErMdAFI-uVuW60BNNF8X41NrH9XDrIHJlNlEtY,805
 itw_python_builder/templates/new_version_email.html,sha256=I0RuZ8UMBavXTaSzQJQP1wNjsDY5TtxrASgeGiX0NGo,2854
 itw_python_builder/templates/server.sitemap.snippet.ts,sha256=qjRCLiAqzDUTqsWxJLeqlr-jOluK0IE2IoN_lbSx0ec,669
 itw_python_builder/templates/sitemap.routes.ts,sha256=yOXZ8TpHq_-QKH7y_u75XpL8paCF4AEv5z5cvWeI7yY,1323
 itw_python_builder/templates/task_template.md,sha256=SxoaWOuQVru6xNTLmhICkDoOSuHPM2B5FiVO67i7ciM,345
-itw_python_builder-0.2.13.dist-info/licenses/LICENSE,sha256=WZ75-earCxnov77gsH4vckNf7Ag8RPst-7y9dPaZTCU,1063
-itw_python_builder-0.2.13.dist-info/METADATA,sha256=bu_Z8CtKfcR_wKJesNmUAmezonLffgHy7VOMt1YnRtc,4928
-itw_python_builder-0.2.13.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
-itw_python_builder-0.2.13.dist-info/entry_points.txt,sha256=Rx2zlbaCxl954YX8kF4hey3Y25fxsaxiEPXjBPw3ky0,52
-itw_python_builder-0.2.13.dist-info/top_level.txt,sha256=9djpWUrRa0vuSfdVrHc4-3gvAHbBvzh_lbyzgTHtkJA,19
-itw_python_builder-0.2.13.dist-info/RECORD,,
+itw_python_builder-0.2.15.dist-info/licenses/LICENSE,sha256=WZ75-earCxnov77gsH4vckNf7Ag8RPst-7y9dPaZTCU,1063
+itw_python_builder-0.2.15.dist-info/METADATA,sha256=RrfIX8iXpf0yVBzkqAUVU3ZIlKdjaoqnLIJwTwzaPaw,11369
+itw_python_builder-0.2.15.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+itw_python_builder-0.2.15.dist-info/entry_points.txt,sha256=Rx2zlbaCxl954YX8kF4hey3Y25fxsaxiEPXjBPw3ky0,52
+itw_python_builder-0.2.15.dist-info/top_level.txt,sha256=9djpWUrRa0vuSfdVrHc4-3gvAHbBvzh_lbyzgTHtkJA,19
+itw_python_builder-0.2.15.dist-info/RECORD,,

{itw_python_builder-0.2.13.dist-info → itw_python_builder-0.2.15.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (83.0.0)
+Generator: setuptools (84.0.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

itw_python_builder-0.2.13.dist-info/METADATA

@@ -1,166 +0,0 @@
-Metadata-Version: 2.4
-Name: itw_python_builder
-Version: 0.2.13
-Summary: Standardized Django deployment pipeline with Docker, testing, and SonarQube integration
-Author-email: IT-Works <contact@it-works.io>
-License: MIT
-Project-URL: Homepage, https://git.it-works.io/
-Project-URL: Repository, https://git.it-works.io/
-Project-URL: Issues, https://git.it-works.io/
-Keywords: django,deployment,docker,ci-cd,sonarqube
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Software Development :: Build Tools
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: invoke>=2.0.0
-Requires-Dist: pylint>=3.0.0
-Requires-Dist: pylint-django>=2.5.0
-Requires-Dist: python-decouple>=3.8
-Requires-Dist: requests>=2.28.0
-Dynamic: license-file
-
-# 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
-```bash
-pip install itw-python-builder
-```
-
-Install globally (outside any project venv). The `itw` command becomes available system-wide.
-
-## Quick Start
-
-1. Navigate to your Django project directory (must have a `.venv` or `venv`):
-
-2. Initialize versioning:
-```bash
-itw tag-init
-```
-
-3. Run local pipeline:
-```bash
-itw pipelinelocal
-```
-
-4. Deploy to staging:
-```bash
-itw incrementrc
-```
-
-5. Deploy to production:
-```bash
-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
-```bash
-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.
-```bash
-# Review issues with human-readable output
-itw lintlocal
-
-# Generate report files for SonarQube
-itw lint
-```
-
-Add this to your `sonar-project.properties`:
-```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