René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Add PEP 484 -- Type Hints","articleBody":"Python supports type hints to improve static analysis:\r\n\u003chttps://www.python.org/dev/peps/pep-0484/\u003e\r\nThis helps to identify cases, were wrong types are passed into functions et al by using type checkers like\u003chttp://mypy-lang.org/\u003e or \u003chttps://github.com/google/pytype/\u003e.\r\n\r\n`python-ldap` does not yet seem to contain those annotations nor am I aware of any project doing that.\r\nThose annotation can either we added directly in the library like\r\n\r\n\u003e def func(arg: str, val: int = 0) -\u003e Tuple[int, str]\r\n\r\nsince Python 3.5 or in a Python-2 backward compatible way as\r\n\r\n\u003e def func(arg, val=0):  # type: (str, int) -\u003e Tuple[int, str]\r\n\r\nAs an alternative the annotations can be put into so-called \"stub files\" names \"*.pyi\", which are collected by \u003chttps://github.com/python/typeshed\u003e, but inline annotations are preferred as they are easier to keep in sync.\r\n\r\n\r\nI started working on that, but other projects have preempted that\r\neffort. My current work is at\r\n\u003chttps://github.com/univention/typeshed/commit/8fc5f796d4ef009e5cf8282575ae304994170b25\u003e,\r\nbut it not much more then generating the stubs using `stubgen`.\r\nIf someone wants to join that effort that is much appreciated.\r\n\r\n\r\nThis was proposed to the [Mailing List](https://mail.python.org/pipermail/python-ldap/2020q2/004098.html).\r\n@tiran proposed to start the work only after the Python 2 legacy code is removed:\r\n\u003e we are planning to drop support for Python 3.5 and earlier in the next\r\n\u003e version of python-ldap. This would make it simpler to add signatures for\r\n\u003e type hints directly to the code base. Patches are welcome, but please\r\n\u003e wait until we have finalized Python 2 cleanup in master.","author":{"url":"https://github.com/pmhahn","@type":"Person","name":"pmhahn"},"datePublished":"2020-07-01T16:41:50.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":3},"url":"https://github.com/368/python-ldap/issues/368"}