René's URL Explorer Experiment


Title: General discussion of using `@deprecated()` (from PEP 702) to signal typing-only deprecations · Issue #12092 · python/typeshed · GitHub

Open Graph Title: General discussion of using `@deprecated()` (from PEP 702) to signal typing-only deprecations · Issue #12092 · python/typeshed

X Title: General discussion of using `@deprecated()` (from PEP 702) to signal typing-only deprecations · Issue #12092 · python/typeshed

Description: This is an attempt to centralize discussion about using @(warnings/typing_extensions).deprecated() in typeshed to convey "typing-only" deprecations, not just runtime-related ones. I'm currently trying to use the decorator that way in #12...

Open Graph Description: This is an attempt to centralize discussion about using @(warnings/typing_extensions).deprecated() in typeshed to convey "typing-only" deprecations, not just runtime-related ones. I'm currently try...

X Description: This is an attempt to centralize discussion about using @(warnings/typing_extensions).deprecated() in typeshed to convey "typing-only" deprecations, not just runtime-related ones. I'm...

Opengraph URL: https://github.com/python/typeshed/issues/12092

X: @github

direct link

Domain: github.com


Hey, it has json ld scripts:
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"General discussion of using `@deprecated()` (from PEP 702) to signal typing-only deprecations","articleBody":"This is an attempt to centralize discussion about using `@(warnings/typing_extensions).deprecated()` in typeshed to convey \"typing-only\" deprecations, not just runtime-related ones. I'm currently trying to use the decorator that way in #12087, and only just now saw it brought up in [another PR](\u003chttps://github.com/python/typeshed/pull/12088#discussion_r1624723106>) as well. @AlexWaygood made some good points (imo) about things to consider when using `@deprecated()` with an (artificial or natural) overload this way, so I figured moving such discussion to its own dedicated thread was well warranted.\r\n\r\nI linked messages with points in favor of using `@deprecated()` this way below (because I'm too lazy right now to rephrase them into clean bullets, but it'll happen at some point):\r\n- In a message [here](https://github.com/python/typeshed/pull/12088#discussion_r1624804334) from @srittau in a PR comment chain.\r\n- In a PR of mine, e.g. in the first message of #12087, under \"Additional Rationale\", and [in a later comment](https://github.com/python/typeshed/pull/12087#issue-2329849817).\r\n\r\nThen, a few starting questions and concerns quoted from Alex (hope you don't mind):\r\n1. Are we planning on removing the [deprecated] overload eventually?\r\n2. If so, how long a deprecation period are we planning on giving?\r\n3. Should we communicate that deprecation period in the message to the user?\r\n4. How will we remember to remove the deprecated overload when we reach the end of the deprecation period?\r\n5. Should we have a policy around this?\r\n6. Do we need some clear language here to make clear that there's not actually any indication that runtime support for this will ever be removed, it's just a typing-only deprecation?\r\n7. ... the main point I want us to remember is that deprecations can still be really disruptive, but we don't have a good sense of how disruptive at all in our CI at the moment, because mypy doesn't support `@deprecated()` yet, so nothing will show up in mypy_primer.\r\n\r\nHope this is useful and not just me being overzealous.\r\n\r\nEDIT: Also including [a link](https://github.com/python/typeshed/pull/12088#discussion_r1624946548) to a message by @Akuli in one of the comment chains mentioned earlier, which gives an example for making the choice between using `deprecated` vs. removing a function stub entirely, and what consideration can go into that.","author":{"url":"https://github.com/Sachaa-Thanasius","@type":"Person","name":"Sachaa-Thanasius"},"datePublished":"2024-06-03T21:00:11Z","url":"https://github.com/python/typeshed/issues/12092"}

