René's URL Explorer Experiment


Title: Adding low-level support for numbering styles. by jlovegren0 · Pull Request #582 · python-openxml/python-docx · GitHub

Open Graph Title: Adding low-level support for numbering styles. by jlovegren0 · Pull Request #582 · python-openxml/python-docx

X Title: Adding low-level support for numbering styles. by jlovegren0 · Pull Request #582 · python-openxml/python-docx

Description: This PR addresses the issue with numbering styles identified on StackOverflow and issues #25 and #122 . My proposal does not add API support for these issues, but it makes it easier to handle work-arounds for users who are familiar with the numbering system from ISO 29500. Basically, I just define the following types in the oxml submodule: CT_NumPicBullet CT_AbstractNum CT_LongHexNumber ST_LongHexNumber CT_MultiLevelType ST_MultiLevelType CT_Lvl CT_NumFmt ST_NumberFormat CT_LevelSuffix ST_LevelSuffix CT_LevelText CT_LvlLegacy CT_Num Once these are defined, and the appropriate declarations are added to oxml.__init__ so that the parser can recognize them, a user can use the methods exposed by the xmlchemy submodule. The maintainer has commented in the past that that lag on creating support for numbering is that the standard itself is very byzantine (I agree 100%) and there are some tough design choices for crafting the API. My PR is basically setting up some very low-level support so that more capable developers can look into addressing this within the API. I have no experience with Open Source projects so I will need help from other community members for qa/qc and testing of the code. However, I have added a detailed write-up to the documentation (contributor guide, numbering section). I'll also be posting a solution to the SE question.

Open Graph Description: This PR addresses the issue with numbering styles identified on StackOverflow and issues #25 and #122 . My proposal does not add API support for these issues, but it makes it easier to handle work-...

