v0.17.0

🏆 Highlights

• Added a new optype.JustAny type that only accepts Any (docs)
• Removed the generic type parameter of optype.dataclasses.HasDataclassFields, and turn __dataclass_fields__ into a ClassVar. This fixes an assignability issue with dataclass instances.

What's Changed

optype

• optype.JustAny by @jorenham in #545

optype.dataclasses

• dataclasses: remove HasDataclassFields type parameter, use ClassVar by @nstarman in #548

Maintenance

4 pull requests

• update development dependencies by @jorenham in #550
• Bump the actions group with 2 updates by @dependabot[bot] in #551
• Bump the actions group with 5 updates by @dependabot[bot] in #552
• update development dependencies by @jorenham in #553

Full Changelog: v0.16.0...v0.17.0

documentation: https://jorenham.github.io/optype/

v0.16.0

Highlights

• Dedicated documentation: https://jorenham.github.io/optype/
• New experimental (type-check-only) optype.test module (docs)
• optype.dataclasses.HasDataclassFields (docs) can now be used in issubclass
• Fixed an ImportError in optype.typing (docs) on Python 3.13+ when typing_extensions is not installed

Other changes

optype.numpy

• test with numpy 2.4 by @jorenham in #496
• increase numpy lower bound to 1.26 by @jorenham in #524

optype.dataclasses

• Dataclass improvements by @nstarman in #514

optype.test

• new experimental optype.test module by @jorenham in #544

optype.typing

• optype.typing: fix ImportError without typing_extensions on python>=3.13 by @jorenham in #526

Documentation

• Docs by @nstarman in #515
• add logo to basedpyright badge by @jorenham in #525
• docs deployment action workflow by @jorenham in #530
• enable cookieless analytics in posthog by @jorenham in #533
• remove outdated README docs and high-level description by @jorenham in #535

Dependencies

• Bump pyrefly from 0.44.2 to 0.45.0 in the actions group by @dependabot[bot] in #492
• Bump the actions group with 5 updates by @dependabot[bot] in #494
• update development dependencies by @jorenham in #495
• Bump ty from 0.0.4 to 0.0.5 in the actions group by @dependabot[bot] in #497
• ⬆️ ty 0.0.6 and basedpyright 1.36.2 by @jorenham in #498
• ⬆️ upgrade development dependencies by @jorenham in #501
• Bump the actions group with 3 updates by @dependabot[bot] in #503
• ⬆️ update development dependencies by @jorenham in #506
• Pyrefly 0.48.2 by @jorenham in #509
• Bump the actions group across 1 directory with 2 updates by @dependabot[bot] in #510
• upgrade development dependencies by @jorenham in #513
• bump dev deps by @jorenham in #516
• Bump pyrefly from 0.50.1 to 0.51.0 in the actions group by @dependabot[bot] in #519
• bump ruff to 0.15.0 by @jorenham in #520
• update development dependencies by @jorenham in #522
• bump uv_build to 0.10 by @jorenham in #523
• Bump pyrefly from 0.51.2 to 0.52.0 in the actions group by @dependabot[bot] in #528
• update development dependencies by @jorenham in #529
• pyrefly 0.53.0 and other updates by @jorenham in #542

Continuous integration

• Bump the actions group with 2 updates by @dependabot[bot] in #491
• Bump astral-sh/setup-uv from 7.1.5 to 7.1.6 in the actions group by @dependabot[bot] in #493
• Bump crate-ci/typos from 1.40.0 to 1.40.1 in the actions group by @dependabot[bot] in #499
• Bump crate-ci/typos from 1.40.1 to 1.41.0 in the actions group by @dependabot[bot] in #502
• Bump the actions group with 2 updates by @dependabot[bot] in #504
• Bump crate-ci/typos from 1.42.0 to 1.42.1 in the actions group by @dependabot[bot] in #507
• Bump the actions group with 2 updates by @dependabot[bot] in #511
• Bump the actions group with 2 updates by @dependabot[bot] in #518
• Bump the actions group with 2 updates by @dependabot[bot] in #527
• automatic dprint config update workflow by @jorenham in #536
• update-dprint workflow tweaks by @jorenham in #538
• Bump crate-ci/typos from 1.43.4 to 1.43.5 in the actions group by @dependabot[bot] in #540

