Title: Proposal: add `@typing.format_specifiers` · Issue #2321 · python/typing · GitHub
Open Graph Title: Proposal: add `@typing.format_specifiers` · Issue #2321 · python/typing
X Title: Proposal: add `@typing.format_specifiers` · Issue #2321 · python/typing
Description: This decorator factory would tell type checkers what format codes are supported by instances of that type. It would take variable positional arguments, each a string corresponding to a valid specification, and type checkers will know the...
Open Graph Description: This decorator factory would tell type checkers what format codes are supported by instances of that type. It would take variable positional arguments, each a string corresponding to a valid specif...
X Description: This decorator factory would tell type checkers what format codes are supported by instances of that type. It would take variable positional arguments, each a string corresponding to a valid specif...
Opengraph URL: https://github.com/python/typing/issues/2321
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Proposal: add `@typing.format_specifiers`","articleBody":"This decorator factory would tell type checkers what format codes are supported by instances of that type. It would take variable positional arguments, each a string corresponding to a valid specification, and type checkers will know the class its returned decorator is applied to will only take those format specifications, so that it can flag mistyped format specifications and make subtle bugs clear. It, however, requires special-casing string formatting and the `format` builtin.\n\nCurrently it is possible to restrict the type of `format_spec` in `__format__` to `Literal[...]`, but that will cause Liskov substitution principle violations and type checkers may not consider it.\n\nI am opening an issue here in hopes of getting more feedback because my [DPO thread](https://discuss.python.org/t/proposal-add-typing-format-specifiers/108070) has gained little traction.","author":{"url":"https://github.com/jonathandung","@type":"Person","name":"jonathandung"},"datePublished":"2026-07-18T05:44:48Z","url":"https://github.com/python/typing/issues/2321"}
| 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:277eae06-b7c6-55ed-c9b1-4707b4e01fa4 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | C34C:386C04:1FAE3:2902F:6AFF9A07 |
| html-safe-nonce | 4e47bcf7ef8310506c56ee840fa9baca6524d739d4b751a95f2065ef2fe202d3 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJDMzRDOjM4NkMwNDoxRkFFMzoyOTAyRjo2QUZGOUEwNyIsInZpc2l0b3JfaWQiOiI2NDE5MDU1ODY4MDkxODAwMDcxIiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0= |
| visitor-hmac | 998ccabe19e5cd7d8a37c32429868d4ede91166fdad783e8f19b5815b2648cb1 |
| hovercard-subject-tag | issue:4916934061 |
| 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/typing/2321/issue_layout |
| twitter:image | https://opengraph.githubassets.com/af68908459df152e4befe107ef505c9b7b6c01b7cabff02b52f5a0b71100794c/python/typing/issues/2321 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/af68908459df152e4befe107ef505c9b7b6c01b7cabff02b52f5a0b71100794c/python/typing/issues/2321 |
| og:image:alt | This decorator factory would tell type checkers what format codes are supported by instances of that type. It would take variable positional arguments, each a string corresponding to a valid specif... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | jonathandung |
| hostname | github.com |
| expected-hostname | github.com |
| None | 2c75d045e8c84b51e2ac680086a6dd1eeaf2bc15b82137d22ee5106835d6256c |
| turbo-cache-control | no-preview |
| go-import | github.com/python/typing git https://github.com/python/typing.git |
| octolytics-dimension-user_id | 1525981 |
| octolytics-dimension-user_login | python |
| octolytics-dimension-repository_id | 24604008 |
| octolytics-dimension-repository_nwo | python/typing |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 24604008 |
| octolytics-dimension-repository_network_root_nwo | python/typing |
| 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 | 525b66d22c4f7e6bb8b62934bec198964f7e8b93 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width