-
Notifications
You must be signed in to change notification settings - Fork 2
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
* add readme based on package docstring * lint
- Loading branch information
1 parent
12f79f8
commit 38e4e51
Showing
3 changed files
with
21 additions
and
4 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,17 @@ | ||
# pyo3-stubgen | ||
|
||
`pyo3-stubgen` generates `.pyi` typing files for extension modules which were written in rust with pyo3. | ||
|
||
It is designed to work for extension modules created in rust with pyo3 but should work with any compiled extension | ||
modules which include a `__text_signature__` and optionally a `__doc__` attribute for functions. | ||
|
||
The package containing the module must be installed in the current virtual environment, but does not need to be | ||
imported before running `pyo3_stubgen`. | ||
|
||
Despite flake8's recommendation to the contrary, `pyo3_stubgen` adds docstrings to the `.pyi` files so that IDEs can | ||
provide them in hover pop-ups. | ||
|
||
You will need to manually add the typing information to the generated files as this is not included in any of the | ||
function attributes available. | ||
|
||
Currently `pyo3_stubgen` only generates info for functions. Classes are on the to-do list. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters