Skip to content

release: v0.4.0#53

Merged
alphacrack merged 1 commit into
developmentfrom
release/v0.4.0
Jul 23, 2026
Merged

release: v0.4.0#53
alphacrack merged 1 commit into
developmentfrom
release/v0.4.0

Conversation

@alphacrack

@alphacrack alphacrack commented Jul 23, 2026

Copy link
Copy Markdown
Owner

Summary

Prepares the v0.4.0 release — the first PyPI publish since 0.2.0. (0.3.0 was an internal release documented in the CHANGELOG but never tagged or pushed to PyPI; this release bundles that hardening work plus everything merged since.)

Version bump

  • maithili_dsl/__init__.py → 0.4.0 (source of truth)
  • pyproject.toml → 0.4.0
  • setup.py reads from __init__ — verified setup.py --version = 0.4.0

CHANGELOG

What's in 0.4.0 (since 0.3.0)

Pre-release checks (local)

  • ✅ 151 tests pass
  • ✅ all examples run (error.dmai fails as intended)
  • ✅ python -m build produces python_maithili-0.4.0 sdist + wheel
  • ✅ twine check --strict PASSED on both artifacts
  • ✅ version strings consistent across all three locations

⚠️ Publishing is NOT triggered by this PR

This only stages the release commit. After merge, the actual publish path per docs/RELEASE.md is: merge to main → create GitHub Release v0.4.0 → OIDC pipeline publishes to PyPI (with the pypi environment approval gate). I will not trigger any publish without your explicit go-ahead.

Motivation / Audit Reference

Closes the v0.4.0 milestone release prep.

Security Considerations

N/A — version/metadata only.

Breaking Changes

Python 3.9 users can no longer install new releases (3.9 is EOL). Existing installs unaffected.

🤖 Generated with Claude Code

