pyooxml 1.0.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (13) hide show
  1. pyooxml-1.0.0/LICENSE +21 -0
  2. pyooxml-1.0.0/PKG-INFO +77 -0
  3. pyooxml-1.0.0/README.md +59 -0
  4. pyooxml-1.0.0/pyooxml/__init__.py +0 -0
  5. pyooxml-1.0.0/pyooxml/pyooxml.py +2340 -0
  6. pyooxml-1.0.0/pyooxml.egg-info/PKG-INFO +77 -0
  7. pyooxml-1.0.0/pyooxml.egg-info/SOURCES.txt +11 -0
  8. pyooxml-1.0.0/pyooxml.egg-info/dependency_links.txt +1 -0
  9. pyooxml-1.0.0/pyooxml.egg-info/entry_points.txt +2 -0
  10. pyooxml-1.0.0/pyooxml.egg-info/requires.txt +1 -0
  11. pyooxml-1.0.0/pyooxml.egg-info/top_level.txt +1 -0
  12. pyooxml-1.0.0/pyproject.toml +38 -0
  13. pyooxml-1.0.0/setup.cfg +4 -0
pyooxml-1.0.0/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Digital Sleuth
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
pyooxml-1.0.0/PKG-INFO ADDED
@@ -0,0 +1,77 @@
1
+ Metadata-Version: 2.4
2
+ Name: pyooxml
3
+ Version: 1.0.0
4
+ Summary: View, edit and compare OOXML packages
5
+ Author-email: "Corey Forman (digitalsleuth)" <corey@digitalsleuth.ca>
6
+ Maintainer-email: "Corey Forman (digitalsleuth)" <corey@digitalsleuth.ca>
7
+ Project-URL: Homepage, https://github.com/digitalsleuth/PyOOXML
8
+ Keywords: digital forensics,dfir,ooxml,docx,xlsx,pptx,compare
9
+ Classifier: Development Status :: 5 - Production/Stable
10
+ Classifier: Environment :: X11 Applications :: Qt
11
+ Classifier: Programming Language :: Python :: 3
12
+ Classifier: Operating System :: OS Independent
13
+ Requires-Python: >=3.9
14
+ Description-Content-Type: text/markdown
15
+ License-File: LICENSE
16
+ Requires-Dist: PyQt6
17
+ Dynamic: license-file
18
+
19
+ # PyOOXML
20
+
21
+ ## Overview
22
+ #### Purpose
23
+ View, edit and compare the parts inside OOXML packages (docx, xlsx, pptx and related formats), including damaged documents that other tools refuse to open.
24
+
25
+ PyOOXML is a Python 3 / PyQt6 port of the "OOXML Tools" browser extension by Atul Moglewar.
26
+
27
+ #### Installation
28
+ Install from the GitHub repository:
29
+ ```
30
+ python3 -m pip install git+https://github.com/digitalsleuth/PyOOXML
31
+ ```
32
+ PyQt6 is installed automatically. Then launch it with:
33
+ ```
34
+ pyooxml
35
+ ```
36
+
37
+ To run from a clone of the repository instead:
38
+ ```
39
+ python3 -m pip install PyQt6
40
+ python3 -m pyooxml.pyooxml
41
+ ```
42
+
43
+ Pip install forthcoming!
44
+
45
+ #### Usage
46
+ Documents can be passed on the command line, chosen from the File menu, or drag-and-dropped onto the window.
47
+ ```
48
+ pyooxml # start empty
49
+ pyooxml document.docx # view one document
50
+ pyooxml old.docx new.docx # compare two documents
51
+ ```
52
+
53
+ Supported files: `.docx .docm .dotx .dotm .xlsx .xlsm .xltx .xltm .pptx .pptm .potx .potm .ppsx .ppsm .vsdx .zip`
54
+
55
+ ### Viewer / Editor
56
+ - Browse every part of the package in a tree, with a filter box to find parts quickly.
57
+ - XML parts are pretty-printed with syntax highlighting and line numbers, and checked for well-formedness.
58
+ - Images are displayed. Other binary parts show their size, SHA-256 and a hex dump of the first 4 KB.
59
+ - The right-hand pane is read-only until you click **Edit**. Once the content changes, a **Save Part** button appears.
60
+ - **File > Save Package As...** writes the package, including your edits, to a new file. **File > Extract Part...** saves the selected part on its own.
61
+
62
+ ### Compare
63
+ **File > Compare Documents...** (Ctrl+D) accepts one or two documents. If you choose only one, you are prompted for the second.
64
+
65
+ - Every part is listed as Identical, Different, Only in left or Only in right. **Differences only** hides the identical ones.
66
+ - Selecting a part shows a side-by-side diff of the formatted XML. Use **Previous difference** (Shift+F3) and **Next difference** (F3) to move between them, or simply scroll.
67
+ - **Swap sides** exchanges the left and right documents, matters mostly for order of activity.
68
+ - **Export PDF...** (also under the File menu) writes a landscape report containing only the differences, with changed lines highlighted and the exact changed values marked. It also records the full path, size and SHA-256 of both files, and any warnings raised while opening them.
69
+
70
+ ### Damaged and unusual documents
71
+ PyOOXML opens most documents whose zip structure is broken, for example files written by other applications that store `\` instead of `/` in part names, or files with a damaged central directory. Parts are recovered from the raw zip data and verified against their CRC32 and size. Parts that cannot be verified are still shown, but are marked **UNVERIFIED**.
72
+
73
+ Anything unusual that was recovered is listed on the **Warnings** tab, which appears only when there is something to report. Encrypted or IRM-protected documents (OLE compound files) are detected and reported rather than failing with a zip error.
74
+
75
+ ### Original Source
76
+
77
+ This tool is based on the work originally developed by Atul Moglewar, and their Chrome Browser Extension "OOXML Tools". This particular version is no longer available, but I used a previous copy to reverse-engineer and improve upon its features.
pyooxml-1.0.0/README.md ADDED
@@ -0,0 +1,59 @@
1
+ # PyOOXML
2
+
3
+ ## Overview
4
+ #### Purpose
5
+ View, edit and compare the parts inside OOXML packages (docx, xlsx, pptx and related formats), including damaged documents that other tools refuse to open.
6
+
7
+ PyOOXML is a Python 3 / PyQt6 port of the "OOXML Tools" browser extension by Atul Moglewar.
8
+
9
+ #### Installation
10
+ Install from the GitHub repository:
11
+ ```
12
+ python3 -m pip install git+https://github.com/digitalsleuth/PyOOXML
13
+ ```
14
+ PyQt6 is installed automatically. Then launch it with:
15
+ ```
16
+ pyooxml
17
+ ```
18
+
19
+ To run from a clone of the repository instead:
20
+ ```
21
+ python3 -m pip install PyQt6
22
+ python3 -m pyooxml.pyooxml
23
+ ```
24
+
25
+ Pip install forthcoming!
26
+
27
+ #### Usage
28
+ Documents can be passed on the command line, chosen from the File menu, or drag-and-dropped onto the window.
29
+ ```
30
+ pyooxml # start empty
31
+ pyooxml document.docx # view one document
32
+ pyooxml old.docx new.docx # compare two documents
33
+ ```
34
+
35
+ Supported files: `.docx .docm .dotx .dotm .xlsx .xlsm .xltx .xltm .pptx .pptm .potx .potm .ppsx .ppsm .vsdx .zip`
36
+
37
+ ### Viewer / Editor
38
+ - Browse every part of the package in a tree, with a filter box to find parts quickly.
39
+ - XML parts are pretty-printed with syntax highlighting and line numbers, and checked for well-formedness.
40
+ - Images are displayed. Other binary parts show their size, SHA-256 and a hex dump of the first 4 KB.
41
+ - The right-hand pane is read-only until you click **Edit**. Once the content changes, a **Save Part** button appears.
42
+ - **File > Save Package As...** writes the package, including your edits, to a new file. **File > Extract Part...** saves the selected part on its own.
43
+
44
+ ### Compare
45
+ **File > Compare Documents...** (Ctrl+D) accepts one or two documents. If you choose only one, you are prompted for the second.
46
+
47
+ - Every part is listed as Identical, Different, Only in left or Only in right. **Differences only** hides the identical ones.
48
+ - Selecting a part shows a side-by-side diff of the formatted XML. Use **Previous difference** (Shift+F3) and **Next difference** (F3) to move between them, or simply scroll.
49
+ - **Swap sides** exchanges the left and right documents, matters mostly for order of activity.
50
+ - **Export PDF...** (also under the File menu) writes a landscape report containing only the differences, with changed lines highlighted and the exact changed values marked. It also records the full path, size and SHA-256 of both files, and any warnings raised while opening them.
51
+
52
+ ### Damaged and unusual documents
53
+ PyOOXML opens most documents whose zip structure is broken, for example files written by other applications that store `\` instead of `/` in part names, or files with a damaged central directory. Parts are recovered from the raw zip data and verified against their CRC32 and size. Parts that cannot be verified are still shown, but are marked **UNVERIFIED**.
54
+
55
+ Anything unusual that was recovered is listed on the **Warnings** tab, which appears only when there is something to report. Encrypted or IRM-protected documents (OLE compound files) are detected and reported rather than failing with a zip error.
56
+
57
+ ### Original Source
58
+
59
+ This tool is based on the work originally developed by Atul Moglewar, and their Chrome Browser Extension "OOXML Tools". This particular version is no longer available, but I used a previous copy to reverse-engineer and improve upon its features.
pyooxml-1.0.0/pyooxml/__init__.py ADDED
File without changes