v0.13.2: NumPy 2.0 compatibility by using two import routes for VisibleDeprecationWarning

[hakonanes]

Description of the change

The only place orix's code is incompatible with NumPy v2 is the importing of VisibleDeprecationWarning from the top namespace. This was removed in v2. The replacement, exceptions.VisibleDeprecationWarning, was added in v1.25. To support NumPy older and newer, I've added both import attempts in orix.constants, making the warning available internally via this module.

diffpy.structure just made a pre-release v3.2.2rc0 which supports NumPy 2.0 (here on PyPI). With this PR, orix is also compatible with NumPy 2.0. orix is still compatible with diffpy.structure >= 3.0.2, and we don't need to increase this.

I suggest to make a patch release v0.13.2 within the next few days after this PR is merged into main.

Progress of the PR

• [n/a] Docstrings for all functions
• Unit tests with pytest for all lines
• Clean code style by running black via pre-commit

For reviewers

• The PR title is short, concise, and will make sense 1 year later.
• New functions are imported in corresponding __init__.py.
• New features, API changes, and deprecations are mentioned in the unreleased
  section in CHANGELOG.rst.
• Contributor(s) are listed correctly in __credits__ in orix/__init__.py and in
  .zenodo.json.

[pc494]

Description of the change

The only place orix's code is incompatible with NumPy v2 is the importing of VisibleDeprecationWarning from the top namespace. This was removed in v2. The replacement, exceptions.VisibleDeprecationWarning, was added in v1.25. To support NumPy older and newer, I've added both import attempts in orix.constants, making the warning available internally via this module.

diffpy.structure just made a pre-release v3.2.2rc0 which supports NumPy 2.0 (here on PyPI). With this PR, orix is also compatible with NumPy 2.0. orix is still compatible with diffpy.structure >= 3.0.2, and we don't need to increase this.

Just to be clear, orix would have two installation options:

Path one, full fresh install

pip install orix

takes numpy2 and this new diffpy version.

Path 2, on a legacy install which already has numpy1 would install orix correctly (at 0.13.2) with no issues?

[hakonanes]

Yes

[pc494]

Yes

great! I'll review. I think we should be numpy2 only at some point, but probably not just yet...

[pc494]

Good stuff! Merging.

[hakonanes]

Thanks! I checked locally, and with this PR, diffpy.structure v3.2.2rc0, and NumPy v2, all tests ran fine.

[hakonanes]

I'll publish the patch release v0.13.2 then.

[hakonanes]

Hm, well, perhaps wait a few days until diffpy.structure v3.2.2 is released.