obographs 0.0.6__tar.gz → 0.0.8__tar.gz

{obographs-0.0.6 → obographs-0.0.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: obographs
-Version: 0.0.6
+Version: 0.0.8
 Summary: A python data model for OBO Graphs
 Keywords: snekpack,cookiecutter
 Author: Charles Tapley Hoyt

{obographs-0.0.6 → obographs-0.0.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "obographs"
-version = "0.0.6"
+version = "0.0.8"
 description = "A python data model for OBO Graphs"
 readme = "README.md"
 authors = [
@@ -232,7 +232,7 @@ known-first-party = [
 docstring-code-format = true
 
 [tool.bumpversion]
-current_version = "0.0.6"
+current_version = "0.0.8"
 parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)\\.(?P<patch>\\d+)(?:-(?P<release>[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*))?(?:\\+(?P<build>[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*))?"
 serialize = [
     "{major}.{minor}.{patch}-{release}+{build}",

{obographs-0.0.6 → obographs-0.0.8}/src/obographs/__init__.py

@@ -1,5 +1,6 @@
 """A python data model for OBO Graphs."""
 
+from .contrib import guess_primary_graph
 from .model import (
     Definition,
     DomainRangeAxiom,
@@ -69,5 +70,6 @@ __all__ = [
     "StandardizedXref",
     "Synonym",
     "Xref",
+    "guess_primary_graph",
     "read",
 ]

obographs-0.0.8/src/obographs/contrib.py

@@ -0,0 +1,71 @@
+"""Extra functionality that isn't part of the core obographs package."""
+
+from __future__ import annotations
+
+from typing import overload
+
+from .model import Graph, GraphDocument
+from .standardized import StandardizedGraph, StandardizedGraphDocument
+
+__all__ = [
+    "guess_primary_graph",
+]
+
+CANONICAL = {
+    "mamo": "http://identifiers.org/mamo",
+    "swo": "http://www.ebi.ac.uk/swo/swo.json",
+    "ito": "https://identifiers.org/ito:ontology",
+    "apollosv": "http://purl.obolibrary.org/obo/apollo_sv.owl",
+    "cheminf": "http://semanticchemistry.github.io/semanticchemistry/ontology/cheminf.owl",
+    "dideo": "http://purl.obolibrary.org/obo/dideo/release/2022-06-14/dideo.owl",
+    "micro": "http://purl.obolibrary.org/obo/MicrO.owl",
+    "ogsf": "http://purl.obolibrary.org/obo/ogsf-merged.owl",
+    "mfomd": "http://purl.obolibrary.org/obo/MF.owl",
+    "one": "http://purl.obolibrary.org/obo/ONE",
+    "ons": "https://raw.githubusercontent.com/enpadasi/Ontology-for-Nutritional-Studies/master/ons.owl",
+    "ontie": "https://ontology.iedb.org/ontology/ontie.owl",
+}
+
+
+# docstr-coverage:excused `overload`
+@overload
+def guess_primary_graph(
+    graph_document: GraphDocument,
+    prefix: str,
+) -> Graph: ...
+
+
+# docstr-coverage:excused `overload`
+@overload
+def guess_primary_graph(
+    graph_document: StandardizedGraphDocument,
+    prefix: str,
+) -> StandardizedGraph: ...
+
+
+def guess_primary_graph(
+    graph_document: GraphDocument | StandardizedGraphDocument,
+    prefix: str,
+) -> Graph | StandardizedGraph:
+    """Guess the primary graph from a graph document."""
+    if 0 == len(graph_document.graphs):
+        raise ValueError("Could not automatically identify the primary graph from empty list")
+    elif 1 == len(graph_document.graphs):
+        return graph_document.graphs[0]
+
+    id_to_graph = {graph.id: graph for graph in graph_document.graphs if graph.id}
+
+    # Check for standard construction of OBO PURLs
+    for suffix in ["owl", "obo", "json"]:
+        standard_id = f"http://purl.obolibrary.org/obo/{prefix.lower()}.{suffix}"
+        if standard_id in id_to_graph:
+            return id_to_graph[standard_id]
+
+    # Check if we've manually curated a mapping
+    if prefix in CANONICAL and CANONICAL[prefix] in id_to_graph:
+        return id_to_graph[CANONICAL[prefix]]
+
+    raise ValueError(
+        f"Could not automatically identify the primary graph for {prefix=} from "
+        f"{len(id_to_graph):,} graphs:\n\n{sorted(id_to_graph)}"
+    )

{obographs-0.0.6 → obographs-0.0.8}/src/obographs/model.py

@@ -184,11 +184,30 @@ class Graph(BaseModel):
     domainRangeAxioms: list[DomainRangeAxiom] = Field(default_factory=list)  # noqa:N815
     propertyChainAxioms: list[PropertyChainAxiom] = Field(default_factory=list)  # noqa:N815
 
-    def standardize(self, converter: curies.Converter) -> StandardizedGraph:
+    def _get_property(self, predicate: str) -> str | None:
+        if self.meta is not None:
+            for prop in self.meta.basicPropertyValues or []:
+                if prop.pred == predicate and prop.val:
+                    return prop.val
+        return None
+
+    @property
+    def name(self) -> str | None:
+        """Get the title."""
+        return self._get_property("http://purl.org/dc/terms/title")
+
+    @property
+    def version(self) -> str | None:
+        """Get the version."""
+        return self._get_property("http://www.w3.org/2002/07/owl#versionInfo")
+
+    def standardize(
+        self, converter: curies.Converter, *, strict: bool = False
+    ) -> StandardizedGraph:
         """Standardize the graph."""
         from .standardized import StandardizedGraph
 
-        return StandardizedGraph.from_obograph_raw(self, converter)
+        return StandardizedGraph.from_obograph_raw(self, converter, strict=strict)
 
 
 class GraphDocument(BaseModel):

{obographs-0.0.6 → obographs-0.0.8}/src/obographs/standardized.py

@@ -8,7 +8,7 @@ from typing import Generic, TypeVar, cast
 
 import curies.preprocessing
 from curies import Converter, Reference, Triple, vocabulary
-from curies.vocabulary import SynonymScopeOIO
+from curies.vocabulary import SynonymScopeOIO, has_title, owl_version_info
 from pydantic import BaseModel, Field
 from typing_extensions import Self
 
@@ -209,7 +209,7 @@ class StandardizedMeta(StandardizedBaseModel[Meta]):
     synonyms: list[StandardizedSynonym] | None = None
     comments: list[str] | None = None
     deprecated: bool = False
-    version: str | None = None
+    version_iri: str | None = None
     properties: list[StandardizedProperty] | None = None
 
     @classmethod
@@ -272,7 +272,7 @@ class StandardizedMeta(StandardizedBaseModel[Meta]):
             xrefs=xrefs or None,
             synonyms=synonyms or None,
             comments=meta.comments,
-            version=meta.version,
+            version_iri=meta.version,
             deprecated=meta.deprecated,
             properties=props or None,
         )
@@ -287,7 +287,7 @@ class StandardizedMeta(StandardizedBaseModel[Meta]):
             xrefs=[xref.to_raw(converter) for xref in self.xrefs] if self.xrefs else None,
             synonyms=[s.to_raw(converter) for s in self.synonyms] if self.synonyms else None,
             comments=self.comments,
-            version=self.version,  # TODO might need some kind of expansion?
+            version=self.version_iri,
             deprecated=self.deprecated,
             basicPropertyValues=[p.to_raw(converter) for p in self.properties]
             if self.properties
@@ -623,7 +623,15 @@ class StandardizedGraph(StandardizedBaseModel[Graph]):
     @property
     def name(self) -> str | None:
         """Look up the name of the graph."""
-        r = self._get_property(Reference(prefix="dcterms", identifier="title"))
+        r = self._get_property(has_title)
+        if isinstance(r, Reference):
+            raise TypeError
+        return r
+
+    @property
+    def version(self) -> str | None:
+        """Get the version."""
+        r = self._get_property(owl_version_info)
         if isinstance(r, Reference):
             raise TypeError
         return r

{obographs-0.0.6 → obographs-0.0.8}/src/obographs/version.py

@@ -12,7 +12,7 @@ __all__ = [
     "get_version",
 ]
 
-VERSION = "0.0.6"
+VERSION = "0.0.8"
 
 
 def get_git_hash() -> str: