|
2 | 2 |
|
3 | 3 | All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines. |
4 | 4 |
|
| 5 | +## [4.0.0](https://github.com/box/box-python-sdk/compare/v3.14.0...v4.0.0) (2025-10-23) |
| 6 | + |
| 7 | +Introducing a new major version of Box Python SDK `v4` that includes two packages — the manually maintained `boxsdk` package and the generated `box_sdk_gen` package. The coexisting packages provide easier access to the latest Box API features and support gradual migration to the standalone generated namespace. |
| 8 | + |
| 9 | +### Breaking Changes |
| 10 | + |
| 11 | +- `v4` of Box Python SDK supports Python versions: 3.8+. Compared to `v3`, Python 3.6 and 3.7 are no longer supported. |
| 12 | + |
| 13 | +For more information about migrating to v4 visit [v3 to v4 migration guide](https://github.com/box/box-python-sdk/blob/combined-sdk/migration-guides/from-v3-to-v4.md) |
| 14 | + |
| 15 | +### What's New in `v4` |
| 16 | + |
| 17 | +With this SDK version, alongside the existing `boxsdk` package, we’re introducing a new `box_sdk_gen` package, which gives you access to: |
| 18 | + |
| 19 | +- **Full API Support** — Complete coverage of the Box API ecosystem, giving you access to all the latest features and functionalities to build feature-rich applications. |
| 20 | + |
| 21 | +- **Rapid API Updates** — Our new auto-generation approach enables Box API additions within days, ensuring you can leverage the most up-to-date features without delay. |
| 22 | + |
| 23 | +- **Embedded Documentation** — All objects and parameters are documented directly in the SDK source code, keeping essential information in one place. |
| 24 | + |
| 25 | +- **Enhanced Convenience Methods** — New methods for authentication, chunk uploads, automatic retries, retry strategy, and more. |
| 26 | + |
| 27 | +### Important Notes |
| 28 | + |
| 29 | +This version allows you to gradually migrate your codebase to the `box_sdk_gen` package. The key differences between the packages are documented in the [package migration guide](https://github.com/box/box-python-sdk/blob/combined-sdk/migration-guides/from-boxsdk-to-box_sdk_gen.md). |
| 30 | + |
| 31 | +Ultimately, we recommend to migrate to `v10` which includes only the generated `box_sdk_gen` package. To migrate from `v4` to `v10` follow this [migration guide](https://github.com/box/box-python-sdk/blob/combined-sdk/migration-guides/from-v4-to-v10.md). |
| 32 | + |
| 33 | +For more information, see the [SDK versioning strategy document](https://developer.box.com/guides/tooling/sdks/sdk-versioning/). Follow developer changelog for future updates. |
| 34 | + |
5 | 35 | ## [3.14.0](https://github.com/box/box-python-sdk/compare/v3.13.0...v3.14.0) (2025-04-09) |
6 | 36 |
|
7 | 37 |
|
|
0 commit comments