sysmlpy 0.30.1__tar.gz → 0.30.2__tar.gz

{sysmlpy-0.30.1 → sysmlpy-0.30.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sysmlpy
-Version: 0.30.1
+Version: 0.30.2
 Summary: SysML v2.0 Parser
 License: MIT License
          

{sysmlpy-0.30.1 → sysmlpy-0.30.2}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "poetry.core.masonry.api"
 
 [project]
 name = "sysmlpy"
-version = "0.30.1"
+version = "0.30.2"
 description = "SysML v2.0 Parser"
 authors = [
   { name="Jon R. Fox (mycr0ft)", email="jon.fox@drfox.com" },
@@ -114,7 +114,7 @@ build_command = "pip install poetry && poetry build"
 
 [tool.poetry]
 name = "sysmlpy"
-version = "0.30.1"
+version = "0.30.2"
 description = ""
 authors = ["Jon R. Fox (mycr0ft) <jon.fox@drfox.com>"]
 readme = "README.md"

{sysmlpy-0.30.1 → sysmlpy-0.30.2}/src/sysmlpy/__init__.py

@@ -8,7 +8,7 @@ Uses the ANTLR4 parser for full SysML v2 grammar support.
 """
 
 __all__ = [
-    "load", "loads", "load_grammar", "load_antlr", "load_grammar_antlr",
+    "load", "loads", "parse", "load_grammar", "load_antlr", "load_grammar_antlr",
     "load_files", "load_project", "load_with_dependencies",
     "Searchable",
     "Store", "InMemoryStore", "NetworkXStore", "KuzuStore", "CayleyStore", "create_store", "new_id",
@@ -21,7 +21,7 @@ __all__ = [
     "SysMLSyntaxError",
 ]
 __author__ = "Jon Fox"
-__version__ = "0.30.1"
+__version__ = "0.30.2"
 
 from sysmlpy.usage import (
     Item, Attribute, Part, Port, Action, Reference, UseCase, Requirement, Interface, Message,
@@ -156,6 +156,27 @@ def loads(s: str, library=None) -> Model:
     return Model().load(s, library=library)
 
 
+def parse(s: str, library=None):
+    """Parse SysML source, returning (model, errors) rather than raising.
+
+    Parameters
+    ----------
+    s : str
+        The SysML v2 source code to parse.
+    library : str or Path, optional
+        Path to SysML v2 library files for resolving imports.
+
+    Returns
+    -------
+    tuple[Model | None, list[str]]
+        ``(Model, [])`` on success, ``(None, [error_lines])`` on syntax error.
+    """
+    try:
+        return loads(s, library=library), []
+    except SysMLSyntaxError as e:
+        return None, str(e).splitlines()
+
+
 def load_grammar_antlr(fp, debug=False, library=None):
     """SysML load from file pointer using ANTLR4 parser.
 

{sysmlpy-0.30.1 → sysmlpy-0.30.2}/src/sysmlpy/definition.py

@@ -203,7 +203,7 @@ class Model(Searchable):
         """
         return self.grammar.get_definition()
 
-    def dump(self):
+    def dump(self) -> str:
         """Serialize the model to SysML v2 textual notation.
 
         Returns
@@ -300,6 +300,8 @@ class Model(Searchable):
                 else:
                     return child._get_child(featurechain)
 
+    get_child = _get_child
+
     # ── Convenience functions ───────────────────────────────────────────
 
     def find_all(self, type=None, name=None):
@@ -476,6 +478,8 @@ class Package(Searchable):
 
         return self
 
+    set_name = _set_name
+
     def _get_name(self):
         """Retrieve the declared name from the package grammar.
 
@@ -550,6 +554,8 @@ class Package(Searchable):
                 else:
                     return child._get_child(featurechain)
 
+    get_child = _get_child
+
     def _ensure_body(self):
         """Rebuild the package grammar body from current children and imports.
 
@@ -613,7 +619,7 @@ class Package(Searchable):
 
         return package
 
-    def dump(self, child=None):
+    def dump(self, child=None) -> str:
         """Serialize the package to SysML v2 textual notation.
 
         Parameters

{sysmlpy-0.30.1 → sysmlpy-0.30.2}/src/sysmlpy/navigate.py

@@ -188,7 +188,7 @@ class Searchable:
     # Search methods
     # ------------------------------------------------------------------
 
-    def find(self, name=None, *, sysml_type=None, type=None, recursive=True):
+    def find(self, name=None, *, sysml_type=None, type=None, recursive=True) -> "list[Searchable]":
         """Find model elements by name and/or SysML type.
 
         Parameters
@@ -262,7 +262,7 @@ class Searchable:
 
         return results
 
-    def all(self, sysml_type, type=None, recursive=True):
+    def all(self, sysml_type, type=None, recursive=True) -> "list[Searchable]":
         """Return all elements of *sysml_type*, searching recursively by default.
 
         This is a convenience alias for ``find(sysml_type=sysml_type, recursive=recursive)``.
@@ -290,7 +290,7 @@ class Searchable:
             sysml_type = type
         return self.find(sysml_type=sysml_type, recursive=recursive)
 
-    def find_one(self, name=None, *, sysml_type=None):
+    def find_one(self, name=None, *, sysml_type=None) -> "Searchable | None":
         """Return the single matching element, or None if not found.
 
         Raises LookupError if more than one match is found.
@@ -322,3 +322,22 @@ class Searchable:
         if isinstance(item, str):
             return any(getattr(c, 'name', None) == item for c in self.children)
         return item in self.children
+
+    # ------------------------------------------------------------------
+    # Jupyter HTML representation
+    # ------------------------------------------------------------------
+
+    def _repr_html_(self) -> str:
+        """Jupyter-friendly collapsible HTML tree."""
+        def _render(elem, depth=0):
+            name = getattr(elem, 'name', '?')
+            stype = getattr(elem, 'sysml_type', type(elem).__name__)
+            is_def = getattr(elem, 'is_definition', False)
+            badge = f'<code style="color:#888;font-size:0.8em">{stype}{"_def" if is_def else ""}</code>'
+            children = getattr(elem, 'children', [])
+            if children:
+                inner = ''.join(_render(c, depth + 1) for c in children)
+                return (f'<details open><summary>{badge} <b>{name}</b></summary>'
+                        f'<div style="margin-left:1em">{inner}</div></details>')
+            return f'<div>{badge} {name}</div>'
+        return f'<div style="font-family:monospace">{_render(self)}</div>'

{sysmlpy-0.30.1 → sysmlpy-0.30.2}/src/sysmlpy/usage.py

@@ -298,7 +298,7 @@ class Usage(Searchable):
 
         return package
 
-    def dump(self, child=None):
+    def dump(self, child=None) -> str:
         """Serialize this element to SysML v2 textual notation.
 
         Parameters
@@ -409,6 +409,8 @@ class Usage(Searchable):
 
         return self
 
+    set_name = _set_name
+
     def _get_name(self):
         """Retrieve the declared name from the grammar element.
 
@@ -468,6 +470,8 @@ class Usage(Searchable):
                 else:
                     return child._get_child(featurechain)
 
+    get_child = _get_child
+
     def _set_typed_by(self, typed):
         """Set the typing relationship for this usage element.
 
@@ -531,6 +535,8 @@ class Usage(Searchable):
             raise ValueError("Typed by element was not a definition.")
         return self
 
+    set_typed_by = _set_typed_by
+
     def _set_specializes(self, *parents):
         """Set specialization (`:>`) for definitions.
         
@@ -565,6 +571,8 @@ class Usage(Searchable):
         )
         return self
 
+    set_specializes = _set_specializes
+
     def _set_subsets(self, *parents):
         """Set subsetting (`:>`) for usage elements.
         
@@ -611,6 +619,8 @@ class Usage(Searchable):
         )
         return self
 
+    set_subsets = _set_subsets
+
     def _set_redefines(self, parent):
         """Set redefinition (`:>>`) for usage elements.
         
@@ -652,6 +662,8 @@ class Usage(Searchable):
         )
         return self
 
