René's URL Explorer Experiment


Title: Idea: "Incomplete" marker · Issue #5613 · python/typeshed · GitHub

Open Graph Title: Idea: "Incomplete" marker · Issue #5613 · python/typeshed

X Title: Idea: "Incomplete" marker · Issue #5613 · python/typeshed

Description: When creating stubs, we encourage contributors to leave items unannotated instead of using Any. This often works, but there are cases where you have to fall back on Any, for example: class Foo: def bar(self, some_arg, other_arg=None): se...

Open Graph Description: When creating stubs, we encourage contributors to leave items unannotated instead of using Any. This often works, but there are cases where you have to fall back on Any, for example: class Foo: def...

X Description: When creating stubs, we encourage contributors to leave items unannotated instead of using Any. This often works, but there are cases where you have to fall back on Any, for example: class Foo: def...

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

X: @github

direct link

Domain: github.com


Hey, it has json ld scripts:
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Idea: \"Incomplete\" marker","articleBody":"When creating stubs, we encourage contributors to leave items unannotated instead of using `Any`. This often works, but there are cases where you have to fall back on `Any`, for example:\r\n\r\n```python\r\nclass Foo:\r\n    def bar(self, some_arg, other_arg=None):\r\n        self.a_field = something()\r\n        if some_cond():\r\n            return whatever()\r\n        else:\r\n            return None\r\n```\r\n\r\nIn this case the best we can do is:\r\n\r\n```python\r\nclass Foo:\r\n    a_field: Any\r\n    def bar(self, some_arg, other_arg: Any | None = ...) -> Any | None: ...\r\n```\r\n\r\nIn this case it's not clear if `Any` is used, because there is no better alternative or because this needs better annotations.\r\n\r\nIdea: We could introduce an alias for `Any` in `_typeshed`, called something like `Incomplete`, `Unknown` (my current favorite), `Something`, `Untyped`, or `Unannotated`. This could clearly mark that this argument type still needs work:\r\n\r\n```python\r\nclass Foo:\r\n    some_arg: Unknown\r\n    def bar(self, some_arg, other_arg: Unknown | None = ...) -> Unknown | None: ...\r\n```\r\nThis has a few advantages:\r\n\r\n* Communicates that the type is not final and will be improved (and narrowed) in the future.\r\n* Communicates that this particular annotation needs work.\r\n* Gives us a better overview of the completion of stubs and prevents \"lies\". (In fact, an idea I have is to produce graphs that shows the completion percentage of stubs over time.)\r\n* Gives us the ability to grep for `Any` to find areas where the type system could be improved or where newer type system features could be used.","author":{"url":"https://github.com/srittau","@type":"Person","name":"srittau"},"datePublished":"2021-06-10T19:49:42Z","url":"https://github.com/python/typeshed/issues/5613"}

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:00169630-f9e0-e55b-e2f3-779f105d5768
current-catalog-service-hash81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114
request-idEC82:73851:5BE19E:7F46D3:6B001BB5
html-safe-noncee174866cfe4a5a30c502c3eb349c36fef58ea7bb8e8ea325e050e4ef3ef5a28a
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJFQzgyOjczODUxOjVCRTE5RTo3RjQ2RDM6NkIwMDFCQjUiLCJ2aXNpdG9yX2lkIjoiNjk5OTEzNjQwNDkyNDA3NzMzIiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0=
visitor-hmac4ca9e0b0a41768132c49675e2082dd03073d780f7f516d0caa6e681db4c4e30e
hovercard-subject-tagissue:917818002
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/5613/issue_layout
twitter:imagehttps://opengraph.githubassets.com/e95924b42c5d9d6430dbf2e8c4fdf8f8e9804cb8b94965012fdec1e6cf6fc668/python/typeshed/issues/5613
twitter:cardsummary_large_image
og:imagehttps://opengraph.githubassets.com/e95924b42c5d9d6430dbf2e8c4fdf8f8e9804cb8b94965012fdec1e6cf6fc668/python/typeshed/issues/5613
og:image:altWhen creating stubs, we encourage contributors to leave items unannotated instead of using Any. This often works, but there are cases where you have to fall back on Any, for example: class Foo: def...
og:image:width1200
og:image:height600
og:site_nameGitHub
og:typeobject
og:author:usernamesrittau
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-targetfull
theme-color#1e2327
color-schemelight dark
react-app-nameissues

Links:

Skip to contenthttps://github.com/python/typeshed/issues/5613#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fpython%2Ftypeshed%2Fissues%2F5613
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%2F5613
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/5613
Reloadhttps://github.com/python/typeshed/issues/5613
Reloadhttps://github.com/python/typeshed/issues/5613
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/5613
New issuehttps://github.com/login?return_to=https://github.com/python/typeshed/issues/5613
#7535https://github.com/python/typeshed/pull/7535
Idea: "Incomplete" markerhttps://github.com/python/typeshed/issues/5613#top
#7535https://github.com/python/typeshed/pull/7535
project: policyOrganization of the typeshed projecthttps://github.com/python/typeshed/issues?q=state%3Aopen%20label%3A%22project%3A%20policy%22
https://github.com/srittau
srittauhttps://github.com/srittau
on Jun 10, 2021https://github.com/python/typeshed/issues/5613#issue-917818002
srittauhttps://github.com/srittau
project: policyOrganization of the typeshed projecthttps://github.com/python/typeshed/issues?q=state%3Aopen%20label%3A%22project%3A%20policy%22
on Jun 10, 2021https://github.com/python/typeshed/issues/5613#event-4873833395
https://github.com/srittau
srittauhttps://github.com/srittau
on Jun 10, 2021https://github.com/python/typeshed/issues/5613#issuecomment-858985860
https://github.com/JelleZijlstra
JelleZijlstrahttps://github.com/JelleZijlstra
on Jun 10, 2021https://github.com/python/typeshed/issues/5613#issuecomment-859067775
https://github.com/microsoft/pyright/blob/7bb059ecbab5c0c446d4dcf5376fc5ce8bd8cd26/docs/type-inference.md#type-inferencehttps://github.com/microsoft/pyright/blob/7bb059ecbab5c0c446d4dcf5376fc5ce8bd8cd26/docs/type-inference.md#type-inference
https://github.com/jakebailey
jakebaileyhttps://github.com/jakebailey
on Jun 11, 2021https://github.com/python/typeshed/issues/5613#issuecomment-859351953
@erictrauthttps://github.com/erictraut
https://github.com/srittau
srittauhttps://github.com/srittau
on Jun 11, 2021https://github.com/python/typeshed/issues/5613#issuecomment-859379988
https://github.com/srittau
srittauhttps://github.com/srittau
on Jun 11, 2021https://github.com/python/typeshed/issues/5613#issuecomment-859381536
https://github.com/erictraut
erictrauthttps://github.com/erictraut
on Jun 11, 2021https://github.com/python/typeshed/issues/5613#issuecomment-859674328
https://github.com/srittau
srittauhttps://github.com/srittau
on Jun 11, 2021https://github.com/python/typeshed/issues/5613#issuecomment-859693388
https://github.com/erictraut
erictrauthttps://github.com/erictraut
on Jun 11, 2021https://github.com/python/typeshed/issues/5613#issuecomment-859705883
https://github.com/srittau
srittauhttps://github.com/srittau
on Jun 11, 2021https://github.com/python/typeshed/issues/5613#issuecomment-859718083
https://github.com/srittau
srittauhttps://github.com/srittau
on Jun 11, 2021https://github.com/python/typeshed/issues/5613#issuecomment-859719486
srittauhttps://github.com/srittau
on Mar 22, 2022https://github.com/python/typeshed/issues/5613#event-6281760195
Add _typeshed.Incompletehttps://github.com/srittau/typeshed/commit/3a6d1670935975bd836053483cafe8d0a43bb785
https://docs.github.com/articles/closing-issues-via-commit-messages
3a6d167https://github.com/srittau/typeshed/commit/3a6d1670935975bd836053483cafe8d0a43bb785
srittauhttps://github.com/srittau
completedhttps://github.com/python/typeshed/issues?q=is%3Aissue%20state%3Aclosed%20archived%3Afalse%20reason%3Acompleted
#7535https://github.com/python/typeshed/pull/7535
on Mar 25, 2022https://github.com/python/typeshed/issues/5613#event-6305798563
srittauhttps://github.com/srittau
on Mar 25, 2022https://github.com/python/typeshed/issues/5613#event-6305798918
Add _typeshed.Incomplete (#7535)https://github.com/python/typeshed/commit/9a76b13127ffa8365431dcc105fc111cdd267e7e
#7535https://github.com/python/typeshed/pull/7535
https://docs.github.com/articles/closing-issues-via-commit-messages
9a76b13https://github.com/python/typeshed/commit/9a76b13127ffa8365431dcc105fc111cdd267e7e
https://github.com/srittau
srittauhttps://github.com/srittau
on Mar 25, 2022https://github.com/python/typeshed/issues/5613#issuecomment-1078815165
Sign up for freehttps://github.com/signup?return_to=https://github.com/python/typeshed/issues/5613
Sign in to commenthttps://github.com/login?return_to=https://github.com/python/typeshed/issues/5613
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.