X Description: This PR addresses the issue with numbering styles identified on StackOverflow and issues #25 and #122 . My proposal does not add API support for these issues, but it makes it easier to handle work-...

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

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:d37aed93-0bb4-f049-b12d-b4d6954851ef
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-idD962:1CA0A7:497374:61C6DD:6AFF6BAC
html-safe-nonce771dae90ee289fbf6b5ee0e8c5d1ad791a2f9676b1231b75e1798c7415dce770
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJEOTYyOjFDQTBBNzo0OTczNzQ6NjFDNkREOjZBRkY2QkFDIiwidmlzaXRvcl9pZCI6IjU2MjQ0NDkxODYwMjAzNDA5MiIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9
visitor-hmac4a9f7f822028e965420bfb55aaa1ea017c292718eb870fed6b5623453becf44c
hovercard-subject-tagpull_request:235212042
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/582/files
twitter:imagehttps://avatars.githubusercontent.com/u/13293889?s=400&v=4
twitter:cardsummary_large_image
og:imagehttps://avatars.githubusercontent.com/u/13293889?s=400&v=4
og:image:altThis PR addresses the issue with numbering styles identified on StackOverflow and issues #25 and #122 . My proposal does not add API support for these issues, but it makes it easier to handle work-...
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/582/files#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fpython-openxml%2Fpython-docx%2Fpull%2F582%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%2F582%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/582/files
Reloadhttps://github.com/python-openxml/python-docx/pull/582/files
Reloadhttps://github.com/python-openxml/python-docx/pull/582/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
jlovegren0https://github.com/jlovegren0
python-openxml:masterhttps://github.com/python-openxml/python-docx/tree/master
jlovegren0:masterhttps://github.com/jlovegren0/python-docx/tree/master
Conversation 89 https://github.com/python-openxml/python-docx/pull/582
Commits 19 https://github.com/python-openxml/python-docx/pull/582/commits
Checks 0 https://github.com/python-openxml/python-docx/pull/582/checks
Files changed https://github.com/python-openxml/python-docx/pull/582/files
Please reload this pagehttps://github.com/python-openxml/python-docx/pull/582/files
Adding low-level support for numbering styles. https://github.com/python-openxml/python-docx/pull/582/files#top
Show all changes 19 commits https://github.com/python-openxml/python-docx/pull/582/files
ddbace2 First commit. Begin changes to numbering (analysis section) documenta… jlovegren0 Nov 25, 2018 https://github.com/python-openxml/python-docx/pull/582/commits/ddbace25506c3ebd17866e39f2d83958e8680f1d
821c155 Updated Developer Reference section of documentation w/r/t numbering … jlovegren0 Nov 26, 2018 https://github.com/python-openxml/python-docx/pull/582/commits/821c155478fcf038c632c9a1918f9bc97541697b
aaa944c Added four new simple type definitions in oxml.simpletypes submodule. jlovegren0 Nov 26, 2018 https://github.com/python-openxml/python-docx/pull/582/commits/aaa944c905f10c1c7bee86bb6321bc97418f78cf
978df4e Defined CT_LevelSuffix jlovegren0 Nov 26, 2018 https://github.com/python-openxml/python-docx/pull/582/commits/978df4ec1846a4fc62e159154fbebfdca8a1a9c4
38eeed1 Added CT_MultiLevelType and CT_NumFmt jlovegren0 Nov 27, 2018 https://github.com/python-openxml/python-docx/pull/582/commits/38eeed18a2b65de4cd08fbf61ee4cad306a3f2a4
c096cf1 Added CT_LongHexNumber, CT_LvlLegacy, CT_LevelText and CT_NumPicBullet jlovegren0 Nov 28, 2018 https://github.com/python-openxml/python-docx/pull/582/commits/c096cf1e538a670501f47d6a1556e657b4a5d5fe
bc00f82 Defined the remaining types. jlovegren0 Dec 1, 2018 https://github.com/python-openxml/python-docx/pull/582/commits/bc00f82ab7a3638f0d45495a63da1ea983e0b3c3
f42f153 Added example to contributor section. jlovegren0 Dec 1, 2018 https://github.com/python-openxml/python-docx/pull/582/commits/f42f1538a4781e529bd63b2b3bb34e7ac724985f
f6d393a Bring branch up to date with master, fix conflict jlovegren0 Feb 9, 2019 https://github.com/python-openxml/python-docx/pull/582/commits/f6d393a9fa383769d8c6a5fa007ab3fa47621ef3
a9c58cc Merge remote-tracking branch 'upstream/master' jlovegren0 Apr 1, 2020 https://github.com/python-openxml/python-docx/pull/582/commits/a9c58cceb87e6543201d650c4198e4c88128b246
160dddc register nsid and tmpl elements jlovegren0 Apr 1, 2020 https://github.com/python-openxml/python-docx/pull/582/commits/160dddcf0cb4c6b459115fa91859de9d3c0506fe
2877120 fix capitalization on multiLevelType type attribute (should read mult… jlovegren0 Apr 1, 2020 https://github.com/python-openxml/python-docx/pull/582/commits/2877120de536045aca9aa9bee32b70938c050e6f
5bd5cf6 register two additional elements jlovegren0 Apr 1, 2020 https://github.com/python-openxml/python-docx/pull/582/commits/5bd5cf6a54a2a5585c05f79279da63ce78b8e828
1493247 register isLgl, lvlRestart jlovegren0 Apr 3, 2020 https://github.com/python-openxml/python-docx/pull/582/commits/149324759520785de599b4cde80293f358464ec8
b5ba8f2 fix spelling hybridMultilevel jlovegren0 Apr 3, 2020 https://github.com/python-openxml/python-docx/pull/582/commits/b5ba8f2b477139dbe4268798446936917daa4e27
72fa8ed correct error in ST_TwipsMeasure and ST_SignedTwipsMeasure jlovegren0 Apr 4, 2020 https://github.com/python-openxml/python-docx/pull/582/commits/72fa8ed91d17f4478a2b151b790a31bebee1425f
0085938 Revert "correct error in ST_TwipsMeasure and ST_SignedTwipsMeasure" jlovegren0 Apr 4, 2020 https://github.com/python-openxml/python-docx/pull/582/commits/008593855865e5decd7aeaca8dfeefc9a1dc7ad4
60e54d9 add one method to CT_AbstractNum jlovegren0 Apr 9, 2020 https://github.com/python-openxml/python-docx/pull/582/commits/60e54d91ecc18ff92ccd2acbbb2ee489fc3548f7
5a92d48 correct typo in prior commit jlovegren0 Apr 9, 2020 https://github.com/python-openxml/python-docx/pull/582/commits/5a92d48114e80b4026409c2ae2b92b8774182604
Clear filters https://github.com/python-openxml/python-docx/pull/582/files
Please reload this pagehttps://github.com/python-openxml/python-docx/pull/582/files
Please reload this pagehttps://github.com/python-openxml/python-docx/pull/582/files
README.txt https://github.com/python-openxml/python-docx/pull/582/files#diff-35eeb72a280b386738d2266592d6242d589cbc24725fef3919a820cce724ef7b
.gitignore https://github.com/python-openxml/python-docx/pull/582/files#diff-bc37d034bad564583790a46f19d807abfe519c5671395fd494d8cce506c42947
numbering.rst https://github.com/python-openxml/python-docx/pull/582/files#diff-1eebf63f64ea5f694abc9e5047d5b47878fb7c3221c818f8df6eee291d81ece6
__init__.py https://github.com/python-openxml/python-docx/pull/582/files#diff-33e2fdac365881fbfed40519c30a287c43553f34f44a016cc2331d1165356c03
numbering.py https://github.com/python-openxml/python-docx/pull/582/files#diff-7d408ea4319091551a0ad299ce348a61450094d1f5e7386e465903c461202b11
shared.py https://github.com/python-openxml/python-docx/pull/582/files#diff-fde295dadb5ad1d3d96bdc27bfed0ae5a490f7bcb3db1c3dded9f6923176c807
simpletypes.py https://github.com/python-openxml/python-docx/pull/582/files#diff-099d9477b9370885892c17a69609ff634b4307b5f227ff74d7cea560b3b25bfa
.eggs/README.txthttps://github.com/python-openxml/python-docx/pull/582/files#diff-35eeb72a280b386738d2266592d6242d589cbc24725fef3919a820cce724ef7b
View file https://github.com/python-openxml/python-docx/blob/5a92d48114e80b4026409c2ae2b92b8774182604/.eggs/README.txt
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python-openxml/python-docx/pull/582/{{ revealButtonHref }}
.gitignorehttps://github.com/python-openxml/python-docx/pull/582/files#diff-bc37d034bad564583790a46f19d807abfe519c5671395fd494d8cce506c42947
View file https://github.com/python-openxml/python-docx/blob/5a92d48114e80b4026409c2ae2b92b8774182604/.gitignore
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/python-openxml/python-docx/pull/582/{{ revealButtonHref }}
https://github.com/python-openxml/python-docx/pull/582/files#diff-bc37d034bad564583790a46f19d807abfe519c5671395fd494d8cce506c42947
https://github.com/python-openxml/python-docx/pull/582/files#diff-bc37d034bad564583790a46f19d807abfe519c5671395fd494d8cce506c42947
Please reload this pagehttps://github.com/python-openxml/python-docx/pull/582/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.