Other Changes

• bump to 0.15.1.dev0 by @jorenham in #490
• add .gitattributes for better handling of lockfile merge conflicts by @jorenham in #517
• avoid an error in typos==1.43.0 by @jorenham in #521
• fix docs deploy branch by @jorenham in #531
• configure posthog for web analytics by @jorenham in #532
• update pyproject.toml documentation url by @jorenham in #534
• stricter pyrefly config by @jorenham in #543

New Contributors

• @nstarman made their first contribution in #514

Full Changelog: v0.15.0...v0.16.0

v0.15.0

Highlights

• BREAKING: Certain optype.Can* generic type-parameters intended for literal types have been removed. This affects the following protocols:

  • CanBytes
  • CanStr
  • CanIndex
  • CanRepr
  • CanFormat
  • CanDelattr
  • CanLen
  • CanLengthHint
  • CanBuffer
  • CanGetattr
  • CanSetattr
  • CanSetName
  • CanContains
  • CanSequence

  See #487 for more information.

• Preliminary support for the ty type-checker (currently in alpha) in #489.

• Preliminary support for the upcoming NumPy 2.4 release.

Other changes

Documentation

• Avoid the monthly PyPI downloads badge rate limit by @jorenham in #460

Dependencies

• update development dependencies by @jorenham in #463
• bump basedpyright to 1.31.7 by @jorenham in #466
• bump pyrefly to 0.37.0 by @jorenham in #468
• bump uv_build to 0.9 by @jorenham in #469
• Bump the actions group with 2 updates by @dependabot[bot] in #471
• Bump the actions group with 4 updates by @dependabot[bot] in #473
• Bump the actions group with 3 updates by @dependabot[bot] in #476
• Bump the actions group with 4 updates by @dependabot[bot] in #478
• py314, pytest 9, and other dev dep updates by @jorenham in #479
• Bump the actions group with 3 updates by @dependabot[bot] in #480
• update development dependencies by @jorenham in #484
• Bump beartype from 0.22.6 to 0.22.7 in the actions group by @dependabot[bot] in #485
• increase numpy-typing-compat upper bound and other updates by @jorenham in #486

Continuous integration

• Bump crate-ci/typos from 1.37.0 to 1.37.2 in the actions group by @dependabot[bot] in #461
• Bump the actions group with 2 updates by @dependabot[bot] in #464
• Bump astral-sh/setup-uv from 7.1.0 to 7.1.1 in the actions group by @dependabot[bot] in #470
• Bump astral-sh/setup-uv from 7.1.1 to 7.1.2 in the actions group by @dependabot[bot] in #472
• Bump crate-ci/typos from 1.38.1 to 1.39.0 in the actions group by @dependabot[bot] in #475
• release on tag push by @jorenham in #488

Maintenance

• prepare for further development by @jorenham in #459
• remove unused pyrefly ignore by @jorenham in #474

Full Changelog: v0.14.0...v0.15.0

v0.14.0

Highlights

• Support for the Pyrefly type-checker
• More robust optype.copy.CanReplace protocol
• New optype.numpy.CanArray0 protocol that accepts both scalars and 0-d arrays
• Various optype.numpy.ctypeslib improvements

What's Changed

optype.numpy

• update all optype.numpy.To* to use TypeAliasType by @jorenham in #444
• optype.numpy.ctypes: simplify Object and always use TypeAliasType by @jorenham in #446
• optype.numpy.ctypes: no complex C-types on windows by @jorenham in #447
• optype.numpy.ctypes tests by @jorenham in #449
• optype.numpy.ctypes: simplified abstract numeric aliases by @jorenham in #450
• add optype.numpy.CanArray0 by @jorenham in #454

optype.copy

• remove the (first) generic copy.CanReplace type parameter by @jorenham in #439
• update copy.CanReplace docs by @jorenham in #441

Documentation

• add pyrefly badge and improve badge style consistency by @jorenham in #440
• match badge colors with the github dark theme by @jorenham in #442

Dependencies

