office-export 0.1.0__tar.gz

office_export-0.1.0/.gitignore

@@ -0,0 +1,14 @@
+.pytest_cache/
+.pytest-tmp/
+.pytest-office*/
+.ruff_cache/
+.venv/
+.wheel-smoke/
+__pycache__/
+*.py[cod]
+build/
+dist/
+*.egg-info/
+*.pdf
+*- PNG export/
+*- JPEG export/

office_export-0.1.0/CHANGELOG.md

@@ -0,0 +1,13 @@
+# Changelog
+
+## 0.1.0
+
+- Export Word, Excel, and PowerPoint documents through desktop Microsoft Office on Windows.
+- Produce native PDF output plus PNG and JPEG images rendered through PDFium.
+- Rasterize PDF inputs without requiring Office.
+- Inspect supported documents and report stable JSON results.
+- Select Word pages, PowerPoint slides, Excel sheets, ranges, and charts.
+- Apply safe defaults for macros, external links, data refresh, recalculation, and source writes.
+- Isolate Office automation in a worker subprocess with timeouts and owned-process cleanup.
+- Add sequential batch conversion, capability diagnostics, deterministic output naming, and optional manifests.
+- Add managed `skill install` and `skill remove` commands for coding agents.

office_export-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 John Paul Ellis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

office_export-0.1.0/PKG-INFO

@@ -0,0 +1,263 @@
+Metadata-Version: 2.5
+Name: office-export
+Version: 0.1.0
+Summary: Export Microsoft Office documents to PDF and images through desktop Office
+Project-URL: Homepage, https://github.com/pseudosavant/office-export
+Project-URL: Repository, https://github.com/pseudosavant/office-export
+Project-URL: Issues, https://github.com/pseudosavant/office-export/issues
+Project-URL: Releases, https://github.com/pseudosavant/office-export/releases
+Author: John Paul Ellis
+License-Expression: MIT
+License-File: LICENSE
+License-File: THIRD_PARTY_NOTICES.md
+Keywords: cli,excel,jpeg,office,pdf,png,powerpoint,word
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: Microsoft :: Windows :: Windows 11
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Multimedia :: Graphics :: Graphics Conversion
+Classifier: Topic :: Office/Business :: Office Suites
+Requires-Python: >=3.11
+Requires-Dist: pillow<13,>=11
+Requires-Dist: pypdfium2<6,>=5.13
+Requires-Dist: pywin32>=311; sys_platform == 'win32'
+Description-Content-Type: text/markdown
+
+# office-export
+
+`office-export` is a Windows-first Python CLI that exports Word, Excel, and PowerPoint documents through the installed desktop Microsoft Office applications. It creates native PDFs and consistent PNG or JPEG images. It can also rasterize PDF inputs without Office.
+
+The core promise is faithful local rendering through the same Office applications that users rely on in the desktop UI. The CLI is designed for people, scripts, and coding agents.
+
+## Requirements
+
+Office document export supports:
+
+- Windows 11
+- Microsoft 365 Apps desktop applications
+- Office 2024 and Office LTSC 2024
+- CPython 3.11 or newer
+- `uv` and `uvx`
+
+Office LTSC 2021 and older desktop releases are best effort. The CLI probes capabilities instead of rejecting an application only because of its version number.
+
+Direct PDF rasterization works on any supported Python platform that has a compatible `pypdfium2` wheel. Word, Excel, and PowerPoint are not required for PDF input.
+
+This tool is intended for an interactive Windows user profile. It is not a server-side Office conversion service. First-run setup, modal dialogs, add-ins, Protected View, or an uninitialized Office license can block automation.
+
+## Install and run
+
+Run the published package without a permanent installation:
+
+```powershell
+uvx office-export --version
+uvx office-export doctor
+```
+
+Run a local checkout during development:
+
+```powershell
+$env:UV_LINK_MODE="copy"
+uvx --refresh --from . office-export --version
+```
+
+## Export documents
+
+```powershell
+uvx office-export report.docx --to pdf
+uvx office-export report.docx --to png --pages 1,3-5 --dpi 200
+uvx office-export deck.pptx --to jpeg --slides 2-6 --dpi 200
+uvx office-export model.xlsx --to pdf --sheet Summary --sheet "Q4 Charts"
+uvx office-export model.xlsx --to png --range "Summary!A1:H40"
+uvx office-export document.pdf --to jpeg --pages 1,3-5 --dpi 300
+```
+
+Use `--output PATH` to override the destination. Use `--force` to replace only the output files planned for the current conversion.
+
+### Default output names
+
+- PDF is written beside the input as `<name>.pdf`.
+- PNG files are written to `<name> - PNG export`.
+- JPEG files are written to `<name> - JPEG export`.
+
+Image names retain their logical source identity:
+
+```text
+report-page-001.png
+deck-slide-003.jpg
+model-sheet-summary-page-001.png
+model-sheet-summary-chart-revenue.png
+```
+
+Image output always uses a directory by default. An explicit image filename is accepted when the selection produces exactly one image.
+
+## Word
+
+```powershell
+uvx office-export report.docx --to pdf --bookmarks headings
+uvx office-export report.docx --to pdf --pages 2-5 --include-markup
+uvx office-export report.docx --to png --pages 1,4,7
+```
+
+Word PDF bookmarks can come from headings, explicit Word bookmarks, or neither. The default is `headings`. The tool updates each table of contents in memory before export without saving the source. Use `--no-update-toc` to preserve the currently displayed values and pagination.
+
+Contiguous page selection uses Word's native fixed-format range. Noncontiguous Word pages are supported for image output by rasterizing selected pages from a complete temporary PDF. Noncontiguous Word PDF output is rejected because combining PDFs can damage tags, links, destinations, metadata, and bookmarks.
+
+## PowerPoint
+
+```powershell
+uvx office-export deck.pptx --to pdf --slides 1,3-5
+uvx office-export deck.pptx --to png --output-type notes
+uvx office-export deck.pptx --to pdf --output-type handout6
+uvx office-export deck.pptx --to png --image-engine office
+```
+
+The default PDFium image engine renders the Office-created PDF. It provides consistent DPI, encoding, annotation, selection, notes, and handout behavior. The optional Office image engine calls PowerPoint's native slide export. It supports slide output only.
+
+Inspection reports both one-based slide positions and stable PowerPoint slide IDs.
+
+## Excel
+
+```powershell
+uvx office-export model.xlsx --to pdf --sheet Summary --sheet "Q4 Charts"
+uvx office-export model.xlsx --to png --range "Summary!A1:H40"
+uvx office-export model.xlsx --to png --charts all
+uvx office-export model.xlsx --to jpeg --chart "Dashboard!Margin" --jpeg-quality 95
+```
+
+Repeated `--sheet` values accept exact names or one-based positions. A range uses `SHEET!ADDRESS` syntax. Excel chart selection creates one tightly bounded native chart image. JPEG charts are converted from Excel's temporary PNG so quality and background handling stay deterministic.
+
+`--dpi` does not apply to native chart export. Chart dimensions come from the workbook. Excel can lose internal workbook links during native PDF conversion. External links emitted by Excel remain subject to Excel's own behavior.
+
+The following options intentionally change how workbook content is evaluated:
+
+- `--recalculate auto|full`
+- `--update-links`
+- `--refresh-data`
+
+They are disabled by default.
+
+## PDF input
+
+```powershell
+uvx office-export document.pdf --to png
+uvx office-export document.pdf --to jpeg --pages 1,3-5 --dpi 300
+uvx office-export document.pdf --to png --exclude-annotations
+```
+
+PDF input supports PNG and JPEG output in version 0.1.0. PDF-to-PDF rewriting is not supported. Physical page selectors are one-based. `inspect` also reports page labels when the PDF contains them.
+
+Visible annotations and standard form appearances are rendered by default. `--exclude-annotations` also excludes form widget appearances. Dynamic XFA content produces a warning. Password-protected, encrypted, or permission-restricted PDFs are rejected.
+
+Defaults:
+
+- 150 DPI
+- JPEG quality 92
+- White JPEG background
+- 50 megapixels per page
+
+Use `--max-megapixels` only after reviewing the memory cost of the requested page size and DPI.
+
+## Inspect and diagnose
+
+```powershell
+uvx office-export inspect report.docx --json
+uvx office-export inspect deck.pptx --json
+uvx office-export inspect model.xlsx --json
+uvx office-export inspect document.pdf --json
+uvx office-export doctor --json
+uvx office-export doctor --smoke-word report.docx --smoke-excel model.xlsx --smoke-powerpoint deck.pptx --json
+uvx office-export formats --json
+```
+
+`doctor` reports each Office application separately from PDFium. It also reports the Office version, bitness, active printer when available, Print Spooler state, installed printers, dependency versions, and temporary-directory access.
+
+Smoke exports are opt-in. Supply one or more known local fixtures with `--smoke-word`, `--smoke-excel`, or `--smoke-powerpoint`.
+
+## JSON and manifests
+
+Add `--json` to print a stable result object to stdout. Diagnostics stay on stderr. A successful conversion includes:
+
+- Tool and schema versions
+- Source size and SHA-256 hash
+- Office application and version
+- Active printer when relevant
+- Effective options and warnings
+- PDFium and Pillow versions
+- Output paths, sizes, and SHA-256 hashes
+- Logical source-to-output mappings
+- Duration
+
+Use `--manifest PATH` to persist the same result. Failed conversions also write a structured failure manifest when the requested manifest path is safe and writable. No sidecar manifest is created by default.
+
+## Batch conversion
+
+```powershell
+uvx office-export batch .\incoming --to pdf
+uvx office-export batch .\incoming --to png --recursive --continue-on-error --json
+```
+
+Version 0.1.0 processes files sequentially and accepts only `--jobs 1`. Each Office source gets a fresh worker process and an isolated temporary directory.
+
+## Agent skill
+
+Install the bundled managed skill:
+
+```powershell
+uvx office-export skill install
+uvx office-export skill install --skills-dir C:\custom\skills
+uvx office-export skill remove
+```
+
+The default target is `~/.agents/skills/office-export/SKILL.md`. Installation is idempotent and updates stale managed content. Installation and removal refuse unmanaged content unless `--force` is explicitly supplied.
+
+The skill teaches agents to run diagnostics, inspect before selecting, export with JSON, review representative images, report exact paths and warnings, and preserve safe defaults.
+
+## Safety model
+
+- Sources open read-only.
+- VBA macros are force-disabled.
+- AutoOpen and Auto_Open macros are not executed.
+- External links do not update by default.
+- Data connections do not refresh by default.
+- Workbooks do not recalculate by default.
+- Source changes are never saved.
+- Passwords, Protected View, IRM, sensitivity restrictions, and PDF permissions are not bypassed.
+- Final outputs are published only after conversion validation.
+- A timeout can terminate only an Office process proven to have been created by the isolated worker.
+- A pre-existing user Office process is never quit or terminated.
+
+Office automation is not a security sandbox. Do not use it to open untrusted documents outside the protections of your Windows and Office environment.
+
+## Development
+
+```powershell
+$env:UV_LINK_MODE="copy"
+uv sync --all-groups
+uv run ruff check .
+uv run ruff format --check .
+uv run pytest
+uv run pytest -m office
+uv build
+uv run twine check dist/*
+```
+
+The default test run is cross-platform and excludes tests that require licensed desktop Office. Run the `office` marker in an interactive Windows session before release.
+
+## Known native limitations
+
+- Office rendering can vary with Office updates, installed fonts, document compatibility settings, and printer metrics.
+- Excel internal workbook links can be lost in native PDF output.
+- PowerPoint-native images can differ slightly from PDFium images.
+- Dynamic XFA forms may not match a full PDF viewer.
+- Modal Office dialogs and add-ins can still interfere with automation.
+
+## License
+
+MIT. See [LICENSE](LICENSE) and [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).