scitex 2.5.0__py3-none-any.whl → 2.7.3__py3-none-any.whl

scitex/str/_latex.py

@@ -24,25 +24,25 @@ from ._latex_fallback import safe_latex_render, latex_fallback_decorator
 def to_latex_style(str_or_num):
     """
     Convert string or number to LaTeX math mode format with fallback.
-    
+
     Parameters
     ----------
     str_or_num : str or numeric
         Input to format in LaTeX style
-        
+
     Returns
     -------
     str
         LaTeX-formatted string with automatic fallback
-        
+
     Examples
     --------
     >>> to_latex_style('aaa')
     '$aaa$'
-    
+
     >>> to_latex_style('alpha')  # Falls back to unicode if LaTeX fails
     'α'
-    
+
     Notes
     -----
     If LaTeX rendering fails (e.g., due to missing fonts or Node.js conflicts),
@@ -50,9 +50,9 @@ def to_latex_style(str_or_num):
     """
     if not str_or_num and str_or_num != 0:  # Handle empty string case
         return ""
-    
+
     string = str(str_or_num)
-    
+
     # Avoid double-wrapping
     if len(string) >= 2 and string[0] == "$" and string[-1] == "$":
         return safe_latex_render(string)
@@ -65,25 +65,25 @@ def to_latex_style(str_or_num):
 def add_hat_in_latex_style(str_or_num):
     """
     Add LaTeX hat notation to string with fallback.
-    
+
     Parameters
     ----------
     str_or_num : str or numeric
         Input to format with hat notation
-        
+
     Returns
     -------
     str
         LaTeX-formatted string with hat notation and automatic fallback
-        
+
     Examples
     --------
     >>> add_hat_in_latex_style('aaa')
     '$\\hat{aaa}$'
-    
+
     >>> add_hat_in_latex_style('x')  # Falls back to unicode if LaTeX fails
     'x̂'
-    
+
     Notes
     -----
     If LaTeX rendering fails, this function falls back to unicode hat
@@ -91,7 +91,7 @@ def add_hat_in_latex_style(str_or_num):
     """
     if not str_or_num and str_or_num != 0:  # Handle empty string case
         return ""
-    
+
     hat_latex = r"\hat{%s}" % str_or_num
     latex_string = to_latex_style(hat_latex)
     return safe_latex_render(latex_string)
@@ -100,14 +100,14 @@ def add_hat_in_latex_style(str_or_num):
 def safe_to_latex_style(str_or_num, fallback_strategy="auto"):
     """
     Safe version of to_latex_style with explicit fallback control.
-    
+
     Parameters
     ----------
     str_or_num : str or numeric
         Input to format in LaTeX style
     fallback_strategy : str, optional
         Explicit fallback strategy: "auto", "mathtext", "unicode", "plain"
-        
+
     Returns
     -------
     str
@@ -115,7 +115,7 @@ def safe_to_latex_style(str_or_num, fallback_strategy="auto"):
     """
     if not str_or_num and str_or_num != 0:
         return ""
-    
+
     string = str(str_or_num)
     if len(string) >= 2 and string[0] == "$" and string[-1] == "$":
         return safe_latex_render(string, fallback_strategy)
@@ -127,14 +127,14 @@ def safe_to_latex_style(str_or_num, fallback_strategy="auto"):
 def safe_add_hat_in_latex_style(str_or_num, fallback_strategy="auto"):
     """
     Safe version of add_hat_in_latex_style with explicit fallback control.
-    
+
     Parameters
     ----------
     str_or_num : str or numeric
         Input to format with hat notation
     fallback_strategy : str, optional
         Explicit fallback strategy: "auto", "mathtext", "unicode", "plain"
-        
+
     Returns
     -------
     str
@@ -142,7 +142,7 @@ def safe_add_hat_in_latex_style(str_or_num, fallback_strategy="auto"):
     """
     if not str_or_num and str_or_num != 0:
         return ""
-    
+
     hat_latex = r"\hat{%s}" % str_or_num
     latex_string = safe_to_latex_style(hat_latex, fallback_strategy)
     return latex_string

scitex/str/_latex_fallback.py

@@ -5,6 +5,7 @@
 # ----------------------------------------
 from __future__ import annotations
 import os
