Migrations
Migrations
Most updates need nothing from you: cad installs every new release of its major version by itself, and cad update does it now. A new major version waits for you: run cad update --major (Updating).
A release that breaks something comes with a migration guide. Each guide says what changed and what to change in a project written for the earlier release. Below 1.0, a breaking change bumps the minor version, so the guides are named for the minor versions they move between.
| From | To | Guide |
|---|---|---|
| 0.10 | 0.11 | Migrating from 0.10 to 0.11 |
| 0.8 | 0.10 | Migrating from 0.8 to 0.10 |
| 0.7 | 0.8 | Migrating from 0.7 to 0.8 |
| 0.4 | 0.5 | Migrating from 0.4 to 0.5 |
One guide follows a dependency instead of a release: moving to OpenCASCADE 8, for model code that uses build123d methods 0.12 removed or calls the kernel directly.
The guides are files in the repository, under docs/migrations, and are shown here as they are written there.