sysml2tikz 0.0.1__tar.gz → 0.0.2__tar.gz

{sysml2tikz-0.0.1 → sysml2tikz-0.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: sysml2tikz
-Version: 0.0.1
+Version: 0.0.2
 Summary: SysML v2 notation for LaTeX/TikZ: a .sty notation layer plus a model-to-figure pipeline
 Project-URL: Homepage, https://github.com/mycr0ft/sysml2tikz
 Project-URL: Issues, https://github.com/mycr0ft/sysml2tikz/issues
@@ -38,16 +38,25 @@ Two things live here:
 Two independent doors:
 
 ```bash
-# LaTeX only — drop the .sty in your document's directory (or install it from CTAN
-# once the package is accepted), then:
-\usepackage{sysml2tikz}
+# LaTeX only, option A — put the .sty beside your document
+#   (from CTAN once the package is accepted, or copy it out of the Python package)
+
+# LaTeX only, option B — install once into your TeX user tree, then it is found
+# from every directory, no copying per document:
+pip install sysml2tikz
+sysml2tikz install-sty          # -> $TEXMFHOME/tex/latex/sysml2tikz/sysml2tikz.sty
+kpsewhich sysml2tikz.sty        # sanity check
 
 # Python — the generator; the wheel carries the same .sty
 pip install sysml2tikz
-sysml2tikz emit model.json out.tex --copy-sty   # --copy-sty puts the .sty beside the output
-tectonic out.tex
+sysml2tikz emit model.json out.tex --copy-sty   # portable: .sty lands beside the output
+tectonic out.tex                                # or pdflatex/lualatex/latexmk
 ```
 
+With TeX Live, `install-sty` needs the picture and extra packages present:
+`texlive-pictures` (pgf/TikZ) and `texlive-latex-extra` (`standalone.cls`,
+`xstring`). `tectonic` needs none of that — it fetches what a document uses.
+
 `--copy-sty` exists because tectonic resolves packages from its own bundle rather
 than from `TEXINPUTS`, and a plain TeX Live only finds `sysml2tikz.sty` after CTAN
 ships it. For a repo checkout the `gen/*.py` scripts are thin shims over

{sysml2tikz-0.0.1 → sysml2tikz-0.0.2}/README.md

@@ -16,16 +16,25 @@ Two things live here:
 Two independent doors:
 
 ```bash
-# LaTeX only — drop the .sty in your document's directory (or install it from CTAN
-# once the package is accepted), then:
-\usepackage{sysml2tikz}
+# LaTeX only, option A — put the .sty beside your document
+#   (from CTAN once the package is accepted, or copy it out of the Python package)
+
+# LaTeX only, option B — install once into your TeX user tree, then it is found
+# from every directory, no copying per document:
+pip install sysml2tikz
+sysml2tikz install-sty          # -> $TEXMFHOME/tex/latex/sysml2tikz/sysml2tikz.sty
+kpsewhich sysml2tikz.sty        # sanity check
 
 # Python — the generator; the wheel carries the same .sty
 pip install sysml2tikz
-sysml2tikz emit model.json out.tex --copy-sty   # --copy-sty puts the .sty beside the output
-tectonic out.tex
+sysml2tikz emit model.json out.tex --copy-sty   # portable: .sty lands beside the output
+tectonic out.tex                                # or pdflatex/lualatex/latexmk
 ```
 
+With TeX Live, `install-sty` needs the picture and extra packages present:
+`texlive-pictures` (pgf/TikZ) and `texlive-latex-extra` (`standalone.cls`,
+`xstring`). `tectonic` needs none of that — it fetches what a document uses.
+
 `--copy-sty` exists because tectonic resolves packages from its own bundle rather
 than from `TEXINPUTS`, and a plain TeX Live only finds `sysml2tikz.sty` after CTAN
 ships it. For a repo checkout the `gen/*.py` scripts are thin shims over

{sysml2tikz-0.0.1 → sysml2tikz-0.0.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sysml2tikz"
-version = "0.0.1"
+version = "0.0.2"
 description = "SysML v2 notation for LaTeX/TikZ: a .sty notation layer plus a model-to-figure pipeline"
 readme = "README.md"
 requires-python = ">=3.10"

{sysml2tikz-0.0.1 → sysml2tikz-0.0.2}/src/sysml2tikz/__init__.py

@@ -14,12 +14,25 @@ Two halves, usable separately:
 Nothing here is required to use the ``.sty``, and the ``.sty`` is not required
 to emit IR.
 """
+import os
 from importlib.resources import files
 
-__version__ = "0.0.1"
+__version__ = "0.0.2"
 
 def sty_path() -> str:
-    """Absolute path of the bundled ``sysml2tikz.sty`` (for TEXINPUTS)."""
-    return str(files(__name__).joinpath("sysml2tikz.sty"))
+    """Absolute path of ``sysml2tikz.sty``.
+
+    An installed wheel carries the file inside the package (force-included at
+    build time from the repo root); a source checkout does not, so fall back to
+    the canonical file at the repo root.
+    """
+    packaged = files(__name__).joinpath("sysml2tikz.sty")
+    if packaged.is_file():
+        return str(packaged)
+    root = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+    candidate = os.path.join(root, "sysml2tikz.sty")
+    if os.path.isfile(candidate):
+        return candidate
+    raise FileNotFoundError("sysml2tikz.sty not found (installed package or repo root)")
 
 __all__ = ["__version__", "sty_path"]

{sysml2tikz-0.0.1 → sysml2tikz-0.0.2}/src/sysml2tikz/cli.py

@@ -6,6 +6,7 @@
     sysml2tikz layout   model.json out.tex     IR -> measured + routed .tex
     sysml2tikz project  model.sysml out.json   SysML v2 text -> IR
     sysml2tikz sty                             print the bundled .sty path
+    sysml2tikz install-sty                     copy it into TEXMFHOME (TeX Live/MiKTeX)
     sysml2tikz version
 """
 from __future__ import annotations
@@ -32,6 +33,9 @@ def main(argv: list[str] | None = None) -> int:
         from . import sty_path
         print(sty_path())
         return 0
+    if cmd == "install-sty":
+        from .install import install
+        return install(rest)
     if cmd == "emit":
         from .emit import main as run
         return run(["emit"] + rest)

sysml2tikz-0.0.2/src/sysml2tikz/install.py

@@ -0,0 +1,76 @@
+# SPDX-License-Identifier: MPL-2.0
+# Copyright (c) 2026 Jon R. Fox and Hermes Agent
+"""Install the bundled ``sysml2tikz.sty`` where a TeX distribution will find it.
+
+`--copy-sty` is the zero-configuration route (the file lands beside your
+document). This is the other one: put it in the user tree once, then
+``\\usepackage{sysml2tikz}`` works from every document, in every directory.
+
+Target is ``$TEXMFHOME/tex/latex/sysml2tikz/sysml2tikz.sty`` where TEXMFHOME comes
+from ``kpsewhich -var-value TEXMFHOME`` (usually ``~/texmf``). No sudo anywhere —
+a system-wide install belongs to the distribution package manager or CTAN.
+"""
+from __future__ import annotations
+
+import os
+import shutil
+import subprocess
+import sys
+
+TEX_SUBDIR = os.path.join("tex", "latex", "sysml2tikz")
+
+
+def texmfhome() -> str:
+    try:
+        out = subprocess.run(["kpsewhich", "-var-value", "TEXMFHOME"],
+                             capture_output=True, text=True, timeout=30)
+        path = out.stdout.strip()
+        if path:
+            return os.path.expanduser(path)
+    except (FileNotFoundError, subprocess.SubprocessError):
+        pass
+    return os.path.expanduser("~/texmf")
+
+
+def install(argv: list[str]) -> int:
+    dest_root = texmfhome()
+    force = "--force" in argv
+    from . import sty_path
+
+    src = sty_path()
+    dest_dir = os.path.join(dest_root, TEX_SUBDIR)
+    dest = os.path.join(dest_dir, "sysml2tikz.sty")
+
+    if os.path.exists(dest) and not force:
+        same = open(src, "rb").read() == open(dest, "rb").read()
+        print("%s %s" % ("already current:" if same else "differs (use --force):", dest))
+        return 0 if same else 1
+
+    os.makedirs(dest_dir, exist_ok=True)
+    shutil.copyfile(src, dest)
+    # a user tree without ls-R is still searched, but refreshing costs nothing
+    for cmd in (["texhash", dest_root], ["mktexlsr", dest_root]):
+        try:
+            r = subprocess.run(cmd, capture_output=True, text=True, timeout=120)
+            if r.returncode == 0:
+                break
+        except (FileNotFoundError, subprocess.SubprocessError):
+            continue
+
+    print("installed", dest)
+    try:
+        found = subprocess.run(["kpsewhich", "sysml2tikz.sty"],
+                               capture_output=True, text=True, timeout=30).stdout.strip()
+    except (FileNotFoundError, subprocess.SubprocessError):
+        found = ""
+    if found:
+        print("kpsewhich resolves sysml2tikz.sty ->", found)
+        return 0
+    print("note: kpsewhich does not see it yet. TEXMFHOME is %s — check that your TeX\n"
+          "distribution searches the user tree (TeX Live does by default; MiKTeX needs\n"
+          "the directory registered in its settings)." % dest_root)
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(install(sys.argv[1:]))