+
 __FILE__ = __file__
 __DIR__ = os.path.dirname(__FILE__)
 # ----------------------------------------
@@ -38,18 +39,22 @@ from typing import Any, Callable, Dict
 
 # matplotlib imports moved to functions that need them
 
+
 # Delay logging import to avoid circular dependency
 # scitex.logging imports _Tee which imports scitex.str which imports this file
 def _get_logger():
     """Get logger lazily to avoid circular import."""
     from scitex import logging
+
     return logging.getLogger(__name__)
 
+
 # Use property-like access for logger
 class _LoggerProxy:
     def __getattr__(self, name):
         return getattr(_get_logger(), name)
 
+
 logger = _LoggerProxy()
 
 # Global state for LaTeX capability
@@ -485,23 +490,16 @@ def latex_fallback_decorator(
                     "ghostscript",
                 ]
 
-                if any(
-                    indicator in error_str
-                    for indicator in latex_error_indicators
-                ):
+                if any(indicator in error_str for indicator in latex_error_indicators):
                     logger.warning(f"LaTeX error in {func.__name__}: {e}")
-                    logger.warning(
-                        "Falling back to alternative text rendering"
-                    )
+                    logger.warning("Falling back to alternative text rendering")
 
                     # Try to apply fallback to string arguments
                     new_args = []
                     for arg in args:
                         if isinstance(arg, str):
                             new_args.append(
-                                safe_latex_render(
-                                    arg, fallback_strategy, preserve_math
-                                )
+                                safe_latex_render(arg, fallback_strategy, preserve_math)
                             )
                         else:
                             new_args.append(arg)
@@ -575,4 +573,5 @@ def reset_latex_cache() -> None:
     global _latex_available
     _latex_available = None
 
+
 # EOF

scitex/str/_parse.py

@@ -4,6 +4,7 @@
 # File: /ssh:sp:/home/ywatanabe/proj/scitex_repo/src/scitex/str/_parse.py
 # ----------------------------------------
 import os
+
 __FILE__ = __file__
 __DIR__ = os.path.dirname(__FILE__)
 # ----------------------------------------
