Skip to content

refactor: add jax DeprecationWarning#3609

Merged
ianna merged 1 commit intomainfrom
ianna/jax_deprication_warning
Aug 8, 2025
Merged

refactor: add jax DeprecationWarning#3609
ianna merged 1 commit intomainfrom
ianna/jax_deprication_warning

Conversation

@ianna
Copy link
Copy Markdown
Member

@ianna ianna commented Aug 7, 2025

Description:

This PR adds a DeprecationWarning to the Jax nplike backend, notifying users that JAX support in Awkward Array will be deprecated and removed in a future release.

Changes:

  • Imported warnings and added a DeprecationWarning in Jax.init.
  • Warning message encourages users to migrate away from the JAX backend.

Rationale:
The JAX backend in Awkward Array is no longer actively maintained and is planned for removal in an upcoming release. Adding an explicit deprecation warning will ensure that downstream users are aware of this change before it happens, giving them time to adapt their code.

Note: ak.to_jax and ak.from_jax will continue to be maintained for interoperability with JAX, even after the backend is removed.

Example Warning Output:

DeprecationWarning: The JAX backend is deprecated and will be removed in a future release of Awkward Array. Please plan to migrate your code accordingly.

Next Steps:

  • Update documentation to reflect the planned removal.
  • Announce the deprecation in release notes and communication channels.

If there are any comments or suggestions, please add them to the ongoing discussion: #3603

Copy link
Copy Markdown
Member Author

@ianna ianna left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The deprecation warning for the JAX backend is clear and appropriately placed to alert users ahead of removal. The message is visible during tests and runtime, ensuring good visibility.

This aligns well with the ongoing discussion and planned removal after the JAX branching.

I approve merging this PR for inclusion in the next release.

@ianna ianna merged commit 481d5c9 into main Aug 8, 2025
53 of 54 checks passed
@ianna ianna deleted the ianna/jax_deprication_warning branch August 8, 2025 09:12
@ianna ianna changed the title refactor: add jax deprication warning refactor: add jax DeprecationWarning Aug 9, 2025
@scikit-hep scikit-hep deleted a comment from ikrommyd Aug 15, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant