René's URL Explorer Experiment


Title: gh-161708: Document the __lazy_import__ built-in function by RoryGlenn · Pull Request #161762 · python/cpython · GitHub

Open Graph Title: gh-161708: Document the __lazy_import__ built-in function by RoryGlenn · Pull Request #161762 · python/cpython

X Title: gh-161708: Document the __lazy_import__ built-in function by RoryGlenn · Pull Request #161762 · python/cpython

Description: Document __lazy_import__ for programmatic lazy imports at module scope, including its arguments, namespace requirements, lazy proxy behavior and eager fallback. Link the entry from the language reference and built-in functions table. Use a direct function reference in the table, widen its fourth column and remove the obsolete lazy-import substitution. Preserve the local type links and describe the eager result as __import__ would return it. Sphinx lint, a fresh HTML build with warnings treated as errors, and rendered wording/table/link checks passed. Runtime tests were not run for this documentation-only change. Related PR #161716 covers the C docstring; this PR covers the reference documentation. Prepared with OpenAI Codex assistance. Issue: gh-161708 Validation GIT_NO_LAZY_FETCH=1 git --no-optional-locks diff --check 039658b302bb0bf4caca95671cc8008741d466de HEAD -- Doc/builtins/functions.rst — exit 0 /cache/cpython-pr-161762-docs/bin/sphinx-lint --enable=default-role Doc/builtins/functions.rst Doc/reference/simple_stmts.rst — exit 0 make -C Doc html VENVDIR=/cache/cpython-pr-161762-docs JOBS=4 SPHINXOPTS='--fresh-env --write-all' — exit 0 `python3 -B - <<'PY' import html from pathlib import Path import re root = Path('Doc/build/html') functions_path = root / 'builtins/functions.html' reference_path = root / 'reference/simple_stmts.html' functions = functions_path.read_text(encoding='utf-8') reference = reference_path.read_text(encoding='utf-8') for anchor in ('func-lazy-import', 'lazy_import__'): assert functions.count(f'id="{anchor}"') == 1, anchor table = re.search(r']*>', '', cells[3])) assert last_column.index('import()') < last_column.index('lazy_import()') for anchor in re.findall(r'href="#([^"]+)"', table): assert functions.count(f'id="{anchor}"') == 1, anchor for anchor in ('func-dict', 'func-list', 'func-range'): assert f'href="#{anchor}"' in table, anchor section = functions.split('id="lazy_import__"', 1)[1].split('', 1)[0] visible = ' '.join(html.unescape(re.sub(r'<[^>]>', '', section)).split()) for wording in ( 'Use this function for programmatic lazy imports.', 'Otherwise, use a lazy import statement.', 'The function must be called at module scope.', 'Calling it from a function or class body raises SyntaxError.', 'dictionary containing a builtins entry.', 'If locals is omitted or None, it defaults to globals.', 'result as import() would do.', ): assert wording in visible, wording assert 'normally a types.ModuleType instance' not in visible assert 'Use a substitution because' not in html.unescape(re.sub(r'<[^>]>', '', functions)) assert 'id="lazy-imports"' in reference for origin, href in ( (functions_path, '../reference/simple_stmts.html#lazy-imports'), (functions_path, '../library/types.html#types.LazyImportType'), (functions_path, '../library/sys.html#sys.set_lazy_imports_filter'), (reference_path, '../builtins/functions.html#lazy_import__'), ): assert f'href="{href}"' in origin.read_text(encoding='utf-8'), href target, anchor = href.split('#', 1) assert (origin.parent / target).read_text(encoding='utf-8').count(f'id="{anchor}"') == 1, href print('Rendered wording, table, anchors and links passed') PY` — exit 0 `python3 -B - <<'PY' import html from pathlib import Path import re root = Path('Doc/build/html') functions_path = root / 'builtins/functions.html' reference_path = root / 'reference/simple_stmts.html' functions = functions_path.read_text(encoding='utf-8') reference = reference_path.read_text(encoding='utf-8') for anchor in ('func-lazy-import', 'lazy_import__'): assert functions.count(f'id="{anchor}"') == 1, anchor table = re.search(r']*>', '', cells[3])) assert last_column.index('import()') < last_column.index('lazy_import()') for anchor in re.findall(r'href="#([^"]+)"', table): assert functions.count(f'id="{anchor}"') == 1, anchor for anchor in ('func-dict', 'func-list', 'func-range'): assert f'href="#{anchor}"' in table, anchor section = functions.split('id="lazy_import__"', 1)[1].split('', 1)[0] visible = ' '.join(html.unescape(re.sub(r'<[^>]>', '', section)).split()) for wording in ( 'Use this function for programmatic lazy imports.', 'Otherwise, use a lazy import statement.', 'The function must be called at module scope.', 'Calling it from a function or class body raises SyntaxError.', 'dictionary containing a builtins entry.', 'If locals is omitted or None, it defaults to globals.', 'result as import() would do.', ): assert wording in visible, wording assert 'normally a types.ModuleType instance' not in visible assert 'Use a substitution because' not in html.unescape(re.sub(r'<[^>]>', '', functions)) assert 'id="lazy-imports"' in reference for origin, href in ( (functions_path, '../reference/simple_stmts.html#lazy-imports'), (functions_path, '../library/types.html#types.LazyImportType'), (functions_path, '../library/sys.html#sys.set_lazy_imports_filter'), (reference_path, '../builtins/functions.html#lazy_import__'), ): assert f'href="{href}"' in origin.read_text(encoding='utf-8'), href target, anchor = href.split('#', 1) assert (origin.parent / target).read_text(encoding='utf-8').count(f'id="{anchor}"') == 1, href print('PASS: direct function link, four-column table, all local table links, retained anchors and namespace guidance, eager-result wording and language-reference links') PY` — exit 0 Prepared with AI assistance (Codex gpt-6.1-sol). Independent automated review and verification passed for source tree f7aa0e966cb039f01b1880a5b7bd34efcabed90f. This is automated review. Upstream CI is pending until GitHub reports its result.

Open Graph Description: Document __lazy_import__ for programmatic lazy imports at module scope, including its arguments, namespace requirements, lazy proxy behavior and eager fallback. Link the entry from the language ref...

X Description: Document __lazy_import__ for programmatic lazy imports at module scope, including its arguments, namespace requirements, lazy proxy behavior and eager fallback. Link the entry from the language ref...

Opengraph URL: https://github.com/python/cpython/pull/161762

X: @github

direct link

Domain: github.com

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/:user_id/:repository/pull/:id/files(.:format)
route-controllerpull_requests
route-actionfiles
fetch-noncev2:1e912c12-fc27-baf2-4ff6-8b764b922dd6
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-idCE1A:14EB6E:141E0D5:1A79060:6B01EFD4
html-safe-nonce0cba44166af30a47d4d29e4a8f5f2ade9ce03d888c558be17a19ff87befbe230
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJDRTFBOjE0RUI2RToxNDFFMEQ1OjFBNzkwNjA6NkIwMUVGRDQiLCJ2aXNpdG9yX2lkIjoiNzQ1MTk4NDEyMTExNjYxODcwOSIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9
visitor-hmac29e0bc9d907e013c8d9e812c3bc0807730c2bb49e50c9b637346e0b8b8102843
hovercard-subject-tagpull_request:5245876450
github-keyboard-shortcutsrepository,pull-request-list,pull-request-conversation,pull-request-files-changed,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///pull_requests/show/files
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/python/cpython/pull/161762/files
twitter:imagehttps://avatars.githubusercontent.com/u/32777747?s=400&v=4
twitter:cardsummary_large_image
og:imagehttps://avatars.githubusercontent.com/u/32777747?s=400&v=4
og:image:altDocument __lazy_import__ for programmatic lazy imports at module scope, including its arguments, namespace requirements, lazy proxy behavior and eager fallback. Link the entry from the language ref...
og:site_nameGitHub
og:typeobject
hostnamegithub.com
expected-hostnamegithub.com
None87e774ee7c6b3bee0490394e4d3e57ec9dbc956f74b87ea685dc8996c1676456
turbo-cache-controlno-preview
diff-viewunified
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 full-width
disable-turbotrue
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
release423dbb54c5e7bfecc838eb387c1435eb3d0e760d
ui-targetfull
theme-color#1e2327
color-schemelight dark

Links:

Skip to contenthttps://github.com/python/cpython/pull/161762/files#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fpython%2Fcpython%2Fpull%2F161762%2Ffiles
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%2Fpull%2F161762%2Ffiles
Sign uphttps://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fpull_requests%2Fshow%2Ffiles&source=header-repo&source_repo=python%2Fcpython
Reloadhttps://github.com/python/cpython/pull/161762/files
Reloadhttps://github.com/python/cpython/pull/161762/files
Reloadhttps://github.com/python/cpython/pull/161762/files
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
Sign up for GitHub https://github.com/signup?return_to=%2Fpython%2Fcpython%2Fissues%2Fnew%2Fchoose
terms of servicehttps://docs.github.com/terms
privacy statementhttps://docs.github.com/privacy
Sign inhttps://github.com/login?return_to=%2Fpython%2Fcpython%2Fissues%2Fnew%2Fchoose
RoryGlennhttps://github.com/RoryGlenn
python:mainhttps://github.com/python/cpython/tree/main
RoryGlenn:gh-161708-document-lazy-importhttps://github.com/RoryGlenn/cpython/tree/gh-161708-document-lazy-import
Conversation 18 https://github.com/python/cpython/pull/161762
Commits 4 https://github.com/python/cpython/pull/161762/commits
Checks 27 https://github.com/python/cpython/pull/161762/checks
Files changed https://github.com/python/cpython/pull/161762/files
Please reload this pagehttps://github.com/python/cpython/pull/161762/files
gh-161708: Document the __lazy_import__ built-in function https://github.com/python/cpython/pull/161762/files#top
Show all changes 4 commits https://github.com/python/cpython/pull/161762/files
f34ba98 gh-161708: Document the __lazy_import__ built-in function RoryGlenn Nov 10, 2026 https://github.com/python/cpython/pull/161762/commits/f34ba9882b2bc06a45513d749b1ce421e74e376c
4d01f7f gh-161708: Document the __lazy_import__ built-in function RoryGlenn Nov 11, 2026 https://github.com/python/cpython/pull/161762/commits/4d01f7fbc3c80222fbf3c8362308d4e2fe1c7979
039658b gh-161708: Address lazy-import documentation review RoryGlenn Nov 13, 2026 https://github.com/python/cpython/pull/161762/commits/039658b302bb0bf4caca95671cc8008741d466de
da4ac43 gh-161708: Document the __lazy_import__ built-in function RoryGlenn Nov 13, 2026 https://github.com/python/cpython/pull/161762/commits/da4ac432db941d43673cace0c21c32f6f4d2793a
Clear filters https://github.com/python/cpython/pull/161762/files
Please reload this pagehttps://github.com/python/cpython/pull/161762/files
Please reload this pagehttps://github.com/python/cpython/pull/161762/files
functions.rst https://github.com/python/cpython/pull/161762/files#diff-6f52938ccf212a8a44906f01b5fd15dc063b4f114ea4aa074a1363e56576d7d9
simple_stmts.rst https://github.com/python/cpython/pull/161762/files#diff-300d3fafb76c1066e44118597e6707da9b20127b7b3a1fe35668f5c41c69e0a5
Doc/builtins/functions.rsthttps://github.com/python/cpython/pull/161762/files#diff-6f52938ccf212a8a44906f01b5fd15dc063b4f114ea4aa074a1363e56576d7d9
View file https://github.com/python/cpython/blob/da4ac432db941d43673cace0c21c32f6f4d2793a/Doc/builtins/functions.rst
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python/cpython/pull/161762/{{ revealButtonHref }}
https://github.com/python/cpython/pull/161762/files#diff-6f52938ccf212a8a44906f01b5fd15dc063b4f114ea4aa074a1363e56576d7d9
Please reload this pagehttps://github.com/python/cpython/pull/161762/files
https://github.com/python/cpython/pull/161762/files#diff-6f52938ccf212a8a44906f01b5fd15dc063b4f114ea4aa074a1363e56576d7d9
https://github.com/python/cpython/pull/161762/files#diff-6f52938ccf212a8a44906f01b5fd15dc063b4f114ea4aa074a1363e56576d7d9
Please reload this pagehttps://github.com/python/cpython/pull/161762/files
https://github.com/python/cpython/blob/main/.github/CODEOWNERS#L115
Doc/reference/simple_stmts.rsthttps://github.com/python/cpython/pull/161762/files#diff-300d3fafb76c1066e44118597e6707da9b20127b7b3a1fe35668f5c41c69e0a5
View file https://github.com/python/cpython/blob/da4ac432db941d43673cace0c21c32f6f4d2793a/Doc/reference/simple_stmts.rst
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python/cpython/pull/161762/{{ revealButtonHref }}
https://github.com/python/cpython/pull/161762/files#diff-300d3fafb76c1066e44118597e6707da9b20127b7b3a1fe35668f5c41c69e0a5
https://github.com/python/cpython/pull/161762/files#diff-300d3fafb76c1066e44118597e6707da9b20127b7b3a1fe35668f5c41c69e0a5
Please reload this pagehttps://github.com/python/cpython/pull/161762/files
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.