@@ -80,9 +81,7 @@ def parse(
         errors.append(str(e))
         # logging.warning(f"Second attempt failed: {e}")
 
-    raise ValueError(
-        f"Parsing failed in both directions: {' | '.join(errors)}"
-    )
+    raise ValueError(f"Parsing failed in both directions: {' | '.join(errors)}")
 
 
 def _parse(string: str, expression: str) -> Dict[str, Union[str, int]]:
@@ -138,9 +137,7 @@ def _parse(string: str, expression: str) -> Dict[str, Union[str, int]]:
 
     for placeholder, value in zip(placeholders, groups):
         if placeholder in result and result[placeholder] != value:
-            raise ValueError(
-                f"Inconsistent values for placeholder '{placeholder}'"
-            )
+            raise ValueError(f"Inconsistent values for placeholder '{placeholder}'")
 
         # Try to convert to int if it looks like a number
         if value.lstrip("-").isdigit():

scitex/str/_print_debug.py

@@ -45,19 +45,19 @@ def print_debug():
     """
     printc(
         (
-            f"{'!'*60}\n"
-            f"{'!'*60}\n"
-            f"{'!'*60}\n"
-            f"{'!'*60}\n"
-            f"{'!'*60}\n"
-            f"{'!'*60}\n"
-            f"{'!'*24} DEBUG MODE {'!'*24}\n"
-            f"{'!'*60}\n"
-            f"{'!'*60}\n"
-            f"{'!'*60}\n"
-            f"{'!'*60}\n"
-            f"{'!'*60}\n"
-            f"{'!'*60}"
+            f"{'!' * 60}\n"
+            f"{'!' * 60}\n"
+            f"{'!' * 60}\n"
+            f"{'!' * 60}\n"
+            f"{'!' * 60}\n"
+            f"{'!' * 60}\n"
+            f"{'!' * 24} DEBUG MODE {'!' * 24}\n"
+            f"{'!' * 60}\n"
+            f"{'!' * 60}\n"
+            f"{'!' * 60}\n"
+            f"{'!' * 60}\n"
+            f"{'!' * 60}\n"
+            f"{'!' * 60}"
         ),
         c="yellow",
         char="!",

scitex/str/_printc.py

@@ -4,6 +4,7 @@
 # File: /ssh:sp:/home/ywatanabe/proj/SciTeX-Code/src/scitex/str/_printc.py
 # ----------------------------------------
 import os
+
 __FILE__ = __file__
 __DIR__ = os.path.dirname(__FILE__)
 # ----------------------------------------
@@ -57,4 +58,5 @@ def printc(message, c="blue", char="-", n=40):
 
     print(text)
 
+
 # EOF

scitex/str/_search.py

@@ -112,9 +112,9 @@ def search(
     keys_matched = list(np.array(strings)[indices_matched])
 
     if ensure_one:
-        assert (
-            len(indices_matched) == 1
-        ), "Expected exactly one match, but found {}".format(len(indices_matched))
+        assert len(indices_matched) == 1, (
+            "Expected exactly one match, but found {}".format(len(indices_matched))
+        )
 
     if as_bool:
         bool_matched = np.zeros(len(strings), dtype=bool)

scitex/template/.legacy/_clone_project.py

@@ -5,9 +5,8 @@
 # ----------------------------------------
 from __future__ import annotations
 import os
-__FILE__ = (
-    "./src/scitex/template/_clone_project.py"
-)
+
+__FILE__ = "./src/scitex/template/_clone_project.py"
 __DIR__ = os.path.dirname(__FILE__)
 # ----------------------------------------
 
@@ -95,9 +94,7 @@ def _rename_template_package(
         tests_template_dir.rename(tests_new_dir)
 
     # Update file contents
-    logger.info(
-        f"Updating references from {template_package_name} to {project_name}"
-    )
+    logger.info(f"Updating references from {template_package_name} to {project_name}")
 
     # Files that typically contain package name references
     files_to_update = [
@@ -119,9 +116,7 @@ def _rename_template_package(
                 content = f.read()
 
             # Replace template package name with project name
-            updated_content = content.replace(
-                template_package_name, project_name
-            )
+            updated_content = content.replace(template_package_name, project_name)
 
             # Only write if content changed
             if updated_content != content:
@@ -184,9 +179,7 @@ def clone_project(
             )
             return False
 
-        logger.info(
-            f"Creating new project from {template_name}: {project_name}"
-        )
+        logger.info(f"Creating new project from {template_name}: {project_name}")
         logger.info(f"Target directory: {target_path}")
 
         # Create temporary directory for cloning
@@ -205,7 +198,9 @@ def clone_project(
             # Handle git directory based on strategy
             git_dir = temp_path / ".git"
             if git_strategy == "origin" and git_dir.exists():
-                logger.info("Using 'origin' git strategy, preserving template git history...")
+                logger.info(
+                    "Using 'origin' git strategy, preserving template git history..."
+                )
             else:
                 if git_dir.exists():
                     shutil.rmtree(git_dir)
@@ -268,4 +263,5 @@ def clone_project(
         logger.error(f"Failed to create project: {str(e)}")
         return False
 
+
 # EOF

scitex/template/__init__.py

@@ -9,8 +9,16 @@ Template management for SciTeX projects.
 from .clone_research import clone_research, TEMPLATE_REPO_URL as RESEARCH_URL
 from .clone_pip_project import clone_pip_project, TEMPLATE_REPO_URL as PIP_PROJECT_URL
 from .clone_singularity import clone_singularity, TEMPLATE_REPO_URL as SINGULARITY_URL
-from .clone_writer_directory import clone_writer_directory, TEMPLATE_REPO_URL as PAPER_DIRECTORY_URL
-from scitex.git import init_git_repo, find_parent_git, create_child_git, remove_child_git
+from .clone_writer_directory import (
+    clone_writer_directory,
+    TEMPLATE_REPO_URL as PAPER_DIRECTORY_URL,
+)
+from scitex.git import (
+    init_git_repo,
+    find_parent_git,
+    create_child_git,
+    remove_child_git,
+)
 
 
 def get_available_templates_info():

scitex/template/_clone_project.py

@@ -5,6 +5,7 @@
 # ----------------------------------------
 from __future__ import annotations
 import os
+
 __FILE__ = "./src/scitex/template/_clone_project.py"
 __DIR__ = os.path.dirname(__FILE__)
 # ----------------------------------------
@@ -84,7 +85,9 @@ def clone_project(
         # Parse project_dir into name and parent directory
         project_path = Path(project_dir)
         project_name = project_path.name
-        target_dir_path = project_path.parent if project_path.parent != Path('.') else Path.cwd()
+        target_dir_path = (
+            project_path.parent if project_path.parent != Path(".") else Path.cwd()
+        )
         target_path = target_dir_path / project_name
 
         # Check if target directory already exists
@@ -116,7 +119,9 @@ def clone_project(
 
                 # Clone the template repository
                 ctx.substep(f"Cloning from {template_url}{ref_info}...")
-                if not scitex.git.clone_repo(template_url, temp_path, branch=branch, tag=tag, verbose=False):
+                if not scitex.git.clone_repo(
+                    template_url, temp_path, branch=branch, tag=tag, verbose=False
+                ):
                     ctx.step(f"Failed to clone to {target_path}", success=False)
                     return False
                 ctx.step(f"Cloned to {target_path}")

scitex/template/_copy.py

@@ -5,6 +5,7 @@
 # ----------------------------------------
 from __future__ import annotations
 import os
+
 __FILE__ = "./src/scitex/template/_copy.py"
 __DIR__ = os.path.dirname(__FILE__)
 # ----------------------------------------

scitex/template/_customize.py

@@ -5,6 +5,7 @@
 # ----------------------------------------
 from __future__ import annotations
 import os
+
 __FILE__ = "./src/scitex/template/_customize.py"
 __DIR__ = os.path.dirname(__FILE__)
 # ----------------------------------------
@@ -88,9 +89,7 @@ def update_references(
     int
         Number of files updated
     """
-    logger.debug(
-        f"Updating references from {template_package_name} to {new_name}"
-    )
+    logger.debug(f"Updating references from {template_package_name} to {new_name}")
 
     # Files that typically contain package name references
     files_to_update = [
@@ -106,9 +105,7 @@ def update_references(
     updated_count = 0
     for file_path in files_to_update:
         if update_file_references(file_path, template_package_name, new_name):
-            logger.debug(
-                f"Updated references in {file_path.relative_to(target_path)}"
-            )
+            logger.debug(f"Updated references in {file_path.relative_to(target_path)}")
             updated_count += 1
 
     return updated_count

scitex/template/_git_strategy.py

@@ -5,6 +5,7 @@
 # ----------------------------------------
 from __future__ import annotations
 import os
+
 __FILE__ = "./src/scitex/template/_git_strategy.py"
 __DIR__ = os.path.dirname(__FILE__)
 # ----------------------------------------
@@ -81,9 +82,7 @@ def apply_git_strategy(
         logger.debug("Using 'origin' git strategy, preserving template git history")
         git_dir = project_path / ".git"
         if not git_dir.exists():
-            logger.warning(
-                "No .git directory found, cannot preserve origin history"
-            )
+            logger.warning("No .git directory found, cannot preserve origin history")
         return
 
     # Git initialization group

scitex/template/_rename.py

@@ -5,6 +5,7 @@
 # ----------------------------------------
 from __future__ import annotations
 import os
+
 __FILE__ = "./src/scitex/template/_rename.py"
 __DIR__ = os.path.dirname(__FILE__)
 # ----------------------------------------

scitex/template/clone_pip_project.py

@@ -5,9 +5,8 @@
 # ----------------------------------------
 from __future__ import annotations
 import os
-__FILE__ = (
-    "./src/scitex/template/clone_pip_project.py"
-)
+
+__FILE__ = "./src/scitex/template/clone_pip_project.py"
 __DIR__ = os.path.dirname(__FILE__)
 # ----------------------------------------
 
@@ -82,13 +81,13 @@ def main(args: list = None) -> None:
         args = sys.argv[1:]
 
     if len(args) < 1:
-        print(
-            "Usage: python -m scitex clone_pip_project <project-dir>"
-        )
+        print("Usage: python -m scitex clone_pip_project <project-dir>")
         print("")
         print("Arguments:")
         print("  project-dir   Path to project directory (will be created)")
-        print("                Can be a simple name like 'my_project' or a full path like './projects/my_project'")
+        print(
+            "                Can be a simple name like 'my_project' or a full path like './projects/my_project'"
+        )
         print("")
         print("Example:")
         print("  python -m scitex clone_pip_project my_pip_project")

scitex/template/clone_research.py

@@ -5,9 +5,8 @@
 # ----------------------------------------
 from __future__ import annotations
 import os
-__FILE__ = (
-    "./src/scitex/template/clone_research.py"
-)
+
+__FILE__ = "./src/scitex/template/clone_research.py"
 __DIR__ = os.path.dirname(__FILE__)
 # ----------------------------------------
 
@@ -20,9 +19,7 @@ from typing import Optional
 
 from ._clone_project import clone_project
 
-TEMPLATE_REPO_URL = (
-    "https://github.com/ywatanabe1989/scitex-research-template.git"
-)
+TEMPLATE_REPO_URL = "https://github.com/ywatanabe1989/scitex-research-template.git"
 
 
 def clone_research(
@@ -84,13 +81,13 @@ def main(args: list = None) -> None:
         args = sys.argv[1:]
 
     if len(args) < 1:
-        print(
-            "Usage: python -m scitex clone_research_project <project-dir>"
-        )
+        print("Usage: python -m scitex clone_research_project <project-dir>")
         print("")
         print("Arguments:")
         print("  project-dir   Path to project directory (will be created)")
-        print("                Can be a simple name like 'my_project' or a full path like './projects/my_project'")
+        print(
+            "                Can be a simple name like 'my_project' or a full path like './projects/my_project'"
+        )
         print("")
         print("Example:")
         print("  python -m scitex clone_research_project my_research_project")

scitex/template/clone_singularity.py

@@ -5,9 +5,8 @@
 # ----------------------------------------
 from __future__ import annotations
 import os
-__FILE__ = (
-    "./src/scitex/template/clone_singularity.py"
-)
+
+__FILE__ = "./src/scitex/template/clone_singularity.py"
 __DIR__ = os.path.dirname(__FILE__)
 # ----------------------------------------
 
@@ -82,13 +81,13 @@ def main(args: list = None) -> None:
         args = sys.argv[1:]
 
     if len(args) < 1:
-        print(
-            "Usage: python -m scitex clone_singularity_project <project-dir>"
-        )
+        print("Usage: python -m scitex clone_singularity_project <project-dir>")
         print("")
         print("Arguments:")
         print("  project-dir   Path to project directory (will be created)")
-        print("                Can be a simple name like 'my_project' or a full path like './projects/my_project'")
+        print(
+            "                Can be a simple name like 'my_project' or a full path like './projects/my_project'"
+        )
         print("")
         print("Example:")
         print("  python -m scitex clone_singularity_project my_singularity_project")

scitex/template/clone_writer_directory.py

@@ -5,9 +5,8 @@
 # ----------------------------------------
 from __future__ import annotations
 import os
-__FILE__ = (
-    "./src/scitex/template/clone_writer_directory.py"
-)
+
+__FILE__ = "./src/scitex/template/clone_writer_directory.py"
 __DIR__ = os.path.dirname(__FILE__)
 # ----------------------------------------
 
@@ -82,13 +81,13 @@ def main(args: list = None) -> None:
         args = sys.argv[1:]
 
     if len(args) < 1:
-        print(
-            "Usage: python -m scitex clone_writer_directory <project-dir>"
-        )
+        print("Usage: python -m scitex clone_writer_directory <project-dir>")
         print("")
         print("Arguments:")
         print("  project-dir   Path to project directory (will be created)")
-        print("                Can be a simple name like 'my_paper' or a full path like './papers/my_paper'")
+        print(
+            "                Can be a simple name like 'my_paper' or a full path like './papers/my_paper'"
+        )
         print("")
         print("Example:")
         print("  python -m scitex clone_writer_directory my_paper")

scitex/tex/__init__.py

@@ -1,10 +1,14 @@
 #!/usr/bin/env python3
 """LaTeX utilities module for scitex."""
 
+from ._export import export_tex, compile_tex, CompileResult
 from ._preview import preview
 from ._to_vec import to_vec
 
 __all__ = [
+    "export_tex",
+    "compile_tex",
+    "CompileResult",
     "preview",
     "to_vec",
 ]