gsn-model-parser 0.16.10__tar.gz

gsn_model_parser-0.16.10/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Vanderbilt University, ICONS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

gsn_model_parser-0.16.10/MANIFEST.in

@@ -0,0 +1,5 @@
+prune test
+prune examples
+prune venv
+global-exclude __pycache__
+global-exclude *.py[cod]

gsn_model_parser-0.16.10/PKG-INFO

@@ -0,0 +1,155 @@
+Metadata-Version: 2.4
+Name: gsn-model-parser
+Version: 0.16.10
+Summary: Parse Goal Structuring Notation (.gsn) models and propagate subjective-logic opinions
+Author-email: Patrik Meijer <patrik.meijer@vanderbilt.edu>, Mark Wutka <mark.wutka@vanderbilt.edu>
+License-Expression: MIT
+Project-URL: Homepage, https://git-dains-vu.isis.vanderbilt.edu/dains/tools/caid/gsn-domain
+Project-URL: Issues, https://git-dains-vu.isis.vanderbilt.edu/dains/tools/caid/gsn-domain/-/issues
+Keywords: gsn,goal-structuring-notation,assurance,subjective-logic
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+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: Topic :: Scientific/Engineering
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: textX==4.4.0
+Dynamic: license-file
+
+# gsn-model-parser
+
+Python parser for Goal Structuring Notation (`.gsn`) models. It loads one or more `.gsn` files from a directory, resolves references, and returns `GSNNode` objects with attributes (including opinions) and content hashes.
+
+Requires **Python 3.10+**.
+
+## Virtual environment
+
+From this directory (`python-model-parser`):
+
+```shell
+python3 -m venv venv
+source venv/bin/activate
+pip install -U pip
+```
+
+## Install
+
+From PyPI:
+
+```shell
+pip install gsn-model-parser
+```
+
+Editable install from a clone (used for development and tests):
+
+```shell
+pip install -e .
+```
+
+A release is also published to this project's GitLab PyPI registry. Authenticate with a [personal access token](https://git-dains-vu.isis.vanderbilt.edu/-/user_settings/personal_access_tokens) that has `read_api` and `read_package_registry` (do not commit the token):
+
+```shell
+export GSN_DOMAIN_PYPI="https://__token__:${TOKEN}@git-dains-vu.isis.vanderbilt.edu/api/v4/projects/dains%2Ftools%2Fcaid%2Fgsn-domain/packages/pypi/simple"
+pip install gsn-model-parser --index-url "${GSN_DOMAIN_PYPI}" --extra-index-url https://pypi.org/simple
+```
+
+## Build a wheel
+
+```shell
+pip install build
+python -m build
+```
+
+Artifacts land in `dist/` (`gsn_model_parser-*.whl` and `*.tar.gz`). Check the metadata, then upload.
+
+Public PyPI (create an API token at <https://pypi.org/manage/account/token/>):
+
+```shell
+pip install twine
+python -m twine check dist/*
+python -m twine upload dist/*
+```
+
+GitLab CI does this on a version tag (`v0.16.9`). The tag job rewrites `version` in `pyproject.toml` from the tag, builds the artifacts, uploads them to the GitLab PyPI registry, and uploads the same artifacts to public PyPI when the masked CI variable `PYPI_API_TOKEN` is set. Make that variable available to tag pipelines.
+
+To upload the same build to the GitLab registry by hand:
+
+```shell
+python -m twine upload --repository-url https://git-dains-vu.isis.vanderbilt.edu/api/v4/projects/<project-id>/packages/pypi dist/*
+```
+
+## Usage
+
+Parse a directory of `.gsn` files (all files in the folder are one model).
+`get_solved_bys` and `get_in_context_ofs` return the direct children, in source order.
+`ref_goal`, `ref_strategy`, `ref_solution`, `ref_context`, `ref_assumption`, and
+`ref_justification` resolve to the target node, so the same calls continue into a
+node that lives in another namespace. Recurse to walk the whole argument.
+`examples/traverse_model.py` prints this outline for a model directory.
+
+```python
+from gsn_model_parser import load_model
+
+def walk(node, indent=0, seen=None):
+    if seen is None:
+        seen = set()
+    print(f"{'  ' * indent}{node.node_type} {node.name}")
+    if node.node_id in seen:
+        return
+    seen.add(node.node_id)
+    for context in node.get_in_context_ofs():
+        walk(context, indent + 1, seen)
+    for child in node.get_solved_bys():
+        walk(child, indent + 1, seen)
+
+model = load_model("/path/to/sample-models/control-system")
+for root in model.get_roots():
+    walk(root)
+```
+
+#### Compute Propagated Opinions
+`get_propagated_opinion` derives the subjective-logic opinion of a node from its `solvedBy` and `inContextOf` links. On a top-level node that walks the whole argument underneath it. Solutions and assumptions still use their stored opinion; a goal or strategy is computed.
+
+```python
+from gsn_model_parser import load_model
+
+model = load_model("/path/to/sample-models/simple")
+for root in model.get_roots():
+    print(root.name, root.get_propagated_opinion())
+```
+
+#### Updating Opinions
+``get_gsn_nodes`` still returns the flat node map and a ``persist`` callback:
+
+```python
+from gsn_model_parser import get_gsn_nodes
+
+nodes, persist = get_gsn_nodes("/path/to/sample-models/simple", as_dict=True)
+
+for node in nodes.values():
+    print(node.name, node.node_type, node.opinion, node.get_content_hash(nodes))
+    if node.node_type == 'SolutionNode':
+        node.opinion = {'b': 1.0, 'd': 0.0, 'u': 0.0, 'a': 0.5}
+
+        persist("/path/to/out.gsn")          # one combined file
+        persist("/path/to/out-dir")         # original filenames, one file per source .gsn
+```
+
+## Tests
+
+Unit tests parse the sample models under [`../sample-models/`](../sample-models/). From this directory, with the venv activated:
+
+```shell
+pip install -e .
+python -m unittest discover -s test -p '*test*.py'
+```
+
+## Grammar
+
+The textX grammar [`src/gsn_model_parser/gsn.tx`](src/gsn_model_parser/gsn.tx) tracks [`Assurance.xtext`](../gsn-xtext/edu.vanderbilt.isis.caid.assurancedsl/src/main/java/edu/vanderbilt/isis/caid/assurancedsl/Assurance.xtext). When the `.gsn` language changes, update both.

gsn_model_parser-0.16.10/README.md

@@ -0,0 +1,131 @@
+# gsn-model-parser
+
+Python parser for Goal Structuring Notation (`.gsn`) models. It loads one or more `.gsn` files from a directory, resolves references, and returns `GSNNode` objects with attributes (including opinions) and content hashes.
+
+Requires **Python 3.10+**.
+
+## Virtual environment
+
+From this directory (`python-model-parser`):
+
+```shell
+python3 -m venv venv
+source venv/bin/activate
+pip install -U pip
+```
+
+## Install
+
+From PyPI:
+
+```shell
+pip install gsn-model-parser
+```
+
+Editable install from a clone (used for development and tests):
+
+```shell
+pip install -e .
+```
+
+A release is also published to this project's GitLab PyPI registry. Authenticate with a [personal access token](https://git-dains-vu.isis.vanderbilt.edu/-/user_settings/personal_access_tokens) that has `read_api` and `read_package_registry` (do not commit the token):
+
+```shell
+export GSN_DOMAIN_PYPI="https://__token__:${TOKEN}@git-dains-vu.isis.vanderbilt.edu/api/v4/projects/dains%2Ftools%2Fcaid%2Fgsn-domain/packages/pypi/simple"
+pip install gsn-model-parser --index-url "${GSN_DOMAIN_PYPI}" --extra-index-url https://pypi.org/simple
+```
+
+## Build a wheel
+
+```shell
+pip install build
+python -m build
+```
+
+Artifacts land in `dist/` (`gsn_model_parser-*.whl` and `*.tar.gz`). Check the metadata, then upload.
+
+Public PyPI (create an API token at <https://pypi.org/manage/account/token/>):
+
+```shell
+pip install twine
+python -m twine check dist/*
+python -m twine upload dist/*
+```
+
+GitLab CI does this on a version tag (`v0.16.9`). The tag job rewrites `version` in `pyproject.toml` from the tag, builds the artifacts, uploads them to the GitLab PyPI registry, and uploads the same artifacts to public PyPI when the masked CI variable `PYPI_API_TOKEN` is set. Make that variable available to tag pipelines.
+
+To upload the same build to the GitLab registry by hand:
+
+```shell
+python -m twine upload --repository-url https://git-dains-vu.isis.vanderbilt.edu/api/v4/projects/<project-id>/packages/pypi dist/*
+```
+
+## Usage
+
+Parse a directory of `.gsn` files (all files in the folder are one model).
+`get_solved_bys` and `get_in_context_ofs` return the direct children, in source order.
+`ref_goal`, `ref_strategy`, `ref_solution`, `ref_context`, `ref_assumption`, and
+`ref_justification` resolve to the target node, so the same calls continue into a
+node that lives in another namespace. Recurse to walk the whole argument.
+`examples/traverse_model.py` prints this outline for a model directory.
+
+```python
+from gsn_model_parser import load_model
+
+def walk(node, indent=0, seen=None):
+    if seen is None:
+        seen = set()
+    print(f"{'  ' * indent}{node.node_type} {node.name}")
+    if node.node_id in seen:
+        return
+    seen.add(node.node_id)
+    for context in node.get_in_context_ofs():
+        walk(context, indent + 1, seen)
+    for child in node.get_solved_bys():
+        walk(child, indent + 1, seen)
+
+model = load_model("/path/to/sample-models/control-system")
+for root in model.get_roots():
+    walk(root)
+```
+
+#### Compute Propagated Opinions
+`get_propagated_opinion` derives the subjective-logic opinion of a node from its `solvedBy` and `inContextOf` links. On a top-level node that walks the whole argument underneath it. Solutions and assumptions still use their stored opinion; a goal or strategy is computed.
+
+```python
+from gsn_model_parser import load_model
+
+model = load_model("/path/to/sample-models/simple")
+for root in model.get_roots():
+    print(root.name, root.get_propagated_opinion())
+```
+
+#### Updating Opinions
+``get_gsn_nodes`` still returns the flat node map and a ``persist`` callback:
+
+```python
+from gsn_model_parser import get_gsn_nodes
+
+nodes, persist = get_gsn_nodes("/path/to/sample-models/simple", as_dict=True)
+
+for node in nodes.values():
+    print(node.name, node.node_type, node.opinion, node.get_content_hash(nodes))
+    if node.node_type == 'SolutionNode':
+        node.opinion = {'b': 1.0, 'd': 0.0, 'u': 0.0, 'a': 0.5}
+
+        persist("/path/to/out.gsn")          # one combined file
+        persist("/path/to/out-dir")         # original filenames, one file per source .gsn
+```
+
+## Tests
+
+Unit tests parse the sample models under [`../sample-models/`](../sample-models/). From this directory, with the venv activated:
+
+```shell
+pip install -e .
+python -m unittest discover -s test -p '*test*.py'
+```
+
+## Grammar
+
+The textX grammar [`src/gsn_model_parser/gsn.tx`](src/gsn_model_parser/gsn.tx) tracks [`Assurance.xtext`](../gsn-xtext/edu.vanderbilt.isis.caid.assurancedsl/src/main/java/edu/vanderbilt/isis/caid/assurancedsl/Assurance.xtext). When the `.gsn` language changes, update both.

gsn_model_parser-0.16.10/pyproject.toml

@@ -0,0 +1,47 @@
+[build-system]
+requires = ["setuptools >= 77.0.3"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "gsn-model-parser"
+version = "0.16.10"
+description = "Parse Goal Structuring Notation (.gsn) models and propagate subjective-logic opinions"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = ["gsn", "goal-structuring-notation", "assurance", "subjective-logic"]
+authors = [
+    { name = "Patrik Meijer", email = "patrik.meijer@vanderbilt.edu" },
+    { name = "Mark Wutka", email = "mark.wutka@vanderbilt.edu" },
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering",
+]
+dependencies = [
+    "textX==4.4.0",
+]
+
+[project.urls]
+Homepage = "https://git-dains-vu.isis.vanderbilt.edu/dains/tools/caid/gsn-domain"
+Issues = "https://git-dains-vu.isis.vanderbilt.edu/dains/tools/caid/gsn-domain/-/issues"
+
+[project.scripts]
+gsn-model-parser = "gsn_model_parser.parser:main"
+
+[tool.setuptools]
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+gsn_model_parser = ["gsn.tx"]

gsn_model_parser-0.16.10/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

gsn_model_parser-0.16.10/src/gsn_model_parser/__init__.py

@@ -0,0 +1,5 @@
+"""Parse Goal Structuring Notation (.gsn) models."""
+
+from gsn_model_parser.parser import GSNModel, GSNNode, get_gsn_nodes, list_solutions, load_model
+
+__all__ = ['GSNModel', 'GSNNode', 'get_gsn_nodes', 'list_solutions', 'load_model']

gsn_model_parser-0.16.10/src/gsn_model_parser/__main__.py

@@ -0,0 +1,3 @@
+from gsn_model_parser.parser import main
+
+main()

gsn_model_parser-0.16.10/src/gsn_model_parser/gsn.tx

@@ -0,0 +1,218 @@
+AssuranceModel:
+    assurancemodels += GSNDefinition*
+;
+
+GSNDefinition:
+    Goals|Strategies|Contexts|Assumptions|Justifications|Solutions
+;
+
+Goals:
+    'GOALS' name=ID '{' goals *= GoalNode '}'
+;
+
+Strategies:
+    'STRATEGIES' name=ID '{' strategies *= StrategyNode '}'
+;
+
+Contexts:
+    'CONTEXTS' name=ID '{' contexts *= ContextNode '}'
+;
+
+Assumptions:
+    'ASSUMPTIONS' name=ID '{' assumptions *= AssumptionNode '}'
+;
+
+Justifications:
+    'JUSTIFICATIONS' name=ID '{' justifications *= JustificationNode '}'
+;
+
+Solutions:
+    'SOLUTIONS' name=ID '{' solutions *= SolutionNode '}'
+;
+
+GoalSupportNodes:
+    GoalNode
+    | StrategyNode
+    | SolutionNode
+    | GoalNodeRef
+    | StrategyNodeRef
+    | SolutionNodeRef
+;
+
+StrategySupportNodes:
+    GoalNode
+    | StrategyNode
+    | GoalNodeRef
+    | StrategyNodeRef
+;
+
+ContextNodes:
+    ContextNode
+    | ContextNodeRef
+;
+
+AssumptionNodes:
+    AssumptionNode
+    | AssumptionNodeRef
+;
+
+JustificationNodes:
+    JustificationNode
+    | JustificationNodeRef
+;
+
+ALLNodes:
+    GoalNode
+    | StrategyNode
+    | SolutionNode
+    | ContextNode
+    | AssumptionNode
+    | JustificationNode
+;
+
+GoalNodeRef:
+    'ref_goal' ref=[GoalNode:FQN]
+;
+
+StrategyNodeRef:
+    'ref_strategy' ref=[StrategyNode:FQN]
+;
+
+SolutionNodeRef:
+    'ref_solution' ref=[SolutionNode:FQN]
+;
+
+ContextNodeRef:
+    'ref_context' ref=[ContextNode:FQN]
+;
+
+AssumptionNodeRef:
+    'ref_assumption' ref=[AssumptionNode:FQN]
+;
+
+JustificationNodeRef:
+    'ref_justification' ref=[JustificationNode:FQN]
+;
+
+Number:
+    FLOAT | INT
+;
+
+Opinion:
+    '(' b=Number ',' d=Number ',' u=Number (',' a=Number)? ')'
+;
+
+WarrantBlock:
+    'warrant' '{'
+        ('givenTrue' givenTrue=Opinion)?
+        ('givenFalse' givenFalse=Opinion)?
+    '}'
+;
+
+GoalChild:
+    GoalSupportNodes | ContextNodes | AssumptionNodes | JustificationNodes
+;
+
+StrategyChild:
+    StrategySupportNodes | ContextNodes | AssumptionNodes | JustificationNodes
+;
+
+GoalDetails:
+    child=GoalChild
+    (warrants=WarrantBlock)?
+;
+
+StrategyDetails:
+    child=StrategyChild
+    (warrants=WarrantBlock)?
+;
+
+GoalNode:
+    'goal' name=ID '{'
+        (details=BaseNode)?
+        ('status' status=SolutionStatus)?
+        (nodedetails *= GoalDetails)
+    '}'
+;
+
+StrategyNode:
+    'strategy' name=ID '{'
+        (details=BaseNode)?
+        ('argument' argumentType=ArgumentType)?
+        (nodedetails *= StrategyDetails)
+    '}'
+;
+
+ContextNode:
+    'context' name=ID '{'
+        (details=BaseNode)?
+    '}'
+;
+
+AssumptionNode:
+    'assumption' name=ID '{'
+        (details=BaseNode)?
+        ('opinion' opinion=Opinion)?
+    '}'
+;
+
+JustificationNode:
+    'justification' name=ID '{'
+        (details=BaseNode)?
+    '}'
+;
+
+SolutionNode:
+    'solution' name=ID '{'
+        (details=BaseNode)?
+        ('status' status=SolutionStatus)?
+        ('opinion' opinion=Opinion)?
+    '}'
+;
+
+BaseNode:
+    (uuid=UUIDType)?
+    (summary=Summary)?
+    (info=Description)?
+    (labels *= LabelInfo)
+    (artifacts *= URI)
+;
+
+SolutionStatus:
+    'NotReviewed' | 'Approved' | 'Disapproved'
+;
+
+ArgumentType:
+    'CONJUNCTION' | 'DISJUNCTION' | 'FUSION' | 'DISCOUNT'
+;
+
+UUIDType:
+    'uuid' info=GUID
+;
+
+Summary:
+    'summary' info=MLString
+;
+
+Description:
+    'info' info=MLString
+;
+
+LabelInfo:
+    'label' name=ID
+;
+
+URI:
+    'artifact' uri=MLString
+;
+
+FQN:
+    ID+['.']
+;
+
+MLString: data=/(?ms)\"(.*?)\"/;
+GUID: /\{?[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}\}?/;
+
+Comment:
+  /\/\/.*$/
+;