release: 3.0.0 (#254)

* perf(client): optimize file structure copying in multipart requests

* chore(tests): bump steady to v0.22.1

* chore(internal): more robust bootstrap script

* fix: use correct field name format for multipart file arrays

* feat: support setting headers via env

* codegen metadata

* codegen metadata

* chore(internal): reformat pyproject.toml

* fix(client): add missing f-string prefix in file type error message

* feat(internal/types): support eagerly validating pydantic iterators

* ci: pin GitHub Actions to commit SHAs

Pin all GitHub Actions referenced in generated workflows (both
first-party `actions/*` and third-party) to immutable commit SHAs.
Updating pinned actions is now a deliberate codegen-side bump rather
than implicit on every workflow run.

* fix: treat text/plan with format: binary as raw upload

* release: 3.0.0

---------

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

Author: stainless-app[bot]

.github/workflows/ci.yml

@@ -21,7 +21,7 @@ jobs:
     runs-on: ${{ github.repository == 'stainless-sdks/writer-python' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     if: (github.event_name == 'push' || github.event.pull_request.head.repo.fork) && (github.event_name != 'push' || github.event.head_commit.message != 'codegen metadata')
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Install Rye
         run: |
@@ -46,7 +46,7 @@ jobs:
       id-token: write
     runs-on: ${{ github.repository == 'stainless-sdks/writer-python' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Install Rye
         run: |
@@ -67,7 +67,7 @@ jobs:
           github.repository == 'stainless-sdks/writer-python' &&
           !startsWith(github.ref, 'refs/heads/stl/')
         id: github-oidc
-        uses: actions/github-script@v8
+        uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0
         with:
           script: core.setOutput('github_token', await core.getIDToken());
 
@@ -87,7 +87,7 @@ jobs:
     runs-on: ${{ github.repository == 'stainless-sdks/writer-python' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Install Rye
         run: |

.github/workflows/publish-pypi.yml

@@ -14,7 +14,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Install Rye
         run: |

.github/workflows/release-doctor.yml

@@ -12,7 +12,7 @@ jobs:
     if: github.repository == 'writer/writer-python' && (github.event_name == 'push' || github.event_name == 'workflow_dispatch' || startsWith(github.head_ref, 'release-please') || github.head_ref == 'next')
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Check release environment
         run: |

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "3.0.0-rc1"
+  ".": "3.0.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 30
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/writerai%2Fwriter-ea6b4de3976794a02ea8fc01669d901cd7b159ba0d598cc9653e01c987a2f806.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/writerai/writer-275de8f7afa2d37404ebebc082dda35e70ab94437de270b5bc6e2fdc94c9fdae.yml
 openapi_spec_hash: 4d4a9ba232d19a6180e6d4a7d5566103
 config_hash: 8701b1a467238f1afdeceeb7feb1adc6

CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## 3.0.0 (2026-06-02)
+
+Full Changelog: [v3.0.0-rc1...v3.0.0](https://github.com/writer/writer-python/compare/v3.0.0-rc1...v3.0.0)
+
+### Features
+
+* **internal/types:** support eagerly validating pydantic iterators ([324b108](https://github.com/writer/writer-python/commit/324b1081959e99879dca3ff2e26681904e83963a))
+* support setting headers via env ([78f3187](https://github.com/writer/writer-python/commit/78f3187470d4e515c1c6f7d05b6eb1ea5bc52c7c))
+
+
+### Bug Fixes
+
+* **client:** add missing f-string prefix in file type error message ([958f3ee](https://github.com/writer/writer-python/commit/958f3eee1c5a1e719871f2c8bb3cd56384107756))
+* treat text/plan with format: binary as raw upload ([71e3e9e](https://github.com/writer/writer-python/commit/71e3e9eced88dc65ff3e19375f9396b4ee39f76e))
+* use correct field name format for multipart file arrays ([0fc449c](https://github.com/writer/writer-python/commit/0fc449c31140dc028795b5dec9e96108d383e644))
+
+
+### Performance Improvements
+
+* **client:** optimize file structure copying in multipart requests ([9f217a1](https://github.com/writer/writer-python/commit/9f217a150d0f2035bd3d84256886bb3fe23b9db4))
+
+
+### Chores
+
+* **internal:** more robust bootstrap script ([cec8c09](https://github.com/writer/writer-python/commit/cec8c0965b639b633a5d53a1a5a33780cd00af48))
+* **internal:** reformat pyproject.toml ([ddec191](https://github.com/writer/writer-python/commit/ddec1911c7f2bf22dbc508da84081f787a22293a))
+* **tests:** bump steady to v0.22.1 ([8989979](https://github.com/writer/writer-python/commit/898997940ea34e3d3eddaf69556195ad64a17ab3))
+
 ## 3.0.0-rc1 (2026-04-13)
 
 Full Changelog: [v2.4.0...v3.0.0-rc1](https://github.com/writer/writer-python/compare/v2.4.0...v3.0.0-rc1)

README.md

@@ -28,7 +28,7 @@ To install the package from PyPI, use `pip`:
 
 ```sh
 # install from PyPI
-pip install --pre writer-sdk
+pip install writer-sdk
 ```
 
 ## Prequisites
@@ -125,7 +125,7 @@ You can enable this by installing `aiohttp`:
 
 ```sh
 # install from PyPI
-pip install --pre writer-sdk[aiohttp]
+pip install writer-sdk[aiohttp]
 ```
 
 Then you can enable it by instantiating the client with `http_client=DefaultAioHttpClient()`:

api.md

@@ -155,7 +155,7 @@ Methods:
 - <code title="delete /v1/files/{file_id}">client.files.<a href="./src/writerai/resources/files.py">delete</a>(file_id) -> <a href="./src/writerai/types/file_delete_response.py">FileDeleteResponse</a></code>
 - <code title="get /v1/files/{file_id}/download">client.files.<a href="./src/writerai/resources/files.py">download</a>(file_id) -> BinaryAPIResponse</code>
 - <code title="post /v1/files/retry">client.files.<a href="./src/writerai/resources/files.py">retry</a>(\*\*<a href="src/writerai/types/file_retry_params.py">params</a>) -> <a href="./src/writerai/types/file_retry_response.py">FileRetryResponse</a></code>
-- <code title="post /v1/files">client.files.<a href="./src/writerai/resources/files.py">upload</a>(\*\*<a href="src/writerai/types/file_upload_params.py">params</a>) -> <a href="./src/writerai/types/file.py">File</a></code>
+- <code title="post /v1/files">client.files.<a href="./src/writerai/resources/files.py">upload</a>(content, \*\*<a href="src/writerai/types/file_upload_params.py">params</a>) -> <a href="./src/writerai/types/file.py">File</a></code>
 
 # Tools
 

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "writer-sdk"
-version = "3.0.0-rc1"
+version = "3.0.0"
 description = "The official Python library for the writer API"
 dynamic = ["readme"]
 license = "Apache-2.0"
@@ -172,7 +172,7 @@ show_error_codes = true
 #
 # We also exclude our `tests` as mypy doesn't always infer
 # types correctly and Pyright will still catch any type errors.
-exclude = ['src/writerai/_files.py', '_dev/.*.py', 'tests/.*']
+exclude = ["src/writerai/_files.py", "_dev/.*.py", "tests/.*"]
 
 strict_equality = true
 implicit_reexport = true

scripts/bootstrap

@@ -4,7 +4,7 @@ set -e
 
 cd "$(dirname "$0")/.."
 
-if [ -f "Brewfile" ] && [ "$(uname -s)" = "Darwin" ] && [ "$SKIP_BREW" != "1" ] && [ -t 0 ]; then
+if [ -f "Brewfile" ] && [ "$(uname -s)" = "Darwin" ] && [ "${SKIP_BREW:-}" != "1" ] && [ -t 0 ]; then
   brew bundle check >/dev/null 2>&1 || {
     echo -n "==> Install Homebrew dependencies? (y/N): "
     read -r response