# MyPythonModule
[](https://badge.fury.io/py/IHSBotballKit)
An object-oriented wrapper for the KIPR Botball library with additional functionalities.
## Installation
The module is installed using pip:
```bash
pip install IHSBotballKit
```
## Usage
Documentation can be found in the source code or stubs. Examples use cases are provided in the examples folder.
## Contributing
Contributions are welcome! Please follow the following style guides:
- Use standard python syntax and naming conventions(e.g. snake_case for variables, CamelCase for classes).
-
- All importable members must be documented using [Google style docstrings](https://sphinxcontrib-napoleon.readthedocs.io/en/latest/example_google.html).
- Type hinting is not required but strongly recommended whenever possible.
- It is recommended to use a static type checker such as [mypy](https://mypy.readthedocs.io/en/stable/) while contributing to the package.
- Create stubs in the stubs folder after you've made all the changes. A good way to do that is to use [mypy's stubgen](https://mypy.readthedocs.io/en/stable/stubgen.html).
- note: the stubs generated will have some issues and incomplete typing. It is your job to fix them before committing the code.
```bash
# generate all the stubs at once
stubgen -p ./IHSBotballKit -v --include-docstrings -o ./stubs
# generate stubs for one (or more) file
stubgen ./IHSBotballKit/file.py ./IHSBotballKit/file2.py -v --include-docstrings -0 ./stubs
```
- Chores:
- Update version number in `__init__.py` according to semantic versioning guidelines.
- Create new release on GitHub.
- Update relevant information in `setup.py`, namely version, download url, and dependencies.
- Run the following to upload the new version to pypi.
```bash
rm -rf dist && python3 setup.py sdist
twine check dist/* # make sure there are no problems in the uploaded file(s)
twine upload dist/*
```
## Acknowledgements
- [Botballkit](https://pypi.org/project/BotballKit/) - For inspiration and some functionality.
## Issues
If you encounter any issues, please create a new issue here. Please be detailed in the description of the issue, include relevant background information (e.g. operating system, software versions), expected behavior, and how to reproduce the issue.
Raw data
{
"_id": null,
"home_page": "https://github.com/snow4060",
"name": "IHSBotballKit",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "KIPR, BOTBALL, WOMBAT, LIBKIPR, LIBWALLABY",
"author": "snow4060",
"author_email": "haoyun807963@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/fc/51/d5c71c5d3c8f1dfc7cadc53c2cef7266d38a454bf2e1c42ce001438c6bfe/IHSBotballKit-1.0.1.tar.gz",
"platform": null,
"description": "# MyPythonModule\n\n[](https://badge.fury.io/py/IHSBotballKit)\n\nAn object-oriented wrapper for the KIPR Botball library with additional functionalities.\n\n## Installation\n\nThe module is installed using pip:\n\n```bash\npip install IHSBotballKit\n```\n\n## Usage\n\nDocumentation can be found in the source code or stubs. Examples use cases are provided in the examples folder.\n\n## Contributing\n\nContributions are welcome! Please follow the following style guides:\n\n- Use standard python syntax and naming conventions(e.g. snake_case for variables, CamelCase for classes).\n-\n- All importable members must be documented using [Google style docstrings](https://sphinxcontrib-napoleon.readthedocs.io/en/latest/example_google.html).\n- Type hinting is not required but strongly recommended whenever possible.\n- It is recommended to use a static type checker such as [mypy](https://mypy.readthedocs.io/en/stable/) while contributing to the package.\n- Create stubs in the stubs folder after you've made all the changes. A good way to do that is to use [mypy's stubgen](https://mypy.readthedocs.io/en/stable/stubgen.html).\n - note: the stubs generated will have some issues and incomplete typing. It is your job to fix them before committing the code.\n\n ```bash\n # generate all the stubs at once\n stubgen -p ./IHSBotballKit -v --include-docstrings -o ./stubs\n # generate stubs for one (or more) file\n stubgen ./IHSBotballKit/file.py ./IHSBotballKit/file2.py -v --include-docstrings -0 ./stubs\n ```\n- Chores:\n - Update version number in `__init__.py` according to semantic versioning guidelines.\n - Create new release on GitHub.\n - Update relevant information in `setup.py`, namely version, download url, and dependencies.\n - Run the following to upload the new version to pypi.\n ```bash\n rm -rf dist && python3 setup.py sdist\n twine check dist/* # make sure there are no problems in the uploaded file(s)\n twine upload dist/*\n ```\n\n## Acknowledgements\n\n- [Botballkit](https://pypi.org/project/BotballKit/) - For inspiration and some functionality.\n\n## Issues\n\nIf you encounter any issues, please create a new issue here. Please be detailed in the description of the issue, include relevant background information (e.g. operating system, software versions), expected behavior, and how to reproduce the issue.\n\n\n",
"bugtrack_url": null,
"license": "GPL-3.0",
"summary": "An object-oriented wrapper for the KIPR Botball library with additional functionalities.",
"version": "1.0.1",
"project_urls": {
"Download": "https://github.com/ihsrobotics/IHSBotballKit/archive/refs/tags/1.0.1.tar.gz",
"Homepage": "https://github.com/snow4060"
},
"split_keywords": [
"kipr",
" botball",
" wombat",
" libkipr",
" libwallaby"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "fc51d5c71c5d3c8f1dfc7cadc53c2cef7266d38a454bf2e1c42ce001438c6bfe",
"md5": "3e65efd74ab43274def38dabc3ca3afa",
"sha256": "c8d344b7fe9566db32e49da689e432098b6e08006d67b5c9d94197a50b24866a"
},
"downloads": -1,
"filename": "IHSBotballKit-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "3e65efd74ab43274def38dabc3ca3afa",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 30175,
"upload_time": "2024-06-28T12:02:47",
"upload_time_iso_8601": "2024-06-28T12:02:47.452949Z",
"url": "https://files.pythonhosted.org/packages/fc/51/d5c71c5d3c8f1dfc7cadc53c2cef7266d38a454bf2e1c42ce001438c6bfe/IHSBotballKit-1.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-28 12:02:47",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ihsrobotics",
"github_project": "IHSBotballKit",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "ihsbotballkit"
}
JSON
