iolanta 2.0.0__py3-none-any.whl → 2.0.2__py3-none-any.whl

iolanta/cli/formatters/choose.py

@@ -7,7 +7,7 @@ from iolanta.cli.formatters.json import print_json
 from iolanta.cli.formatters.pretty import pretty_print
 from iolanta.models import QueryResultsFormat
 from iolanta.node_to_qname import node_to_qname
-from ldflex.ldflex import SelectResult
+from iolanta.query_result import SelectResult
 
 
 # @cli_print.instance(SelectResult)

iolanta/cli/formatters/csv.py

@@ -4,7 +4,7 @@ import sys
 from classes import typeclass
 from rdflib import Graph
 
-from ldflex.ldflex import QueryResult, SelectResult
+from iolanta.query_result import QueryResult, SelectResult
 
 
 @typeclass

iolanta/cli/formatters/json.py

@@ -4,7 +4,7 @@ import sys
 from classes import typeclass
 from rdflib import Graph
 
-from ldflex.ldflex import QueryResult, SelectResult
+from iolanta.query_result import QueryResult, SelectResult
 
 
 @typeclass

iolanta/cli/formatters/pretty.py

@@ -1,5 +1,4 @@
 import itertools
-from datetime import date
 from typing import Union
 
 from classes import typeclass
@@ -10,7 +9,7 @@ from rich.table import Table
 
 from iolanta.cli.pretty_print import render_literal_value
 from iolanta.models import ComputedQName
-from ldflex.ldflex import QueryResult, SelectResult
+from iolanta.query_result import QueryResult, SelectResult
 
 
 @typeclass

iolanta/cyberspace/processor.py

@@ -111,7 +111,7 @@ def _extract_from_mapping(  # noqa: WPS213
     algebra: Mapping[str, Any],
 ) -> Iterable[URIRef | Variable]:
     match algebra.name:
-        case 'SelectQuery' | 'Project' | 'Distinct':
+        case 'SelectQuery' | 'AskQuery' | 'Project' | 'Distinct':
             yield from extract_mentioned_urls(algebra['p'])
 
         case 'BGP':
@@ -260,7 +260,7 @@ def _extract_nanopublication_uris(
 ) -> Iterable[URIRef]:
     """Extract nanopublications to get retracting information for."""
     match algebra.name:
-        case 'SelectQuery' | 'Project' | 'Distinct' | 'Graph':
+        case 'SelectQuery' | 'AskQuery' | 'Project' | 'Distinct' | 'Graph':
             yield from _extract_nanopublication_uris(algebra['p'])
 
         case 'BGP':
@@ -429,7 +429,12 @@ class GlobalSPARQLProcessor(Processor):  # noqa: WPS338, WPS214
 
             query_result = evalQuery(self.graph, query, initBindings, base)
 
-            bindings = list(query_result['bindings'])
+            try:
+                bindings = list(query_result['bindings'])
+            except KeyError:
+                # This was probably an ASK query
+                return query_result
+
             for row in bindings:
                 for _, maybe_iri in row.items():
                     if (

iolanta/data/textual-browser.yaml

@@ -10,6 +10,11 @@
   dcterms: https://purl.org/dc/terms/
   xsd: https://www.w3.org/2001/XMLSchema#
 
+  iolanta:outputs:
+    "@type": "@id"
+
+  $: rdfs:label
+
 "@included":
   - $id: iolanta:icon
     rdfs:label: Icon
@@ -107,3 +112,7 @@
   - $id: https://iolanta.tech/qname
     iolanta:hasDefaultFacet:
       $id: python://iolanta.facets.qname.QNameFacet
+
+  - $id: python://iolanta.facets.textual_property_pairs_table.TextualPropertyPairsTableFacet
+    iolanta:outputs: https://iolanta.tech/cli/textual
+    $: Subjects → Objects

iolanta/facets/facet.py

@@ -2,13 +2,12 @@ import inspect
 from dataclasses import dataclass, field
 from functools import cached_property
 from pathlib import Path
-from typing import Any, Generic, Iterable, List, Optional, TypeVar, Union
+from typing import Any, Generic, Iterable, Optional, TypeVar, Union
 
 from rdflib.term import BNode, Literal, Node, URIRef
 
 from iolanta.models import NotLiteralNode, Triple, TripleTemplate
-from ldflex import LDFlex
-from ldflex.ldflex import QueryResult, SPARQLQueryArgument
+from iolanta.query_result import QueryResult, SPARQLQueryArgument
 
 FacetOutput = TypeVar('FacetOutput')
 
@@ -21,16 +20,16 @@ class Facet(Generic[FacetOutput]):
     iolanta: 'iolanta.Iolanta' = field(repr=False)
     as_datatype: Optional[NotLiteralNode] = None
 
+    @property
+    def this(self) -> NotLiteralNode:
+        """This node."""
+        return self.iri
+
     @property
     def stored_queries_path(self) -> Path:
         """Construct directory for stored queries for this facet."""
         return Path(inspect.getfile(self.__class__)).parent / 'sparql'
 
-    @property
-    def ldflex(self) -> LDFlex:
-        """Extract LDFLex instance."""
-        return self.iolanta.ldflex
-
     @cached_property
     def uriref(self) -> NotLiteralNode:
         """Format as URIRef."""
@@ -45,7 +44,7 @@ class Facet(Generic[FacetOutput]):
         **kwargs: SPARQLQueryArgument,
     ) -> QueryResult:
         """SPARQL query."""
