-
Notifications
You must be signed in to change notification settings - Fork 4
TYP: add typing information #8
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: main
Are you sure you want to change the base?
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Looks quite good! Some suggestions in-line. I can push some of those, but before doing so, an idea may be to set up pre-commit in a separate PR (without mypy), just to keep review easier.
quantity/core.py
Outdated
| array_api_compat.array_namespace(arg) | ||
| except TypeError: | ||
| return False | ||
| else: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Can we turn off the rule that removes this else - it is more readable to keep it!
|
|
||
|
|
||
| @runtime_checkable | ||
| class ArrayQuantity(Quantity, Array, Protocol): |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
QuantityArray may be better?
More relevantly, for my own understanding, an isinstance will check that something has the value and unit atttributes, that those are of the right type, and adds to Quantity that it will also check that the something itself is array-like (i.e., has __array_namespace__), right?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
that those are of the right type
I don't think that's included in "runtime checkable" protocols.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Yeah, unfortunately not.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Well, at some level that makes things easy, in that basic Quantity operations will just work with float values.
|
|
||
| def _make_comp(comp): | ||
| def __comp__(self, other): | ||
| def _make_comp(comp: str) -> Callable[[Quantity, Any], Array]: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Should be Union[Array | NotImplementedType], no?
| def _make_comp(comp): | ||
| def __comp__(self, other): | ||
| def _make_comp(comp: str) -> Callable[[Quantity, Any], Array]: | ||
| def _comp_(self: Quantity, other: Any) -> Array | NotImplementedType: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Don't mind changing it at all, but if we do, probably nicer to change __op__ above too.
| else: | ||
| try: | ||
| exp = exp.__complex__() | ||
| out = complex(exp) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is not the same! E.g., complex("1+1j") works, but we don't want to support 2**"1+1j"
|
|
||
| def __array_namespace__(self, *, api_version: str | None = None) -> Any: | ||
| # TODO: make our own? | ||
| del api_version |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Why is this needed? Can one not add something like Unused[str | None] ... checking, I see that this was suggested at python/typing#1499 but not liked; instead a relevant noqa to get the linter happy was suggested. That does seem nicer.
|
|
||
| def _operate(self, other, op, units_helper): | ||
| def _operate( | ||
| self, other: Any, op: Any, units_helper: Any |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think op and units_helper can be
op: str, units_helper: Callable[[Unit, Unit], tuple[list[Callable | None, Callable | None], Unit | None]]
Not sure I did the second one right, but it takes 2 units and returns a list of two converters or None and a final unit or None. Maybe worth defining separately? The general helper could have arbitrary number of units, with the output having the same number of converters.
| exp = _check_pow_args(exp, mod) | ||
| if exp is NotImplemented: | ||
| def __pow__(self, exp: Any, mod: Any = None) -> Self | NotImplementedType: | ||
| if (mod := _parse_pow_mod(mod)) is NotImplemented: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I like the symmetry of the parsing, but maybe we should just go for
if mod is not None:
return NotImplemented
(and then perhaps overload __pow__ itself??)
| if (mod := _parse_pow_mod(mod)) is NotImplemented: | ||
| return NotImplemented | ||
|
|
||
| if (exp := _check_pow_exp(exp)) is NotImplemented: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is a nice improvement.
| def __ipow__(self, exp, mod=None): | ||
| exp = _check_pow_args(exp, mod) | ||
| if exp is NotImplemented: | ||
| if (mod := _parse_pow_mod(mod)) is NotImplemented: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
As above.
60f06ed to
79d4f22
Compare
| warn_unused_configs = true | ||
|
|
||
| [[tool.mypy.overrides]] | ||
| module = ["quantity._dev.*", "quantity.tests.*"] |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Just a bit of a flyby - cool to see the mypy setup! But this is out of date - test has moved now (and another reason why that is good!)
|
Agreed! I think this PR will serve only as reference for a few equivalent PRs. |
Signed-off-by: nstarman <[email protected]>
No description provided.