Stubmaker
Stubmaker is an easy-to-use tool for generating python stubs.
Requirements
- Stubmaker is to be run under Python 3.7.4+
- No side effects during module imports
- Must contain
__all__(this restriction will be removed in upcomming releases)
How to install
pip install stubmaker
stubmaker --help
Usage example
Imagine you have a package with the following structure:
package
-> __init__.py
Contents of __init__.py:
__all__ = ['sleep_for']
from time import sleep
def some_decorator(func):
return func
@some_decorator
def sleep_for(amount: float) -> None:
sleep(amount)
There is a script that calls sleep_for method but passes wrong arguments:
from package import sleep_for
sleep_for(123, 123)
Due to dynamic nature of decorators static analysers (such as mypy) may not raise an error while checking the script:
>> mypy __main__.py
Success: no issues found in 1 source file
Stubs exist to help you! Stubmaker will provide stubs for your package so that its users can find the error using mypy:
>> stubmaker --module-root package --src-root <path to package>/package --output-dir <path to package>/package
>> mypy __main__.py
__main__.py:3: error: Too many arguments for "sleep_for"
Found 1 error in 1 file (checked 1 source file)
License
© YANDEX LLC, 2020-2021. Licensed under the Apache License, Version 2.0. See LICENSE file for more details.
6 Jun 8, 2022
1 Dec 24, 2021
1 Dec 27, 2021
37 Nov 2, 2022
2 Mar 3, 2022
3 Aug 6, 2022
12 Jan 2, 2023
14 Oct 14, 2022
6 Dec 12, 2022
3 Jun 06, 2021
2 Dec 14, 2022
4 Nov 28, 2021
6 Dec 07, 2021
262 Jan 08, 2023
4 Sep 27, 2022
26 Jul 18, 2022
1 Jul 16, 2022
3 Dec 20, 2021
2 Dec 05, 2021
4 Jan 26, 2022
1 Jan 07, 2022
11 Oct 04, 2022
26 Dec 27, 2022
6 Jul 20, 2021
6 Dec 08, 2022
51 Nov 04, 2022
0 Jul 14, 2022