+    set_redefines = _set_redefines
+
     def _get_grammar(self):
         """Ensure the grammar tree is up to date and return it.
 
@@ -1517,7 +1529,7 @@ class Interface(Usage):
         self.children = []
         self.typedby = None
         self.parent = None
-        self.grammar = True
+        self.grammar = None
         self.iface_shortname = shortname
         self.ends = []  # list of (name, type_name, multiplicity, children)
         self.iface_connections = []  # list of (from_path, to_path)
@@ -1553,6 +1565,8 @@ class Interface(Usage):
         self._typed_by_name = typed.name if hasattr(typed, 'name') else str(typed)
         return self
 
+    set_typed_by = _set_typed_by
+
     def _set_specializes(self, *parents):
         """Set specialization (`:>`) for interface definitions."""
         self._specializes_names = [
@@ -1560,6 +1574,8 @@ class Interface(Usage):
         ]
         return self
 
+    set_specializes = _set_specializes
+
     def dump(self):
         name_str = getattr(self, 'name', "") or ""
         keyword = getattr(self, 'keyword', 'interface')
@@ -2190,6 +2206,8 @@ class Action(Usage):
         self._typed_by_name = typed.name if hasattr(typed, 'name') else str(typed)
         return self
 
+    set_typed_by = _set_typed_by
+
     def _set_specializes(self, *parents):
         """Set specialization (`:>`) for action definitions."""
         self._specializes_names = [
@@ -2197,6 +2215,8 @@ class Action(Usage):
         ]
         return self
 
+    set_specializes = _set_specializes
+
 
 class UseCase(Usage):
     """SysML v2 UseCase usage/definition.
