Add stubs for invoke

[kasium]

No description provided.

[arnimarj]

I wrote stubs for the subset of invoke I've been using. Some if them I put in this comment. I'd be happy to send them all over if you like.

[arnimarj]

If it helps here, I've been using this annotation for task:

FuncType = Callable[..., Any]
_F = TypeVar('_F', bound=FuncType)


def task(
	func: _F,
	*,
	name: str = ...,
) -> _F:
	...

[kasium]

TBH, not sure about this, since it returns a Task object which is not present

[JelleZijlstra]

Haven't looked at this, but this sounds like a use case for ParamSpec from PEP 612.

[arnimarj]

I looked at the implementation in a bit more details (https://github.com/pyinvoke/invoke/blob/master/invoke/tasks.py)

The return object is indeed a Task, but the returned type can be controlled via the klass kwarg (currently defaults to Task). The Task object itself implements a __call__ which ends up calling the wrapped method using the given args/kwargs.

My proposed tweak is accurate for the use-cases I have (naked @task wrapping), but the return type is still not accurate.

[kasium]

I wrote stubs for the subset of invoke I've been using. Some if them I put in this comment. I'd be happy to send them all over if you like.

Sure, if it's fine for you I would keep this as a first draft. After the merge you can open a new PR and just merge your hints. Feel free to add me for a short review!

[JelleZijlstra]

Thanks! Looked over all the stubs, and added some suggestions for obvious types that stubgen didn't catch.

[JelleZijlstra]

Thank you!