tex2pptx 0.1.0__tar.gz

tex2pptx-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zhuoxiang (Shawn) Zhou
+
+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.

tex2pptx-0.1.0/MANIFEST.in

@@ -0,0 +1,20 @@
+include LICENSE
+include PYPI.md
+include THIRD_PARTY_NOTICES.md
+include pyproject.toml
+
+recursive-include src/tex2pptx/data *.cjs *.LEGAL.txt *.yaml
+
+exclude README.md
+prune .github
+prune docs
+prune node_modules
+prune schemas
+prune scripts
+prune src/pptx-writer
+prune tests
+prune work
+
+global-exclude .DS_Store
+global-exclude *.py[cod]
+global-exclude __pycache__

tex2pptx-0.1.0/PKG-INFO

@@ -0,0 +1,126 @@
+Metadata-Version: 2.4
+Name: tex2pptx
+Version: 0.1.0
+Summary: Editable-first LaTeX/Beamer to PowerPoint conversion workflow
+Author: Zhuoxiang (Shawn) Zhou
+License-Expression: MIT AND ISC AND Zlib
+Keywords: beamer,latex,powerpoint,pptx,presentation
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: MacOS
+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 :: Office/Business :: Office Suites
+Classifier: Topic :: Text Processing :: Markup :: LaTeX
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: THIRD_PARTY_NOTICES.md
+License-File: src/tex2pptx/data/pptx-writer.cjs.LEGAL.txt
+Requires-Dist: lxml<7,>=5.0
+Requires-Dist: numpy<3,>=2.0
+Requires-Dist: Pillow<13,>=11.0
+Requires-Dist: pydantic<3,>=2.9
+Requires-Dist: pylatexenc<3,>=2.10
+Requires-Dist: PyMuPDF<2,>=1.24
+Requires-Dist: PyYAML<7,>=6.0
+Requires-Dist: rich<15,>=13.9
+Requires-Dist: scikit-image<1,>=0.24
+Requires-Dist: typer<1,>=0.15
+Provides-Extra: dev
+Requires-Dist: build<2,>=1.2; extra == "dev"
+Requires-Dist: pytest<10,>=8.3; extra == "dev"
+Requires-Dist: pytest-cov<8,>=6.0; extra == "dev"
+Requires-Dist: twine<7,>=6.0; extra == "dev"
+Dynamic: license-file
+
+# tex2pptx
+
+`tex2pptx` converts a LaTeX Beamer presentation into an editable Microsoft
+PowerPoint deck. It keeps supported text, lists, equations, tables, shapes,
+links, and notes editable, while figures remain movable and resizable assets.
+
+The converter also produces PDFs of the LaTeX and PowerPoint renderings and an
+HTML report for reviewing visual differences and conversion diagnostics.
+
+## Install
+
+Create an isolated Python environment and install the released package:
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+python -m pip install --upgrade pip
+python -m pip install tex2pptx==0.1.0
+```
+
+The package includes its compiled PowerPoint writer. You do not need the
+development repository, pnpm, TypeScript, or a local `node_modules` directory.
+
+## System requirements
+
+The complete conversion workflow currently requires:
+
+- macOS with a logged-in desktop session
+- Python 3.11 or newer
+- Node.js 22 or newer
+- Pandoc
+- MacTeX or an equivalent TeX Live installation
+- Microsoft PowerPoint installed at
+  `/Applications/Microsoft PowerPoint.app`
+
+The TeX installation must provide `latexmk`, SyncTeX, `dvisvgm`, pdfLaTeX,
+XeLaTeX, and LuaLaTeX. Check the installation before converting a deck:
+
+```bash
+tex2pptx doctor
+```
+
+The command reports every missing or unsupported prerequisite and a suggested
+remedy.
+
+## Convert a presentation
+
+Inspect the main Beamer file without creating conversion artifacts:
+
+```bash
+tex2pptx inspect path/to/presentation.tex
+```
+
+Convert it into an explicit output directory:
+
+```bash
+tex2pptx convert path/to/presentation.tex --to path/to/output
+```
+
+For `presentation.tex`, the output directory contains:
+
+```text
+presentation.pptx
+presentation-from-latex.pdf
+presentation-from-powerpoint.pdf
+presentation-report/
+```
+
+PowerPoint opens during final validation. On first use, macOS may ask for
+Automation permission; grant access and let the command finish before using
+PowerPoint. Review the two PDFs and the HTML conversion report before
+circulating the deck.
+
+## Troubleshooting
+
+- If `tex2pptx` is not found, activate the virtual environment in which it was
+  installed.
+- If `doctor` reports an old or missing Node.js runtime, install Node.js 22 or
+  newer and open a new terminal.
+- If TeX commands are missing after installing MacTeX, open a new terminal so
+  its command directory is added to `PATH`.
+- If PowerPoint validation fails, confirm that PowerPoint is installed in
+  `/Applications` and that macOS Automation permission has been granted to the
+  terminal application running `tex2pptx`.
+- If conversion completes with warnings, open the generated HTML report and
+  review the listed slides and fallback objects.

tex2pptx-0.1.0/PYPI.md

@@ -0,0 +1,86 @@
+# tex2pptx
+
+`tex2pptx` converts a LaTeX Beamer presentation into an editable Microsoft
+PowerPoint deck. It keeps supported text, lists, equations, tables, shapes,
+links, and notes editable, while figures remain movable and resizable assets.
+
+The converter also produces PDFs of the LaTeX and PowerPoint renderings and an
+HTML report for reviewing visual differences and conversion diagnostics.
+
+## Install
+
+Create an isolated Python environment and install the released package:
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+python -m pip install --upgrade pip
+python -m pip install tex2pptx==0.1.0
+```
+
+The package includes its compiled PowerPoint writer. You do not need the
+development repository, pnpm, TypeScript, or a local `node_modules` directory.
+
+## System requirements
+
+The complete conversion workflow currently requires:
+
+- macOS with a logged-in desktop session
+- Python 3.11 or newer
+- Node.js 22 or newer
+- Pandoc
+- MacTeX or an equivalent TeX Live installation
+- Microsoft PowerPoint installed at
+  `/Applications/Microsoft PowerPoint.app`
+
+The TeX installation must provide `latexmk`, SyncTeX, `dvisvgm`, pdfLaTeX,
+XeLaTeX, and LuaLaTeX. Check the installation before converting a deck:
+
+```bash
+tex2pptx doctor
+```
+
+The command reports every missing or unsupported prerequisite and a suggested
+remedy.
+
+## Convert a presentation
+
+Inspect the main Beamer file without creating conversion artifacts:
+
+```bash
+tex2pptx inspect path/to/presentation.tex
+```
+
+Convert it into an explicit output directory:
+
+```bash
+tex2pptx convert path/to/presentation.tex --to path/to/output
+```
+
+For `presentation.tex`, the output directory contains:
+
+```text
+presentation.pptx
+presentation-from-latex.pdf
+presentation-from-powerpoint.pdf
+presentation-report/
+```
+
+PowerPoint opens during final validation. On first use, macOS may ask for
+Automation permission; grant access and let the command finish before using
+PowerPoint. Review the two PDFs and the HTML conversion report before
+circulating the deck.
+
+## Troubleshooting
+
+- If `tex2pptx` is not found, activate the virtual environment in which it was
+  installed.
+- If `doctor` reports an old or missing Node.js runtime, install Node.js 22 or
+  newer and open a new terminal.
+- If TeX commands are missing after installing MacTeX, open a new terminal so
+  its command directory is added to `PATH`.
+- If PowerPoint validation fails, confirm that PowerPoint is installed in
+  `/Applications` and that macOS Automation permission has been granted to the
+  terminal application running `tex2pptx`.
+- If conversion completes with warnings, open the generated HTML report and
+  review the listed slides and fallback objects.

