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
6 Aug 10, 2022
638 Dec 13, 2022
14 Aug 02, 2022
15 Mar 08, 2022
8 Nov 27, 2022
259 Dec 13, 2022
4 Oct 30, 2022
25 Nov 28, 2022
8 Mar 30, 2022
3 May 30, 2022
2 Nov 07, 2021
2.9k Jan 06, 2023
39 Dec 23, 2022
3 Jan 24, 2022
5 Mar 09, 2022
3.5k Jan 05, 2023
1.6k Jan 08, 2023
12 Sep 07, 2022
14 Dec 29, 2022
9 Jun 08, 2022