texdiff 0.2.0__py3-none-any.whl

texdiff-0.2.0.dist-info/METADATA

@@ -0,0 +1,112 @@
+Metadata-Version: 2.4
+Name: texdiff
+Version: 0.2.0
+Summary: AST-driven semantic diff for LaTeX documents
+Author: GoBobr
+License: MIT License
+        
+        Copyright (c) 2026 GoBobr
+        
+        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.
+        
+Project-URL: Homepage, https://github.com/GoBobr/texdiff
+Keywords: latex,diff,latexdiff,ast,track-changes
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Text Processing :: Markup :: LaTeX
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pylatexenc>=2.10
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Requires-Dist: pytest-cov>=4; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: mkdocs>=1.5; extra == "docs"
+Requires-Dist: mkdocs-material>=9; extra == "docs"
+Requires-Dist: mkdocstrings[python]>=0.24; extra == "docs"
+Requires-Dist: pymdown-extensions>=10; extra == "docs"
+Dynamic: license-file
+
+# texdiff
+
+**AST-driven semantic diff for LaTeX documents.**
+
+`texdiff` compares two revisions of a LaTeX document and produces a single
+marked-up `diff.tex` that compiles with `pdflatex` — added text in blue,
+deleted text struck out — while preserving the original document's styling,
+cross-references and custom classes.
+
+## Why
+
+[`latexdiff`](https://www.ctan.org/pkg/latexdiff) is the de-facto standard for
+review-marked LaTeX, but it diffs *token soup*: it guesses word boundaries with
+regexes and re-injects markup into the merged text, hoping braces still
+balance. On real-world documents the result is markup that crosses brace /
+environment boundaries, glues old and new table cells together, and corrupts
+listings — which is why every serious latexdiff user eventually ends up
+maintaining a pile of fragile pre/post-processing scripts around it.
+
+`texdiff` takes the other road: **diff the tree, never the text.**
+
+1. Parse old and new documents into a LaTeX syntax tree
+   ([pylatexenc](https://github.com/phfaist/pylatexenc) — a faithful concrete
+   syntax tree carrying exact source spans, no macro expansion).
+2. Align the trees level by level (document → environments → groups → text
+   runs) with difflib-style sequence matching. A change can never leak across
+   a node boundary.
+3. Walk the merged tree and emit `\DIFadd{...}` / `\DIFdel{...}` markup —
+   latexdiff-compatible rendering, valid by construction.
+
+Restructured tables (re-ordered rows, changed column layouts), math,
+listings and verbatim environments are handled as atomic or row-aligned
+blocks instead of being shredded by a word diff.
+
+Multi-file sources are flattened automatically (`\input`/`\include`
+resolved relative to each file, like `latexdiff --flatten`), and the
+preamble of the new revision is used verbatim so custom classes and
+macros keep working.
+
+## Usage
+
+```sh
+texdiff old/main.tex new/main.tex > diff.tex   # \input expansion built in
+pdflatex diff.tex                              # done - no pre/postprocessing
+texdiff old.tex new.tex -o diff.tex --check    # + fail loudly if it won't compile
+texdiff old.tex new.tex --stats                # "611 unchanged, 29 added, ..."
+```
+
+```sh
+pip install texdiff        # or from a checkout:
+pip install -e ".[dev]" && pytest
+```
+
+Status: **v0.2.0** — core pipeline plus flattening, row-granular table
+alignment, preamble policy, `--check` and a compile-guaranteed corpus in
+CI; validated on a 65-page generated longtable-heavy document. See the
+[roadmap](https://gobobr.github.io/texdiff/roadmap/) for what is next.
+
+## License
+
+MIT

texdiff-0.2.0.dist-info/RECORD

@@ -0,0 +1,19 @@
+texdiff/__init__.py,sha256=ISoBdBHEbstR5ydBF3kjTsMvhWxxc3pL_Ufz-Gw9tKw,1023
+texdiff/align.py,sha256=5JiN4YLE9Xa7ymr1xOeuzOWSebVNyX8QAJDOT6LM7rM,7532
+texdiff/api.py,sha256=qZ7ZxmzTIpJV_RRpDbRj-hW5bIRObiKm6xBjy97cFd8,11867
+texdiff/check.py,sha256=Wpqst1nbGh2RYZPUWmXrsYfNX0zECo5SRmkrfOcOwOE,1820
+texdiff/cli.py,sha256=xFiaLutQu9hdFVJz6QWKgLuK_XTCCXv-MPkkdwaxW8E,2560
+texdiff/emit.py,sha256=BaeCVpO_zCa3BMlvuu-fVE7U_--B5qk5nW7Ffl1zuEM,48764
+texdiff/flatten.py,sha256=qfizn6-uhxmAjyNPdJbImPyA875ZwufagFz7x9mHQqY,6804
+texdiff/nodes.py,sha256=J1y9X55Xy3nGpHk5uMxsO8-obYclelsOhTuTfHobtXs,6122
+texdiff/oldlines.py,sha256=lue8HSyOnOf92Zm4ypI2qpYi85eLJhuWQ5K7eqvs5sM,1907
+texdiff/parse.py,sha256=CVRNYDwIhYMKjOK0VzvSAOZPrdQUCVGQE5kbPpu1Bpc,18684
+texdiff/preamble.py,sha256=XaueZ_AX7JiHVcSyzAdjaXGI9Eq_PYfipMuwQXCsF0Y,15046
+texdiff/tables.py,sha256=Pkkass34goAHyBNHQbBEGY5FEPmKP1ZBIa8QYp2LoXM,19608
+texdiff/textdiff.py,sha256=gs8HeLA8__ts-NvQWJCqOS-wtXtQbxaPZk459qKdJvE,5199
+texdiff-0.2.0.dist-info/licenses/LICENSE,sha256=fUppg5evqA2g0mRPkqN6nZf05_CMWDbB7eCJLLm77LI,1063
+texdiff-0.2.0.dist-info/METADATA,sha256=mH-acVMi3RkOPtDYq1w0h24zjgwJzFp7zJ19DluhBoE,4950
+texdiff-0.2.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+texdiff-0.2.0.dist-info/entry_points.txt,sha256=dwCa4uRkbpmQY1DySP66BMbj45-zNRPufkY3fJ19OIs,45
+texdiff-0.2.0.dist-info/top_level.txt,sha256=_h2FYJPSZ88JDmjQNW15BoBM4-XaosFBS8UAAyveSok,8
+texdiff-0.2.0.dist-info/RECORD,,

texdiff-0.2.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

texdiff-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+texdiff = texdiff.cli:main

texdiff-0.2.0.dist-info/licenses/LICENSE

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

texdiff-0.2.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+texdiff