René's URL Explorer Experiment


Title: The docs for the typing stdlib module use the phrase "bound type var" to mean two distinct things · Issue #126543 · python/cpython · GitHub

Open Graph Title: The docs for the typing stdlib module use the phrase "bound type var" to mean two distinct things · Issue #126543 · python/cpython

X Title: The docs for the typing stdlib module use the phrase "bound type var" to mean two distinct things · Issue #126543 · python/cpython

Description: Documentation Follow-up of: https://discuss.python.org/t/a-typevar-with-a-bound-is-a-bounded-typevar-or-a-bound-typevar/69966 As discussed above, in some places the stdlib docs for the typing module use the phrase "bound type var" to mea...

Open Graph Description: Documentation Follow-up of: https://discuss.python.org/t/a-typevar-with-a-bound-is-a-bounded-typevar-or-a-bound-typevar/69966 As discussed above, in some places the stdlib docs for the typing modul...

X Description: Documentation Follow-up of: https://discuss.python.org/t/a-typevar-with-a-bound-is-a-bounded-typevar-or-a-bound-typevar/69966 As discussed above, in some places the stdlib docs for the typing modul...

Opengraph URL: https://github.com/python/cpython/issues/126543

X: @github

direct link

Domain: github.com


Hey, it has json ld scripts:
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"The docs for the typing stdlib module use the phrase \"bound type var\" to mean two distinct things","articleBody":"# Documentation\r\n\r\nFollow-up of: https://discuss.python.org/t/a-typevar-with-a-bound-is-a-bounded-typevar-or-a-bound-typevar/69966\r\n\r\nAs discussed above, in some places the stdlib docs for the typing module use the phrase \"bound type var\" to mean a TypeVar created using the `bound` keyword argument. This keyword argument, however, establishes a _boundary_ for that type variable, instead of _binding_ it---the _binding_ happens when we instantiate a generic function or class.\r\n\r\nI proposed changing \"bound type var\" to \"bounded type var\" in such contexts. @hauntsaninja expressed a concern that distinguishing between \"bound\" and \"bounded\" could be too subtle, and suggested using \"type var with upper bound\" instead, and \"hope that PEP 695 means we all end up talking about bound or unbound type variables less often.\" Two other people commented agreeing that there is an issue, but expressing no preference for \"bounded\" vs \"with upper bound\".\r\n\r\nI'd like to make a case for \"bounded\":\r\n\r\n1. The expression \"upper bound\" is used in the typing spec and in mypy's documentation (links in the Discourse thread), but it is not currently used in the stdlib docs. Introducing this expression would require a little refactoring of the text.\r\n2. In a few places in the text, the stdlib docs focuses on distinguishing _bound_ (i.e. bounded) type vars from _constrained_ type vars, and the text makes use of the fact that both \"bound\" and \"constrinained\" can be used as single-word adjectives to make parallell arguments clear. I believe that, for the resulting text to feel netural, changing \"bound\" to \"with upper bound\" would also require a little bit of refactoring.\r\n3. @hauntsaninja hoped that \"PEP 695 means we all end up talking about bound or unbound type variables less often.\" I don't really see why this would be the case. Take this docs snippet (which by the way is the first use of the word \"bound\" to mean \"bounded\"):\r\n\r\n```rst\r\n   This syntax can also be used to create bound and constrained type\r\n   variables::\r\n\r\n      class StrSequence[S: str]:  # S is a TypeVar bound to str\r\n          ...\r\n\r\n\r\n      class StrOrBytesSequence[A: (str, bytes)]:  # A is a TypeVar constrained to str or bytes\r\n          ...\r\n```\r\n\r\nPEP 695 introduces the `[S: str]` syntax so that the user can still explicitly declare that that type var has an upper bound (even though the word \"bound\" is not used anymore). Since this is a decision the user has to make, I believe the docs will still need to distinguish bounded type vars from unbounded type vars.\r\n\r\nI'll play around with the text, but before submitting a PR I'll wait until we reach a consensus on \"bounded\" vs \"with upper bound\". Of course, if we end up deciding in favor of \"with upper bound\", I'll be happy to introduce the expression \"upper bound\" and make the small text refactorings required.\n\n\u003c!-- gh-linked-prs -->\n### Linked PRs\n* gh-126584\n* gh-126657\n* gh-126658\n\u003c!-- /gh-linked-prs -->\n","author":{"url":"https://github.com/fofoni","@type":"Person","name":"fofoni"},"datePublished":"2024-11-07T14:21:41Z","url":"https://github.com/python/cpython/issues/126543"}

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:fbcb9eb8-609d-5308-d04e-b2bd8d73f9fa
current-catalog-service-hash81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114
request-id837A:3E19F2:10D4167:16293B3:6B000B1D
html-safe-nonce4ffce8f3434f037afa0338691e06d4d97f67eb0a2b7497d7061e58ac6f655e6d
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiI4MzdBOjNFMTlGMjoxMEQ0MTY3OjE2MjkzQjM6NkIwMDBCMUQiLCJ2aXNpdG9yX2lkIjoiODg3MDIyOTg2MzI0ODY5NDA0NiIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9
visitor-hmac1c871e48c4620a7473d526e0eb24e88b4eaf19a244d55ae76313109bb670fc37
hovercard-subject-tagissue:2641172085
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/cpython/126543/issue_layout
twitter:imagehttps://opengraph.githubassets.com/bc56cc8d63c6974ee4c0ed01160c6522d8c444dcd523ee02713325159a0aecbe/python/cpython/issues/126543
twitter:cardsummary_large_image
og:imagehttps://opengraph.githubassets.com/bc56cc8d63c6974ee4c0ed01160c6522d8c444dcd523ee02713325159a0aecbe/python/cpython/issues/126543
og:image:altDocumentation Follow-up of: https://discuss.python.org/t/a-typevar-with-a-bound-is-a-bounded-typevar-or-a-bound-typevar/69966 As discussed above, in some places the stdlib docs for the typing modul...
og:image:width1200
og:image:height600
og:site_nameGitHub
og:typeobject
og:author:usernamefofoni
hostnamegithub.com
expected-hostnamegithub.com
None0a0d8686a27478df474dd7415776a7a080cde8838b3cd92ea7601187572e5729
turbo-cache-controlno-preview
go-importgithub.com/python/cpython git https://github.com/python/cpython.git
octolytics-dimension-user_id1525981
octolytics-dimension-user_loginpython
octolytics-dimension-repository_id81598961
octolytics-dimension-repository_nwopython/cpython
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id81598961
octolytics-dimension-repository_network_root_nwopython/cpython
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
release16a11879678aaf97e2a42c33ee70830aa084fa37
ui-targetfull
theme-color#1e2327
color-schemelight dark
react-app-nameissues

