Source code for rdflib.plugins.stores.regexmatching

"""
This wrapper intercepts calls through the store interface which make use of
the REGEXTerm class to represent matches by REGEX instead of literal
comparison.

Implemented for stores that don't support this and essentially
provides the support by replacing the REGEXTerms by wildcards (None) and
matching against the results from the store it's wrapping.
"""

from rdflib.store import Store
from rdflib.graph import Graph


import re

# Store is capable of doing its own REGEX matching
NATIVE_REGEX = 0
# Store uses Python's re module internally for REGEX matching
PYTHON_REGEX = 1


[docs]class REGEXTerm(str): """ REGEXTerm can be used in any term slot and is interpreted as a request to perform a REGEX match (not a string comparison) using the value (pre-compiled) for checking rdf:type matches """
[docs] def __init__(self, expr): self.compiledExpr = re.compile(expr)
[docs] def __reduce__(self): return (REGEXTerm, (str(""),))
[docs]def regexCompareQuad(quad, regexQuad): for index in range(4): if isinstance(regexQuad[index], REGEXTerm) and not regexQuad[ index ].compiledExpr.match(quad[index]): return False return True
[docs]class REGEXMatching(Store):
[docs] def __init__(self, storage): self.storage = storage self.context_aware = storage.context_aware # NOTE: this store can't be formula_aware as it doesn't have enough # info to reverse the removal of a quoted statement. self.formula_aware = storage.formula_aware self.transaction_aware = storage.transaction_aware
[docs] def open(self, configuration, create=True): return self.storage.open(configuration, create)
[docs] def close(self, commit_pending_transaction=False): self.storage.close()
[docs] def destroy(self, configuration): self.storage.destroy(configuration)
[docs] def add(self, triple, context, quoted=False): (subject, predicate, object_) = triple self.storage.add((subject, predicate, object_), context, quoted)
[docs] def remove(self, triple, context=None): (subject, predicate, object_) = triple if ( isinstance(subject, REGEXTerm) or isinstance(predicate, REGEXTerm) or isinstance(object_, REGEXTerm) or (context is not None and isinstance(context.identifier, REGEXTerm)) ): # One or more of the terms is a REGEX expression, so we must # replace it / them with wildcard(s)and match after we query. s = not isinstance(subject, REGEXTerm) and subject or None p = not isinstance(predicate, REGEXTerm) and predicate or None o = not isinstance(object_, REGEXTerm) and object_ or None c = ( (context is not None and not isinstance(context.identifier, REGEXTerm)) and context or None ) removeQuadList = [] for (s1, p1, o1), cg in self.storage.triples((s, p, o), c): for ctx in cg: ctx = ctx.identifier if regexCompareQuad( (s1, p1, o1, ctx), ( subject, predicate, object_, context is not None and context.identifier or context, ), ): removeQuadList.append((s1, p1, o1, ctx)) for s, p, o, c in removeQuadList: self.storage.remove((s, p, o), c and Graph(self, c) or c) else: self.storage.remove((subject, predicate, object_), context)
[docs] def triples(self, triple, context=None): (subject, predicate, object_) = triple if ( isinstance(subject, REGEXTerm) or isinstance(predicate, REGEXTerm) or isinstance(object_, REGEXTerm) or (context is not None and isinstance(context.identifier, REGEXTerm)) ): # One or more of the terms is a REGEX expression, so we must # replace it / them with wildcard(s) and match after we query. s = not isinstance(subject, REGEXTerm) and subject or None p = not isinstance(predicate, REGEXTerm) and predicate or None o = not isinstance(object_, REGEXTerm) and object_ or None c = ( (context is not None and not isinstance(context.identifier, REGEXTerm)) and context or None ) for (s1, p1, o1), cg in self.storage.triples((s, p, o), c): matchingCtxs = [] for ctx in cg: if c is None: if context is None or context.identifier.compiledExpr.match( ctx.identifier ): matchingCtxs.append(ctx) else: matchingCtxs.append(ctx) if matchingCtxs and regexCompareQuad( (s1, p1, o1, None), (subject, predicate, object_, None) ): yield (s1, p1, o1), (c for c in matchingCtxs) else: for (s1, p1, o1), cg in self.storage.triples( (subject, predicate, object_), context ): yield (s1, p1, o1), cg
[docs] def __len__(self, context=None): # NOTE: If the context is a REGEX this could be an expensive # proposition return self.storage.__len__(context)
[docs] def contexts(self, triple=None): # NOTE: There is no way to control REGEX matching for this method at # this level as it only returns the contexts, not the matching # triples. for ctx in self.storage.contexts(triple): yield ctx
[docs] def remove_context(self, identifier): self.storage.remove((None, None, None), identifier)
[docs] def bind(self, prefix, namespace): self.storage.bind(prefix, namespace)
[docs] def prefix(self, namespace): return self.storage.prefix(namespace)
[docs] def namespace(self, prefix): return self.storage.namespace(prefix)
[docs] def namespaces(self): return self.storage.namespaces()
[docs] def commit(self): self.storage.commit()
[docs] def rollback(self): self.storage.rollback()