unxts.api 2.0.1__tar.gz → 2.0.2__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: unxts.api
3
- Version: 2.0.1
3
+ Version: 2.0.2
4
4
  Summary: Abstract dispatch API definitions for unxt (canonical: unxts.api)
5
5
  Project-URL: Bug Tracker, https://github.com/GalacticDynamics/unxt/issues
6
6
  Project-URL: Homepage, https://github.com/GalacticDynamics/unxt
@@ -20,7 +20,8 @@ Classifier: Programming Language :: Python :: 3.14
20
20
  Classifier: Topic :: Scientific/Engineering
21
21
  Classifier: Typing :: Typed
22
22
  Requires-Python: >=3.12
23
- Requires-Dist: plum-dispatch>=2.5.7
23
+ Requires-Dist: plum-dispatch!=2.10.0,>=2.5.7
24
+ Requires-Dist: plum-dispatch>=2.9.0; python_version >= '3.14'
24
25
  Description-Content-Type: text/markdown
25
26
 
26
27
  # unxts.api
@@ -16,11 +16,11 @@ Abstract dispatch API for [unxt](https://github.com/GalacticDynamics/unxt).
16
16
 
17
17
  :::
18
18
 
19
- {mod}`unxts.api` defines the abstract dispatch interfaces that {mod}`unxt` and other packages implement. It provides a minimal dependency foundation for packages that want to define or use {mod}`unxt`'s multiple-dispatch-based API without pulling in the full {mod}`unxt` implementation.
19
+ `unxts.api` defines the abstract dispatch interfaces that `unxt` and other packages implement. It provides a minimal dependency foundation for packages that want to define or use `unxt`'s multiple-dispatch-based API without pulling in the full `unxt` implementation.
20
20
 
21
- The {mod}`unxts.api` package serves several important purposes:
21
+ The `unxts.api` package serves several important purposes:
22
22
 
23
- 1. **Minimal Dependencies**: Depends only on {mod}`plum`, not on {mod}`jax`, {mod}`numpy`, or {mod}`astropy`
23
+ 1. **Minimal Dependencies**: Depends only on `plum`, not on `jax`, `numpy`, or `astropy`
24
24
  2. **Extensibility**: Allows third-party packages to register their own implementations
25
25
  3. **Type Safety**: Provides a clear contract for what functions exist and what they should do
26
26
  4. **Separation of Concerns**: API definitions are separate from implementation details
@@ -49,16 +49,16 @@ uv add unxts.api
49
49
 
50
50
  ## Core API
51
51
 
52
- The {mod}`unxts.api` package defines abstract dispatch functions organized by domain:
52
+ The `unxts.api` package defines abstract dispatch functions organized by domain:
53
53
 
54
- - **Dimensions** ({func}`~unxts.api.dimension`, {func}`~unxts.api.dimension_of`) - Working with physical dimensions
55
- - **Units** ({func}`~unxts.api.unit`, {func}`~unxts.api.unit_of`) - Constructing and inspecting units
56
- - **Quantities** ({func}`~unxts.api.uconvert`, {func}`~unxts.api.uconvert_value`, {func}`~unxts.api.ustrip`, {func}`~unxts.api.is_unit_convertible`, {func}`~unxts.api.wrap_to`) - Unit conversion and quantity operations
57
- - **Unit Systems** ({func}`~unxts.api.unitsystem_of`) - Inspecting unit systems
54
+ - **Dimensions** ({func}`~unxt.dims.dimension`, {func}`~unxt.dims.dimension_of`) - Working with physical dimensions
55
+ - **Units** ({func}`~unxt.units.unit`, {func}`~unxt.units.unit_of`) - Constructing and inspecting units
56
+ - **Quantities** ({func}`~unxt.quantity.uconvert`, {func}`~unxt.quantity.uconvert_value`, {func}`~unxt.quantity.ustrip`, {func}`~unxt.quantity.is_unit_convertible`, {func}`~unxt.quantity.wrap_to`) - Unit conversion and quantity operations
57
+ - **Unit Systems** ({func}`~unxt.unitsystems.unitsystem_of`) - Inspecting unit systems
58
58
 
59
59
  ## Using Multiple Dispatch
60
60
 
61
- All functions in {mod}`unxts.api` use [plum](https://beartype.github.io/plum/) for multiple dispatch. This means:
61
+ All functions in `unxts.api` use [plum](https://beartype.github.io/plum/) for multiple dispatch. This means:
62
62
 
63
63
  1. **Functions can have multiple implementations** based on argument types
64
64
  2. **You can register your own implementations** for custom types
@@ -139,7 +139,7 @@ This separation allows:
139
139
 
140
140
  ## Integration with `unxt`
141
141
 
142
- The {mod}`unxt` package provides the concrete implementations of all {mod}`unxts.api` functions. When you use:
142
+ The `unxt` package provides the concrete implementations of all `unxts.api` functions. When you use:
143
143
 
144
144
  ```python
145
145
  import unxt as u
@@ -148,7 +148,7 @@ q = u.Q(5, "m")
148
148
  u.uconvert("km", q)
149
149
  ```
150
150
 
151
- The `u.uconvert` function is the implementation registered by {mod}`unxt` for the abstract `uapi.uconvert` function.
151
+ The `u.uconvert` function is the implementation registered by `unxt` for the abstract `uapi.uconvert` function.
152
152
 
153
153
  ## For Package Authors
154
154
 
@@ -156,7 +156,7 @@ If you're writing a package that works with physical quantities:
156
156
 
157
157
  ### Minimal Dependency Approach
158
158
 
159
- Depend on {mod}`unxts.api` to use the dispatch system without pulling in {mod}`jax`:
159
+ Depend on `unxts.api` to use the dispatch system without pulling in `jax`:
160
160
 
161
161
  ```toml
162
162
  # pyproject.toml
@@ -192,7 +192,7 @@ def dimension_of(obj: YourType, /):
192
192
 
193
193
  ### Full Integration Approach
194
194
 
195
- If you need JAX and want full {mod}`unxt` functionality:
195
+ If you need JAX and want full `unxt` functionality:
196
196
 
197
197
  ```toml
198
198
  # pyproject.toml
@@ -202,7 +202,7 @@ dependencies = [
202
202
  ]
203
203
  ```
204
204
 
205
- Then use {mod}`unxt`'s types directly:
205
+ Then use `unxt`'s types directly:
206
206
 
207
207
  ```python
208
208
  import unxt as u
@@ -17,7 +17,12 @@ classifiers = [
17
17
  "Topic :: Scientific/Engineering",
18
18
  "Typing :: Typed",
19
19
  ]
20
- dependencies = ["plum-dispatch>=2.5.7"]
20
+ # !=2.10.0: see the root `pyproject.toml`. The 3.14 floor is spelled out because,
21
+ # unlike the sibling packages, this one does not depend on `unxt` to supply it.
22
+ dependencies = [
23
+ "plum-dispatch>=2.5.7,!=2.10.0",
24
+ "plum-dispatch>=2.9.0; python_version>='3.14'",
25
+ ]
21
26
  description = "Abstract dispatch API definitions for unxt (canonical: unxts.api)"
22
27
  dynamic = ["version"]
23
28
  license = "BSD-3-Clause"
@@ -47,6 +52,7 @@ test = [
47
52
  "pytest-cov>=6.2.1",
48
53
  "pytest-env>=1.1.5",
49
54
  "pytest-github-actions-annotate-failures>=0.3.0",
55
+ "pytest-xdist>=3.6.1",
50
56
  "sybil[pytest]>=9.2.0",
51
57
  "unxt",
52
58
  ]
@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
18
18
  commit_id: str | None
19
19
  __commit_id__: str | None
20
20
 
21
- __version__ = version = '2.0.1'
22
- __version_tuple__ = version_tuple = (2, 0, 1)
21
+ __version__ = version = '2.0.2'
22
+ __version_tuple__ = version_tuple = (2, 0, 2)
23
23
 
24
24
  __commit_id__ = commit_id = None
File without changes
File without changes
File without changes
File without changes
File without changes