Onya 0.1.1__tar.gz

onya-0.1.1/.gitignore

@@ -0,0 +1,44 @@
+scratch
+#PyCharm
+.idea
+.vscode
+MANIFEST
+
+#----
+
+*.py[cod]
+
+# C extensions
+*.so
+
+# Packages
+*.egg
+*.egg-info
+dist
+build
+eggs
+parts
+bin
+var
+sdist
+develop-eggs
+.installed.cfg
+lib
+lib64
+__pycache__
+
+# Installer logs
+pip-log.txt
+
+# Unit test / coverage reports
+.coverage
+.tox
+nosetests.xml
+
+# Translations
+*.mo
+
+# Mr Developer
+.mr.developer.cfg
+.project
+.pydevproject

onya-0.1.1/LICENSE-spec

@@ -0,0 +1,47 @@
+Word Loom Specification License
+
+The Word Loom specification document (wordloom_spec.md) is licensed under the
+Creative Commons Attribution 4.0 International License (CC BY 4.0).
+
+To view a copy of this license, visit:
+https://creativecommons.org/licenses/by/4.0/
+
+or send a letter to:
+Creative Commons
+PO Box 1866
+Mountain View, CA 94042
+USA
+
+---
+
+You are free to:
+
+  * Share — copy and redistribute the specification in any medium or format
+  * Adapt — remix, transform, and build upon the specification for any purpose,
+    even commercially
+
+Under the following terms:
+
+  * Attribution — You must give appropriate credit, provide a link to the
+    license, and indicate if changes were made. You may do so in any reasonable
+    manner, but not in any way that suggests the licensor endorses you or your
+    use.
+
+  * No additional restrictions — You may not apply legal terms or technological
+    measures that legally restrict others from doing anything the license
+    permits.
+
+---
+
+This is a human-readable summary of (and not a substitute for) the full license.
+
+The full legal text of the Creative Commons Attribution 4.0 International
+License is available at:
+https://creativecommons.org/licenses/by/4.0/legalcode
+
+---
+
+Copyright (c) 2023-2025 Oori Data
+
+Attribution example:
+"Based on the Word Loom specification by Oori Data (https://github.com/OoriData/WordLoom)"

onya-0.1.1/PKG-INFO

