Ufunc support

[nstarman]

Description

Add support for overloading ufuncs and their methods (like accumulate).

Fixes #19, #23

PR Checklist

• Check out the contributing guidelines and code of conduct
• Check out the contributing workflow ( for a practical example click here )
• Give a detailed description of the PR above.
• Document changes in the CHANGES.rst file. See existing changelog for examples.
• Add tests, if applicable, to ensure code coverage never decreases.
• Make sure the docs are up to date, if applicable, particularly the docstrings and RST files in docs folder.
• Ensure linear history by rebasing, when requested by the maintainer.

[codecov]

Codecov Report

Base: 93.67% // Head: 87.39% // Decreases project coverage by -6.27% ⚠️

Coverage data is based on head (3eba2c4) compared to base (8838c78).
Patch coverage: 87.16% of modified lines in pull request are covered.

❗ Current head 3eba2c4 differs from pull request most recent head e1ae3ab. Consider uploading reports for the commit e1ae3ab to get more accurate results

Additional details and impacted files

@@            Coverage Diff             @@
##             main      #25      +/-   ##
==========================================
- Coverage   93.67%   87.39%   -6.28%     
==========================================
  Files           7       11       +4     
  Lines         237      468     +231     
==========================================
+ Hits          222      409     +187     
- Misses         15       59      +44     

Impacted Files	Coverage Δ
src/overload_numpy/_typeutils.py	65.00% <65.00%> (ø)
src/overload_numpy/constraints.py	97.50% <66.66%> (-2.50%)	⬇️
src/overload_numpy/overload.py	70.42% <68.42%> (-18.59%)	⬇️
src/overload_numpy/mixin.py	72.72% <76.47%> (-8.23%)	⬇️
src/overload_numpy/wrapper/dispatch.py	90.00% <90.00%> (ø)
src/overload_numpy/wrapper/func.py	92.92% <92.92%> (ø)
src/overload_numpy/wrapper/ufunc.py	93.82% <93.82%> (ø)
src/overload_numpy/wrapper/many.py	95.83% <95.83%> (ø)
src/overload_numpy/utils.py	96.55% <96.55%> (ø)
src/overload_numpy/__init__.py	100.00% <100.00%> (ø)
... and 1 more

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

☔ View full report at Codecov.
📢 Do you have feedback about the report comment? Let us know in this issue.

[nstarman]

@mhvk, obviously still a work in progress, but I've solved the ufunc overloads. And it still compiles with mypyc for super duper speed (🤞🏼, benchmarks upcoming). https://overload-numpy--25.org.readthedocs.build/en/25/

[mhvk]

@nstarman - in principle sounds interesting but sadly having limited time to actually look at this -- probably better to meet in person at some point.

But obviously, if this makes things like adding two quantities quite a lot faster, that would be great! I'm not sure that for Quantity, __array_ufunc__ itself is the main bottleneck, but the unit handling stuff can perhaps be compiled too? Anyway, would indeed be good to benchmark...

[nstarman]

Codecov is erroneously counting TYPE_CHECKING and ... lines against the code coverage. When I run this locally, the coverage is 92%, which is expected. I'll fix the codecov error in a later PR.