| Name | jk_typing JSON |
| Version |
0.2024.1.3
JSON |
| download |
| home_page | None |
| Summary | This module provides capabilities for type checking function arguments. (NOTE: A full type check with this module is not possible, since this is fundamentally not possible due to limitiations of Python itself.) |
| upload_time | 2024-01-03 12:04:08 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.8 |
| license | None |
| keywords |
typing
type-checking
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
jk_typing
==========
Introduction
------------
This module provides capabilities for type checking function arguments.
Please note that a full type check with this module is not possible, since this is fundamentally not possible due to limitiations of Python itself.
Information about this module can be found here:
* [github.org](https://github.com/jkpubsrc/python-module-jk-typing)
* [Documentation](https://github.com/jkpubsrc/python-module-jk-typing/tree/master/documentation)
* [pypi.python.org](https://pypi.python.org/pypi/jk_typing)
Why this module?
----------------
Python nowadays is capable of managing type hints for function arguments and return values. Unfortunately Python does not perform type checking automatically. This module provides capabilities of performing type checking automatically.
For more details have a look at the [documentation](https://github.com/jkpubsrc/python-module-jk-typing/tree/master/documentation).
Requirements
------------
This module requires Python 3.7 or later. It can not be used on older releases of Python because of limitations of module `typing`.
Limitations of this module
--------------------------
Type checking is not implemented in pure Python. Therefore it is slower as if the Python interpreter would perform type checking itself. Additionally this module has not yet a complete implementation of all kinds of types. (This will change in the future, maybe with your help.)
For more details have a look at the [documentation](https://github.com/jkpubsrc/python-module-jk-typing/tree/master/documentation).
How to use this module
----------------------
### Import this module
Please include this module into your application using the following code:
```python
import jk_typing
```
### Define a function
Example:
```python
@checkFunctionSignature(bDebug = True)
def someFunction(a:int, b:str) -> bool:
return str(a) == b
```
### Invoke the function (and perform type checking)
```python
result = someFunction(123, "123")
print(result)
```
Contact Information
-------------------
This work is Open Source. This enables you to use this work for free.
Please have in mind this also enables you to contribute. We, the subspecies of software developers, can create great things. But the more collaborate, the more fantastic these things can become. Therefore Feel free to contact the author(s) listed below, either for giving feedback, providing comments, hints, indicate possible collaborations, ideas, improvements. Or maybe for "only" reporting some bugs:
* Jürgen Knauth: jknauth@uni-goettingen.de, pubsrc@binary-overflow.de
License
-------
This software is provided under the following license:
* Apache Software License 2.0
Raw data
{
"_id": null,
"home_page": null,
"name": "jk_typing",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "J\u00fcrgen Knauth <pubsrc@binary-overflow.de>",
"keywords": "typing,type-checking",
"author": null,
"author_email": "J\u00fcrgen Knauth <pubsrc@binary-overflow.de>",
"download_url": "https://files.pythonhosted.org/packages/c7/25/7f162946eb01117229e021c1962c7e02c11508f43cdce17d9ca53bccc805/jk_typing-0.2024.1.3.tar.gz",
"platform": null,
"description": "jk_typing\n==========\n\nIntroduction\n------------\n\nThis module provides capabilities for type checking function arguments.\n\nPlease note that a full type check with this module is not possible, since this is fundamentally not possible due to limitiations of Python itself.\n\nInformation about this module can be found here:\n\n* [github.org](https://github.com/jkpubsrc/python-module-jk-typing)\n\t* [Documentation](https://github.com/jkpubsrc/python-module-jk-typing/tree/master/documentation)\n* [pypi.python.org](https://pypi.python.org/pypi/jk_typing)\n\nWhy this module?\n----------------\n\nPython nowadays is capable of managing type hints for function arguments and return values. Unfortunately Python does not perform type checking automatically. This module provides capabilities of performing type checking automatically.\n\nFor more details have a look at the [documentation](https://github.com/jkpubsrc/python-module-jk-typing/tree/master/documentation).\n\nRequirements\n------------\n\nThis module requires Python 3.7 or later. It can not be used on older releases of Python because of limitations of module `typing`.\n\nLimitations of this module\n--------------------------\n\nType checking is not implemented in pure Python. Therefore it is slower as if the Python interpreter would perform type checking itself. Additionally this module has not yet a complete implementation of all kinds of types. (This will change in the future, maybe with your help.)\n\nFor more details have a look at the [documentation](https://github.com/jkpubsrc/python-module-jk-typing/tree/master/documentation).\n\nHow to use this module\n----------------------\n\n### Import this module\n\nPlease include this module into your application using the following code:\n\n```python\nimport jk_typing\n```\n\n### Define a function\n\nExample:\n\n```python\n@checkFunctionSignature(bDebug = True)\ndef someFunction(a:int, b:str) -> bool:\n\treturn str(a) == b\n```\n\n### Invoke the function (and perform type checking)\n\n```python\nresult = someFunction(123, \"123\")\nprint(result)\n```\n\nContact Information\n-------------------\n\nThis work is Open Source. This enables you to use this work for free.\n\nPlease have in mind this also enables you to contribute. We, the subspecies of software developers, can create great things. But the more collaborate, the more fantastic these things can become. Therefore Feel free to contact the author(s) listed below, either for giving feedback, providing comments, hints, indicate possible collaborations, ideas, improvements. Or maybe for \"only\" reporting some bugs:\n\n* J\u00fcrgen Knauth: jknauth@uni-goettingen.de, pubsrc@binary-overflow.de\n\nLicense\n-------\n\nThis software is provided under the following license:\n\n* Apache Software License 2.0\n\n\n\n",
"bugtrack_url": null,
"license": null,
"summary": "This module provides capabilities for type checking function arguments. (NOTE: A full type check with this module is not possible, since this is fundamentally not possible due to limitiations of Python itself.)",
"version": "0.2024.1.3",
"project_urls": null,
"split_keywords": [
"typing",
"type-checking"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "1d9b15467632d81e5598746f2888697e3450fcbd400c6cc76b2aaf3efc5ff77e",
"md5": "4cff230d5c91b54bc6a6d539acf3ce14",
"sha256": "6ae6f17b055d8a2f12f11f9f369bee961fe4a65b88ad2de82e29dbd5745fea8a"
},
"downloads": -1,
"filename": "jk_typing-0.2024.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4cff230d5c91b54bc6a6d539acf3ce14",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 19565,
"upload_time": "2024-01-03T12:04:06",
"upload_time_iso_8601": "2024-01-03T12:04:06.377903Z",
"url": "https://files.pythonhosted.org/packages/1d/9b/15467632d81e5598746f2888697e3450fcbd400c6cc76b2aaf3efc5ff77e/jk_typing-0.2024.1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "c7257f162946eb01117229e021c1962c7e02c11508f43cdce17d9ca53bccc805",
"md5": "9ee41a15ce7df4b283a71d2a7fe42af7",
"sha256": "a9b8d98a79551eb136beed0d464275630e4811ded3e5224e0f30d1b29efa6818"
},
"downloads": -1,
"filename": "jk_typing-0.2024.1.3.tar.gz",
"has_sig": false,
"md5_digest": "9ee41a15ce7df4b283a71d2a7fe42af7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 11324,
"upload_time": "2024-01-03T12:04:08",
"upload_time_iso_8601": "2024-01-03T12:04:08.386389Z",
"url": "https://files.pythonhosted.org/packages/c7/25/7f162946eb01117229e021c1962c7e02c11508f43cdce17d9ca53bccc805/jk_typing-0.2024.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-03 12:04:08",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "jk_typing"
}
