ff9mapkit 1.0.0b3__py3-none-any.whl

ff9mapkit/__init__.py

@@ -0,0 +1,18 @@
+"""ff9mapkit — author novel custom field maps for Final Fantasy IX (Memoria engine).
+
+The kit compiles a declarative per-field TOML project into a drop-in Memoria mod:
+field background scene (.bgx + overlay PNGs), walkmesh (.bgi), event script (.eb, all
+languages), dialogue text (.mes), and the DictionaryPatch / BattlePatch registration —
+everything a custom field needs at runtime on a *stock* (unmodified) Memoria install.
+
+Public surface is organized as:
+  ff9mapkit.config    — game/mod path resolution + the FF9 mod folder layout
+  ff9mapkit.binutils  — little-endian struct helpers shared by the binary codecs
+  ff9mapkit.eb        — the field event-script (.eb) library (model / edit / disasm / opcodes)
+  ff9mapkit.scene     — camera math, .bgx scene, .bgi walkmesh, paint guides
+  ff9mapkit.content   — generalized script-content injectors (npc/gateway/encounter/...)
+  ff9mapkit.build     — the field.toml -> mod-folder builder
+  ff9mapkit.battle    — the battle.toml -> custom battle-background (BBG) builder (fork/edit/build a 3D battle map)
+"""
+
+__version__ = "1.0.0b3"   # keep in lockstep with [project] version in pyproject.toml

ff9mapkit/__main__.py

@@ -0,0 +1,36 @@
+"""Enable ``python -m ff9mapkit ...`` (identical to the ``ff9mapkit`` console command).
+
+Handy when the package isn't pip-installed on PATH -- run it from the repo:
+    py -m ff9mapkit build my_room.field.toml --out dist
+
+Robustness: running ``python -m ff9mapkit`` from a directory whose child folder is ALSO named
+``ff9mapkit`` (e.g. the repo *parent* that contains the ``ff9mapkit/`` project) makes Python pick
+up that folder as an empty PEP-420 namespace package, shadowing the real install -- so
+``from . import __version__`` blows up with "cannot import name ... (unknown location)". This file
+lives at the real package's true path, so we detect the shadow and repoint the import there.
+"""
+
+import sys
+from pathlib import Path
+
+
+def _ensure_real_package() -> None:
+    """If ``ff9mapkit`` resolved to a namespace shadow (a folder with no __init__), repoint it at the
+    real package -- the directory holding THIS file -- so the absolute import below loads code."""
+    pkg = sys.modules.get("ff9mapkit")
+    if pkg is not None and getattr(pkg, "__file__", None) is not None:
+        return                                   # already the real, importable package -- nothing to do
+    real_parent = str(Path(__file__).resolve().parent.parent)   # dir that CONTAINS the real ff9mapkit/
+    sys.path.insert(0, real_parent)
+    for name in [m for m in sys.modules if m == "ff9mapkit" or m.startswith("ff9mapkit.")]:
+        if name != __name__:                     # keep this running module
+            del sys.modules[name]
+    import importlib
+    importlib.invalidate_caches()
+
+
+_ensure_real_package()
+from ff9mapkit.cli import main      # noqa: E402  (must follow the sys.path repair above)
+
+if __name__ == "__main__":
+    sys.exit(main())