• Bump the actions group with 3 updates by @dependabot[bot] in #425
• Bump ruff from 0.12.10 to 0.12.11 in the actions group by @dependabot[bot] in #426
• Bump the actions group with 3 updates by @dependabot[bot] in #429
• Bump the actions group with 3 updates by @dependabot[bot] in #432
• Bump ruff from 0.13.0 to 0.13.1 in the actions group by @dependabot[bot] in #433
• upgrade development dependencies by @jorenham in #434
• bump ci action dependencies by @jorenham in #457

Continuous integration

• Bump astral-sh/setup-uv from 6.5.0 to 6.6.0 in the actions group by @dependabot[bot] in #424
• Bump the actions group with 2 updates by @dependabot[bot] in #427
• Bump the actions group with 3 updates by @dependabot[bot] in #431
• Bump crate-ci/typos from 1.36.2 to 1.36.3 in the actions group by @dependabot[bot] in #436
• Bump scientific-python/repo-review from 0.12.2 to 0.12.3 in the actions group by @dependabot[bot] in #452
• Also typecheck in CI with Python 3.13 by @jorenham in #455
• cleaner ci job names by @jorenham in #456

Other Changes

• prepare for further development by @jorenham in #423
• Bump pypa/gh-action-pypi-publish from 1.12.4 to 1.13.0 in /.github/workflows in the github_actions group across 1 directory by @dependabot[bot] in #428
• fix dependabot config by @jorenham in #435
• Preliminary Pyrefly support by @jorenham in #438
• bump pyrefly to 0.35.0 by @jorenham in #453

Full Changelog: v0.13.4...v0.14.0

v0.13.4

What's Changed

optype.numpy

• upgrade numpy-typing-compat to v20250818 in the numpy extra by @jorenham in #421
• installation instructions for the conda optype-numpy package by @jorenham in #422

Other Changes

• prepare for the next release by @jorenham in #419

Full Changelog: v0.13.3...v0.13.4

v0.13.3

This patch release adds an upper version bound for numpy-typing-compat to prevent potential compatibility issues with future releases.

What's Changed

optype.numpy

• set an upper version bound for numpy-typing-compat by @jorenham in #414
• prepare for the new numpy-typing-compat versioning by @jorenham in #418

Other Changes

• prepare for the 0.13.3 release by @jorenham in #416
• improved project metadata by @jorenham in #417

Full Changelog: v0.13.2...v0.13.3

v0.13.2

This is a bugfix release that addresses a permission issue in the built wheels that was caused by astral-sh/uv#14920.

What's Changed

• Bump the actions group with 3 updates by @dependabot[bot] in #409
• Bump the actions group with 4 updates by @dependabot[bot] in #410
• upgrade development and build dependencies by @jorenham in #412
• bump astral-sh/setup-uv to 6.5.0 by @jorenham in #413

Full Changelog: v0.13.1...v0.13.2

v0.13.1

What's Changed

optype.numpy

• fix CanArrayStrict{1,2,3}D by @jorenham in #407

Full Changelog: v0.13.0...v0.13.1

v0.13.0

Important

To ensure static typing compatibility with the SPEC 0 NumPy versions, optype.numpy now requires numpy-typing-compat. It will automatically be installed with the optype[numpy] extra.

What's Changed

optype.numpy

• robust numpy compat with numpy-typing-compat by @jorenham in #394
• make AnyLongDouble* compatible with numpy<2.2 by @jorenham in #395
• make Any[U]IntPDType compatible with numpy<2.2 by @jorenham in #396
• fix older numpy compat issues with numpy-typing-compat by @jorenham in #399
• include numpy==2.0.* in the testing matrix by @jorenham in #401
• use np.ndarray instead of CanArray in To*Strict{1,2,3}D on numpy<2.1 by @jorenham in #400
• warn on numpy-typing-compat / numpy version mismatch by @jorenham in #403
• bump numpy-typing-compat to v20250730 by @jorenham in #404
• error instead of warn in case of unsupported numpy-typing-compat by @jorenham in #405

Documentation

• update the documented minimum support NumPy version by @jorenham in #397

Dependencies

• bump development dependencies by @jorenham in #402

Other Changes

• prepare for further development by @jorenham in #392

Full Changelog: v0.12.2...v0.13.0

v0.12.2

What's Changed

• Bundle the license file by @jorenham in #391

Full Changelog: v0.12.1...v0.12.2