tex2pptx-0.1.0/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,17 @@
+# Third-party software notices
+
+The `tex2pptx` distribution contains a bundled JavaScript PowerPoint writer.
+The complete license notices for PptxGenJS and every package incorporated into
+that bundle are distributed with the package as
+`tex2pptx/data/pptx-writer.cjs.LEGAL.txt`.
+
+The bundle's notices are generated from the dependency graph used to build the
+writer. They must be regenerated and reviewed whenever the bundled JavaScript
+dependencies change.
+
+Python dependencies installed separately by a package manager are not copied
+into the `tex2pptx` distribution. Their own distributions provide the terms
+that govern them.
+
+These notices are provided for attribution and do not replace or modify the
+terms of any third-party license.

tex2pptx-0.1.0/pyproject.toml

@@ -0,0 +1,78 @@
+[build-system]
+requires = ["setuptools>=77.0.3"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "tex2pptx"
+version = "0.1.0"
+description = "Editable-first LaTeX/Beamer to PowerPoint conversion workflow"
+readme = { file = "PYPI.md", content-type = "text/markdown" }
+requires-python = ">=3.11"
+license = "MIT AND ISC AND Zlib"
+license-files = [
+  "LICENSE",
+  "THIRD_PARTY_NOTICES.md",
+  "src/tex2pptx/data/pptx-writer.cjs.LEGAL.txt",
+]
+authors = [
+  { name = "Zhuoxiang (Shawn) Zhou" },
+]
+keywords = ["beamer", "latex", "powerpoint", "pptx", "presentation"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Intended Audience :: Science/Research",
+  "Operating System :: MacOS",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Topic :: Office/Business :: Office Suites",
+  "Topic :: Text Processing :: Markup :: LaTeX",
+]
+dependencies = [
+  "lxml>=5.0,<7",
+  "numpy>=2.0,<3",
+  "Pillow>=11.0,<13",
+  "pydantic>=2.9,<3",
+  "pylatexenc>=2.10,<3",
+  "PyMuPDF>=1.24,<2",
+  "PyYAML>=6.0,<7",
+  "rich>=13.9,<15",
+  "scikit-image>=0.24,<1",
+  "typer>=0.15,<1",
+]
+
+[project.optional-dependencies]
+dev = [
+  "build>=1.2,<2",
+  "pytest>=8.3,<10",
+  "pytest-cov>=6.0,<8",
+  "twine>=6.0,<7",
+]
+
+[project.scripts]
+tex2pptx = "tex2pptx.cli:app"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+tex2pptx = [
+  "data/*.cjs",
+  "data/*.LEGAL.txt",
+  "data/*.yaml",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-ra"
+markers = [
+  "integration: exercises the TypeScript/PptxGenJS writer",
+  "regression: validates the PhoneBans end-to-end fixture artifacts",
+]

tex2pptx-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

tex2pptx-0.1.0/src/tex2pptx/__init__.py

@@ -0,0 +1,3 @@
+"""Editable-first LaTeX/Beamer to PowerPoint conversion package."""
+
+__version__ = "0.1.0"

tex2pptx-0.1.0/src/tex2pptx/__main__.py

@@ -0,0 +1,4 @@
+from .cli import app
+
+
+app()

tex2pptx-0.1.0/src/tex2pptx/alignment/__init__.py

@@ -0,0 +1,5 @@
+"""Source-to-PDF object alignment."""
+
+from .matcher import build_deck_ir, recover_unicode_text
+
+__all__ = ["build_deck_ir", "recover_unicode_text"]