René's URL Explorer Experiment


Title: Add public inline shape description and title properties by pseudosavant · Pull Request #1613 · python-openxml/python-docx · GitHub

Open Graph Title: Add public inline shape description and title properties by pseudosavant · Pull Request #1613 · python-openxml/python-docx

X Title: Add public inline shape description and title properties by pseudosavant · Pull Request #1613 · python-openxml/python-docx

Description: Summary Inline pictures currently have no public API for reading or writing their alternative-text description and title. This draft adds InlineShape.description and InlineShape.title, allowing callers to preserve image descriptions without manipulating XML. picture = document.add_picture("revenue.png") picture.description = "Quarterly revenue increased by 20 percent." picture.title = "Quarterly revenue" The properties map to wp:docPr/@descr and wp:docPr/@title. They apply to each placed shape, so repeated uses of one image can carry different descriptions. Scope and behavior Add optional XML attributes, public properties, documentation, unit tests, and acceptance scenarios. Preserve existing add_picture() signatures. Callers set metadata on the returned shape. Return None for an absent attribute. Assigning None removes it. An empty string remains explicit. Preserve image bytes, relationships, dimensions, IDs, object names, and unrelated metadata. Leave nested pic:cNvPr metadata unchanged and do not use it as a fallback. Leave decorative-image flags and floating-shape authoring outside this proposal. Related work and API feedback Related to #1530, #227, and #317. In particular, this follows the properties-only scope discussed as an option in #1530. That proposal uses alt_text and alt_title, while this draft uses description and title. Naming and missing/empty-value conventions are open for discussion. This implementation is used in a separately published fork by the Markdown converter markdown-docx. That is currently the fork's only consumer. We can update both projects to follow the conventions agreed here, so the fork's published names do not need to constrain the upstream API. This branch is based directly on upstream master and contains one feature commit. Fork packaging, release configuration, theme-font changes, and hyperlink changes are excluded. Validation 1,631 unit tests passed against the upstream-based branch. 652 acceptance scenarios passed against the upstream-based branch. Tests cover Unicode, empty and cleared values, invalid assignments, repeated image instances, and pictures in body paragraphs, table cells, headers, and footers. Saved-package checks verify unrelated parts and drawing metadata are preserved. Microsoft Word read both properties correctly through its object model. After Word saved the document, both values were verified on reopening with python-docx.

Open Graph Description: Summary Inline pictures currently have no public API for reading or writing their alternative-text description and title. This draft adds InlineShape.description and InlineShape.title, allowing cal...

X Description: Summary Inline pictures currently have no public API for reading or writing their alternative-text description and title. This draft adds InlineShape.description and InlineShape.title, allowing cal...

Opengraph URL: https://github.com/python-openxml/python-docx/pull/1613

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:57addbe0-dc56-cef8-a9e4-b42f680752f6
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-idD502:BFDE6:48C8F6:6110F6:6AFF6C0B
html-safe-nonce5e5704029c778989e6d56533cb65067110e9b2d10de9a62e513d3659419d4a90
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJENTAyOkJGREU2OjQ4QzhGNjo2MTEwRjY6NkFGRjZDMEIiLCJ2aXNpdG9yX2lkIjoiMzg2MjM4OTcxNTEzOTI1OTQwMyIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9
visitor-hmacfc962a31352cc9412de3aab1e29de20768db064bb7bbeb8c2b1f08d00e157f42
hovercard-subject-tagpull_request:4629368666
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-openxml/python-docx/pull/1613/files
twitter:imagehttps://avatars.githubusercontent.com/u/455424?s=400&v=4
twitter:cardsummary_large_image
og:imagehttps://avatars.githubusercontent.com/u/455424?s=400&v=4
og:image:altSummary Inline pictures currently have no public API for reading or writing their alternative-text description and title. This draft adds InlineShape.description and InlineShape.title, allowing cal...
og:site_nameGitHub
og:typeobject
hostnamegithub.com
expected-hostnamegithub.com
None6d580fc7098c193d7866bf290c4c2b4859a153e87379f44161f35a4495e6b730
turbo-cache-controlno-preview
diff-viewunified
go-importgithub.com/python-openxml/python-docx git https://github.com/python-openxml/python-docx.git
octolytics-dimension-user_id3403760
octolytics-dimension-user_loginpython-openxml
octolytics-dimension-repository_id13592924
octolytics-dimension-repository_nwopython-openxml/python-docx
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id13592924
octolytics-dimension-repository_network_root_nwopython-openxml/python-docx
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
releaseec5dd94a369dad6e9ce618a1705cbe3b618a2863
ui-targetfull
theme-color#1e2327
color-schemelight dark

Links:

Skip to contenthttps://github.com/python-openxml/python-docx/pull/1613/files#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fpython-openxml%2Fpython-docx%2Fpull%2F1613%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-openxml%2Fpython-docx%2Fpull%2F1613%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-openxml%2Fpython-docx
Reloadhttps://github.com/python-openxml/python-docx/pull/1613/files
Reloadhttps://github.com/python-openxml/python-docx/pull/1613/files
Reloadhttps://github.com/python-openxml/python-docx/pull/1613/files
python-openxmlhttps://github.com/python-openxml
python-docxhttps://github.com/python-openxml/python-docx
Codehttps://github.com/python-openxml/python-docx
Issues387 (387)https://github.com/python-openxml/python-docx/issues
Pull requests167 (167)https://github.com/python-openxml/python-docx/pulls
Actionshttps://github.com/python-openxml/python-docx/actions
Projectshttps://github.com/python-openxml/python-docx/projects
Wikihttps://github.com/python-openxml/python-docx/wiki
Security and qualityhttps://github.com/python-openxml/python-docx/security
Insightshttps://github.com/python-openxml/python-docx/insights
Sign up for GitHub https://github.com/signup?return_to=%2Fpython-openxml%2Fpython-docx%2Fissues%2Fnew%2Fchoose
terms of servicehttps://docs.github.com/terms
privacy statementhttps://docs.github.com/privacy
Sign inhttps://github.com/login?return_to=%2Fpython-openxml%2Fpython-docx%2Fissues%2Fnew%2Fchoose
pseudosavanthttps://github.com/pseudosavant
python-openxml:masterhttps://github.com/python-openxml/python-docx/tree/master
pseudosavant:codex/image-alt-text-upstreamhttps://github.com/pseudosavant/python-docx/tree/codex/image-alt-text-upstream
Conversation 0 https://github.com/python-openxml/python-docx/pull/1613
Commits 1 https://github.com/python-openxml/python-docx/pull/1613/commits
Checks 0 https://github.com/python-openxml/python-docx/pull/1613/checks
Files changed https://github.com/python-openxml/python-docx/pull/1613/files
Please reload this pagehttps://github.com/python-openxml/python-docx/pull/1613/files
Add public inline shape description and title properties https://github.com/python-openxml/python-docx/pull/1613/files#top
Show all changes 1 commit https://github.com/python-openxml/python-docx/pull/1613/files
fe39602 Add inline shape description and title properties pseudosavant Sep 24, 2026 https://github.com/python-openxml/python-docx/pull/1613/commits/fe396020386ae4dbeeab9a5fc4db8f190a6afad3
Clear filters https://github.com/python-openxml/python-docx/pull/1613/files
Please reload this pagehttps://github.com/python-openxml/python-docx/pull/1613/files
Please reload this pagehttps://github.com/python-openxml/python-docx/pull/1613/files
shapes.rst https://github.com/python-openxml/python-docx/pull/1613/files#diff-4df904823f0f90bf786118259efc7b90eeee2b2ba398f86983ff82e56b7235ca
shp-alt-text.feature https://github.com/python-openxml/python-docx/pull/1613/files#diff-f4e64a64ed52e0f6f6d9603815acc9c5fa6872796444eafdd8635647ba4ca5ad
shape_alt_text.py https://github.com/python-openxml/python-docx/pull/1613/files#diff-385d6d5c8355772e91f9659cc58d9c8d2fa27d01725450da57d21c621ace81ff
shape.py https://github.com/python-openxml/python-docx/pull/1613/files#diff-44d8a3691bb9e00e36a40a46fc29417f56a4a8e55082bbeb5fc143199f0c834b
shape.py https://github.com/python-openxml/python-docx/pull/1613/files#diff-cd4e5f67ccc49a96300e5195ddd86dd61c498b4738b24f31f956065f4081c990
test_shape_alt_text.py https://github.com/python-openxml/python-docx/pull/1613/files#diff-c6864efdb9a153d212efe431706894410d88a491d5d137eff9145afcfa7f8b51
docs/user/shapes.rsthttps://github.com/python-openxml/python-docx/pull/1613/files#diff-4df904823f0f90bf786118259efc7b90eeee2b2ba398f86983ff82e56b7235ca
View file https://github.com/python-openxml/python-docx/blob/fe396020386ae4dbeeab9a5fc4db8f190a6afad3/docs/user/shapes.rst
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python-openxml/python-docx/pull/1613/{{ revealButtonHref }}
https://github.com/python-openxml/python-docx/pull/1613/files#diff-4df904823f0f90bf786118259efc7b90eeee2b2ba398f86983ff82e56b7235ca
features/shp-alt-text.featurehttps://github.com/python-openxml/python-docx/pull/1613/files#diff-f4e64a64ed52e0f6f6d9603815acc9c5fa6872796444eafdd8635647ba4ca5ad
View file https://github.com/python-openxml/python-docx/blob/fe396020386ae4dbeeab9a5fc4db8f190a6afad3/features/shp-alt-text.feature
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python-openxml/python-docx/pull/1613/{{ revealButtonHref }}
features/steps/shape_alt_text.pyhttps://github.com/python-openxml/python-docx/pull/1613/files#diff-385d6d5c8355772e91f9659cc58d9c8d2fa27d01725450da57d21c621ace81ff
View file https://github.com/python-openxml/python-docx/blob/fe396020386ae4dbeeab9a5fc4db8f190a6afad3/features/steps/shape_alt_text.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python-openxml/python-docx/pull/1613/{{ revealButtonHref }}
src/docx/oxml/shape.pyhttps://github.com/python-openxml/python-docx/pull/1613/files#diff-44d8a3691bb9e00e36a40a46fc29417f56a4a8e55082bbeb5fc143199f0c834b
View file https://github.com/python-openxml/python-docx/blob/fe396020386ae4dbeeab9a5fc4db8f190a6afad3/src/docx/oxml/shape.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python-openxml/python-docx/pull/1613/{{ revealButtonHref }}
https://github.com/python-openxml/python-docx/pull/1613/files#diff-44d8a3691bb9e00e36a40a46fc29417f56a4a8e55082bbeb5fc143199f0c834b
https://github.com/python-openxml/python-docx/pull/1613/files#diff-44d8a3691bb9e00e36a40a46fc29417f56a4a8e55082bbeb5fc143199f0c834b
src/docx/shape.pyhttps://github.com/python-openxml/python-docx/pull/1613/files#diff-cd4e5f67ccc49a96300e5195ddd86dd61c498b4738b24f31f956065f4081c990
View file https://github.com/python-openxml/python-docx/blob/fe396020386ae4dbeeab9a5fc4db8f190a6afad3/src/docx/shape.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python-openxml/python-docx/pull/1613/{{ revealButtonHref }}
https://github.com/python-openxml/python-docx/pull/1613/files#diff-cd4e5f67ccc49a96300e5195ddd86dd61c498b4738b24f31f956065f4081c990
https://github.com/python-openxml/python-docx/pull/1613/files#diff-cd4e5f67ccc49a96300e5195ddd86dd61c498b4738b24f31f956065f4081c990
https://github.com/python-openxml/python-docx/pull/1613/files#diff-cd4e5f67ccc49a96300e5195ddd86dd61c498b4738b24f31f956065f4081c990
tests/test_shape_alt_text.pyhttps://github.com/python-openxml/python-docx/pull/1613/files#diff-c6864efdb9a153d212efe431706894410d88a491d5d137eff9145afcfa7f8b51
View file https://github.com/python-openxml/python-docx/blob/fe396020386ae4dbeeab9a5fc4db8f190a6afad3/tests/test_shape_alt_text.py
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python-openxml/python-docx/pull/1613/{{ revealButtonHref }}
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.