python-color-math 0.2.17__tar.gz → 0.2.18__tar.gz

{python_color_math-0.2.17/python_color_math.egg-info → python_color_math-0.2.18}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-color-math
-Version: 0.2.17
+Version: 0.2.18
 Summary: A fast, local semantic LaTeX colorizer for Markdown, Jupyter, and LaTeX math equations.
 Author: Aditya
 License: MIT License

{python_color_math-0.2.17 → python_color_math-0.2.18}/color_math/__init__.py

@@ -1,13 +1,13 @@
 """Public helpers for converting Obsidian LaTeX color markup."""
 
 from .adapters import detect_format, transform_document
-from .config import ColorMathOptions
+from .config import ColorMathOptions, ensure_global_config_exists, open_config_folder
 from .converters.block import convert_text
 from .undo import uncolor_text
 
 from .ipython import ColorMath, colormath, load_ipython_extension, unload_ipython_extension
 
-__version__ = "0.2.17"
+__version__ = "0.2.18"
 
 __all__ = [
     "__version__",
@@ -16,7 +16,9 @@ __all__ = [
     "colormath",
     "convert_text",
     "detect_format",
+    "ensure_global_config_exists",
     "load_ipython_extension",
+    "open_config_folder",
     "transform_document",
     "uncolor_text",
     "unload_ipython_extension",

{python_color_math-0.2.17 → python_color_math-0.2.18}/color_math/config.py

@@ -730,6 +730,61 @@ def get_global_config_path() -> Path | None:
     return None
 
 
+def ensure_global_config_exists() -> Path | None:
+    """Ensure that the global configuration file and folder exist on disk.
+
+    Creates the directory and saves the documented default configuration if it
+    does not already exist. Returns the Path to the global config.
+    """
+    path = get_global_config_path()
+    if path is None:
+        return None
+    if not path.exists():
+        try:
+            path.parent.mkdir(parents=True, exist_ok=True)
+            save_default_config(path)
+        except OSError:
+            pass
+    return path
+
+
+def open_config_folder(path: Path | None = None) -> bool:
+    """Open the configuration folder in the operating system's file manager."""
+    target = path
+    if target is None:
+        local_candidate = Path(".colormath.json")
+        if local_candidate.exists():
+            target = local_candidate
+        else:
+            target = ensure_global_config_exists() or get_global_config_path()
+
+    if target is None:
+        return False
+
+    folder = target.parent if target.suffix else target
+    try:
+        folder.mkdir(parents=True, exist_ok=True)
+        if not target.exists() and target.suffix == ".json":
+            save_default_config(target)
+    except OSError:
+        pass
+
+    try:
+        if sys.platform == "win32":
+            os.startfile(folder)
+            return True
+        elif sys.platform == "darwin":
+            import subprocess
+            subprocess.run(["open", str(folder)], check=False)
+            return True
+        else:
+            import subprocess
+            subprocess.run(["xdg-open", str(folder)], check=False)
+            return True
+    except Exception:
+        return False
+
+
 DEFAULT_UNICODE_CONFIG: dict[str, object] = {
     "greek_style": "plane1",
     "convert_definite_integrals": False,
@@ -781,7 +836,7 @@ def load_config(
         if local_candidate.exists():
             target = local_candidate
         else:
-            global_candidate = get_global_config_path()
+            global_candidate = ensure_global_config_exists()
             if global_candidate and global_candidate.exists():
                 target = global_candidate
 

{python_color_math-0.2.17 → python_color_math-0.2.18}/color_math/ipython.py

@@ -16,6 +16,8 @@ from .config import (
     THEMES,
     load_config,
     get_global_config_path,
+    ensure_global_config_exists,
+    open_config_folder,
     save_default_config,
 )
 from .converters.block import convert_math_block, convert_text
@@ -191,14 +193,22 @@ if HAS_IPYTHON:
                 save_default_config(target)
                 print(f"Color Math: Created config template at '{target.resolve()}'.")
                 self._palette, self._options, _ = load_config(target)
+            raw = line.strip().lower()
+            if raw in ("open", "--open", "explore", "folder"):
+                opened = open_config_folder()
+                if opened:
+                    print("Color Math: Opened configuration folder in file manager.")
+                else:
+                    print("Color Math: Could not open configuration folder automatically.")
                 return
-            if "--reload" in raw:
+
+            if "--reload" in raw or raw == "reload":
                 self._palette, self._options, _ = load_config()
                 print("Color Math: Configuration reloaded.")
                 return
 
             local_path = Path(".colormath.json")
-            global_path = get_global_config_path()
+            global_path = ensure_global_config_exists() or get_global_config_path()
             print("Color Math Configuration:")
             print(f"  Local config:  {local_path.resolve()} ({'exists' if local_path.exists() else 'not found'})")
             if global_path:
@@ -207,6 +217,7 @@ if HAS_IPYTHON:
             print(f"  Taxonomy:      {'ENABLED' if self._options.enable_taxonomy else 'DISABLED'}")
             print(f"  Delimiters:    {'ENABLED' if self._options.rainbow_delimiters else 'DISABLED'}")
             print(f"  Auto-display:  {'ENABLED' if self._auto_hook_active else 'DISABLED'}")
+            print("\nTip: Run '%color_math_config open' to open the configuration folder in your file manager.")
 
         @line_magic("color_math_auto")
         def color_math_auto(self, line: str) -> None:

{python_color_math-0.2.17 → python_color_math-0.2.18}/color_math/main.py

@@ -227,6 +227,11 @@ def build_parser() -> argparse.ArgumentParser:
         const=".colormath.json",
         help="Generate a .colormath.json config template (optional target path).",
     )
+    style_group.add_argument(
+        "--open-config",
+        action="store_true",
+        help="Open configuration folder in system file manager.",
+    )
     style_group.add_argument(
         "--config",
         type=Path,
@@ -590,6 +595,11 @@ def _main_impl(argv: list[str] | None = None) -> int:
         sys.stdout.write(f"Created configuration file: {cfg_path}\n")
         return 0
 
+    if args.open_config:
+        from .config import open_config_folder
+        open_config_folder(args.config)
+        return 0
+
     # 3. Load base configuration & theme
     palette, config_options, unicode_config = load_config(args.config)
     if args.theme:

{python_color_math-0.2.17 → python_color_math-0.2.18}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-color-math"
-version = "0.2.17"
+version = "0.2.18"
 description = "A fast, local semantic LaTeX colorizer for Markdown, Jupyter, and LaTeX math equations."
 readme = "README.md"
 requires-python = ">=3.10"

{python_color_math-0.2.17 → python_color_math-0.2.18/python_color_math.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-color-math
-Version: 0.2.17
+Version: 0.2.18
 Summary: A fast, local semantic LaTeX colorizer for Markdown, Jupyter, and LaTeX math equations.
 Author: Aditya
 License: MIT License