@alphacrack @claude
release: v0.4.0
c9f3c44 
Bump version to 0.4.0 across __init__.py, pyproject.toml (setup.py reads
from __init__). Finalize CHANGELOG: promote [Unreleased] to [0.4.0] dated
2026-07-23, consolidate the fixed entries, and add the coverage-gate (#42)
and examples README (#41) entries that were merged without changelog lines.

First PyPI publish since 0.2.0 (0.3.0 was never pushed to the index).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@alphacrack alphacrack added this to the v0.4.0 milestone Jul 23, 2026
@alphacrack alphacrack added packaging setup.py, pyproject, PyPI, distribution P1 High priority: fix soon labels Jul 23, 2026
@alphacrack
alphacrack merged commit ea68b13 into development Jul 23, 2026
7 checks passed
@alphacrack
alphacrack deleted the release/v0.4.0 branch July 23, 2026 18:44
@alphacrack alphacrack mentioned this pull request Jul 23, 2026
Merged
alphacrack added a commit that referenced this pull request Jul 23, 2026
@alphacrack Bishwas Jha
@claude @Sanjays2402 @dependabot @hanu-14 MOHAMMED HANAN M T P
release: promote development → main for v0.4.0 (#54)
fe75478 
* ci(publish): add PyPI publish pipeline via Trusted Publishing (OIDC)

Adds a two-stage publish workflow that ships python_maithili to
PyPI without storing long-lived API tokens in GitHub. Three
triggers, three behaviours:

  - release.published (non-prerelease) -> publishes to production
    PyPI (environment: pypi, with optional manual-approval gate)
  - release.published (prerelease) OR workflow_dispatch target=testpypi
    -> publishes to TestPyPI (environment: testpypi, staging/verification)
  - workflow_dispatch target=build-only -> builds + twine-checks, no
    network publish (credential-free dry run)

Every path runs the same build job first: python -m build, twine
check --strict, install the wheel in a clean venv, run the full
pytest suite against the installed wheel. Only if the wheel itself
passes the test suite does anything get uploaded. The production
job additionally verifies that the GitHub Release tag (v0.X.Y)
matches __version__ in the package and refuses to publish on
mismatch — preventing accidental version drift.

Trusted Publishing was chosen over API tokens because:

  - No secrets to rotate or leak.
  - Scoped per environment: the pypi environment can be gated with
    required reviewers and tag-only deployment branches.
  - PyPI binds the trust to (owner, repo, workflow filename,
    environment), so a fork or a different workflow cannot publish
    on your behalf even if it runs on this repo.

The one-time setup (register Trusted Publisher on PyPI and pending
publisher on TestPyPI, create pypi + testpypi GitHub Environments)
is documented in the new docs/RELEASE.md, along with the routine
release checklist, version-bump convention, and recovery procedure
for bad releases.

build + twine added to requirements-dev.txt so contributors can
reproduce the build locally before opening a release PR.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* chore: add OSS community health files

- Issue templates (bug report, feature request, Maithili keyword proposal)
- CODE_OF_CONDUCT.md (Contributor Covenant 2.1)
- SUPPORT.md and issue template contact links (security reporting routed privately)
- CODEOWNERS for security-sensitive paths
- Label guide in CONTRIBUTING.md; CoC links in README/CONTRIBUTING
- Mark BACKLOG.md as historical (tracking moved to GitHub Issues)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* ci: add ci-ok aggregate gate job + Dependabot config

- ci-ok: single required-status-check target that fails if any test
  matrix leg fails, so branch protection survives matrix changes
- dependabot.yml: weekly github-actions + pip updates targeting
  development, labeled infra/needs-triage

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* fix(linter): accept augmented assignments

Strip augmented-assignment operators before validating the target name. Add regression coverage for every reported arithmetic operator.

* chore(deps): bump actions/upload-artifact from 4 to 7 (#14)

Bumps [actions/upload-artifact](https://github.com/actions/upload-artifact) from 4 to 7.
- [Release notes](https://github.com/actions/upload-artifact/releases)
- [Commits](actions/upload-artifact@v4...v7)

---
updated-dependencies:
- dependency-name: actions/upload-artifact
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* chore(deps): bump actions/setup-python from 5 to 6 (#15)

Bumps [actions/setup-python](https://github.com/actions/setup-python) from 5 to 6.
- [Release notes](https://github.com/actions/setup-python/releases)
- [Commits](actions/setup-python@v5...v6)

---
updated-dependencies:
- dependency-name: actions/setup-python
  dependency-version: '6'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* chore(deps): bump actions/checkout from 4 to 7 (#16)

Bumps [actions/checkout](https://github.com/actions/checkout) from 4 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v4...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* chore(deps): bump actions/download-artifact from 4 to 8 (#17)

Bumps [actions/download-artifact](https://github.com/actions/download-artifact) from 4 to 8.
- [Release notes](https://github.com/actions/download-artifact/releases)
- [Commits](actions/download-artifact@v4...v8)

---
updated-dependencies:
- dependency-name: actions/download-artifact
  dependency-version: '8'
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* chore(deps-dev): update twine requirement from <6,>=4.0 to >=6.2.0,<7 (#18)

Updates the requirements on [twine](https://github.com/pypa/twine) to permit the latest version.
- [Release notes](https://github.com/pypa/twine/releases)
- [Changelog](https://github.com/pypa/twine/blob/main/docs/changelog.rst)
- [Commits](pypa/twine@4.0.0...6.2.0)

---
updated-dependencies:
- dependency-name: twine
  dependency-version: 6.2.0
  dependency-type: direct:development
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* chore(deps-dev): update pytest-cov requirement (#20)

Updates the requirements on [pytest-cov](https://github.com/pytest-dev/pytest-cov) to permit the latest version.
- [Changelog](https://github.com/pytest-dev/pytest-cov/blob/master/CHANGELOG.rst)
- [Commits](pytest-dev/pytest-cov@v4.1.0...v7.1.0)

---
updated-dependencies:
- dependency-name: pytest-cov
  dependency-version: 7.1.0
  dependency-type: direct:development
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* chore(deps-dev): update pytest-timeout requirement (#21)

Updates the requirements on [pytest-timeout](https://github.com/pytest-dev/pytest-timeout) to permit the latest version.
- [Commits](pytest-dev/pytest-timeout@2.2.0...2.4.0)

---
updated-dependencies:
- dependency-name: pytest-timeout
  dependency-version: 2.4.0
  dependency-type: direct:development
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* chore: drop Python 3.9 support (EOL Oct 2025) (#52)

Removes 3.9 from the CI matrix, bumps requires-python to >=3.10, drops
the 3.9 classifier from pyproject.toml and setup.py, and updates the
README support line. Unblocks Dependabot PRs #19 (pytest 9) and #22
(build 1.5) which dropped 3.9 support.

Closes #44

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>

* chore(deps-dev): update pytest requirement from <9,>=7.4 to >=9.1.1,<10 (#19)

Updates the requirements on [pytest](https://github.com/pytest-dev/pytest) to permit the latest version.
- [Release notes](https://github.com/pytest-dev/pytest/releases)
- [Changelog](https://github.com/pytest-dev/pytest/blob/main/CHANGELOG.rst)
- [Commits](pytest-dev/pytest@7.4.0...9.1.1)

---
updated-dependencies:
- dependency-name: pytest
  dependency-version: 9.1.1
  dependency-type: direct:development
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* chore(deps-dev): update build requirement from <2,>=1.0 to >=1.5.0,<2 (#22)

Updates the requirements on [build](https://github.com/pypa/build) to permit the latest version.
- [Release notes](https://github.com/pypa/build/releases)
- [Changelog](https://github.com/pypa/build/blob/main/CHANGELOG.rst)
- [Commits](pypa/build@1.0.0...1.5.0)

---
updated-dependencies:
- dependency-name: build
  dependency-version: 1.5.0
  dependency-type: direct:development
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

* fix(linter): detect real function call sites (#48)

* fix(linter): detect real function call sites

Match declared functions at Devanagari-aware identifier boundaries and ignore string/comment contents when checking usage. Add regressions for longer identifiers and string literals.

* docs(changelog): note function-as-value trade-off for unused check

* docs: add examples/README.md describing each example program (fixes #41) (#47)

Co-authored-by: MOHAMMED HANAN M T P <hanu@example.com>
Co-authored-by: Bishwas Jha <18480504+alphacrack@users.noreply.github.com>

* ci: enforce coverage gate with fail_under = 85 (fixes #42) (#46)

Co-authored-by: MOHAMMED HANAN M T P <hanu@example.com>
Co-authored-by: Bishwas Jha <18480504+alphacrack@users.noreply.github.com>

* release: v0.4.0 (#53)

Bump version to 0.4.0 across __init__.py, pyproject.toml (setup.py reads
from __init__). Finalize CHANGELOG: promote [Unreleased] to [0.4.0] dated
2026-07-23, consolidate the fixed entries, and add the coverage-gate (#42)
and examples README (#41) entries that were merged without changelog lines.

First PyPI publish since 0.2.0 (0.3.0 was never pushed to the index).

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: Bishwas Jha <bishwasjha@Bishwass-MacBook-Pro.local>
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-authored-by: Sanjay Santhanam <51058514+Sanjays2402@users.noreply.github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: MOHAMMED HANAN M T P <91409429+hanu-14@users.noreply.github.com>
Co-authored-by: MOHAMMED HANAN M T P <hanu@example.com>
alphacrack added a commit that referenced this pull request Jul 23, 2026
@alphacrack Bishwas Jha
@claude @Sanjays2402 @dependabot @hanu-14 MOHAMMED HANAN M T P
release: promote development → main for v0.4.0 (#54) (#55)
1abf16d 
* ci(publish): add PyPI publish pipeline via Trusted Publishing (OIDC)

Adds a two-stage publish workflow that ships python_maithili to
PyPI without storing long-lived API tokens in GitHub. Three
triggers, three behaviours:

  - release.published (non-prerelease) -> publishes to production
    PyPI (environment: pypi, with optional manual-approval gate)
  - release.published (prerelease) OR workflow_dispatch target=testpypi
    -> publishes to TestPyPI (environment: testpypi, staging/verification)
  - workflow_dispatch target=build-only -> builds + twine-checks, no
    network publish (credential-free dry run)

Every path runs the same build job first: python -m build, twine
check --strict, install the wheel in a clean venv, run the full
pytest suite against the installed wheel. Only if the wheel itself
passes the test suite does anything get uploaded. The production
job additionally verifies that the GitHub Release tag (v0.X.Y)
matches __version__ in the package and refuses to publish on
mismatch — preventing accidental version drift.

Trusted Publishing was chosen over API tokens because:

  - No secrets to rotate or leak.
  - Scoped per environment: the pypi environment can be gated with
    required reviewers and tag-only deployment branches.
  - PyPI binds the trust to (owner, repo, workflow filename,
    environment), so a fork or a different workflow cannot publish
    on your behalf even if it runs on this repo.

The one-time setup (register Trusted Publisher on PyPI and pending
publisher on TestPyPI, create pypi + testpypi GitHub Environments)
is documented in the new docs/RELEASE.md, along with the routine
release checklist, version-bump convention, and recovery procedure
for bad releases.

build + twine added to requirements-dev.txt so contributors can
reproduce the build locally before opening a release PR.



* chore: add OSS community health files

- Issue templates (bug report, feature request, Maithili keyword proposal)
- CODE_OF_CONDUCT.md (Contributor Covenant 2.1)
- SUPPORT.md and issue template contact links (security reporting routed privately)
- CODEOWNERS for security-sensitive paths
- Label guide in CONTRIBUTING.md; CoC links in README/CONTRIBUTING
- Mark BACKLOG.md as historical (tracking moved to GitHub Issues)



* ci: add ci-ok aggregate gate job + Dependabot config

- ci-ok: single required-status-check target that fails if any test
  matrix leg fails, so branch protection survives matrix changes
- dependabot.yml: weekly github-actions + pip updates targeting
  development, labeled infra/needs-triage



* fix(linter): accept augmented assignments

Strip augmented-assignment operators before validating the target name. Add regression coverage for every reported arithmetic operator.

* chore(deps): bump actions/upload-artifact from 4 to 7 (#14)

Bumps [actions/upload-artifact](https://github.com/actions/upload-artifact) from 4 to 7.
- [Release notes](https://github.com/actions/upload-artifact/releases)
- [Commits](actions/upload-artifact@v4...v7)

---
updated-dependencies:
- dependency-name: actions/upload-artifact
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...




* chore(deps): bump actions/setup-python from 5 to 6 (#15)

Bumps [actions/setup-python](https://github.com/actions/setup-python) from 5 to 6.
- [Release notes](https://github.com/actions/setup-python/releases)
- [Commits](actions/setup-python@v5...v6)

---
updated-dependencies:
- dependency-name: actions/setup-python
  dependency-version: '6'
  dependency-type: direct:production
  update-type: version-update:semver-major
...




* chore(deps): bump actions/checkout from 4 to 7 (#16)

Bumps [actions/checkout](https://github.com/actions/checkout) from 4 to 7.
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](actions/checkout@v4...v7)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
...




* chore(deps): bump actions/download-artifact from 4 to 8 (#17)

Bumps [actions/download-artifact](https://github.com/actions/download-artifact) from 4 to 8.
- [Release notes](https://github.com/actions/download-artifact/releases)
- [Commits](actions/download-artifact@v4...v8)

---
updated-dependencies:
- dependency-name: actions/download-artifact
  dependency-version: '8'
  dependency-type: direct:production
  update-type: version-update:semver-major
...




* chore(deps-dev): update twine requirement from <6,>=4.0 to >=6.2.0,<7 (#18)

Updates the requirements on [twine](https://github.com/pypa/twine) to permit the latest version.
- [Release notes](https://github.com/pypa/twine/releases)
- [Changelog](https://github.com/pypa/twine/blob/main/docs/changelog.rst)
- [Commits](pypa/twine@4.0.0...6.2.0)

---
updated-dependencies:
- dependency-name: twine
  dependency-version: 6.2.0
  dependency-type: direct:development
...




* chore(deps-dev): update pytest-cov requirement (#20)

Updates the requirements on [pytest-cov](https://github.com/pytest-dev/pytest-cov) to permit the latest version.
- [Changelog](https://github.com/pytest-dev/pytest-cov/blob/master/CHANGELOG.rst)
- [Commits](pytest-dev/pytest-cov@v4.1.0...v7.1.0)

---
updated-dependencies:
- dependency-name: pytest-cov
  dependency-version: 7.1.0
  dependency-type: direct:development
...




* chore(deps-dev): update pytest-timeout requirement (#21)

Updates the requirements on [pytest-timeout](https://github.com/pytest-dev/pytest-timeout) to permit the latest version.
- [Commits](pytest-dev/pytest-timeout@2.2.0...2.4.0)

---
updated-dependencies:
- dependency-name: pytest-timeout
  dependency-version: 2.4.0
  dependency-type: direct:development
...




* chore: drop Python 3.9 support (EOL Oct 2025) (#52)

Removes 3.9 from the CI matrix, bumps requires-python to >=3.10, drops
the 3.9 classifier from pyproject.toml and setup.py, and updates the
README support line. Unblocks Dependabot PRs #19 (pytest 9) and #22
(build 1.5) which dropped 3.9 support.

Closes #44



* chore(deps-dev): update pytest requirement from <9,>=7.4 to >=9.1.1,<10 (#19)

Updates the requirements on [pytest](https://github.com/pytest-dev/pytest) to permit the latest version.
- [Release notes](https://github.com/pytest-dev/pytest/releases)
- [Changelog](https://github.com/pytest-dev/pytest/blob/main/CHANGELOG.rst)
- [Commits](pytest-dev/pytest@7.4.0...9.1.1)

---
updated-dependencies:
- dependency-name: pytest
  dependency-version: 9.1.1
  dependency-type: direct:development
...




* chore(deps-dev): update build requirement from <2,>=1.0 to >=1.5.0,<2 (#22)

Updates the requirements on [build](https://github.com/pypa/build) to permit the latest version.
- [Release notes](https://github.com/pypa/build/releases)
- [Changelog](https://github.com/pypa/build/blob/main/CHANGELOG.rst)
- [Commits](pypa/build@1.0.0...1.5.0)

---
updated-dependencies:
- dependency-name: build
  dependency-version: 1.5.0
  dependency-type: direct:development
...




* fix(linter): detect real function call sites (#48)

* fix(linter): detect real function call sites

Match declared functions at Devanagari-aware identifier boundaries and ignore string/comment contents when checking usage. Add regressions for longer identifiers and string literals.

* docs(changelog): note function-as-value trade-off for unused check

* docs: add examples/README.md describing each example program (fixes #41) (#47)




* ci: enforce coverage gate with fail_under = 85 (fixes #42) (#46)




* release: v0.4.0 (#53)

Bump version to 0.4.0 across __init__.py, pyproject.toml (setup.py reads
from __init__). Finalize CHANGELOG: promote [Unreleased] to [0.4.0] dated
2026-07-23, consolidate the fixed entries, and add the coverage-gate (#42)
and examples README (#41) entries that were merged without changelog lines.

First PyPI publish since 0.2.0 (0.3.0 was never pushed to the index).



---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: Bishwas Jha <bishwasjha@Bishwass-MacBook-Pro.local>
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Co-authored-by: Sanjay Santhanam <51058514+Sanjays2402@users.noreply.github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: MOHAMMED HANAN M T P <91409429+hanu-14@users.noreply.github.com>
Co-authored-by: MOHAMMED HANAN M T P <hanu@example.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

P1 High priority: fix soon packaging setup.py, pyproject, PyPI, distribution

Projects

None yet

Milestone

v0.4.0

Development

Successfully merging this pull request may close these issues.

1 participant

@alphacrack