Title: Unify typing for `__path__`? · Issue #6650 · python/typeshed · GitHub
Open Graph Title: Unify typing for `__path__`? · Issue #6650 · python/typeshed
X Title: Unify typing for `__path__`? · Issue #6650 · python/typeshed
Description: After the last mypy update v0.920, I started to notice an inconsistency with how the module variable __path__ is typed mainly across typeshed, mypy, and pyright. Type Link typeshed - ModuleType MutableSequence[str] #6200 typeshed - pkgut...
Open Graph Description: After the last mypy update v0.920, I started to notice an inconsistency with how the module variable __path__ is typed mainly across typeshed, mypy, and pyright. Type Link typeshed - ModuleType Mut...
X Description: After the last mypy update v0.920, I started to notice an inconsistency with how the module variable __path__ is typed mainly across typeshed, mypy, and pyright. Type Link typeshed - ModuleType Mut...
Opengraph URL: https://github.com/python/typeshed/issues/6650
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Unify typing for `__path__`?","articleBody":"After the last mypy update v0.920, I started to notice an inconsistency with how the module variable `__path__` is typed mainly across typeshed, mypy, and pyright.\r\n\r\n| | Type | Link |\r\n| - | ----- | -----|\r\n| typeshed - `ModuleType` | `MutableSequence[str]` | https://github.com/python/typeshed/pull/6200 |\r\n| typeshed - `pkgutil.extend_path` | `list[str]` | https://github.com/python/typeshed/pull/5222 |\r\n| mypy | `list[str]` | https://github.com/python/mypy/pull/9454 |\r\n| pyright | `Iterable[str]` | https://github.com/microsoft/pylance-release/issues/1098 |\r\n\r\nIn the [Python docs](https://docs.python.org/3.9/reference/import.html#module-path) it's mentioned as:\r\n```markdown\r\n`__path__` must be an iterable of strings, but it may be empty.\r\n```\r\n\r\nHowever the docs for `pkgutil.extend_path` go on say it's mostly a list (?) [cpython/pkgutil.py](https://github.com/python/cpython/blob/04deaee4c8d313717f3ea8f6a4fd70286d510d6e/Lib/pkgutil.py#L527-L530)\r\n```txt\r\n If the input path is not a list (as is the case for frozen\r\n packages) it is returned unchanged. The input path is not\r\n modified; an extended copy is returned. Items are only appended\r\n to the copy at the end.\r\n```\r\n\r\nFrom my point of view, it isn't entirely clear what the \"correct\" type should be. Some points to consider though:\r\n* In most cases it seems to be a `list[str]`.\r\n* It was mentioned [here](https://github.com/python/typeshed/pull/6200#pullrequestreview-788426245) however that it can sometimes also be a `MutableSequence[str]`\r\n* The `__path__` type should be valid as first argument to `pkgutil.extend_path`. At the moment that only applies to `list[str]` but obviously the argument type for `extend_path` could be changed to, for example, accept a TypeVar bound to `Iterable[str]` instead.\r\n* It seems to be fairly common (and safe ?) to access the at least the first item of `__path__` via `__getitem__`.","author":{"url":"https://github.com/cdce8p","@type":"Person","name":"cdce8p"},"datePublished":"2021-12-21T20:58:46Z","url":"https://github.com/python/typeshed/issues/6650"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322 |
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:3e81b491-3a55-dbb0-11fa-9b0bc2bb3653 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | A38E:11BB24:2A1D9AD:3964287:6B004C0D |
| html-safe-nonce | 6b8a37b95bc3321548a67f66c56b18dccfb85c04cd86d5e67641b142df24c990 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJBMzhFOjExQkIyNDoyQTFEOUFEOjM5NjQyODc6NkIwMDRDMEQiLCJ2aXNpdG9yX2lkIjoiNzE4Njg4MTIzNzYxNTY2MDA0NiIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9 |
| visitor-hmac | ea3b4fe4c8a74bb06c6084702c0820600f40d39aee939297c682e5e4623691b8 |
| hovercard-subject-tag | issue:1086225724 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/python/typeshed/6650/issue_layout |
| twitter:image | https://opengraph.githubassets.com/ec105c551e924b6125cd420f833407aeaf6d43ff32fc6fea42ca720ada494b91/python/typeshed/issues/6650 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/ec105c551e924b6125cd420f833407aeaf6d43ff32fc6fea42ca720ada494b91/python/typeshed/issues/6650 |
| og:image:alt | After the last mypy update v0.920, I started to notice an inconsistency with how the module variable __path__ is typed mainly across typeshed, mypy, and pyright. Type Link typeshed - ModuleType Mut... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | cdce8p |
| hostname | github.com |
| expected-hostname | github.com |
| None | f9517bf360d46638a1e5e7daee7158842fe5ef43c9000afa0e127564a7c2f39b |
| turbo-cache-control | no-preview |
| go-import | github.com/python/typeshed git https://github.com/python/typeshed.git |
| octolytics-dimension-user_id | 1525981 |
| octolytics-dimension-user_login | python |
| octolytics-dimension-repository_id | 31696383 |
| octolytics-dimension-repository_nwo | python/typeshed |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 31696383 |
| octolytics-dimension-repository_network_root_nwo | python/typeshed |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | b27c5dde30676028abd5c5fc53ce5c9b625f8281 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width