@@ -34,16 +34,19 @@ release-X.Y ●──●────●───●───●───●
3434 │
3535 first commit on release-X.Y:
3636 - versions (prev).dev → X.Y.0rc0
37- - dapr deps >=(prev).dev → >=X.Y.0rc0
3837 simultaneously on main:
3938 - versions (prev).dev → X.Y.0.dev
40- - dapr deps >=(prev).dev → >=X.Y.0.dev
4139```
4240
41+ Only tag pushes (` v* ` ) publish to PyPI. Pushes to ` main ` and release branches
42+ do not publish anything.
43+
44+ Users who need the development builds can install from git
45+ (see the [ README] ( ./README.md#install-dapr-python-sdk ) ).
46+
4347## Version files
4448
45- Every package in this repository has one version file and, for extensions, one ` setup.cfg `
46- dependency line that must be kept in sync during a release.
49+ Every package in this repository has one version file.
4750
4851** Version files** (set ` __version__ ` ):
4952- ` dapr/version/version.py `
@@ -54,24 +57,16 @@ dependency line that must be kept in sync during a release.
5457- ` ext/dapr-ext-strands/dapr/ext/strands/version.py `
5558- ` ext/flask_dapr/flask_dapr/version.py `
5659
57- ** Dependency lower bounds** in extension ` setup.cfg ` files (each has ` dapr >= <version> ` ):
58- - ` ext/dapr-ext-workflow/setup.cfg `
59- - ` ext/dapr-ext-grpc/setup.cfg `
60- - ` ext/dapr-ext-fastapi/setup.cfg `
61- - ` ext/dapr-ext-langgraph/setup.cfg `
62- - ` ext/dapr-ext-strands/setup.cfg `
63- - ` ext/flask_dapr/setup.cfg `
64-
6560## Version string conventions
6661
67- | Stage | ` __version__ ` example | dep lower bound example |
68- | ---| ---| ---|
69- | Development (always on ` main ` ) | ` 1.17 .0.dev ` | ` dapr >= 1.17.0.dev ` |
70- | First RC (on ` release-X.Y ` ) | ` 1.17 .0rc0 ` | ` dapr >= 1.17.0rc0 ` |
71- | Subsequent RCs (on ` release-X.Y ` ) | ` 1.17 .0rc1 ` , ` 1.17 .0rc2 ` , … | ` dapr >= 1.17.0rc1 ` |
72- | Stable release | ` 1.17 .0 ` | ` dapr >= 1.17.0 ` |
73- | Patch release candidate | ` 1.17 .1rc1 ` | ` dapr >= 1.17.1rc1 ` |
74- | Stable patch release | ` 1.17 .1 ` | ` dapr >= 1.17.1 ` |
62+ | Stage | ` __version__ ` example |
63+ | ---------------------------------- | ----------------------------- |
64+ | Development (always on ` main ` ) | ` 1.18 .0.dev ` |
65+ | First RC (on ` release-X.Y ` ) | ` 1.18 .0rc0 ` |
66+ | Subsequent RCs (on ` release-X.Y ` ) | ` 1.18 .0rc1 ` , ` 1.18 .0rc2 ` , … |
67+ | Stable release | ` 1.18 .0 ` |
68+ | Patch release candidate | ` 1.18 .1rc1 ` |
69+ | Stable patch release | ` 1.18 .1 ` |
7570
7671## Remote convention
7772
@@ -94,17 +89,13 @@ git push upstream release-X.Y
9489
9590### 2. Bump versions on the release branch (first commit)
9691
97- On the newly created ` release-X.Y ` branch, open a PR ** targeting ` release-X.Y ` ** that does:
98-
99- - In all seven version files: change ` X.Y.0.dev ` → ` X.Y.0rc0 `
100- - In all six extension ` setup.cfg ` files: change ` dapr >= X.Y.0.dev ` → ` dapr >= X.Y.0rc0 `
92+ On the newly created ` release-X.Y ` branch, open a PR ** targeting ` release-X.Y ` ** that
93+ changes ` X.Y.0.dev ` → ` X.Y.0rc0 ` in all the version files.
10194
10295### 3. Bump versions on ` main ` (second commit)
10396
104- Open a PR targeting ` main ` to align it with the new release version:
105-
106- - In all seven version files: change the previous dev version to ` X.Y.0.dev `
107- - In all six extension ` setup.cfg ` files: change the previous ` dapr >= ...dev ` to ` dapr >= X.Y.0.dev `
97+ Open a PR targeting ` main ` that changes the previous dev version to ` X.Y.0.dev ` in all
98+ the version files.
10899
109100### 4. Push the tag
110101
@@ -127,10 +118,8 @@ Perform this when you want to publish `X.Y.0rcN` (N ≥ 1) from an existing `rel
127118
128119### 1. Bump versions on the release branch
129120
130- Open a PR ** targeting ` release-X.Y ` ** that does:
131-
132- - In all seven version files: change ` X.Y.0rc(N-1) ` → ` X.Y.0rcN `
133- - In all six extension ` setup.cfg ` files: change ` dapr >= X.Y.0rc(N-1) ` → ` dapr >= X.Y.0rcN `
121+ Open a PR ** targeting ` release-X.Y ` ** that changes ` X.Y.0rc(N-1) ` → ` X.Y.0rcN ` in all
122+ the version files.
134123
135124### 2. Push the tag
136125
@@ -150,10 +139,8 @@ initial `X.Y.0` or a patch release (`X.Y.1`, `X.Y.2`, …).
150139
151140### 1. Bump versions on the release branch
152141
153- Open a PR ** targeting ` release-X.Y ` ** that does:
154-
155- - In all seven version files: change ` X.Y.ZrcN ` → ` X.Y.Z ` (drop the ` rcN ` suffix)
156- - In all six extension ` setup.cfg ` files: change ` dapr >= X.Y.ZrcN ` → ` dapr >= X.Y.Z `
142+ Open a PR ** targeting ` release-X.Y ` ** that drops the ` rcN ` suffix in all the version
143+ files: ` X.Y.ZrcN ` → ` X.Y.Z ` .
157144
158145### 2. Push the tag
159146
0 commit comments