Links:

Skip to contenthttps://github.com/python/cpython/issues/126543#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fpython%2Fcpython%2Fissues%2F126543
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%2Fcpython%2Fissues%2F126543
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%2Fcpython
Reloadhttps://github.com/python/cpython/issues/126543
Reloadhttps://github.com/python/cpython/issues/126543
Reloadhttps://github.com/python/cpython/issues/126543
pythonhttps://github.com/python
cpythonhttps://github.com/python/cpython
Codehttps://github.com/python/cpython
Issues5k+ (5k+)https://github.com/python/cpython/issues
Pull requests2.4k (2.4k)https://github.com/python/cpython/pulls
Actionshttps://github.com/python/cpython/actions
Projectshttps://github.com/python/cpython/projects
Security and qualityhttps://github.com/python/cpython/security
Insightshttps://github.com/python/cpython/insights
https://github.com/python/cpython
New issuehttps://github.com/login?return_to=https://github.com/python/cpython/issues/126543
New issuehttps://github.com/login?return_to=https://github.com/python/cpython/issues/126543
The docs for the typing stdlib module use the phrase "bound type var" to mean two distinct thingshttps://github.com/python/cpython/issues/126543#top
docsDocumentation in the Doc dirhttps://github.com/python/cpython/issues?q=state%3Aopen%20label%3A%22docs%22
topic-typinghttps://github.com/python/cpython/issues?q=state%3Aopen%20label%3A%22topic-typing%22
https://github.com/fofoni
fofonihttps://github.com/fofoni
on Nov 7, 2024https://github.com/python/cpython/issues/126543#issue-2641172085
https://discuss.python.org/t/a-typevar-with-a-bound-is-a-bounded-typevar-or-a-bound-typevar/69966https://discuss.python.org/t/a-typevar-with-a-bound-is-a-bounded-typevar-or-a-bound-typevar/69966
@hauntsaninjahttps://github.com/hauntsaninja
@hauntsaninjahttps://github.com/hauntsaninja
gh-126543: Docs: change "bound type var" to "bounded" when used in the context of the 'bound' kw argument to TypeVar #126584https://github.com/python/cpython/pull/126584
[3.13] gh-126543: Docs: change "bound type var" to "bounded" when used in the context of the 'bound' kw argument to TypeVar (GH-126584) #126657https://github.com/python/cpython/pull/126657
[3.12] gh-126543: Docs: change "bound type var" to "bounded" when used in the context of the 'bound' kw argument to TypeVar (GH-126584) #126658https://github.com/python/cpython/pull/126658
fofonihttps://github.com/fofoni
docsDocumentation in the Doc dirhttps://github.com/python/cpython/issues?q=state%3Aopen%20label%3A%22docs%22
on Nov 7, 2024https://github.com/python/cpython/issues/126543#event-15182546112
github-project-automationhttps://github.com/apps/github-project-automation
docs issueshttps://github.com/orgs/python/projects/52
on Nov 7, 2024https://github.com/python/cpython/issues/126543#event-15182548894
github-project-automationhttps://github.com/apps/github-project-automation
docs issueshttps://github.com/orgs/python/projects/52
on Nov 7, 2024https://github.com/python/cpython/issues/126543
Eclips4https://github.com/Eclips4
topic-typinghttps://github.com/python/cpython/issues?q=state%3Aopen%20label%3A%22topic-typing%22
on Nov 7, 2024https://github.com/python/cpython/issues/126543#event-15182681756
https://github.com/carljm
carljmhttps://github.com/carljm
on Nov 7, 2024https://github.com/python/cpython/issues/126543#issuecomment-2462427537
https://github.com/picnixz
picnixzhttps://github.com/picnixz
on Nov 7, 2024https://github.com/python/cpython/issues/126543#issuecomment-2462798233
https://github.com/JelleZijlstra
JelleZijlstrahttps://github.com/JelleZijlstra
on Nov 7, 2024https://github.com/python/cpython/issues/126543#issuecomment-2462817169
https://github.com/carljm
carljmhttps://github.com/carljm
on Nov 7, 2024https://github.com/python/cpython/issues/126543#issuecomment-2462823448
https://github.com/hauntsaninja
hauntsaninjahttps://github.com/hauntsaninja
on Nov 7, 2024https://github.com/python/cpython/issues/126543#issuecomment-2463070213
https://github.com/carljm
carljmhttps://github.com/carljm
on Nov 7, 2024https://github.com/python/cpython/issues/126543#issuecomment-2463084413
@JelleZijlstrahttps://github.com/JelleZijlstra
JelleZijlstrahttps://github.com/JelleZijlstra
on Nov 11, 2024https://github.com/python/cpython/issues/126543#event-15242640536
gh-126543: Docs: change "bound type var" to "bounded" when used in th…https://github.com/python/cpython/commit/434b29767f2fdef9f35c8e93303cf6aca4a66a80
gh-126543https://github.com/python/cpython/issues/126543
434b297https://github.com/python/cpython/commit/434b29767f2fdef9f35c8e93303cf6aca4a66a80
miss-islingtonhttps://github.com/miss-islington
on Nov 11, 2024https://github.com/python/cpython/issues/126543#event-15242641492
pythongh-126543: Docs: change "bound type var" to "bounded" when used…https://github.com/miss-islington/cpython/commit/14ef1dd2fcc363c86ee1e729e87f100a416ee314
pythongh-126543https://github.com/python/cpython/issues/126543
14ef1ddhttps://github.com/miss-islington/cpython/commit/14ef1dd2fcc363c86ee1e729e87f100a416ee314
pythongh-126543: Docs: change "bound type var" to "bounded" when used…https://github.com/miss-islington/cpython/commit/fe4e35728068dde877f247533a89ebc5dd031b9f
pythongh-126543https://github.com/python/cpython/issues/126543
fe4e357https://github.com/miss-islington/cpython/commit/fe4e35728068dde877f247533a89ebc5dd031b9f
JelleZijlstrahttps://github.com/JelleZijlstra
on Nov 11, 2024https://github.com/python/cpython/issues/126543#event-15243334819
[3.13] gh-126543: Docs: change "bound type var" to "bounded" when use…https://github.com/python/cpython/commit/3d8f5490e27f4d787d176b7f2d22d6cb4cb0d069
gh-126543https://github.com/python/cpython/issues/126543
3d8f549https://github.com/python/cpython/commit/3d8f5490e27f4d787d176b7f2d22d6cb4cb0d069
[3.12] gh-126543: Docs: change "bound type var" to "bounded" when use…https://github.com/python/cpython/commit/55c53056906cd962d977d209af7672bc6b2cb560
gh-126543https://github.com/python/cpython/issues/126543
55c5305https://github.com/python/cpython/commit/55c53056906cd962d977d209af7672bc6b2cb560
https://github.com/fofoni
fofonihttps://github.com/fofoni
on Nov 11, 2024https://github.com/python/cpython/issues/126543#issuecomment-2467697751
fofonihttps://github.com/fofoni
completedhttps://github.com/python/cpython/issues?q=is%3Aissue%20state%3Aclosed%20archived%3Afalse%20reason%3Acompleted
on Nov 11, 2024https://github.com/python/cpython/issues/126543#event-15247175412
https://github.com/picnixz
picnixzhttps://github.com/picnixz
on Nov 11, 2024https://github.com/python/cpython/issues/126543#issuecomment-2467700324
picnixzhttps://github.com/picnixz
on Dec 8, 2024https://github.com/python/cpython/issues/126543#event-15572738575
pythongh-126543: Docs: change "bound type var" to "bounded" when used…https://github.com/picnixz/cpython/commit/2eab16a797c9e10a9ccaebb1e2b06717e9f8413c
pythongh-126543https://github.com/python/cpython/issues/126543
2eab16ahttps://github.com/picnixz/cpython/commit/2eab16a797c9e10a9ccaebb1e2b06717e9f8413c
ebonnalhttps://github.com/ebonnal
on Jan 12, 2025https://github.com/python/cpython/issues/126543#event-15894560610
pythongh-126543: Docs: change "bound type var" to "bounded" when used…https://github.com/ebonnal/cpython/commit/2fcdddd40811fc3d082ea2c64d69f83eec8a4c1a
pythongh-126543https://github.com/python/cpython/issues/126543
2fcddddhttps://github.com/ebonnal/cpython/commit/2fcdddd40811fc3d082ea2c64d69f83eec8a4c1a
Sign up for freehttps://github.com/signup?return_to=https://github.com/python/cpython/issues/126543
Sign in to commenthttps://github.com/login?return_to=https://github.com/python/cpython/issues/126543
docsDocumentation in the Doc dirhttps://github.com/python/cpython/issues?q=state%3Aopen%20label%3A%22docs%22
topic-typinghttps://github.com/python/cpython/issues?q=state%3Aopen%20label%3A%22topic-typing%22
docs issueshttps://github.com/orgs/python/projects/52
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.