@@ -0,0 +1,201 @@
+Metadata-Version: 2.4
+Name: Onya
+Version: 0.1.1
+Summary: Knowledge graph (property graph-style) model and serialization for web resources
+Project-URL: Homepage, https://github.com/OoriData/Onya
+Project-URL: Repository, https://github.com/OoriData/Onya
+Project-URL: Issues, https://github.com/OoriData/Onya/issues
+Author-email: Uche Ogbuji <uche@ogbuji.net>
+License: Apache-2.0
+License-File: LICENSE-spec
+Keywords: data,graph,linked-data,rdf,web
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Utilities
+Requires-Python: >=3.12
+Requires-Dist: amara>=4.0.1
+Requires-Dist: markdown
+Requires-Dist: pyparsing
+Provides-Extra: demo
+Requires-Dist: fire; extra == 'demo'
+Provides-Extra: dev
+Requires-Dist: build; extra == 'dev'
+Requires-Dist: hatch; extra == 'dev'
+Requires-Dist: pipdeptree; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-asyncio; extra == 'dev'
+Requires-Dist: pytest-mock; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Requires-Dist: twine; extra == 'dev'
+Description-Content-Type: text/markdown
+
+**Onya** is a knowledge graph expression and implementation. This repository combines a [data model and format spec](SPEC.md) with a Python parser and API implementation.
+
+# Python quick start
+
+## Installation
+
+<!--
+```bash
+pip install amara
+```
+
+Or with uv (recommended):
+
+```bash
+uv pip install amara
+```
+-->
+
+Requires Python 3.12 or later. The package is still in early development, so install directly from source:
+
+```bash
+git clone https://github.com/OoriData/Onya.git
+cd Onya
+pip install -U .
+```
+
+<!--
+pip install git+https://github.com/OoriData/Onya.git
+-->
+
+## Basic Usage
+
+Here's a simple example demonstrating the core Onya API. First, let's define a small friendship graph in Onya Literate format:
+
+```
+# @docheader
+
+* @document: http://example.org/friendship-graph
+* @base: http://example.org/people/
+* @schema: https://schema.org/
+* @type-base: https://schema.org/
+
+# Chuks [Person]
+
+* name: Chukwuemeka Okafor
+* nickname: Chuks
+* age: 28
+
+# Ify [Person]
+
+* name: Ifeoma Adebayo
+* nickname: Ify
+* age: 27
+```
+
+Now let's parse this graph and interact with it using the Python API:
+
+```python
+from onya.graph import graph
+from onya.serial import literate_lex
+
+# Parse the Onya Literate text into a graph
+onya_text = '''
+# @docheader
+
+* @document: http://example.org/friendship-graph
+* @base: http://example.org/people/
+* @schema: https://schema.org/
+* @type-base: https://schema.org/
+
+# Chuks [Person]
+
+* name: Chukwuemeka Okafor
+* nickname: Chuks
+* age: 28
+
+# Ify [Person]
+
+* name: Ifeoma Adebayo
+* nickname: Ify
+* age: 27
+'''
+
+g = graph()
+doc_iri = literate_lex.parse(onya_text, g)
+print(f"Parsed document: {doc_iri}")
+print(f"Graph has {len(g)} nodes")
+
+# Access nodes and their properties
+chuks = g['http://example.org/people/Chuks']
+ify = g['http://example.org/people/Ify']
+
+# Get a specific property value
+for prop in chuks.getprop('https://schema.org/name'):
+    print(f"Name: {prop.value}")
+
+# Add a friendship edge between Chuks and Ify
+friendship = chuks.add_edge('https://schema.org/knows', ify)
+print(f"Added edge: {friendship}")
+
+# Add nested properties to the friendship (metadata about the relationship)
+friendship.add_property('https://schema.org/startDate', '2018-03-15')
+friendship.add_property('https://schema.org/description', 'Met at university')
+
+# Add a new property to Ify
+ify.add_property('https://schema.org/jobTitle', 'Software Engineer')
+
+# Modify a property by removing the old one and adding a new one
+age_props = list(chuks.getprop('https://schema.org/age'))
+for prop in age_props:
+    chuks.remove_property(prop)
+chuks.add_property('https://schema.org/age', '29')
+
+# Traverse edges
+for edge in chuks.traverse('https://schema.org/knows'):
+    friend = edge.target
+    for name_prop in friend.getprop('https://schema.org/name'):
+        print(f"Chuks knows: {name_prop.value}")
+    # Access nested properties on the edge
+    for date_prop in edge.getprop('https://schema.org/startDate'):
+        print(f"  Friends since: {date_prop.value}")
+
+# Find all nodes of a certain type
+for person in g.typematch('https://schema.org/Person'):
+    for name_prop in person.getprop('https://schema.org/name'):
+        print(f"Person in graph: {name_prop.value}")
+```
+
+This example demonstrates:
+- Parsing Onya Literate format
+- Accessing nodes and properties
+- Adding edges with nested properties (reified relationships)
+- Modifying properties
+- Traversing the graph
+- Querying by type
+
+# Background
+
+Onya is based on experience from developing [Versa](https://github.com/uogbuji/versa) and also working on [the MicroXML spec](https://dvcs.w3.org/hg/microxml/raw-file/tip/spec/microxml.html) and implementations thereof.
+
+The URL used for metavocabulary is [managed via purl.org](https://purl.archive.org/purl/onya/vocab).
+
+The name is from Igbo "ọ́nyà", web, snare, trap, and by extension, network. The expanded sense is ọ́nyà úchè, web of knowledge.
+
+# Contributing
+
+Contributions welcome! We're interested in feedback from the community about what works and what doesn't in real-world usage. To get help with the code implementation, read [CONTRIBUTING.md](CONTRIBUTING.md).
+
+# License
+
+- **Code** (Python library): Apache 2.0 - See [LICENSE](LICENSE)
+- **Specification** (wordloom_spec.md): [Creative Commons Attribution 4.0 International (CC BY 4.0)](https://creativecommons.org/licenses/by/4.0/) - See [LICENSE-spec](LICENSE-spec)
+
+The specification is under CC BY 4.0 to encourage broad adoption and derivative work while ensuring attribution. We want the format itself to be as open and reusable as possible, allowing anyone to create implementations in any language or adapt the format for their specific needs.
+
+# Acknowledgments
+
+Created by [Oori Data](https://oori.dev). Word Loom emerged from our work building multilingual LLM applications and finding gaps in existing prompt management approaches.
+
+# Related Work
+
+- [networkx](https://github.com/networkx/networkx): Network Analysis in Python
+- [Apache AGE](https://github.com/apache/incubator-age): PostgreSQL Extension that for graphs. ANSI SQL & openCypher over the same DB.

onya-0.1.1/README.md

@@ -0,0 +1,163 @@
+**Onya** is a knowledge graph expression and implementation. This repository combines a [data model and format spec](SPEC.md) with a Python parser and API implementation.
+
+# Python quick start
+
+## Installation
+
+<!--
+```bash
+pip install amara
+```
+
+Or with uv (recommended):
+
+```bash
+uv pip install amara
+```
+-->
+
+Requires Python 3.12 or later. The package is still in early development, so install directly from source:
+
+```bash
+git clone https://github.com/OoriData/Onya.git
+cd Onya
+pip install -U .
+```
+
+<!--
+pip install git+https://github.com/OoriData/Onya.git
+-->
+
+## Basic Usage
+
+Here's a simple example demonstrating the core Onya API. First, let's define a small friendship graph in Onya Literate format:
+
+```
+# @docheader
+
+* @document: http://example.org/friendship-graph
+* @base: http://example.org/people/
+* @schema: https://schema.org/
+* @type-base: https://schema.org/
+
+# Chuks [Person]
+
+* name: Chukwuemeka Okafor
+* nickname: Chuks
+* age: 28
+
+# Ify [Person]
+
+* name: Ifeoma Adebayo
+* nickname: Ify
+* age: 27
+```
+
+Now let's parse this graph and interact with it using the Python API:
+
+```python
+from onya.graph import graph
+from onya.serial import literate_lex
+
+# Parse the Onya Literate text into a graph
+onya_text = '''
+# @docheader
+
+* @document: http://example.org/friendship-graph
+* @base: http://example.org/people/
+* @schema: https://schema.org/
+* @type-base: https://schema.org/
+
+# Chuks [Person]
+
+* name: Chukwuemeka Okafor
+* nickname: Chuks
+* age: 28
+
+# Ify [Person]
+
+* name: Ifeoma Adebayo
+* nickname: Ify
+* age: 27
+'''
+
+g = graph()
+doc_iri = literate_lex.parse(onya_text, g)
+print(f"Parsed document: {doc_iri}")
+print(f"Graph has {len(g)} nodes")
+
+# Access nodes and their properties
+chuks = g['http://example.org/people/Chuks']
+ify = g['http://example.org/people/Ify']
+
+# Get a specific property value
+for prop in chuks.getprop('https://schema.org/name'):
+    print(f"Name: {prop.value}")
+
+# Add a friendship edge between Chuks and Ify
+friendship = chuks.add_edge('https://schema.org/knows', ify)
+print(f"Added edge: {friendship}")
+
+# Add nested properties to the friendship (metadata about the relationship)
+friendship.add_property('https://schema.org/startDate', '2018-03-15')
+friendship.add_property('https://schema.org/description', 'Met at university')
+
+# Add a new property to Ify
+ify.add_property('https://schema.org/jobTitle', 'Software Engineer')
+
+# Modify a property by removing the old one and adding a new one
+age_props = list(chuks.getprop('https://schema.org/age'))
+for prop in age_props:
+    chuks.remove_property(prop)
+chuks.add_property('https://schema.org/age', '29')
+
+# Traverse edges
+for edge in chuks.traverse('https://schema.org/knows'):
+    friend = edge.target
+    for name_prop in friend.getprop('https://schema.org/name'):
+        print(f"Chuks knows: {name_prop.value}")
+    # Access nested properties on the edge
+    for date_prop in edge.getprop('https://schema.org/startDate'):
+        print(f"  Friends since: {date_prop.value}")
+
+# Find all nodes of a certain type
+for person in g.typematch('https://schema.org/Person'):
+    for name_prop in person.getprop('https://schema.org/name'):
+        print(f"Person in graph: {name_prop.value}")
+```
+
+This example demonstrates:
+- Parsing Onya Literate format
+- Accessing nodes and properties
+- Adding edges with nested properties (reified relationships)
+- Modifying properties
+- Traversing the graph
+- Querying by type
+
+# Background
+
+Onya is based on experience from developing [Versa](https://github.com/uogbuji/versa) and also working on [the MicroXML spec](https://dvcs.w3.org/hg/microxml/raw-file/tip/spec/microxml.html) and implementations thereof.
+
+The URL used for metavocabulary is [managed via purl.org](https://purl.archive.org/purl/onya/vocab).
+
+The name is from Igbo "ọ́nyà", web, snare, trap, and by extension, network. The expanded sense is ọ́nyà úchè, web of knowledge.
+
+# Contributing
+
+Contributions welcome! We're interested in feedback from the community about what works and what doesn't in real-world usage. To get help with the code implementation, read [CONTRIBUTING.md](CONTRIBUTING.md).
+
+# License
+
+- **Code** (Python library): Apache 2.0 - See [LICENSE](LICENSE)
+- **Specification** (wordloom_spec.md): [Creative Commons Attribution 4.0 International (CC BY 4.0)](https://creativecommons.org/licenses/by/4.0/) - See [LICENSE-spec](LICENSE-spec)
+
+The specification is under CC BY 4.0 to encourage broad adoption and derivative work while ensuring attribution. We want the format itself to be as open and reusable as possible, allowing anyone to create implementations in any language or adapt the format for their specific needs.
+
+# Acknowledgments
+
+Created by [Oori Data](https://oori.dev). Word Loom emerged from our work building multilingual LLM applications and finding gaps in existing prompt management approaches.
+
+# Related Work
+
+- [networkx](https://github.com/networkx/networkx): Network Analysis in Python
+- [Apache AGE](https://github.com/apache/incubator-age): PostgreSQL Extension that for graphs. ANSI SQL & openCypher over the same DB.