@@ -2215,7 +2235,7 @@ class UseCase(Usage):
             self.grammar = UseCaseDefinition()
             self.grammar.declaration.identification.declaredName = name if name else None
         else:
-            self.grammar = True
+            self.grammar = None
         
         self.is_definition = definition
         self.name = name if name else str(uuidlib.uuid4())
@@ -2310,6 +2330,8 @@ class UseCase(Usage):
         self._typed_by_name = typed.name if hasattr(typed, 'name') else str(typed)
         return self
 
+    set_typed_by = _set_typed_by
+
     def _set_specializes(self, *parents):
         """Set specialization (`:>`) for use case definitions."""
         self._specializes_names = [
@@ -2317,6 +2339,8 @@ class UseCase(Usage):
         ]
         return self
 
+    set_specializes = _set_specializes
+
     def dump(self):
         name_str = getattr(self, 'name', "") or ""
         keyword = getattr(self, 'keyword', 'use case')
@@ -2409,7 +2433,7 @@ class Requirement(Usage):
             if self.grammar.declaration is not None and hasattr(self.grammar.declaration, 'identification'):
                 self.grammar.declaration.identification.declaredName = name if name else None
         else:
-            self.grammar = True
+            self.grammar = None
         
         self.is_definition = definition
         self.name = name if name else str(uuidlib.uuid4())
@@ -2522,6 +2546,8 @@ class Requirement(Usage):
         self._typed_by_name = typed.name if hasattr(typed, 'name') else str(typed)
         return self
 
+    set_typed_by = _set_typed_by
+
     def _set_specializes(self, *parents):
         """Set specialization (`:>`) for requirement definitions."""
         self._specializes_names = [
@@ -2529,6 +2555,8 @@ class Requirement(Usage):
         ]
         return self
 
+    set_specializes = _set_specializes
+
     def dump(self):
         name_str = getattr(self, 'name', "") or ""
         keyword = getattr(self, 'keyword', 'requirement')
@@ -2653,7 +2681,7 @@ class Message(Usage):
         self.children = []
         self.typedby = None
         self.parent = None
-        self.grammar = True
+        self.grammar = None
         self.from_port = from_port
         self.to_port = to_port
         self.of_type = of_type
@@ -3804,6 +3832,8 @@ class Reference(Usage):
         """Alias for set_type for consistency with other classes."""
         return self.set_type(type_obj)
 
+    set_typed_by = _set_typed_by
+
     def dump(self):
         name_str = getattr(self, 'name', "") or ""
         type_str = ""