Add a context manager as an alternative to monkey patching

[krokosik]

Closes #29

[read-the-docs-community]

Documentation build overview

📚 xarray-einstats | 🛠️ Build #33056277 | 📁 Comparing 5712455 against latest (2dcbd7e)

  🔍 Preview build  

81 files changed · ± 81 modified

± Modified

• changelog.html
• getting_started.html
• api/linalg.html
• api/stats.html
• background/einops.html
• background/index.html
• background/linalg.html
• background/stats.html
• tutorials/dask_support.html
• tutorials/einops-basics-port.html
• and 71 more...

[OriolAbril]

I think the body can be kept mostly as is, the only change is I would define it inside the linalg.py file so it is also imported from xarray_einstats.linalg instead of being available at the top level. We might then want to remove the linalg from the name but I am also fine keeping it.

[krokosik]

done and removed the linalg part

[OriolAbril]

numpydoc doesn't say anything on documenting context managers but I would remove this section and instead add an examples section or a seealso pointing to the docs on using it. In general I would also update all the docs to remove any reference to monkeypatching and rely on the context manager only (I am more than happy to do this myself if you prefer).

[krokosik]

Made some changes and added missing sections

[OriolAbril]

Looks like the linting check is complaining, you should be able to fix it with tox -e reformat, after that it's good to merge. Thanks for the contributions and the patience ❤️

[codecov]

Codecov Report

❌ Patch coverage is 93.33333% with 1 line in your changes missing coverage. Please review.
✅ Project coverage is 91.50%. Comparing base (2dcbd7e) to head (5712455).
⚠️ Report is 2 commits behind head on main.

Files with missing lines	Patch %	Lines
src/xarray_einstats/linalg.py	93.33%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main      #91      +/-   ##
==========================================
+ Coverage   91.46%   91.50%   +0.03%     
==========================================
  Files           6        6              
  Lines         844      859      +15     
==========================================
+ Hits          772      786      +14     
- Misses         72       73       +1     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[krokosik]

fixed :)