tangle-md2tex 0.1.0__py3-none-any.whl

tangle_md2tex-0.1.0.dist-info/METADATA

@@ -0,0 +1,12 @@
+Metadata-Version: 2.4
+Name: tangle-md2tex
+Version: 0.1.0
+Summary: Extract LaTeX fenced blocks from literate Markdown files.
+Author-email: yindaheng98 <yindaheng98@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/yindaheng98/tangle-md2tex
+Project-URL: Repository, https://github.com/yindaheng98/tangle-md2tex
+Requires-Python: >=3.10
+License-File: LICENSE
+Requires-Dist: markdown-it-py>=4.2.0
+Dynamic: license-file

tangle_md2tex-0.1.0.dist-info/RECORD

@@ -0,0 +1,11 @@
+tangle_md2tex-0.1.0.dist-info/licenses/LICENSE,sha256=oI-e71S3HyCSR40MoS3enu_1Z6yayOKmcV_4b2fXqq4,1067
+tanglemd2tex/__init__.py,sha256=ONkVrANA2LtjrXwNaiHbWdA1Jdgay6nPTj1Re9dJFh0,109
+tanglemd2tex/__main__.py,sha256=PSQ4rpL0dG6f-qH4N7H-gD9igQkdHzH4yVZDcW8lfZo,80
+tanglemd2tex/cli.py,sha256=Q6Oj2aDnUSXfwsy11gT5sOhFJEvMGWmERjNmg-toJks,1317
+tanglemd2tex/lit_file.py,sha256=HhL3W1y3eezJoQAnhYqO5p06sa9yGDgyYneuszDRLiI,852
+tanglemd2tex/tangle.py,sha256=0hUihGUTnEAkQVkpDxQOGE_JT92N-zUiHZJ7a9B80vw,582
+tangle_md2tex-0.1.0.dist-info/METADATA,sha256=-cNucKOQudTnRy2-7QFtMdcy_mBxEZxrBHsvfVS9eFY,441
+tangle_md2tex-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+tangle_md2tex-0.1.0.dist-info/entry_points.txt,sha256=owkLxIYwyAPkYuYUwh8u-7o634MoeMqcYth1i2VCteM,55
+tangle_md2tex-0.1.0.dist-info/top_level.txt,sha256=1Y1In3h4AwH7NPGbY07R52TNAzE7gTilcdkQMqCB_AI,13
+tangle_md2tex-0.1.0.dist-info/RECORD,,

tangle_md2tex-0.1.0.dist-info/WHEEL

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

tangle_md2tex-0.1.0.dist-info/entry_points.txt

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

tangle_md2tex-0.1.0.dist-info/licenses/LICENSE

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

tangle_md2tex-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+tanglemd2tex

tanglemd2tex/__init__.py

@@ -0,0 +1,4 @@
+from .tangle import tangle_text, tangle_file
+
+__all__ = ["tangle_text", "tangle_file"]
+__version__ = "0.1.0"

tanglemd2tex/__main__.py

@@ -0,0 +1,5 @@
+from .cli import main
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

tanglemd2tex/cli.py

@@ -0,0 +1,55 @@
+from __future__ import annotations
+
+import argparse
+import sys
+from pathlib import Path
+
+from .lit_file import find_lit_files
+from .tangle import tangle_file
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="tanglemd2tex",
+        description="Extract ```latex``` fenced blocks from .lit.md files into .tex files.",
+    )
+    parser.add_argument(
+        "paths",
+        nargs="*",
+        type=Path,
+        help=(
+            ".lit.md files or directories to scan recursively. "
+            "Defaults to the current directory."
+        ),
+    )
+    return parser
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = build_parser()
+    args = parser.parse_args(argv)
+
+    paths = args.paths or [Path(".")]
+
+    try:
+        lit_files = find_lit_files(paths)
+    except Exception as error:
+        print(f"ERROR: {error}", file=sys.stderr)
+        return 1
+
+    if not lit_files:
+        print("ERROR: no .lit.md files found", file=sys.stderr)
+        return 1
+
+    status = 0
+    for lit_path in lit_files:
+        try:
+            tex_path = tangle_file(lit_path)
+        except Exception as error:
+            print(f"ERROR: {error}", file=sys.stderr)
+            status = 1
+            continue
+
+        print(f"WROTE: {tex_path}")
+
+    return status

tanglemd2tex/lit_file.py

@@ -0,0 +1,34 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+
+LIT_SUFFIX = ".lit.md"
+TEX_SUFFIX = ".tex"
+
+
+def lit_to_tex_path(lit_path: Path) -> Path:
+    if not lit_path.name.endswith(LIT_SUFFIX):
+        raise ValueError(f"not a {LIT_SUFFIX} file: {lit_path}")
+
+    tex_name = lit_path.name[: -len(LIT_SUFFIX)] + TEX_SUFFIX
+    return lit_path.with_name(tex_name)
+
+
+def find_lit_files(paths: list[Path]) -> list[Path]:
+    files: list[Path] = []
+
+    for path in paths:
+        if path.is_dir():
+            files.extend(path.rglob(f"*{LIT_SUFFIX}"))
+            continue
+
+        if path.is_file():
+            if not path.name.endswith(LIT_SUFFIX):
+                raise ValueError(f"not a {LIT_SUFFIX} file: {path}")
+            files.append(path)
+            continue
+
+        raise ValueError(f"path does not exist: {path}")
+
+    return files

tanglemd2tex/tangle.py

@@ -0,0 +1,22 @@
+from __future__ import annotations
+
+from pathlib import Path
+from markdown_it import MarkdownIt
+
+from .lit_file import lit_to_tex_path
+
+
+def tangle_text(text: str) -> str:
+    return "".join(
+        token.content
+        for token in MarkdownIt("commonmark").parse(text)
+        if token.type == "fence" and token.info.strip() == "latex"
+    )
+
+
+def tangle_file(lit_path: Path) -> Path:
+    tex_path = lit_to_tex_path(lit_path)
+    text = lit_path.read_text(encoding="utf-8")
+    tex_text = tangle_text(text)
+    tex_path.write_text(tex_text, encoding="utf-8")
+    return tex_path