react-profiling0
react-import-mapreact,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-controllervoltron_issues_fragments
route-actionissue_layout
fetch-noncev2:8a9cbb99-19ee-2985-9cb0-256fff449681
current-catalog-service-hash81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114
request-id8B96:4D728:2D85585:3BDA336:6B001BCB
html-safe-noncee74eb40c35a942e9c334423d22913b3f6b65c7ba58a90cedba13386b81b7b78e
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiI4Qjk2OjRENzI4OjJEODU1ODU6M0JEQTMzNjo2QjAwMUJDQiIsInZpc2l0b3JfaWQiOiIyNzkzMTI4MjYzNTgzNTM4MTIzIiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0=
visitor-hmaca50801ac1bec9cd70a92b7d657cc3cc3252a9a3b58e6c11ccbeebde174220028
hovercard-subject-tagissue:2332043865
github-keyboard-shortcutsrepository,issues,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///voltron/issues_fragments/issue_layout
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/python/typeshed/12092/issue_layout
twitter:imagehttps://opengraph.githubassets.com/2a9781a8988ec3a8020e41e3b77503a517aad3d412ba33e147ac3d9e6dc21b20/python/typeshed/issues/12092
twitter:cardsummary_large_image
og:imagehttps://opengraph.githubassets.com/2a9781a8988ec3a8020e41e3b77503a517aad3d412ba33e147ac3d9e6dc21b20/python/typeshed/issues/12092
og:image:altThis is an attempt to centralize discussion about using @(warnings/typing_extensions).deprecated() in typeshed to convey "typing-only" deprecations, not just runtime-related ones. I'm currently try...
og:image:width1200
og:image:height600
og:site_nameGitHub
og:typeobject
og:author:usernameSachaa-Thanasius
hostnamegithub.com
expected-hostnamegithub.com
None4eb4cba0d69f045374ac15de9666d22b0961e1d555cc3824f36b7734c00c78e0
turbo-cache-controlno-preview
go-importgithub.com/python/typeshed git https://github.com/python/typeshed.git
octolytics-dimension-user_id1525981
octolytics-dimension-user_loginpython
octolytics-dimension-repository_id31696383
octolytics-dimension-repository_nwopython/typeshed
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id31696383
octolytics-dimension-repository_network_root_nwopython/typeshed
turbo-body-classeslogged-out env-production page-responsive
disable-turbofalse
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
release44c658b24abf00491fb7ae5f56d42c9f38cbeab2
ui-targetcanary-1
theme-color#1e2327
color-schemelight dark
react-app-nameissues

Links:

