From 24511a60cffa88b8c5edcaf411f5f53a7157173e Mon Sep 17 00:00:00 2001 From: Daraan Date: Wed, 21 May 2025 18:13:13 +0200 Subject: [PATCH 1/4] Add development versioning --- CONTRIBUTING.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 1b030d56..1dc35bf0 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -24,6 +24,10 @@ Starting with version 4.0.0, `typing_extensions` uses [Semantic Versioning](https://semver.org/). See the documentation for more detail. +## Development versions +After meaningful updates, but without concrete plans for a release, the version can pre increased once in [pyproject.toml](/pyproject.toml) file and appended with a `.dev` suffix, e.g. `4.0.1.dev`. +Further development versions adjust their suffix in following increasing way `.dev1`, `.dev2`, ... + # Type stubs A stub file for `typing_extensions` is maintained @@ -54,7 +58,7 @@ may have installed. # Workflow for PyPI releases - Make sure you follow the versioning policy in the documentation - (e.g., release candidates before any feature release) + (e.g., release candidates before any feature release, do not release development versions) - Ensure that GitHub Actions reports no errors. From f457e7ae3b87b78af53bb97fae37e008e29a66ad Mon Sep 17 00:00:00 2001 From: Daraan Date: Sat, 28 Jun 2025 12:18:03 +0200 Subject: [PATCH 2/4] feedback --- CONTRIBUTING.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 1dc35bf0..3f50a7ee 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -25,8 +25,8 @@ Starting with version 4.0.0, `typing_extensions` uses for more detail. ## Development versions -After meaningful updates, but without concrete plans for a release, the version can pre increased once in [pyproject.toml](/pyproject.toml) file and appended with a `.dev` suffix, e.g. `4.0.1.dev`. -Further development versions adjust their suffix in following increasing way `.dev1`, `.dev2`, ... +After a release the version is increased once in the [pyproject.toml](/pyproject.toml) file and appended with a `.dev` suffix, e.g. `4.0.1.dev`. +Further subsequent updates, i.e. to `.dev2`, are not planned between releases. # Type stubs From 31e48e2a42fc363c092e3d17c9c6b5b702019b1e Mon Sep 17 00:00:00 2001 From: Daraan Date: Sat, 28 Jun 2025 12:37:43 +0200 Subject: [PATCH 3/4] dev version after a release --- CONTRIBUTING.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 3f50a7ee..6f8d80e1 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -24,8 +24,9 @@ Starting with version 4.0.0, `typing_extensions` uses [Semantic Versioning](https://semver.org/). See the documentation for more detail. -## Development versions -After a release the version is increased once in the [pyproject.toml](/pyproject.toml) file and appended with a `.dev` suffix, e.g. `4.0.1.dev`. +## Development version +After a release the version is increased once in [pyproject.toml](/pyproject.toml) and +appended with a `.dev` suffix, e.g. `4.0.1.dev`. Further subsequent updates, i.e. to `.dev2`, are not planned between releases. # Type stubs @@ -72,3 +73,6 @@ may have installed. - Release automation will finish the release. You'll have to manually approve the last step before upload. + +- After the release has been published on PyPI the version of the repositiory + is upgraded to the next [development versions](#development-version). From 0468ba863eefd39f327e9299044501eca7c9a4ef Mon Sep 17 00:00:00 2001 From: Daniel Sperber Date: Wed, 2 Jul 2025 14:51:41 +0200 Subject: [PATCH 4/4] Apply feedback with open TODO --- CONTRIBUTING.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 6f8d80e1..625f6cb6 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -27,7 +27,7 @@ for more detail. ## Development version After a release the version is increased once in [pyproject.toml](/pyproject.toml) and appended with a `.dev` suffix, e.g. `4.0.1.dev`. -Further subsequent updates, i.e. to `.dev2`, are not planned between releases. +Further subsequent updates are not planned between releases. # Type stubs @@ -74,5 +74,4 @@ may have installed. - Release automation will finish the release. You'll have to manually approve the last step before upload. -- After the release has been published on PyPI the version of the repositiory - is upgraded to the next [development versions](#development-version). +- After the release has been published on PyPI upgrade the version in number in [pyproject.toml](/pyproject.toml) to a `dev` version of the next planned release. For example, change 4.1.1 to 4.X.X.dev, see also [Development versions](#development-version). # TODO decide on major vs. minor increase.