pyact-cli 0.6.0__tar.gz → 0.7.0__tar.gz

{pyact_cli-0.6.0 → pyact_cli-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyact-cli
-Version: 0.6.0
+Version: 0.7.0
 Summary: A CLI tool to compile .pamd files to Markdown.
 Home-page: https://github.com/Abstergo2003/PyAct
 Author: Abstergo2003
@@ -68,7 +68,19 @@ You can also include other pamd files as templates!
 <tmp>path/to/another_file</tmp>
 ```
 
-### 3. Compile to Markdown
+### 3. Use Global Variables `<glb>`
+If you have data you want to access everywhere across multiple nested files (like an author name or project ID), simply create a `global.py` file in your root folder:
+
+```python
+def global_context():
+    return {"author": "Jane Doe"}
+```
+You can then inject this data into any Markdown cell using the `<glb>` tag!
+```markdown
+Written by <glb>author</glb>
+```
+
+### 4. Compile to Markdown
 Run the compiler from your terminal to generate your final Markdown document:
 ```bash
 pyact path/to/your_file.pamd -o output.md

{pyact_cli-0.6.0 → pyact_cli-0.7.0}/README.md

@@ -45,7 +45,19 @@ You can also include other pamd files as templates!
 <tmp>path/to/another_file</tmp>
 ```
 
-### 3. Compile to Markdown
+### 3. Use Global Variables `<glb>`
+If you have data you want to access everywhere across multiple nested files (like an author name or project ID), simply create a `global.py` file in your root folder:
+
+```python
+def global_context():
+    return {"author": "Jane Doe"}
+```
+You can then inject this data into any Markdown cell using the `<glb>` tag!
+```markdown
+Written by <glb>author</glb>
+```
+
+### 4. Compile to Markdown
 Run the compiler from your terminal to generate your final Markdown document:
 ```bash
 pyact path/to/your_file.pamd -o output.md

pyact_cli-0.7.0/pyact/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.6.1"

{pyact_cli-0.6.0 → pyact_cli-0.7.0}/pyact/cli.py

@@ -1,9 +1,15 @@
 import argparse
 import sys
 import os
-from .core import map_content, process_content
+import time
+from .core import map_content, process_content, build_logs
+
+def is_cache_valid(build_tree, cache_mtime, root_dir=None):
+    if root_dir is not None:
+        global_file = os.path.join(root_dir, "global.py")
+        if os.path.exists(global_file) and os.path.getmtime(global_file) > cache_mtime:
+            return False
 
-def is_cache_valid(build_tree, cache_mtime):
     file_path = os.path.join(build_tree.get("path", ""), build_tree.get("name", "") + ".pamd")
     if os.path.exists(file_path) and os.path.getmtime(file_path) > cache_mtime:
         return False
@@ -62,7 +68,7 @@ def main():
         
         if os.path.exists(cache_file):
             cache_mtime = os.path.getmtime(cache_file)
-            if is_cache_valid(build_tree, cache_mtime):
+            if is_cache_valid(build_tree, cache_mtime, directory):
                 use_cache = True
                 
         if use_cache:
@@ -71,12 +77,28 @@ def main():
                 content = f.read()
         else:
             print("pamd-cache: Cache invalid or missing. Rebuilding...")
+            build_logs.clear()
+            
+            total_start = time.perf_counter()
             content = process_content(build_tree)
+            total_end = time.perf_counter()
+            total_ms = (total_end - total_start) * 1000
+            
             # Write cache
             if not os.path.exists(cache_dir):
                 os.makedirs(cache_dir)
             with open(cache_file, "w", encoding="utf-8") as f:
                 f.write(content)
+                
+            # Write build log
+            log_file = os.path.join(cache_dir, "build.log")
+            with open(log_file, "w", encoding="utf-8") as f:
+                f.write("PyAct Build Log\n")
+                f.write("================\n\n")
+                f.write("File Execution Times:\n")
+                for log in build_logs:
+                    f.write(f"- {log['file']}: {log['time_ms']:.2f} ms\n")
+                f.write(f"\nTotal Build Time: {total_ms:.2f} ms\n")
         
         if args.output:
             with open(args.output, "w", encoding="utf-8") as f:

{pyact_cli-0.6.0 → pyact_cli-0.7.0}/pyact/core.py

@@ -1,5 +1,9 @@
 import re
 import json
+import time
+import os
+
+build_logs = []
 
 def get_directory(path: str) -> list:
     """
@@ -94,6 +98,34 @@ def get_imports(file: str, code_text: str):
 
     return result_dict
 
+def get_globals(directory: str):
+    """
+    Reads global.py and executes its global_context() function to get global variables.
+    """
+    global_path = os.path.join(directory, "global.py")
+    if not os.path.exists(global_path):
+        return {}
+        
+    with open(global_path, "r", encoding="utf-8") as f:
+        code_text = f.read()
+        
+    file_namespace = {"__file__": global_path}
+    try:
+        exec(code_text, file_namespace)
+    except Exception as e:
+        raise RuntimeError(f"Error executing global.py: {e}")
+        
+    if "global_context" in file_namespace:
+        func = file_namespace["global_context"]
+    else:
+        raise ValueError("The global.py file must define a 'global_context()' function. (Note: 'global' is a reserved Python keyword!)")
+        
+    res = func()
+    if not isinstance(res, dict):
+        raise TypeError("'global_context()' in global.py must return a dictionary.")
+        
+    return res
+
 def find_imports(text: str):
     """
     Finds all `<ctx>var_name</ctx>` tags in a markdown string.
@@ -111,6 +143,13 @@ def find_imports(text: str):
     return re.findall(pattern, text)
 
 
+def find_globals(text: str):
+    """
+    Finds all `<glb>var_name</glb>` tags in a markdown string.
+    """
+    pattern = r"<glb>(.*?)</glb>"
+    return re.findall(pattern, text)
+
 def find_templates(text: str):
     """
     Finds all `<tmp>file_name</tmp>` tags in a markdown string.
@@ -155,6 +194,7 @@ def map_content(file: str, path: str):
     code_text, main_file = read_pamd_cells(f"{full_path}.pamd")
     templates = find_templates(main_file)
     imports = find_imports(main_file)
+    globals_req = find_globals(main_file)
     meta = get_directory(full_path)
     
     ready_t = []
@@ -166,24 +206,19 @@ def map_content(file: str, path: str):
         "name": meta[1],
         "path": meta[0],
         "imports": imports,
+        "globals": globals_req,
         "templates": ready_t
     }
 
-def process_content(build_tree: dict):
+def process_content(build_tree: dict, globals_dict: dict = None):
     """
     Compiles a mapped build tree into a final flat Markdown string.
+    """
+    start_time = time.perf_counter()
     
-    Why it is needed:
-    This is the core renderer. It reads the `.pamd` files, executes their Python code 
-    to fetch the context dictionary, replaces all `<ctx>` tags with dynamic data, 
-    and recursively replaces all `<tmp>` tags with their fully compiled child documents.
-    
-    Inputs:
-        build_tree (dict): The AST mapping generated by `map_content()`.
+    if globals_dict is None:
+        globals_dict = get_globals(build_tree.get("path", ""))
         
-    Outputs:
-        str: The final, fully compiled Markdown text string ready for export.
-    """
     file_path_base = build_tree.get("path", "") + build_tree.get("name", "")
     code_text, file_text = read_pamd_cells(file_path_base + ".pamd")
     
@@ -192,7 +227,23 @@ def process_content(build_tree: dict):
         imports = get_imports(file_path_base, code_text)
         for i in needed_imports:
             file_text = file_text.replace(f"<ctx>{i}</ctx>", str(imports.get(i, '')))
+            
+    needed_globals = build_tree.get("globals", [])
+    for g in needed_globals:
+        if g in globals_dict:
+            file_text = file_text.replace(f"<glb>{g}</glb>", str(globals_dict[g]))
+        else:
+            raise ValueError(f"Global variable '{g}' requested via <glb> but not found in global.py's global_context().")
 
     for i in build_tree.get("templates", []):
-        file_text = file_text.replace(f"<tmp>{i.get('tag_name')}</tmp>", process_content(i))
+        file_text = file_text.replace(f"<tmp>{i.get('tag_name')}</tmp>", process_content(i, globals_dict))
+        
+    end_time = time.perf_counter()
+    elapsed_ms = (end_time - start_time) * 1000
+    
+    build_logs.append({
+        "file": f"{build_tree.get('name', '')}.pamd",
+        "time_ms": elapsed_ms
+    })
+        
     return file_text

{pyact_cli-0.6.0 → pyact_cli-0.7.0}/pyact_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyact-cli
-Version: 0.6.0
+Version: 0.7.0
 Summary: A CLI tool to compile .pamd files to Markdown.
 Home-page: https://github.com/Abstergo2003/PyAct
 Author: Abstergo2003
@@ -68,7 +68,19 @@ You can also include other pamd files as templates!
 <tmp>path/to/another_file</tmp>
 ```
 
-### 3. Compile to Markdown
+### 3. Use Global Variables `<glb>`
+If you have data you want to access everywhere across multiple nested files (like an author name or project ID), simply create a `global.py` file in your root folder:
+
+```python
+def global_context():
+    return {"author": "Jane Doe"}
+```
+You can then inject this data into any Markdown cell using the `<glb>` tag!
+```markdown
+Written by <glb>author</glb>
+```
+
+### 4. Compile to Markdown
 Run the compiler from your terminal to generate your final Markdown document:
 ```bash
 pyact path/to/your_file.pamd -o output.md

{pyact_cli-0.6.0 → pyact_cli-0.7.0}/pyact_cli.egg-info/SOURCES.txt

@@ -1,8 +1,6 @@
 README.md
 setup.py
 pamd_helpers/__init__.py
-pamd_helpers/conversions.py
-pamd_helpers/unit.py
 pyact/__init__.py
 pyact/cli.py
 pyact/core.py

{pyact_cli-0.6.0 → pyact_cli-0.7.0}/setup.py

@@ -5,7 +5,7 @@ with open("README.md", "r", encoding="utf-8") as fh:
 
 setup(
     name="pyact-cli",
-    version="0.6.0",
+    version="0.7.0",
     author="Abstergo2003",
     author_email="",
     description="A CLI tool to compile .pamd files to Markdown.",

pyact_cli-0.6.0/pamd_helpers/conversions.py

@@ -1,126 +0,0 @@
-"""
-Engineering Unit Conversions for PyAct
-
-A collection of helper functions to seamlessly convert values between 
-Metric (SI) and Imperial / US Customary systems.
-"""
-
-# ==========================================
-# LENGTH CONVERSIONS
-# ==========================================
-
-def mm_to_inch(mm: float) -> float:
-    """Converts millimeters [mm] to inches [in]"""
-    return mm / 25.4
-
-def inch_to_mm(inch: float) -> float:
-    """Converts inches [in] to millimeters [mm]"""
-    return inch * 25.4
-
-def m_to_ft(m: float) -> float:
-    """Converts meters [m] to feet [ft]"""
-    return m * 3.280839895
-
-def ft_to_m(ft: float) -> float:
-    """Converts feet [ft] to meters [m]"""
-    return ft / 3.280839895
-
-# ==========================================
-# AREA & VOLUME CONVERSIONS
-# ==========================================
-
-def mm2_to_in2(mm2: float) -> float:
-    """Converts square millimeters [mm^2] to square inches [in^2]"""
-    return mm2 / 645.16
-
-def in2_to_mm2(in2: float) -> float:
-    """Converts square inches [in^2] to square millimeters [mm^2]"""
-    return in2 * 645.16
-
-def m3_to_ft3(m3: float) -> float:
-    """Converts cubic meters [m^3] to cubic feet [ft^3]"""
-    return m3 * 35.3146667
-
-def ft3_to_m3(ft3: float) -> float:
-    """Converts cubic feet [ft^3] to cubic meters [m^3]"""
-    return ft3 / 35.3146667
-
-# ==========================================
-# MASS & FORCE CONVERSIONS
-# ==========================================
-
-def kg_to_lbs(kg: float) -> float:
-    """Converts kilograms [kg] to pounds-mass [lbs]"""
-    return kg * 2.20462262
-
-def lbs_to_kg(lbs: float) -> float:
-    """Converts pounds-mass [lbs] to kilograms [kg]"""
-    return lbs / 2.20462262
-
-def kn_to_kips(kn: float) -> float:
-    """Converts kilonewtons [kN] to kilopounds-force [kips]"""
-    return kn * 0.224808943
-
-def kips_to_kn(kips: float) -> float:
-    """Converts kilopounds-force [kips] to kilonewtons [kN]"""
-    return kips / 0.224808943
-
-def n_to_lbf(n: float) -> float:
-    """Converts newtons [N] to pounds-force [lbf]"""
-    return n * 0.224808943
-
-def lbf_to_n(lbf: float) -> float:
-    """Converts pounds-force [lbf] to newtons [N]"""
-    return lbf / 0.224808943
-
-# ==========================================
-# PRESSURE & STRESS CONVERSIONS
-# ==========================================
-
-def mpa_to_psi(mpa: float) -> float:
-    """Converts Megapascals [MPa] (or N/mm^2) to pounds per square inch [psi]"""
-    return mpa * 145.037738
-
-def psi_to_mpa(psi: float) -> float:
-    """Converts pounds per square inch [psi] to Megapascals [MPa]"""
-    return psi / 145.037738
-
-def mpa_to_ksi(mpa: float) -> float:
-    """Converts Megapascals [MPa] to kilopounds per square inch [ksi]"""
-    return mpa * 0.145037738
-
-def ksi_to_mpa(ksi: float) -> float:
-    """Converts kilopounds per square inch [ksi] to Megapascals [MPa]"""
-    return ksi / 0.145037738
-
-# ==========================================
-# MOMENT & TORQUE CONVERSIONS
-# ==========================================
-
-def knm_to_kipft(knm: float) -> float:
-    """Converts kilonewton-meters [kNm] to kilopound-feet [kip-ft]"""
-    return knm * 0.737562149
-
-def kipft_to_knm(kipft: float) -> float:
-    """Converts kilopound-feet [kip-ft] to kilonewton-meters [kNm]"""
-    return kipft / 0.737562149
-
-def knm_to_lbfft(knm: float) -> float:
-    """Converts kilonewton-meters [kNm] to pound-force feet [lbf-ft]"""
-    return knm * 737.562149
-
-def lbfft_to_knm(lbfft: float) -> float:
-    """Converts pound-force feet [lbf-ft] to kilonewton-meters [kNm]"""
-    return lbfft / 737.562149
-
-# ==========================================
-# TEMPERATURE CONVERSIONS
-# ==========================================
-
-def c_to_f(celsius: float) -> float:
-    """Converts degrees Celsius [°C] to degrees Fahrenheit [°F]"""
-    return (celsius * 9/5) + 32
-
-def f_to_c(fahrenheit: float) -> float:
-    """Converts degrees Fahrenheit [°F] to degrees Celsius [°C]"""
-    return (fahrenheit - 32) * 5/9

pyact_cli-0.6.0/pamd_helpers/unit.py

@@ -1,43 +0,0 @@
-class Unit:
-    def __init__(self, value: float, unit: str):
-        self.value: float = value
-        self.unit: str = unit
-
-    def __repr__(self) -> str:
-        return f"{self.value} {self.unit}"
-        
-    def _extract(self, other) -> float:
-        return float(other.value) if isinstance(other, Unit) else float(other)
-
-    def __add__(self, other):
-        return float(self.value) + self._extract(other)
-
-    def __radd__(self, other):
-        return self._extract(other) + float(self.value)
-
-    def __sub__(self, other):
-        return float(self.value) - self._extract(other)
-
-    def __rsub__(self, other):
-        return self._extract(other) - float(self.value)
-
-    def __mul__(self, other):
-        return float(self.value) * self._extract(other)
-
-    def __rmul__(self, other):
-        return self._extract(other) * float(self.value)
-
-    def __truediv__(self, other):
-        return float(self.value) / self._extract(other)
-
-    def __rtruediv__(self, other):
-        return self._extract(other) / float(self.value)
-
-    def __pow__(self, power):
-        return float(self.value) ** self._extract(power)
-
-    def __neg__(self):
-        return -float(self.value)
-        
-    def __abs__(self):
-        return abs(float(self.value))

pyact_cli-0.6.0/pyact/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.6.0"