googleapis / googleapis/google-cloud-python

`py.typed` but no type annotations

Open
#15,409 1 comment 0 reactions 1 assignee Claimed by @gkevinzheng View on GitHub
api: logging priority: p3 type: feature request
Dominant language
Python
Stars
5.4k
Forks
1.8k
Avg merge
3d 4h
Merged PRs (30d)
122

Description

`google.cloud.logging_v2 contains` a `py.typed` file but the package does not provide type annotations.

Hence, code like this:

```py
from google.cloud.logging import Client
from google.cloud.logging.handlers import CloudLoggingHandler
from google.cloud.logging_v2.handlers.handlers import setup_logging

client = Client()
handler = CloudLoggingHandler(client)
setup_logging(handler)
```

will trigger this error in Pyright:

```
test.py:3:55 - error: Type of "setup_logging" is partially unknown
  Type of "setup_logging" is "(handler: Unknown, *, excluded_loggers: Unknown = EXCLUDED_LOGGER_DEFAULTS, log_level: int = logging.INFO) -> None" (reportUnknownVariableType)
```

My interpretation of the meaning of `py.typed` is "this package has type annotations that should be use by the type checker for code importing this package".

Is there any plan to provide type annotations?

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.