-        return self.ldflex.query(
+        return self.iolanta.query(
             query_text=query_text,
             **kwargs,
         )

iolanta/facets/locator.py

@@ -15,7 +15,7 @@ class FoundRow(TypedDict):
     """Facet and datatype to render an IRI."""
 
     facet: NotLiteralNode
-    as_datatype: NotLiteralNode
+    output_datatype: NotLiteralNode
 
 
 def reorder_rows_by_facet_preferences(   # noqa: WPS214, WPS210
@@ -103,6 +103,29 @@ class FacetFinder:   # noqa: WPS214
             key=self.row_sorter_by_output_datatype,
         )
 
+    def by_sparql(self) -> Iterable[FoundRow]:
+        """Determine facet by SHACL shape of the data."""
+        if not isinstance(self.node, URIRef):
+            return
+
+        if self.as_datatype != URIRef('https://iolanta.tech/cli/textual'):
+            return
+
+        # TODO: Retrieve queries from the graph
+        # TODO: Verify datatype for which we are visualizing $this
+        query_to_facet = {
+            'ASK WHERE { ?subject $this ?object }': URIRef(
+                'python://iolanta.facets.textual_property_pairs_table'
+                '.TextualPropertyPairsTableFacet',
+            ),
+        }
+
+        for query, facet in query_to_facet.items():
+            # TODO: Verify that `query` is an ASK query
+            is_matching = self.iolanta.query(query, this=self.node)
+            if is_matching:
+                yield FoundRow(facet=facet, output_datatype=self.as_datatype)
+
     def by_prefix(self) -> Iterable[FoundRow]:
         """Determine facet by URL prefix.
 
@@ -254,6 +277,7 @@ class FacetFinder:   # noqa: WPS214
 
     def _found_facets(self) -> Iterable[FoundRow]:
         """Compose a stream of all possible facet choices."""
+        yield from self.by_sparql()
         yield from self.by_prefix()
         yield from self.by_datatype()
         yield from self.by_facet()

iolanta/facets/textual_property_pairs_table.py

@@ -0,0 +1,133 @@
+from collections import defaultdict
+from typing import Iterable
+
+import funcy
+from rdflib import Literal, Node
+from rich.style import Style
+from rich.text import Text
+from textual.containers import Vertical
+from textual.coordinate import Coordinate
+from textual.widgets import DataTable
+
+from iolanta import Facet
+from iolanta.facets.page_title import PageTitle
+from iolanta.models import NotLiteralNode
+from iolanta.namespaces import DATATYPES
+from iolanta.widgets.mixin import IolantaWidgetMixin
+
+PAIRS_QUERY = """
+SELECT ?subject ?object WHERE {
+    ?subject $this ?object .
+} ORDER BY ?subject ?object
+"""
+
+
+class PairsTable(IolantaWidgetMixin, DataTable):
+    """Render subject → object properties as a table with two columns."""
+
+    BINDINGS = [
+        ('enter', 'goto', 'Goto'),
+    ]
+
+    def __init__(self, pairs: Iterable[tuple[NotLiteralNode, Node]]):
+        """Construct."""
+        super().__init__(show_header=False, cell_padding=1)
+        self.pairs = list(pairs)
+
+    def render_human_readable_cells(self):
+        """Replace the cells with their human readable titles."""
+        terms_and_coordinates = sorted(
+            self.node_to_coordinates.items(),
+            key=lambda node_and_coordinates_pair: len(
+                node_and_coordinates_pair[1],
+            ),
+            reverse=True,
+        )
+
+        for term, coordinates in terms_and_coordinates:
+            title = self.iolanta.render(term, as_datatype=DATATYPES.title)
+            for coordinate in coordinates:
+                self.app.call_from_thread(
+                    self.update_cell_at,
+                    coordinate,
+                    value=Text(title, no_wrap=False),
+                    update_width=False,
+                )
+
+    @funcy.cached_property
+    @funcy.post_processing(dict)
+    def coordinate_to_node(self):
+        """Return a mapping of coordinates to their corresponding nodes."""
+        for row_number, (subject, object_term) in enumerate(self.pairs):
+            yield Coordinate(row_number, 0), subject
+            yield Coordinate(row_number, 1), object_term
+
+    @funcy.cached_property
+    def node_to_coordinates(self) -> defaultdict[Node, list[Coordinate]]:
+        """Map node to coordinates where it appears."""
+        node_to_coordinate = [
+            (node, coordinate)
+            for coordinate, node in self.coordinate_to_node.items()
+        ]
+        return funcy.group_values(node_to_coordinate)
+
+    def format_as_loading(self, node: Node) -> Text:
+        """Intermediate version of a value while it is loading."""
+        if isinstance(node, Literal):
+            node_text = f'⌛ {node}'
+        else:
+            node_text = self.iolanta.node_as_qname(node)
+            node_text = f'⌛ {node_text}'
+
+        return Text(
+            node_text,
+            style=Style(dim=True),
+            no_wrap=False,
+        )
+
+    def on_mount(self):
+        """Fill the table and start rendering."""
+        self.add_columns('Subject', 'Object')
+        self.cell_padding = 1
+
+        for subject, object_term in self.pairs:
+            self.add_row(
+                self.format_as_loading(subject),
+                self.format_as_loading(object_term),
+            )
+
+        self.run_worker(
+            self.render_human_readable_cells,
+            thread=True,
+        )
+
+    def action_goto(self):
+        """Navigate to the selected node."""
+        if self.cursor_coordinate:
+            node = self.coordinate_to_node.get(self.cursor_coordinate)
+            if node is not None:
+                self.app.action_goto(node)
+
+
+class TextualPropertyPairsTableFacet(Facet):
+    """Render a table of subject → object pairs for a property."""
+
+    def show(self):
+        """Construct the table."""
+        rows = self.query(
+            PAIRS_QUERY,
+            this=self.this,
+        )
+
+        return Vertical(
+            PageTitle(
+                self.this,
+                extra='— Subjects & Objects connected by this property',
+            ),
+            PairsTable(
+                [
+                    (row['subject'], row['object'])
+                    for row in rows
+                ],
+            ),
+        )

iolanta/iolanta.py

@@ -18,8 +18,10 @@ from typing import (  # noqa: WPS235
 import funcy
 import loguru
 import yaml_ld
-from rdflib import ConjunctiveGraph, Literal, Namespace, URIRef
+from pyparsing import ParseException
+from rdflib import ConjunctiveGraph, Graph, Literal, Namespace, URIRef
 from rdflib.namespace import NamespaceManager
+from rdflib.plugins.sparql.processor import SPARQLResult
 from rdflib.term import Node
 from yaml_ld.document_loaders.content_types import ParserNotFound
 from yaml_ld.errors import YAMLLDError
@@ -44,8 +46,13 @@ from iolanta.node_to_qname import node_to_qname
 from iolanta.parse_quads import parse_quads
 from iolanta.parsers.yaml import YAML
 from iolanta.plugin import Plugin
+from iolanta.query_result import (
+    QueryResult,
+    SPARQLParseException,
+    SPARQLQueryArgument,
+    format_query_bindings,
+)
 from iolanta.resolvers.python_import import PythonImportResolver
-from ldflex import LDFlex
 
 
 class LoggerProtocol(Protocol):
@@ -124,14 +131,56 @@ class Iolanta:   # noqa: WPS214
             for plugin_class in self.plugin_classes
         ]
 
-    @property
-    def ldflex(self) -> LDFlex:
+    def query(
+        self,
+        query_text: str,
+        **kwargs: SPARQLQueryArgument,
+    ) -> QueryResult:
         """
-        Create ldflex instance.
+        Run a SPARQL `SELECT`, `CONSTRUCT`, or `ASK` query.
 
-        FIXME: Get rid of it.
+        Args:
+            query_text: The SPARQL text;
+            **kwargs: bind variables in the query to values if necessary. For
+                example:
+
+                ```python
+                iolanta.query(
+                    'SELECT ?title WHERE { ?page rdfs:label ?title }',
+                    ?page=page_iri,
+                )
+                ```
+
+        Returns:
+            Results of the query:
+
+            - a graph for `CONSTRUCT`,
+            - a list of dicts for `SELECT`,
+            - or a boolean for `ASK`.
         """
-        return LDFlex(self.graph)
+        try:
+            sparql_result: SPARQLResult = self.graph.query(
+                query_text,
+                processor='cyberspace',
+                initBindings=kwargs,
+            )
+        except ParseException as err:
+            raise SPARQLParseException(
+                error=err,
+                query=query_text,
+            ) from err
+
+        if sparql_result.askAnswer is not None:
+            return sparql_result.askAnswer
+
+        if sparql_result.graph is not None:
+            graph: Graph = sparql_result.graph
+            for prefix, namespace in self.graph.namespaces():
+                graph.bind(prefix, namespace)
+
+            return graph
+
+        return format_query_bindings(sparql_result.bindings)
 
     @functools.cached_property
     def namespaces_to_bind(self) -> Dict[str, Namespace]:
@@ -253,12 +302,6 @@ class Iolanta:   # noqa: WPS214
         self.graph.bind(prefix='dcterms', namespace=namespaces.DCTERMS)
         self.graph.bind(prefix='rdfg', namespace=namespaces.RDFG)
 
-    @property
-    def query(self):
-        """Make a SPARQL query."""
-        self.maybe_infer()
-        return self.ldflex.query
-
     @functools.cached_property
     def context_paths(self) -> Iterable[Path]:
         """

iolanta/query_result.py

@@ -0,0 +1,73 @@
+from dataclasses import dataclass
+from typing import Dict, List, Mapping, Optional, Union
+
+from documented import DocumentedError
+from frozendict import frozendict
+from pyparsing import ParseException
+from rdflib import Graph
+from rdflib.term import Identifier, Node, Variable
+
+SelectRow = Mapping[str, Node]
+
+
+class SelectResult(List[SelectRow]):
+    """Result of a SPARQL SELECT."""
+
+    @property
+    def first(self) -> Optional[SelectRow]:
+        """Return first element of the list."""
+        return self[0] if self else None
+
+
+SPARQLQueryArgument = Optional[Union[Node, str, int, float]]
+
+
+QueryResult = Union[
+    SelectResult,   # SELECT
+    Graph,          # CONSTRUCT
+    bool,           # ASK
+]
+
+
+def format_query_bindings(
+    bindings: List[Dict[Variable, Identifier]],
+) -> SelectResult:
+    """
+    Format bindings before returning them.
+
+    Converts Variable to str for ease of addressing.
+    """
+    return SelectResult([
+        frozendict({
+            str(variable_name): rdf_value
+            for variable_name, rdf_value   # noqa: WPS361
+            in row.items()
+        })
+        for row in bindings
+    ])
+
+
+@dataclass
+class SPARQLParseException(DocumentedError):
+    """
+    SPARQL query is invalid.
+
+    Error:
+
+    ```
+    {self.error}
+    ```
+
+    Query:
+    ```sparql hl_lines="{self.highlight_code}"
+    {self.query}
+    ```
+    """  # noqa: D412
+
+    error: ParseException
+    query: str
+
+    @property
+    def highlight_code(self):
+        """Define lines to highlight."""
+        return self.error.lineno

{iolanta-2.0.0.dist-info → iolanta-2.0.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: iolanta
-Version: 2.0.0
+Version: 2.0.2
 Summary: Semantic Web browser
 License: MIT
 Author: Anatoly Scherbakov

{iolanta-2.0.0.dist-info → iolanta-2.0.2.dist-info}/RECORD

@@ -2,10 +2,10 @@ iolanta/__init__.py,sha256=BvLP-LYFmNYS5F8VPXdzpEEMk8zcm9NMmlUWw9yEtj0,153
 iolanta/base_plugin.py,sha256=vI4DRSIITlKZw8x7Q58BFkChWlg1h8zV-tuNvIKURBI,86
 iolanta/cli/__init__.py,sha256=IV6_RPmrbpPWbdKojuFczwaJAaKm1DIDQh5aZWbeR1U,69
 iolanta/cli/formatters/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-iolanta/cli/formatters/choose.py,sha256=Ac4hNoptvnhuJB77K9KOn5oMF7j2RxmNuaLko28Wlns,1122
-iolanta/cli/formatters/csv.py,sha256=OVucZxhcMjihUli0wkbSOKo500-i7DNV0Zdf6oIougU,753
-iolanta/cli/formatters/json.py,sha256=jkNldFApSWw0kcMkeIPvI2Vt4JTE-Rvx5mWqKJb3Sj4,741
-iolanta/cli/formatters/pretty.py,sha256=Ik75CR5GMBDJCvES9eF0bQPj64ZJD40iFDSSZH0s9aA,2920
+iolanta/cli/formatters/choose.py,sha256=LWzsO_9IBSSgYNIyLlItkp8TNvpW3v6YCQ8-6kbICI4,1129
+iolanta/cli/formatters/csv.py,sha256=ceJ_DTz0beqeK-d6FPBQqqjXrziEfF0FRSLoGZCt_fs,760
+iolanta/cli/formatters/json.py,sha256=Og5B9UrSM_0NWqW5Afpsy6WH8ZfYgPMVXYvT3i-43Jc,748
+iolanta/cli/formatters/pretty.py,sha256=IypZRAr2vNqcXFY6NOIc75mpyfpFWh56aCBlOPDDieQ,2901
 iolanta/cli/main.py,sha256=exDWPljllufn7DiGC9lS1pvojFX9YZJciQ2RPCedKMU,3127
 iolanta/cli/models.py,sha256=cjbpowdzI4wAP0DUk3qoVHyimk6AZwlXi9CGmusZTuM,159
 iolanta/cli/pretty_print.py,sha256=M6E3TmhzA6JY5GeUVmDZLmOh5u70-393PVit4voFKDI,977
@@ -14,12 +14,12 @@ iolanta/conversions.py,sha256=hbLwRF1bAbOxy17eMWLHhYksbdCWN-v4-0y0wn3XSSg,1185
 iolanta/cyberspace/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 iolanta/cyberspace/inference/wikibase-claim.sparql,sha256=JSawj3VTc9ZPoU9mvh1w1AMYb3cWyZ3x1rEYWUsKZ6A,209
 iolanta/cyberspace/inference/wikibase-statement-property.sparql,sha256=SkSHZZlxWVDwBM3aLo0Q7hLuOj9BsIQnXtcuAuwaxqU,240
-iolanta/cyberspace/processor.py,sha256=rxO5MaZEoXD2Kzknq7eRH3yuv8kQ5UILy8qkJxramMY,21828
+iolanta/cyberspace/processor.py,sha256=USGe54XuNMNYYl-Hed1bKxeqZLUhrb1jNRUDbWpay4A,21990
 iolanta/data/cli.yaml,sha256=TsnldYXoY5GIzoNuPDvwBKGw8eAEForZW1FCKqKI0Kg,1029
 iolanta/data/context.yaml,sha256=OULEeDkSqshabaXF_gMujgwFLDJvt9eQn_9FftUlSUw,1424
 iolanta/data/html.yaml,sha256=hVFdLWLy8FMY8xpOrJMYc-tE3S0Nq83xuxVkjRW_7rI,517
 iolanta/data/iolanta.yaml,sha256=xubIFBNU02lmFXhgOSuyQwUcZD3xCqVfeVAZMvOxKbI,1433
-iolanta/data/textual-browser.yaml,sha256=ViMQJLiqa3CHdXluv9Fk3bEtyYC2ezNoHO7kQEp_N7w,3799
+iolanta/data/textual-browser.yaml,sha256=8aGKLN_xnSX5o3dpBLsh8kPMfEsiysOd2QX-pn0Vfd4,4031
 iolanta/ensure_is_context.py,sha256=9aok8asyEx7KPesOR28VBDb3Ch9kfc3eoCpQSJwj07U,717
 iolanta/entry_points.py,sha256=DZbf-udlEwELFGqeWENj0M2BOUPOWlmGJdqyaEtnot0,504
 iolanta/errors.py,sha256=t_RltahnoEvcytVa1BOq2MADgHps3JNd_h5-SFu7_wM,1250
@@ -31,7 +31,7 @@ iolanta/facets/cli/record.py,sha256=lBsECxLkwVSXC-yHmUwfosxAdLBI-0UoqHe8GOCablY,
 iolanta/facets/cli/sparql/link.sparql,sha256=WtWEfLAvdGc2gP0IhZil6Vglkydc3VO24vk4GwRnR5I,163
 iolanta/facets/cli/sparql/record.sparql,sha256=GBWkmNelvaSDbvl7v0-LsJHdjFPbsSAW49kNFOUeoGQ,63
 iolanta/facets/errors.py,sha256=sEBmnzhFcRIgOT18hfNwyMMjry0waa6IB-jC2NVTA50,4124
-iolanta/facets/facet.py,sha256=6TAhKxhBLRNII6bjQzOCzqTR1L7zaaB95nliQmVlmJ0,2865
+iolanta/facets/facet.py,sha256=QByUVrvt_XVBoVhfuyk6lKO--pauhMEN79GWmgejdIo,2822
 iolanta/facets/foaf_person_title/__init__.py,sha256=oj4MNVQvv8Dysb27xiWjtZCii8-nT7-WFa3WMWUwbtU,67
 iolanta/facets/foaf_person_title/facet.py,sha256=Q9TajjGp1v729quDzAM_Lfzawls3yujp1Z_6jXrG3gY,632
 iolanta/facets/foaf_person_title/sparql/names.sparql,sha256=p_2hHZXhEaJ8IwGlvLoN0vb0vhGqo44uAVRpDyTzflU,107
@@ -45,7 +45,7 @@ iolanta/facets/html/base.py,sha256=JcpK7YM_QQE9vwH5w5F_EgPkPv-XRzOrcZlVSy4LhIs,1
 iolanta/facets/html/code_literal.py,sha256=qCddzBrg6Y5XMIKohFQ52Tf9GPOcU7bj83tfAU1FLLU,394
 iolanta/facets/html/default.py,sha256=Dmf_kYiL2M954iigyYsiWrMstwZ1nvxKetuR6aW3xYY,647
 iolanta/facets/icon.py,sha256=ddZcolx1Q5_wo3w0jqiCzcc5Lsru6-jA7s7oAd1T8Og,494
-iolanta/facets/locator.py,sha256=tFwxGT4ujwEjwkgTevK6gwWfj3_1lU9Q305IU7a-I3Y,7697
+iolanta/facets/locator.py,sha256=0FNISVG_Q4Mk8j6ZX0tmIM-YfnewdKJSf7BYQIwb-lc,8636
 iolanta/facets/page_title.py,sha256=TwgZK2g_e5UoWYjKNgDzzkmq1EI3cY58680iC8N9kZI,1407
 iolanta/facets/qname.py,sha256=ztyBbjjcW8dNZzuiNMqhcWfAUxk-gSjbseVGrQE7kVY,531
 iolanta/facets/textual_browser/__init__.py,sha256=sKgDvXOwib9n9d63kdtKCEv26-FoL0VN6zxDmfcheZ8,104
@@ -86,6 +86,7 @@ iolanta/facets/textual_ontology/__init__.py,sha256=3H6bfYaEbXFr90C6ZpGWC4O-24uaO
 iolanta/facets/textual_ontology/facets.py,sha256=60g8ANmePb9_i_-d4ui-FdtNwg9aktrOKXHkTQtLp1w,3338
 iolanta/facets/textual_ontology/sparql/terms.sparql,sha256=oVLxN452nqog_95qRaTWnvar6rxPNxPrRonSo7oFFTg,324
 iolanta/facets/textual_ontology/sparql/visualization-vocab.sparql,sha256=q9TmU15deL0da28mpo_8W8fgMSEcENfYeqLyM0zVbTg,65
+iolanta/facets/textual_property_pairs_table.py,sha256=Drqc_G_6QhzNmrrfDU170eKTGrVmvQ6JMYu4ir--iUk,4176
 iolanta/facets/textual_provenance/__init__.py,sha256=k5-_iK8Lrdwr5ZEJaDxq-UhGYe4G_adXVqGfOA5DAP8,114
 iolanta/facets/textual_provenance/facets.py,sha256=vv3UQsI2duB36DW5Zkw3sqgAXBPmK_xAo7cU0O7jF8g,3767
 iolanta/facets/textual_provenance/sparql/graphs.sparql,sha256=B45uKFd-1vrBuMDSbTURjUUEjHt51vAbqdL4tUcgMvk,103
@@ -96,7 +97,7 @@ iolanta/facets/title/sparql/title.sparql,sha256=4rz47tjwX2OJavWMzftaYKil1-ZHB76Z
 iolanta/facets/wikibase_statement_title/__init__.py,sha256=_yk1akxgSJOiUBJIc8QGrD2vovvmx_iw_vJDuv1rD7M,91
 iolanta/facets/wikibase_statement_title/facets.py,sha256=mUH7twlAgoeX7DgLQuRBQv4ORT6GWbN-0eJ1aliSfiQ,724
 iolanta/facets/wikibase_statement_title/sparql/statement-title.sparql,sha256=n07DQWxKqB5c3CA4kacq2HSN0R0dLgnMnLP1AxMo5YA,320
-iolanta/iolanta.py,sha256=3oxkE3nG8zBE7v46zuO3ftga623D2Nl_M-nMLtVC8Bk,12852
+iolanta/iolanta.py,sha256=ZZ5hBXuVci4v-36xYLeaqDjgo85kEnnYCA07eJMo9ME,14230
 iolanta/loaders/__init__.py,sha256=QTiKCsQc1BTS-IlY2CQsN9iVpEIPqYFvI9ERMYVZCbU,99
 iolanta/loaders/base.py,sha256=-DxYwqG1bfDXB2p_S-mKpkc_3Sh14OHhePbe65Iq3-s,3381
 iolanta/loaders/data_type_choice.py,sha256=zRUXBIzjvuW28P_dhMDVevE9C8EFEIx2_X39WydWrtM,1982
@@ -118,6 +119,7 @@ iolanta/parsers/json.py,sha256=3VrDiz-SaVXP9_B03Gl62VSIk2fKeRrrb2hpTLxqBk4,967
 iolanta/parsers/markdown.py,sha256=wv-PhszgoDOzWdisykIeZyYBD1edCVmw7UQ8jEn4siw,1669
 iolanta/parsers/yaml.py,sha256=MeTe5_OaDK27XB38AzxjqWfCxybAm4tqgqn7LLh-YB0,1244
 iolanta/plugin.py,sha256=MSxpuOIx93AgBahfS8bYh31MEgcwtUSQhj4Js7fgdSI,1096
+iolanta/query_result.py,sha256=VLLBkewUEymtzfB0jeIeRE3Np6pAgo959RPgNsEmiq8,1545
 iolanta/reformat_blank_nodes.py,sha256=MAVcXusUioKzAoTEHAMume5Gt9vBEpxJGrngqFzmkJI,712
 iolanta/resolvers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 iolanta/resolvers/base.py,sha256=cc9bcrVZ0wTwn85I-IYCwcIRU5Lwaph8D00C0dwSOm8,302
@@ -125,9 +127,7 @@ iolanta/resolvers/python_import.py,sha256=kDOhApBDFfxnrDgK9M7ztMkqXfcny81Zo86FgP
 iolanta/shortcuts.py,sha256=j8b0E_yeoas8GumsPOfxO2v2jO0noqpmKJ6LFxFfsu4,1892
 iolanta/widgets/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 iolanta/widgets/mixin.py,sha256=nDRCOc-gizCf1a5DAcYs4hW8eZEd6pHBPFsfm0ncv7E,251
-ldflex/__init__.py,sha256=8IELqR55CQXuI0BafjobXSK7_kOc-qKVTrEtEwXnZRA,33
-ldflex/ldflex.py,sha256=omKmOo5PUyn8Evw4q_lqKCJOq6yqVOcLAYxnYkdwOUs,3332
-iolanta-2.0.0.dist-info/METADATA,sha256=Lg09YX2eoU7Dr4AaYDKUl5-978C-m0TeFX53zE0W9l4,2230
-iolanta-2.0.0.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-iolanta-2.0.0.dist-info/entry_points.txt,sha256=fIp9g4kzjSNcTsTSjUCk4BIG3laHd3b3hUZlkjgFAGU,179
-iolanta-2.0.0.dist-info/RECORD,,
+iolanta-2.0.2.dist-info/METADATA,sha256=BMCrSsOvKpNz7vzyS1iFXXWffpee_tGU1Rtvf_BF4Xc,2230
+iolanta-2.0.2.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+iolanta-2.0.2.dist-info/entry_points.txt,sha256=fIp9g4kzjSNcTsTSjUCk4BIG3laHd3b3hUZlkjgFAGU,179
+iolanta-2.0.2.dist-info/RECORD,,

ldflex/__init__.py

@@ -1 +0,0 @@
-from ldflex.ldflex import LDFlex

ldflex/ldflex.py

@@ -1,138 +0,0 @@
-from dataclasses import dataclass
-from typing import Dict, List, Mapping, Optional, Union
-
-from documented import DocumentedError
-from frozendict import frozendict
-from pyparsing import ParseException
-from rdflib import Graph
-from rdflib.plugins.sparql.processor import SPARQLResult
-from rdflib.term import Identifier, Node, Variable
-
-from iolanta.cyberspace.processor import GlobalSPARQLProcessor
-
-SelectRow = Mapping[str, Node]
-
-
-class SelectResult(List[SelectRow]):
-    """Result of a SPARQL SELECT."""
-
-    @property
-    def first(self) -> Optional[SelectRow]:
-        """Return first element of the list."""
-        return self[0] if self else None
-
-
-SPARQLQueryArgument = Optional[Union[Node, str, int, float]]
-
-
-QueryResult = Union[
-    SelectResult,   # SELECT
-    Graph,          # CONSTRUCT
-    bool,           # ASK
-]
-
-
-def _format_query_bindings(
-    bindings: List[Dict[Variable, Identifier]],
-) -> SelectResult:
-    """
-    Format bindings before returning them.
-
-    Converts Variable to str for ease of addressing.
-    """
-    return SelectResult([
-        frozendict({
-            str(variable_name): rdf_value
-            for variable_name, rdf_value
-            in row.items()
-        })
-        for row in bindings
-    ])
-
-
-@dataclass
-class SPARQLParseException(DocumentedError):
-    """
-    SPARQL query is invalid.
-
-    Error:
-
-    ```
-    {self.error}
-    ```
-
-    Query:
-    ```sparql hl_lines="{self.highlight_code}"
-    {self.query}
-    ```
-    """
-
-    error: ParseException
-    query: str
-
-    @property
-    def highlight_code(self):
-        """Define lines to highlight."""
-        return self.error.lineno
-
-
-@dataclass
-class LDFlex:
-    """Fluent interface to a semantic graph."""
-
-    graph: Graph
-
-    def query(
-        self,
-        query_text: str,
-        **kwargs: SPARQLQueryArgument,
-    ) -> QueryResult:
-        """
-        Run a SPARQL `SELECT`, `CONSTRUCT`, or `ASK` query.
-
-        Args:
-            query_text: The SPARQL text;
-            **kwargs: bind variables in the query to values if necessary. For
-                example:
-
-                ```python
-                ldflex.query(
-                    'SELECT ?title WHERE { ?page rdfs:label ?title }',
-                    ?page=page_iri,
-                )
-                ```
-
-        Returns:
-            Results of the query:
-
-            - a graph for `CONSTRUCT`,
-            - a list of dicts for `SELECT`,
-            - or a boolean for `ASK`.
-        """
-        try:
-            sparql_result: SPARQLResult = self.graph.query(
-                query_text,
-                processor='cyberspace',
-                initBindings=kwargs,
-            )
-        except ParseException as err:
-            raise SPARQLParseException(
-                error=err,
-                query=query_text,
-            ) from err
-
-        if sparql_result.askAnswer is not None:
-            return sparql_result.askAnswer
-
-        if sparql_result.graph is not None:
-            graph: Graph = sparql_result.graph
-            for prefix, namespace in self.graph.namespaces():
-                graph.bind(prefix, namespace)
-
-            return graph
-
-        return _format_query_bindings(sparql_result.bindings)
-
-    def update(self, sparql_query: str):
-        """Apply the given SPARQL INSERT query."""
-        self.graph.update(sparql_query)