aio-libs / aio-libs/aioodbc

Type hints are not readily available through Pylance in VS Code

Đang mở
#421 1 bình luận 0 reaction 0 người được giao Xem trên GitHub
Ngôn ngữ chính
Python
Star
326
Fork
62
Chỉ số merge pull request
Không có pull request nào được merge trong 30 ngày

Mô tả

Alternate title: "aioodbc does not support PEP 561"

[PEP 561 – Distributing and Packaging Type Information] defines the mechanisms for distributing packages with type hints:

> Package maintainers who wish to support type checking of their code MUST add a marker file named `py.typed` to their package supporting typing. This marker applies recursively: if a top-level package includes it, all its sub-packages MUST support type checking as well.

Since aioodbc does not contain a `py.typed` marker file, developers may find themselves without any type hints for the package. Developers are unable to take advantage of the type annotations already part of the project.

Most typed packages on PyPI publish place their `py.typed` file in the namespace directory (e.g., "\/aioodbc") to better centralize the type checking to the package source code. It would be a huge improvement to the developer experience if the aioodbc project included a `py.typed` marker file alongside the package.

[PEP 561 – Distributing and Packaging Type Information]:
https://peps.python.org/pep-0561/

Hướng dẫn đóng góp

Mở hướng dẫn đóng góp

Đánh giá

Issue này chưa được đánh giá.

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.