3
‰ d % ã @ s d dl mZ d dl mZ d dl mZ dZd dlmZ d dlmZ d dl m
Z
d dl m Z d d l m
Z
d d
l mZ d d l mZ G d d
„ d
eƒZdd„ Zdd„ ZdS )é )Úabsolute_import)Údivision)Úprint_functionaß
A Describer is a stateful utility for creating RDF statements in a
semi-declarative manner. It has methods for creating literal values, rel and
rev resource relations (somewhat resembling RDFa).
The `rel` and ``rev`` methods return a context manager which sets the current
about to the referenced resource for the context scope (for use with the
``with`` statement).
Full example in the ``to_rdf`` method below::
>>> import datetime
>>> from rdflib.graph import Graph
>>> from rdflib.namespace import Namespace, RDFS, FOAF
>>>
>>> ORG_URI = "http://example.org/"
>>>
>>> CV = Namespace("http://purl.org/captsolo/resume-rdf/0.2/cv#")
>>>
>>> class Person(object):
... def __init__(self):
... self.first_name = u"Some"
... self.last_name = u"Body"
... self.username = "some1"
... self.presentation = u"Just a Python & RDF hacker."
... self.image = "/images/persons/" + self.username + ".jpg"
... self.site = "http://example.net/"
... self.start_date = datetime.date(2009, 9, 4)
... def get_full_name(self):
... return u" ".join([self.first_name, self.last_name])
... def get_absolute_url(self):
... return "/persons/" + self.username
... def get_thumbnail_url(self):
... return self.image.replace('.jpg', '-thumb.jpg')
...
... def to_rdf(self):
... graph = Graph()
... graph.bind('foaf', FOAF)
... graph.bind('cv', CV)
... lang = 'en'
... d = Describer(graph, base=ORG_URI)
... d.about(self.get_absolute_url()+'#person')
... d.rdftype(FOAF.Person)
... d.value(FOAF.name, self.get_full_name())
... d.value(FOAF.givenName, self.first_name)
... d.value(FOAF.familyName, self.last_name)
... d.rel(FOAF.homepage, self.site)
... d.value(RDFS.comment, self.presentation, lang=lang)
... with d.rel(FOAF.depiction, self.image):
... d.rdftype(FOAF.Image)
... d.rel(FOAF.thumbnail, self.get_thumbnail_url())
... with d.rev(CV.aboutPerson):
... d.rdftype(CV.CV)
... with d.rel(CV.hasWorkHistory):
... d.value(CV.startDate, self.start_date)
... d.rel(CV.employedIn, ORG_URI+"#company")
... return graph
...
>>> person_graph = Person().to_rdf()
>>> expected = Graph().parse(data='''
...
...
... Some Body
... Some
... Body
...
...
...
...
...
...
... Just a Python & RDF hacker.
...
...
...
...
...
...
...
...
... 2009-09-04
...
...
...
...
...
... ''')
>>>
>>> from rdflib.compare import isomorphic
>>> isomorphic(person_graph, expected) #doctest: +SKIP
True
)Úcontextmanager)ÚGraph)ÚRDF)ÚBNode)Ú
Identifier)ÚLiteral)ÚURIRefc @ sV e Zd Zddd„Zdd„ Zdd„ Zddd „Zdd
d „Zd d
„ Zdd„ Z e
dd„ ƒZ dS )Ú DescriberNc C s2 |d krt ƒ }|| _|| _g | _| j|p*d ƒ d S )N)r ÚgraphÚbaseÚ _subjectsÚabout)Úselfr
r r © r ú9/tmp/pip-build-7vycvbft/rdflib/rdflib/extras/describer.pyÚ__init__{ s zDescriber.__init__c K s< |j d| jƒ t|f|Ž}| jr,|| jd< n | jj|ƒ dS )a
Sets the current subject. Will convert the given object into an
``URIRef`` if it's not an ``Identifier``.
Usage::
>>> d = Describer()
>>> d._current() #doctest: +ELLIPSIS
rdflib.term.BNode(...)
>>> d.about("http://example.org/")
>>> d._current()
rdflib.term.URIRef(u'http://example.org/')
r é Néÿÿÿÿ)Ú
setdefaultr Úcast_identifierr Úappend)r ÚsubjectÚkwsr r r r ƒ s
zDescriber.aboutc K s& t |f|Ž}| jj| jƒ ||fƒ dS )aÛ
Set a literal value for the given property. Will cast the value to an
``Literal`` if a plain literal is given.
Usage::
>>> from rdflib import URIRef
>>> from rdflib.namespace import RDF, RDFS
>>> d = Describer(about="http://example.org/")
>>> d.value(RDFS.label, "Example")
>>> d.graph.value(URIRef('http://example.org/'), RDFS.label)
rdflib.term.Literal(u'Example')
N)Ú
cast_valuer
ÚaddÚ_current)r ÚpÚvr r r r Úvalue™ s zDescriber.valuec K sB |j d| jƒ t|ƒ}t|f|Ž}| jj| jƒ ||fƒ | j|ƒS )a Set an object for the given property. Will convert the given object
into an ``URIRef`` if it's not an ``Identifier``. If none is given, a
new ``BNode`` is used.
Returns a context manager for use in a ``with`` block, within which the
given object is used as current subject.
Usage::
>>> from rdflib import URIRef
>>> from rdflib.namespace import RDF, RDFS
>>> d = Describer(about="/", base="http://example.org/")
>>> _ctxt = d.rel(RDFS.seeAlso, "/about")
>>> d.graph.value(URIRef('http://example.org/'), RDFS.seeAlso)
rdflib.term.URIRef(u'http://example.org/about')
>>> with d.rel(RDFS.seeAlso, "/more"):
... d.value(RDFS.label, "More")
>>> (URIRef('http://example.org/'), RDFS.seeAlso,
... URIRef('http://example.org/more')) in d.graph
True
>>> d.graph.value(URIRef('http://example.org/more'), RDFS.label)
rdflib.term.Literal(u'More')
r )r r r r
r r Ú_subject_stack)r r Úor r r r Úrel« s
z
Describer.relc K sB |j d| jƒ t|ƒ}t|f|Ž}| jj||| jƒ fƒ | j|ƒS )aÖ
Same as ``rel``, but uses current subject as *object* of the relation.
The given resource is still used as subject in the returned context
manager.
Usage::
>>> from rdflib import URIRef
>>> from rdflib.namespace import RDF, RDFS
>>> d = Describer(about="http://example.org/")
>>> with d.rev(RDFS.seeAlso, "http://example.net/"):
... d.value(RDFS.label, "Net")
>>> (URIRef('http://example.net/'), RDFS.seeAlso,
... URIRef('http://example.org/')) in d.graph
True
>>> d.graph.value(URIRef('http://example.net/'), RDFS.label)
rdflib.term.Literal(u'Net')
r )r r r r
r r r" )r r Úsr r r r ÚrevÌ s
z
Describer.revc C s | j j| jƒ tj|fƒ dS )a™
Shorthand for setting rdf:type of the current subject.
Usage::
>>> from rdflib import URIRef
>>> from rdflib.namespace import RDF, RDFS
>>> d = Describer(about="http://example.org/")
>>> d.rdftype(RDFS.Resource)
>>> (URIRef('http://example.org/'),
... RDF.type, RDFS.Resource) in d.graph
True
N)r
r r r Útype)r Útr r r Úrdftypeæ s zDescriber.rdftypec C s
| j d S )Nr r )r )r r r r r ÷ s zDescriber._currentc c s | j j|ƒ d V | j jƒ d S )N)r r Úpop)r r r r r r" ú s zDescriber._subject_stack)NNN)N)N) Ú__name__Ú
__module__Ú __qualname__r r r! r$ r& r) r r r" r r r r r y s
!
r c K s t | tƒst| f|Ž} | S )N)Ú
isinstancer
)r r r r r r s
r c K s$ | pt ƒ } t| tƒs t| f|Ž} | S )N)r r. r r )Úrefr r r r r s
r N)Ú
__future__r r r Ú__doc__Ú
contextlibr Z rdflib.graphr Zrdflib.namespacer Z rdflib.termr r r
r Úobjectr r r r r r r Ú s i