Skip to contenthttps://github.com/python/typeshed/issues/12092#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fpython%2Ftypeshed%2Fissues%2F12092
GitHubRepository hosting, code review, and collaborationhttps://github.com/platform
CopilotAI coding agent for tasks, projects, and automated workhttps://github.com/features/copilot
ActionsCI/CD and automationhttps://github.com/features/actions
Code QualityQuality analysis, fixes, and enforcementhttps://github.com/features/code-quality
CodespacesCloud development environmentshttps://github.com/features/codespaces
Code SecurityVulnerability detection and remediationhttps://github.com/security/advanced-security/code-security
Secret ProtectionSecret scanning and leak preventionhttps://github.com/security/advanced-security/secret-protection
All Featureshttps://github.com/features
Documentationhttps://docs.github.com/en
Traininghttps://learn.github.com/skills
Certificationshttps://learn.github.com/credentials
Build with Copilothttps://github.com/features/ai
Customize Copilothttps://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-copilot-overview
Integrationshttps://github.com/marketplace
Trending reposhttps://github.com/trending
GitHub Sponsorshttps://github.com/open-source/sponsors
Developer articleshttps://github.com/resources/articles
ChangelogYour source for the latest features, improvements, and fixes across GitHub products, all in one place.https://github.blog/changelog/
Enterpriseshttps://github.com/enterprise
Teamhttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
Healthcarehttps://github.com/solutions/industry/healthcare
Financial serviceshttps://github.com/solutions/industry/financial-services
Manufacturinghttps://github.com/solutions/industry/manufacturing
Governmenthttps://github.com/solutions/industry/government
See all industrieshttps://github.com/solutions/industry
Why GitHubhttps://github.com/why-github
Customer Storieshttps://github.com/customer-stories
Business insightshttps://github.com/solutions/executive-insights
Trust Centerhttps://github.com/trust-center
GitHub Advanced SecurityEnterprise-grade code securityhttps://github.com/security/advanced-security
Copilot for businessEnterprise-grade AI featureshttps://github.com/features/copilot/copilot-business
Premium SupportEnterprise-grade 24/7 supporthttps://github.com/enterprise/premium-support
Documentationhttps://docs.github.com/en
Resource centerhttps://github.com/resources
Bloghttps://github.blog/
Events & webinarshttps://github.com/resources/events
Community Forumhttps://github.com/orgs/community/discussions
Customer Storieshttps://github.com/customer-stories
Integrationshttps://github.com/marketplace
Customer supporthttps://help.github.com/
Traininghttps://learn.github.com/skills
GitHub Statushttps://www.githubstatus.com/
Abouthttps://github.com/about
Partnershttps://github.com/partners
Changeloghttps://github.blog/changelog/
GitHub UniverseThe event for developers, by developers — talks, workshops, and what’s next for GitHub.https://githubuniverse.com/
Pricinghttps://github.com/pricing
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fpython%2Ftypeshed%2Fissues%2F12092
Sign uphttps://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fvoltron%2Fissues_fragments%2Fissue_layout&source=header-repo&source_repo=python%2Ftypeshed
Reloadhttps://github.com/python/typeshed/issues/12092
Reloadhttps://github.com/python/typeshed/issues/12092
Reloadhttps://github.com/python/typeshed/issues/12092
pythonhttps://github.com/python
typeshedhttps://github.com/python/typeshed
Codehttps://github.com/python/typeshed
Issues196 (196)https://github.com/python/typeshed/issues
Pull requests251 (251)https://github.com/python/typeshed/pulls
Actionshttps://github.com/python/typeshed/actions
Security and qualityhttps://github.com/python/typeshed/security
Insightshttps://github.com/python/typeshed/insights
https://github.com/python/typeshed
New issuehttps://github.com/login?return_to=https://github.com/python/typeshed/issues/12092
New issuehttps://github.com/login?return_to=https://github.com/python/typeshed/issues/12092
#16071https://github.com/python/typeshed/pull/16071
General discussion of using @deprecated() (from PEP 702) to signal typing-only deprecationshttps://github.com/python/typeshed/issues/12092#top
#16071https://github.com/python/typeshed/pull/16071
project: policyOrganization of the typeshed projecthttps://github.com/python/typeshed/issues?q=state%3Aopen%20label%3A%22project%3A%20policy%22
https://github.com/Sachaa-Thanasius
Sachaa-Thanasiushttps://github.com/Sachaa-Thanasius
on Jun 3, 2024https://github.com/python/typeshed/issues/12092#issue-2332043865
#12087https://github.com/python/typeshed/pull/12087
another PRhttps://github.com/python/typeshed/pull/12088#discussion_r1624723106
@AlexWaygoodhttps://github.com/AlexWaygood
herehttps://github.com/python/typeshed/pull/12088#discussion_r1624804334
@srittauhttps://github.com/srittau
Fix the signatures of @(async)contextmanager #12087https://github.com/python/typeshed/pull/12087
in a later commenthttps://github.com/python/typeshed/pull/12087#issue-2329849817
a linkhttps://github.com/python/typeshed/pull/12088#discussion_r1624946548
@Akulihttps://github.com/Akuli
Sachaa-Thanasiushttps://github.com/Sachaa-Thanasius
on Jun 3, 2024https://github.com/python/typeshed/issues/12092#event-13026947414
AlexWaygoodhttps://github.com/AlexWaygood
project: policyOrganization of the typeshed projecthttps://github.com/python/typeshed/issues?q=state%3Aopen%20label%3A%22project%3A%20policy%22
on Jun 3, 2024https://github.com/python/typeshed/issues/12092#event-13026955512
https://github.com/mikeshardmind
mikeshardmindhttps://github.com/mikeshardmind
on Jun 3, 2024https://github.com/python/typeshed/issues/12092#issuecomment-2146183378
https://github.com/Sachaa-Thanasius
Sachaa-Thanasiushttps://github.com/Sachaa-Thanasius
on Jun 3, 2024https://github.com/python/typeshed/issues/12092#issuecomment-2146197875
https://github.com/Akuli
Akulihttps://github.com/Akuli
on Jun 3, 2024https://github.com/python/typeshed/issues/12092#issuecomment-2146246224
https://github.com/JelleZijlstra
JelleZijlstrahttps://github.com/JelleZijlstra
on Jun 3, 2024https://github.com/python/typeshed/issues/12092#issuecomment-2146255661
https://github.com/Sachaa-Thanasius
Sachaa-Thanasiushttps://github.com/Sachaa-Thanasius
on Jun 3, 2024https://github.com/python/typeshed/issues/12092#issuecomment-2146288254
@JelleZijlstrahttps://github.com/JelleZijlstra
https://github.com/JelleZijlstra
JelleZijlstrahttps://github.com/JelleZijlstra
on Jun 3, 2024https://github.com/python/typeshed/issues/12092#issuecomment-2146295714
https://docs.google.com/presentation/d/1yzAh1Tok_wIk3lYo3rq1ieQp8MciVzO7pWI_m_LY30Y/edit?usp=sharinghttps://docs.google.com/presentation/d/1yzAh1Tok_wIk3lYo3rq1ieQp8MciVzO7pWI_m_LY30Y/edit?usp=sharing
https://github.com/srittau
srittauhttps://github.com/srittau
on Jun 4, 2024https://github.com/python/typeshed/issues/12092#issuecomment-2146892784
https://github.com/srittau
srittauhttps://github.com/srittau
on Oct 21, 2024https://github.com/python/typeshed/issues/12092#issuecomment-2426433916
@AlexWaygoodhttps://github.com/AlexWaygood
https://github.com/JelleZijlstra
JelleZijlstrahttps://github.com/JelleZijlstra
on Oct 21, 2024https://github.com/python/typeshed/issues/12092#issuecomment-2426441704
@deprecatedhttps://github.com/deprecated
https://github.com/srittau
srittauhttps://github.com/srittau
on Oct 21, 2024https://github.com/python/typeshed/issues/12092#issuecomment-2426451724
https://github.com/AlexWaygood
AlexWaygoodhttps://github.com/AlexWaygood
on Oct 21, 2024https://github.com/python/typeshed/issues/12092#issuecomment-2426741122
https://github.com/hauntsaninja
hauntsaninjahttps://github.com/hauntsaninja
on Oct 21, 2024https://github.com/python/typeshed/issues/12092#issuecomment-2427640293
srittauhttps://github.com/srittau
completedhttps://github.com/python/typeshed/issues?q=is%3Aissue%20state%3Aclosed%20archived%3Afalse%20reason%3Acompleted
#16071https://github.com/python/typeshed/pull/16071
on Jul 22, 2026https://github.com/python/typeshed/issues/12092#event-28337712194
Sign up for freehttps://github.com/signup?return_to=https://github.com/python/typeshed/issues/12092
Sign in to commenthttps://github.com/login?return_to=https://github.com/python/typeshed/issues/12092
project: policyOrganization of the typeshed projecthttps://github.com/python/typeshed/issues?q=state%3Aopen%20label%3A%22project%3A%20policy%22
https://github.com
Termshttps://docs.github.com/site-policy/github-terms/github-terms-of-service
Privacyhttps://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Securityhttps://github.com/security
Statushttps://www.githubstatus.com/
Communityhttps://github.community/
Docshttps://docs.github.com/
Contacthttps://support.github.com?tags=dotcom-footer

Viewport: width=device-width


URLs of crawlers that visited me.