MAINT: Add pint as a requirement

[larsoner]

On my system pip intstall magicgui followed by running a variant of the "all of these" example from https://pyapp-kit.github.io/magicgui/widgets/#magicgui I got:

monolith:Desktop larsoner$ python -ui magic.py 
Traceback (most recent call last):
  File "/Applications/MNE-Python/1.5.0_1/.mne-python/lib/python3.11/site-packages/superqt/spinbox/_quantity.py", line 4, in <module>
    from pint import Quantity, Unit, UnitRegistry
ModuleNotFoundError: No module named 'pint'

The above exception was the direct cause of the following exception:

...
  File "/Applications/MNE-Python/1.5.0_1/.mne-python/lib/python3.11/site-packages/superqt/__init__.py", line 57, in __getattr__
    from .spinbox._quantity import QQuantity
  File "/Applications/MNE-Python/1.5.0_1/.mne-python/lib/python3.11/site-packages/superqt/spinbox/_quantity.py", line 7, in <module>
    raise ImportError(
ImportError: pint is required to use QQuantity.  Install it with `pip install pint`

I guess pint is an optional dependency for superqt (?) but it seems like magicgui should require it to make sure all examples work out of the box.

[tlambert03]

hey @larsoner 👋 nice to see you here and thanks for opening a PR.

I'm hesitant to add more base level dependencies to magicgui. By its nature, magicgui might potentially support many third party types (beyond pint) but shouldn't require those packages for installation. My assumption with pint was that, if someone wants to provide a widget representation of a pint.Quantity, then that user would be declaring a dependency on pint already. We do add a quantity extra (pip install magicgui[quantity]) along with a number of other optional types:

magicgui/pyproject.toml

Lines 56 to 66 in 21ee452

	pyqt5 = ["pyqt5>=5.12.0"]
	pyqt6 = ["pyqt6"]
	pyside2 = [
	"pyside2>=5.14 ; python_version=='3.8'",
	"pyside2>=5.15 ; python_version>='3.9'",
	]
	pyside6 = ["pyside6"]
	tqdm = ["tqdm>=4.30.0"]
	jupyter = ["ipywidgets>=8.0.0"]
	image = ["pillow>=4.0"]
	quantity = ["pint>=0.13.0"]

I see that this means that someone can't immediately run all of the examples without additional installations, but if we add pint, then a similar argument could be made for pillow, tqdm, and any number of third party types that we're able to support.

As an alternative, would you support the addition and of an all or examples extra that brings in all of these optional dependencies for someone wanting to run all of the examples?

[larsoner]

would you support the addition and of an all or examples extra

Actually I didn't even notice those options. Maybe just a .. note:: or .. warning:: where the QuantityEdit shows up on that examples page and also the QuantityEdit API page would help to know about when optional dependencies are needed. This would also be relevant for the matplotlib stuff we've been discussing.

Just let me know if you agree with how and where these should be documented (or if you have other ideas) and I'm happy to adjust this PR to be a documentation update instead 👍

[tlambert03]

Just let me know if you agree with how and where these should be documented (or if you have other ideas) and I'm happy to adjust this PR to be a documentation update instead

agree!
A note could be added to the doc header of this file and also to the docstring here.

i just tried locally, and mkdocs admonition syntax (!!note) doesn't appear to be working in the gallery pages at the moment. so if you just make a simple note i can fix the admonitions later

[tlambert03]

(note also: I just killed the antiquated setup.py file in #595 ... so your conflict is due to that. it can just be removed)

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 87.68%. Comparing base (21ee452) to head (d2dc045).
⚠️ Report is 82 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #592   +/-   ##
=======================================
  Coverage   87.68%   87.68%           
=======================================
  Files          39       39           
  Lines        4573     4573           
=======================================
  Hits         4010     4010           
  Misses        563      563           

☔ View full report in Codecov by Sentry.
📢 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.