# Stub Generator
[](https://pypi.org/project/safe-ds-stubgen)
[](https://github.com/Safe-DS/Stub-Generator/actions/workflows/main.yml)
[](https://codecov.io/gh/Safe-DS/Stub-Generator)
[](https://stubgen.safeds.com)
Automated generation of [Safe-DS stubs](https://dsl.safeds.com/en/stable/stub-language/) for Python libraries.
## Installation
Get the latest version from [PyPI](https://pypi.org/project/safe-ds-stubgen):
```shell
pip install safe-ds-stubgen
```
## Usage
To run this program:
```txt
usage: safe-ds-stubgen [-h] [-v] -p PACKAGE [-s SRC] -o OUT [--docstyle {PLAINTEXT,EPYDOC,GOOGLE,NUMPYDOC,REST}] [-tr] [-nc]
Analyze Python code.
options:
-h, --help show this help message and exit
-v, --verbose show info messages
-p PACKAGE, --package PACKAGE
The name of the package.
-s SRC, --src SRC Source directory containing the Python code of the package.
-o OUT, --out OUT Output directory.
--docstyle {PLAINTEXT,EPYDOC,GOOGLE,NUMPYDOC,REST}
The docstring style.
-tr, --testrun Set this flag if files in /test or /tests directories should be included.
-nc, --naming_convert
Set this flag if the name identifiers should be converted to Safe-DS standard (UpperCamelCase for classes and camelCase for everything else).
```
## Documentation
You can find the full documentation [here](https://stubgen.safeds.com).
## Contributing
We welcome contributions from everyone. As a starting point, check the following resources:
* [Setting up a development environment](https://stubgen.safeds.com/en/latest/development/environment/)
* [Project guidelines](https://stubgen.safeds.com/en/latest/development/project_guidelines/)
* [Contributing page](https://github.com/Safe-DS/Stub-Generator/contribute)
If you need further help, please [use our discussion forum][forum].
[forum]: https://github.com/orgs/Safe-DS/discussions
Raw data
{
"_id": null,
"home_page": "https://github.com/Safe-DS/Stub-Generator",
"name": "safe-ds-stubgen",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.11",
"maintainer_email": null,
"keywords": "data-science, machine-learning, dsl",
"author": "Lars Reimann",
"author_email": "mail@larsreimann.com",
"download_url": "https://files.pythonhosted.org/packages/6f/37/c36cd63a883b8ba08355fb22d54a03826ba921e64daa639be9ac7618840a/safe_ds_stubgen-0.3.0.tar.gz",
"platform": null,
"description": "# Stub Generator\n\n[](https://pypi.org/project/safe-ds-stubgen)\n[](https://github.com/Safe-DS/Stub-Generator/actions/workflows/main.yml)\n[](https://codecov.io/gh/Safe-DS/Stub-Generator)\n[](https://stubgen.safeds.com)\n\nAutomated generation of [Safe-DS stubs](https://dsl.safeds.com/en/stable/stub-language/) for Python libraries.\n\n## Installation\n\nGet the latest version from [PyPI](https://pypi.org/project/safe-ds-stubgen):\n\n```shell\npip install safe-ds-stubgen\n```\n\n## Usage\n\nTo run this program:\n\n```txt\nusage: safe-ds-stubgen [-h] [-v] -p PACKAGE [-s SRC] -o OUT [--docstyle {PLAINTEXT,EPYDOC,GOOGLE,NUMPYDOC,REST}] [-tr] [-nc]\n\nAnalyze Python code.\n\noptions:\n -h, --help show this help message and exit\n -v, --verbose show info messages\n -p PACKAGE, --package PACKAGE\n The name of the package.\n -s SRC, --src SRC Source directory containing the Python code of the package.\n -o OUT, --out OUT Output directory.\n --docstyle {PLAINTEXT,EPYDOC,GOOGLE,NUMPYDOC,REST}\n The docstring style.\n -tr, --testrun Set this flag if files in /test or /tests directories should be included.\n -nc, --naming_convert\n Set this flag if the name identifiers should be converted to Safe-DS standard (UpperCamelCase for classes and camelCase for everything else).\n```\n\n## Documentation\n\nYou can find the full documentation [here](https://stubgen.safeds.com).\n\n## Contributing\n\nWe welcome contributions from everyone. As a starting point, check the following resources:\n\n* [Setting up a development environment](https://stubgen.safeds.com/en/latest/development/environment/)\n* [Project guidelines](https://stubgen.safeds.com/en/latest/development/project_guidelines/)\n* [Contributing page](https://github.com/Safe-DS/Stub-Generator/contribute)\n\nIf you need further help, please [use our discussion forum][forum].\n\n[forum]: https://github.com/orgs/Safe-DS/discussions\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Generation of Safe-DS stubs for Python libraries.",
"version": "0.3.0",
"project_urls": {
"Documentation": "https://stubgen.readthedocs.io",
"Homepage": "https://github.com/Safe-DS/Stub-Generator",
"Repository": "https://github.com/Safe-DS/Stub-Generator"
},
"split_keywords": [
"data-science",
" machine-learning",
" dsl"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "7f56ef8d396313be9b434413978aa230d88125fac15b6ceed16bf71b107b8a5a",
"md5": "898f0a7f03bef780c2f6a899a4e000e3",
"sha256": "6a14b9bdbec3145aad10db4d56699f2da2803305632798c125c7e971dc13dee0"
},
"downloads": -1,
"filename": "safe_ds_stubgen-0.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "898f0a7f03bef780c2f6a899a4e000e3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.11",
"size": 52387,
"upload_time": "2024-05-04T15:36:34",
"upload_time_iso_8601": "2024-05-04T15:36:34.635017Z",
"url": "https://files.pythonhosted.org/packages/7f/56/ef8d396313be9b434413978aa230d88125fac15b6ceed16bf71b107b8a5a/safe_ds_stubgen-0.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "6f37c36cd63a883b8ba08355fb22d54a03826ba921e64daa639be9ac7618840a",
"md5": "e196a9a1835148fe0a42a25fedf3f95b",
"sha256": "07daa0219329977a3f847a4de0640150c7eb0682a90e1d4079031ca8eb3f7f5b"
},
"downloads": -1,
"filename": "safe_ds_stubgen-0.3.0.tar.gz",
"has_sig": false,
"md5_digest": "e196a9a1835148fe0a42a25fedf3f95b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.11",
"size": 43530,
"upload_time": "2024-05-04T15:36:35",
"upload_time_iso_8601": "2024-05-04T15:36:35.744609Z",
"url": "https://files.pythonhosted.org/packages/6f/37/c36cd63a883b8ba08355fb22d54a03826ba921e64daa639be9ac7618840a/safe_ds_stubgen-0.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-04 15:36:35",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Safe-DS",
"github_project": "Stub-Generator",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "safe-ds-stubgen"
}
JSON
