feat!: add annotations

[flying-sheep]

Add annotations to override and a "scverse" docstring style which is “numpy but parameter types are only in the annotations and not in the docstring”. Scanpy enforces this style and doesn’t accept param : type syntax in the docstring.

This is a breaking change because it also removes the default for docstring_style, which I asked for in #16.

alternatives

• instead of the "scverse" style, we could have an independent option for “no types in param docstrings” (e.g. docstring_style="numpy", types_in_docstring=False)
• do what I think is the best solution (but most work) and move all that logic out of the regular code and into a sphinx extension

[codecov]

Codecov Report

❌ Patch coverage is 97.43590% with 1 line in your changes missing coverage. Please review.
✅ Project coverage is 97.47%. Comparing base (bc96026) to head (33da2e1).
⚠️ Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
src/scverse_misc/_utils.py	92.85%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main      #22      +/-   ##
==========================================
- Coverage   97.59%   97.47%   -0.12%     
==========================================
  Files           5        5              
  Lines         208      238      +30     
==========================================
+ Hits          203      232      +29     
- Misses          5        6       +1     

Files with missing lines	Coverage Δ
src/scverse_misc/_extensions.py	96.15% <ø> (ø)
src/scverse_misc/_settings.py	97.75% <100.00%> (+0.56%)	⬆️
src/scverse_misc/_utils.py	96.66% <92.85%> (-3.34%)	⬇️

🚀 New features to boost your workflow:

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

[ilia-kats]

Can you add a changelog entry? Otherwise looks good to me.

[flying-sheep]

sure! I’ll have to change a bit more though, I’ll mark it as ready when it is

[flying-sheep]

OK, I’m happy now!

[ilia-kats]

awesome, thanks! Just two minor nitpicks, otherwise it's good to go