sysmlpy 0.90.0__tar.gz → 0.91.0__tar.gz

sysmlpy-0.90.0/README.md → sysmlpy-0.91.0/PKG-INFO

@@ -1,3 +1,36 @@
+Metadata-Version: 2.4
+Name: sysmlpy
+Version: 0.91.0
+Summary: 
+License-File: LICENSE
+Author: Jon R. Fox (mycr0ft)
+Author-email: jon.fox@drfox.com
+Requires-Python: >=3.9,<4.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Provides-Extra: cayley
+Provides-Extra: graph
+Provides-Extra: jupyter
+Provides-Extra: kuzu
+Provides-Extra: sim
+Provides-Extra: xlsx
+Requires-Dist: antlr4-python3-runtime (>=4.13)
+Requires-Dist: arrow (>=1.4.0,<2.0.0)
+Requires-Dist: ipython (>=8.0) ; extra == "jupyter"
+Requires-Dist: kuzu (>=0.7,<0.12) ; extra == "kuzu"
+Requires-Dist: networkx (>=3.0) ; extra == "graph"
+Requires-Dist: openpyxl (>=3.1) ; extra == "xlsx"
+Requires-Dist: pint (>=0.24)
+Requires-Dist: pyyaml (>=6.0)
+Requires-Dist: requests (>=2.31) ; extra == "cayley"
+Requires-Dist: transitions (>=0.9,<0.10) ; extra == "sim"
+Description-Content-Type: text/markdown
+
 # sysmlpy
 [![PyPI version](https://badge.fury.io/py/sysmlpy.svg)](https://badge.fury.io/py/sysmlpy)[![PyPI status](https://img.shields.io/pypi/status/sysmlpy.svg)](https://pypi.python.org/pypi/sysmlpy/)[![MIT license](https://img.shields.io/badge/License-MIT-blue.svg)](https://lbesson.mit-license.org/)
 
@@ -41,6 +74,7 @@ sysmlpy requires the following Python packages:
 - [kuzu](https://kuzudb.com/) — embedded graph database with disk persistence and Cypher queries (install with `pip install sysmlpy[kuzu]`)
 - [cayley](https://cayley.io/) — graph database via HTTP API, supports BoltDB/LevelDB backends (install with `pip install sysmlpy[cayley]`)
 - [PlantUML](https://plantuml.com/) **v1.2020.0+** — diagram rendering (requires Java + PlantUML JAR or [PlantUML server](https://www.plantuml.com/plantuml)). The generator uses `<style>` blocks and `skinparam` stereotype selectors introduced in v1.2020.
+- [IPython](https://ipython.org/) **v8.0+** — the `%%sysml` Jupyter cell magic (install with `pip install sysmlpy[jupyter]`; see [Jupyter integration](#jupyter-integration))
 
 ## Installation
 
@@ -53,6 +87,52 @@ Multiple installation methods are supported by sysmlpy, including:
 |       ![PyPI logo](https://simpleicons.org/icons/pypi.svg)        |     PyPI     |              ``python -m pip install sysmlpy[cayley]`` (with Cayley graph DB)              |
 |     ![GitHub logo](https://simpleicons.org/icons/github.svg)      |    GitHub    | ``python -m pip install https://github.com/mycr0ft/sysmlpy/archive/refs/heads/main.zip`` |
 
+## Jupyter integration
+
+With the `jupyter` extra installed (`pip install sysmlpy[jupyter]`), the
+`%%sysml` cell magic lets you write SysML v2 textual notation directly in
+notebook cells, parsed and accumulated into a persistent session `Model`
+exposed in the notebook namespace as `model` (alias `_sysml`):
+
+```python
+# once per notebook
+%load_ext sysmlpy.ipython_magic
+```
+
+```sysml
+%%sysml
+package Vehicle {
+    part def Engine {
+        attribute fuelRate : Real;
+    }
+    part def Vehicle {
+        part engine : Vehicle::Engine;
+    }
+}
+```
+
+Re-declaring a package merges at *package-member* granularity: elements
+with the same `name` and `sysml_type` replace prior definitions; sibling
+members are preserved. Line magics mirror the OMG Pilot Implementation
+Jupyter kernel's command set:
+
+| Magic | Purpose |
+|-------|---------|
+| `%sysml_reset` | Discard the session model |
+| `%sysml_list [NAME]` | List packages, or find elements by exact declared name |
+| `%sysml_show NAME [--json]` | `dump()` of the AST rooted at a named element |
+| `%sysml_viz NAME... [--view V]` | PlantUML view (general\|interconnection\|action\|package\|tree) |
+
+Cell options: `%%sysml --reset` (fresh model), `--file PATH` (parse from a
+file; use `-` as the cell body), `--show` (print the round-tripped model).
+Parse errors report to stderr with line/column and never discard the
+session model. The full magic-command reference — the complete set of the
+official [OMG Pilot Implementation Jupyter
+kernel](https://github.com/Systems-Modeling/SysML-v2-Pilot-Implementation/tree/master/org.omg.sysml.jupyter.kernel)
+and the mapping to this implementation — is in the
+[sysml-copier](https://github.com/mycr0ft/sysml-copier) template's
+`docs/sysml-magics.md`.
+
 ## Command-Line Tools
 
 sysmlpy ships a CLI (`sysmlpy`, plus `sysmlpy-lsp` for editor support).
@@ -797,3 +877,4 @@ Two companion tools for the SysML v2 community, created by the same author:
 
 ## License
 sysmlpy is released under the MIT license, hence allowing commercial use of the library.
+

sysmlpy-0.90.0/PKG-INFO → sysmlpy-0.91.0/README.md

@@ -1,34 +1,3 @@
-Metadata-Version: 2.4
-Name: sysmlpy
-Version: 0.90.0
-Summary: 
-License-File: LICENSE
-Author: Jon R. Fox (mycr0ft)
-Author-email: jon.fox@drfox.com
-Requires-Python: >=3.9,<4.0
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Provides-Extra: cayley
-Provides-Extra: graph
-Provides-Extra: kuzu
-Provides-Extra: sim
-Provides-Extra: xlsx
-Requires-Dist: antlr4-python3-runtime (>=4.13)
-Requires-Dist: arrow (>=1.4.0,<2.0.0)
-Requires-Dist: kuzu (>=0.7,<0.12) ; extra == "kuzu"
-Requires-Dist: networkx (>=3.0) ; extra == "graph"
-Requires-Dist: openpyxl (>=3.1) ; extra == "xlsx"
-Requires-Dist: pint (>=0.24)
-Requires-Dist: pyyaml (>=6.0)
-Requires-Dist: requests (>=2.31) ; extra == "cayley"
-Requires-Dist: transitions (>=0.9,<0.10) ; extra == "sim"
-Description-Content-Type: text/markdown
-
 # sysmlpy
 [![PyPI version](https://badge.fury.io/py/sysmlpy.svg)](https://badge.fury.io/py/sysmlpy)[![PyPI status](https://img.shields.io/pypi/status/sysmlpy.svg)](https://pypi.python.org/pypi/sysmlpy/)[![MIT license](https://img.shields.io/badge/License-MIT-blue.svg)](https://lbesson.mit-license.org/)
 
@@ -72,6 +41,7 @@ sysmlpy requires the following Python packages:
 - [kuzu](https://kuzudb.com/) — embedded graph database with disk persistence and Cypher queries (install with `pip install sysmlpy[kuzu]`)
 - [cayley](https://cayley.io/) — graph database via HTTP API, supports BoltDB/LevelDB backends (install with `pip install sysmlpy[cayley]`)
 - [PlantUML](https://plantuml.com/) **v1.2020.0+** — diagram rendering (requires Java + PlantUML JAR or [PlantUML server](https://www.plantuml.com/plantuml)). The generator uses `<style>` blocks and `skinparam` stereotype selectors introduced in v1.2020.
+- [IPython](https://ipython.org/) **v8.0+** — the `%%sysml` Jupyter cell magic (install with `pip install sysmlpy[jupyter]`; see [Jupyter integration](#jupyter-integration))
 
 ## Installation
 
@@ -84,6 +54,52 @@ Multiple installation methods are supported by sysmlpy, including:
 |       ![PyPI logo](https://simpleicons.org/icons/pypi.svg)        |     PyPI     |              ``python -m pip install sysmlpy[cayley]`` (with Cayley graph DB)              |
 |     ![GitHub logo](https://simpleicons.org/icons/github.svg)      |    GitHub    | ``python -m pip install https://github.com/mycr0ft/sysmlpy/archive/refs/heads/main.zip`` |
 
+## Jupyter integration
+
+With the `jupyter` extra installed (`pip install sysmlpy[jupyter]`), the
+`%%sysml` cell magic lets you write SysML v2 textual notation directly in
+notebook cells, parsed and accumulated into a persistent session `Model`
+exposed in the notebook namespace as `model` (alias `_sysml`):
+
+```python
+# once per notebook
+%load_ext sysmlpy.ipython_magic
+```
+
+```sysml
+%%sysml
+package Vehicle {
+    part def Engine {
+        attribute fuelRate : Real;
+    }
+    part def Vehicle {
+        part engine : Vehicle::Engine;
+    }
+}
+```
+
+Re-declaring a package merges at *package-member* granularity: elements
+with the same `name` and `sysml_type` replace prior definitions; sibling
+members are preserved. Line magics mirror the OMG Pilot Implementation
+Jupyter kernel's command set:
+
+| Magic | Purpose |
+|-------|---------|
+| `%sysml_reset` | Discard the session model |
+| `%sysml_list [NAME]` | List packages, or find elements by exact declared name |
+| `%sysml_show NAME [--json]` | `dump()` of the AST rooted at a named element |
+| `%sysml_viz NAME... [--view V]` | PlantUML view (general\|interconnection\|action\|package\|tree) |
+
+Cell options: `%%sysml --reset` (fresh model), `--file PATH` (parse from a
+file; use `-` as the cell body), `--show` (print the round-tripped model).
+Parse errors report to stderr with line/column and never discard the
+session model. The full magic-command reference — the complete set of the
+official [OMG Pilot Implementation Jupyter
+kernel](https://github.com/Systems-Modeling/SysML-v2-Pilot-Implementation/tree/master/org.omg.sysml.jupyter.kernel)
+and the mapping to this implementation — is in the
+[sysml-copier](https://github.com/mycr0ft/sysml-copier) template's
+`docs/sysml-magics.md`.
+
 ## Command-Line Tools
 
 sysmlpy ships a CLI (`sysmlpy`, plus `sysmlpy-lsp` for editor support).
@@ -828,4 +844,3 @@ Two companion tools for the SysML v2 community, created by the same author:
 
 ## License
 sysmlpy is released under the MIT license, hence allowing commercial use of the library.
-

{sysmlpy-0.90.0 → sysmlpy-0.91.0}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "poetry.core.masonry.api"
 
 [project]
 name = "sysmlpy"
-version = "0.90.0"
+version = "0.91.0"
 description = ""
 authors = [{ name = "Jon R. Fox (mycr0ft)", email = "jon.fox@drfox.com" }]
 readme = "README.md"
@@ -23,6 +23,7 @@ openpyxl = { version = ">=3.1", optional = true }
 arrow = "^1.4.0"
 transitions = {version = "^0.9", optional = true}
 requests = { version = ">=2.31", optional = true }
+ipython = { version = ">=8.0", optional = true }
 
 [tool.poetry.extras]
 graph = ["networkx"]
@@ -30,6 +31,7 @@ kuzu = ["kuzu"]
 xlsx = ["openpyxl"]
 sim = ["transitions"]
 cayley = ["requests"]
+jupyter = ["ipython"]
 
 [tool.poetry.scripts]
 sysmlpy = "sysmlpy.__main__:main"

{sysmlpy-0.90.0 → sysmlpy-0.91.0}/src/sysmlpy/__init__.py

@@ -34,7 +34,7 @@ __all__ = [
     "render_state_transition_view_svg", "boxes_view",
 ]
 __author__ = "Jon Fox"
-__version__ = "0.90.0"
+__version__ = "0.91.0"
 
 from sysmlpy.usage import (
     Item, Attribute, Part, Port, Action, Reference, UseCase, Requirement, Interface, Message,

{sysmlpy-0.90.0 → sysmlpy-0.91.0}/src/sysmlpy/antlr_parser.py

@@ -5,8 +5,6 @@ ANTLR4-based SysML v2.0 parser module.
 This module provides an alternative parser to textX, using ANTLR4 grammar
 generated from the OMG SysML v2 specification (2026-05 release).
 """
-import sys
-import os
 import warnings
 
 from antlr4 import InputStream, CommonTokenStream
@@ -96,9 +94,6 @@ def parse(source, library=None, recover=False, prediction_mode="sll",
         If ``recover`` is False and the source contains syntax errors
         (after both parse stages).
     """
-    from pathlib import Path
-
-    # Handle string or file input
     if hasattr(source, 'read'):
         content = source.read()
     else:
@@ -155,13 +150,11 @@ def _parse_tree(content, recover=False, prediction_mode="sll"):
         # any error means we redo the whole parse in LL mode.
         from antlr4.error.ErrorStrategy import BailErrorStrategy
         tree = None
-        sll_errors = []
         try:
             parser._errHandler = BailErrorStrategy()
             tree = parser.rootNamespace()
         except Exception:
             tree = None
-            sll_errors = ["<sll>"]
         if tree is not None and not error_listener.errors:
             # ── fast path succeeded ──────────────────────────────────
             _maybe_save_dfa_cache()
@@ -226,8 +219,6 @@ def _rescue_constraint_bodies(content, language="English"):
     Constraints whose body contains ``*/`` cannot be wrapped in a comment
     and are left untouched (the original error stands).
     """
-    import re as _re
-
     spans = []
     try:
         lexer = SysMLv2Lexer(InputStream(content))

{sysmlpy-0.90.0 → sysmlpy-0.91.0}/src/sysmlpy/boxes_view.py

@@ -36,7 +36,7 @@ from typing import Any, Optional, Union
 
 try:
     from diagramboxes import (
-        Diagram, Node, Edge, Port,
+        Diagram, Node, Edge,
         InitialPseudostate, JunctionPseudostate,
         ChoicePseudostate, ForkPseudostate, JoinPseudostate,
         FinalState, TerminatePseudostate,

{sysmlpy-0.90.0 → sysmlpy-0.91.0}/src/sysmlpy/definition.py

@@ -293,21 +293,6 @@ class Model(Searchable):
 
     add_child = _set_child
 
-    def _get_child(self, featurechain):
-        """Retrieve a nested child by dot-separated name path.
-
-        Parameters
-        ----------
-        featurechain : str
-            Dot-separated path like "pkg.element".
-
-        Returns
-        -------
-        element or None
-            The matching child element, or None if not found.
-        """
-        return self
-
     def _get_child(self, featurechain):
         """Retrieve a nested child by dot-separated name path.
 
@@ -671,21 +656,6 @@ class Package(Searchable):
 
     add_child = _set_child
 
-    def _get_child(self, featurechain):
-        """Retrieve a nested child by dot-separated name path.
-
-        Parameters
-        ----------
-        featurechain : str
-            Dot-separated path like "pkg.element".
-
-        Returns
-        -------
-        element or None
-            The matching child element, or None if not found.
-        """
-        return self
-
     def _get_child(self, featurechain):
         """Retrieve a nested child by dot-separated name path.
 
@@ -853,7 +823,7 @@ class Package(Searchable):
         """
         from sysmlpy.grammar.classes import (
             Import, NamespaceImport, MembershipImport, ImportPrefix,
-            ImportedNamespace, ImportedMembership, VisibilityIndicator,
+            ImportedNamespace, ImportedMembership,
             RelationshipBody, QualifiedName
         )
 
@@ -882,7 +852,6 @@ class Package(Searchable):
             "protected": "protected" if visibility == "protected" else "",
             "public": "public" if visibility == "public" else "",
         }
-        vis = VisibilityIndicator(vis_def)
 
         # Create import prefix
         prefix_def = {
@@ -1720,7 +1689,7 @@ class Package(Searchable):
             A graph store with elements as nodes and parent-child
             relationships as edges.
         """
-        from sysmlpy.store import NetworkXStore, new_id, REL_PARENT_CHILD
+        from sysmlpy.store import NetworkXStore, new_id
 
         store = NetworkXStore()
         id_map = {}
@@ -1736,7 +1705,7 @@ class Package(Searchable):
             store.put(eid, data, parent_id=parent_id)
             if hasattr(elem, "children"):
                 for child in elem.children:
-                    child_id = _add_element(child, eid)
+                    _add_element(child, eid)
             return eid
 
         _add_element(self)

{sysmlpy-0.90.0 → sysmlpy-0.91.0}/src/sysmlpy/dfa_cache.py

@@ -36,7 +36,6 @@ from __future__ import annotations
 import hashlib
 import os
 import pickle
-import sys
 import threading
 import warnings
 from typing import Any, Dict, Optional, Tuple

{sysmlpy-0.90.0 → sysmlpy-0.91.0}/src/sysmlpy/evaluator.py

@@ -528,17 +528,6 @@ class _Evaluator:
             f"{sorted(self._available_names())}"
         )
 
-    def _evaluate_glued(self, text):
-        """Re-parse a glued expression text and evaluate it in scope."""
-        try:
-            expr_dict = _parse_expression_text(text)
-        except EvaluationError:
-            return None
-        try:
-            return self.evaluate(expr_dict)
-        except EvaluationError:
-            return None
-
     def _all_namespaces(self):
         seen = set()
         stack = [ns for ns in self.scope]
@@ -557,7 +546,7 @@ class _Evaluator:
             if seg in current.values:
                 if i == len(rest) - 1:
                     return self._materialize(current.values[seg], full_names)
-                value = self._materialize(current.values[seg], names=None)  # noqa
+                self._materialize(current.values[seg], names=None)  # noqa
                 raise UnknownNameError(
                     f"Cannot chain into value '{seg}' "
                     f"({'.'.join(str(n) for n in full_names)})"

{sysmlpy-0.90.0 → sysmlpy-0.91.0}/src/sysmlpy/examples/attribute_values.py

@@ -99,7 +99,7 @@ for child in vehicle.children:
     if isinstance(child, Attribute):
         try:
             colors.append(child.get_value())
-        except:
+        except Exception:
             pass
 print(f"\nColors as list: {colors}")
 

{sysmlpy-0.90.0 → sysmlpy-0.91.0}/src/sysmlpy/examples/tuples_sequences.py

@@ -5,7 +5,6 @@ the syntax and current status in sysmlpy.
 """
 
 from sysmlpy import loads, Part, Attribute
-from sysmlpy.usage import ureg
 
 # =============================================================================
 # 1. Tuple Syntax in SysML v2
@@ -123,7 +122,7 @@ if vehicle:
                 if isinstance(subchild, Attribute):
                     try:
                         print(f"    {subchild.name} = {subchild.get_value()}")
-                    except:
+                    except Exception:
                         pass
 
 # =============================================================================
@@ -158,7 +157,7 @@ if sensor:
         if isinstance(attr, Attribute):
             try:
                 print(f"  {attr.name} = {attr.get_value()}")
-            except:
+            except Exception:
                 pass
 
 # =============================================================================