jaclang 0.8.7__py3-none-any.whl → 0.8.9__py3-none-any.whl

jaclang/utils/helpers.py

@@ -94,12 +94,19 @@ def auto_generate_refs() -> str:
         os.path.split(os.path.dirname(__file__))[0], "../jaclang/compiler/jac.lark"
     )
     result = extract_headings(file_path)
-    md_str = '# Jac Language Reference\n\n--8<-- "jac/examples/reference/introduction.md"\n\n'
+
+    # Create the reference subdirectory if it doesn't exist
+    docs_ref_dir = os.path.join(
+        os.path.split(os.path.dirname(__file__))[0], "../../docs/docs/learn/jac_ref"
+    )
+    os.makedirs(docs_ref_dir, exist_ok=True)
+
+    # Generate individual markdown files for each section
     for heading, lines in result.items():
         heading = heading.strip()
         heading_snakecase = heading_to_snake(heading)
         content = (
-            f'## {heading}\n**Code Example**\n!!! example "Runnable Example in Jac and JacLib"\n'
+            f'# {heading}\n\n**Code Example**\n!!! example "Runnable Example in Jac and JacLib"\n'
             '    === "Try it!"\n        <div class="code-block">\n'
             "        ```jac\n"
             f'        --8<-- "jac/examples/reference/{heading_snakecase}.jac"\n'
@@ -112,12 +119,21 @@ def auto_generate_refs() -> str:
             '        --8<-- "jac/examples/reference/'
             f'{heading_snakecase}.py"\n        ```\n'
             f'??? info "Jac Grammar Snippet"\n    ```yaml linenums="{lines[0]}"\n    --8<-- '
-            f'"jac/jaclang/compiler/jac.lark:{lines[0]}:{lines[1]}"\n    ```\n'
+            f'"jac/jaclang/compiler/jac.lark:{lines[0]}:{lines[1]}"\n    ```\n\n'
             "**Description**\n\n--8<-- "
             f'"jac/examples/reference/'
             f'{heading_snakecase}.md"\n'
         )
-        md_str += f"{content}\n"
+
+        # Write individual file
+        output_file = os.path.join(docs_ref_dir, f"{heading_snakecase}.md")
+        with open(output_file, "w") as f:
+            f.write(content)
+
+    # Return just the introduction for the main jac_ref.md file
+    md_str = (
+        '# Jac Language Reference\n\n--8<-- "jac/examples/reference/introduction.md"\n'
+    )
     return md_str
 
 
@@ -192,6 +208,37 @@ def dump_traceback(e: Exception) -> str:
     return trace_dump
 
 
+# FIXME: Use a proper color library and/or move this somewhere common to jac stack and use it everywhere.
+# Reference: https://gist.github.com/rene-d/9e584a7dd2935d0f461904b9f2950007
+class ANSIColors:
+    """ANSI color codes."""
+
+    BLACK = "\033[0;30m"
+    RED = "\033[0;31m"
+    GREEN = "\033[0;32m"
+    BROWN = "\033[0;33m"
+    BLUE = "\033[0;34m"
+    PURPLE = "\033[0;35m"
+    CYAN = "\033[0;36m"
+    LIGHT_GRAY = "\033[0;37m"
+    DARK_GRAY = "\033[1;30m"
+    LIGHT_RED = "\033[1;31m"
+    LIGHT_GREEN = "\033[1;32m"
+    YELLOW = "\033[1;33m"
+    LIGHT_BLUE = "\033[1;34m"
+    LIGHT_PURPLE = "\033[1;35m"
+    LIGHT_CYAN = "\033[1;36m"
+    LIGHT_WHITE = "\033[1;37m"
+    BOLD = "\033[1m"
+    FAINT = "\033[2m"
+    ITALIC = "\033[3m"
+    UNDERLINE = "\033[4m"
+    BLINK = "\033[5m"
+    NEGATIVE = "\033[7m"
+    CROSSED = "\033[9m"
+    END = "\033[0m"
+
+
 # TODO: After implementing the TextRange (or simillar named) class to mark a text range
 # refactor the parameter to accept an instace of that text range object.
 def pretty_print_source_location(
@@ -200,6 +247,8 @@ def pretty_print_source_location(
     error_line: int,
     pos_start: int,
     pos_end: int,
+    *,
+    colors: bool = False,
 ) -> str:
     """Pretty print internal method for the pretty_print method."""
     # NOTE: The Line numbers and the column numbers are starts with 1.
@@ -241,7 +290,16 @@ def pretty_print_source_location(
         idx_line_start = idx
         while idx < len(file_source) and file_source[idx] != "\n":
             idx += 1  # Run to the line end.
-        pretty_dump += file_source[idx_line_start:idx]
+
+        if colors and (curr_line == error_line):
+            pretty_dump += (
+                file_source[idx_line_start:pos_start]
+                + f"{ANSIColors.RED}{file_source[pos_start:pos_end]}{ANSIColors.END}"
+                + file_source[pos_end:idx]
+            )
+        else:
+            pretty_dump += file_source[idx_line_start:idx]
+
         pretty_dump += "\n"
 
         if curr_line == error_line:  # Print the current line with indicator.
@@ -252,7 +310,10 @@ def pretty_print_source_location(
                 spaces += "\t" if file_source[idx_pre] == "\t" else " "
 
             err_token_len = pos_end - pos_start
-            pretty_dump += spaces + ("^" * err_token_len) + "\n"
+            underline = "^" * err_token_len
+            if colors:
+                underline = f"{ANSIColors.RED}{underline}{ANSIColors.END}"
+            pretty_dump += spaces + underline + "\n"
 
         if idx == len(file_source):
             break

jaclang/utils/module_resolver.py

@@ -30,6 +30,16 @@ def get_jac_search_paths(base_path: Optional[str] = None) -> list[str]:
     return list(dict.fromkeys(filter(None, paths)))
 
 
+# TODO: need to be removed once python modules are fully supported in jac
+def get_py_search_paths(base_path: Optional[str] = None) -> list[str]:
+    """Construct a list of paths to search for Python modules."""
+    paths = []
+    if base_path:
+        paths.append(base_path)
+    paths.append(os.getcwd())
+    return list(dict.fromkeys(filter(None, paths)))
+
+
 def _candidate_from(base: str, parts: list[str]) -> Optional[Tuple[str, str]]:
     candidate = os.path.join(base, *parts)
     if os.path.isdir(candidate):

jaclang/utils/test.py

@@ -68,6 +68,14 @@ class TestCase(_TestCase):
         )
         return os.path.abspath(file_path)
 
+    def lang_fixture_abs_path(self, file: str) -> str:
+        """Language fixture abs path."""
+        fixture_src = jaclang.__file__
+        file_path = os.path.join(
+            os.path.dirname(fixture_src), "tests", "fixtures", file
+        )
+        return os.path.abspath(file_path)
+
 
 class TestCaseMicroSuite(TestCase):
     """Base test case for Jaseci."""

jaclang/utils/tests/test_lang_tools.py

@@ -112,7 +112,7 @@ class JacAstToolTests(TestCase):
         """Testing for sym, sym. AstTool."""
         jac_file = os.path.normpath(
             os.path.join(
-                os.path.dirname(jaclang.__file__), "../examples/reference/atom.jac"
+                os.path.dirname(jaclang.__file__), "../examples/reference/while_statements.jac"
             )
         )
         out = self.tool.ir(["sym", jac_file])
@@ -122,25 +122,14 @@ class JacAstToolTests(TestCase):
         )
         check_list = [
             "########",
-            "# atom #",
+            "# while_statements #",
             "########",
-            "SymTable::Module(atom)",
-            "|   +-- list1",
-            "|   +-- x",
-            "|   +-- impl.x",
-            "|   +-- c",
-            "|   +-- d",
-            "|   +-- a",
-            "|   +-- b",
-            "+-- SymTable::ImplDef(impl.x)",
-            " SymTable::Enum(x)",
-            "+-- line 19, col 13",
+            "SymTable::Module(while_statements)",
         ]
         for i in check_list:
             self.assertIn(i, out)
         out = self.tool.ir(["sym.", jac_file])
-        self.assertIn('[label="impl.x"];', out)
-        self.assertNotIn('[label="str"];', out)
+        self.assertIn('[label="', out)
 
     def test_uninode_doc(self) -> None:
         """Testing for Autodoc for Uninodes."""

jaclang/utils/treeprinter.py

@@ -391,20 +391,6 @@ def _build_symbol_tree_common(
     children = SymbolTree(node_name="Sub Tables", parent=root)
 
     syms_to_iterate = set(node.names_in_scope.values())
-    for inhrited_symtab in node.inherited_scope:
-        for inhrited_sym in inhrited_symtab.symbols:
-            sym = inhrited_symtab.lookup(inhrited_sym)
-            assert sym is not None
-            syms_to_iterate.add(sym)
-
-    for stab in node.inherited_scope:
-        if stab.load_all_symbols:
-            syms_to_iterate.update(list(stab.base_symbol_table.names_in_scope.values()))
-        else:
-            for sname in stab.symbols:
-                sym = stab.base_symbol_table.lookup(sname)
-                assert sym is not None
-                syms_to_iterate.add(sym)
 
     for sym in syms_to_iterate:
         symbol_node = SymbolTree(node_name=f"{sym.sym_name}", parent=symbols)
@@ -437,10 +423,6 @@ def _build_symbol_tree_common(
             continue
         _build_symbol_tree_common(k, children)
 
-    for k2 in node.inherited_scope:
-        if k2.base_symbol_table.scope_name == "builtins":
-            continue
-        _build_symbol_tree_common(k2.base_symbol_table, children)
     return root
 
 

{jaclang-0.8.7.dist-info → jaclang-0.8.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jaclang
-Version: 0.8.7
+Version: 0.8.9
 Summary: Jac is a unique and powerful programming language that runs on top of Python, offering an unprecedented level of intelligence and intuitive understanding.
 License: MIT
 Keywords: jac,jaclang,jaseci,python,programming-language,machine-learning,artificial-intelligence
@@ -19,7 +19,6 @@ Provides-Extra: all
 Provides-Extra: cloud
 Provides-Extra: llm
 Provides-Extra: streamlit
-Requires-Dist: mypy (>=1.15.0,<2.0.0)
 Project-URL: Documentation, https://jac-lang.org
 Project-URL: Homepage, https://jaseci.org
 Project-URL: Repository, https://github.com/Jaseci-Labs/jaclang