Permalink
Browse files

Release version 0.5

  • Loading branch information...
1 parent c73d711 commit 3fb78c50f10c8714486f0f70bd2c0f97594b17d9 @dmr committed Sep 11, 2011
Showing with 20 additions and 24 deletions.
  1. +18 −22 README.rst
  2. +1 −1 ldtools/backends.py
  3. +1 −1 setup.py
View
@@ -1,60 +1,56 @@
Ldtools
~~~~~~~
-Ldtools is a simple library to handle RDF data more conveniently..
+Ldtools is a simple library to handle RDF data more conveniently.
Features
========
* A lightweight "ORM" to handle Linked Data Resources and their Origins
* Written in python
-* Stores everything in memory
* Dependencies: rdflib
-* API is still very unstable because I need to add more features and don't know yet how this will turn out
-* 90% test coverage to describe how it works. Most functionality is described in the tests
-* More features following soon.
+* Stores everything in memory
+* API is still subject to change
+* Tests describe basic functionality
How to use it?
==============
-First, we create a Resource object (this will create an Origin object):
+First, we create an Origin object:
+ import pprint
+ import rdflib
from ldtools import Resource, Origin
uri = "http://dbpedia.org/resource/Karlsruhe"
- r, created = Resource.objects.get_or_create(uri, auto_origin=True)
-
+ origin, created = Origin.objects.get_or_create(uri)
-Process it, hopefully discovering more Origins in there (rdfs:seeAlso, owl:sameAs...)
+Process it, hopefully discovering more Origins in there (rdfs:seeAlso, owl:sameAs...):
- import rdflib
-
- r._origin.GET(only_follow_uris=[rdflib.OWL.sameAs])
+ origin.GET(only_follow_uris=[rdflib.OWL.sameAs,rdflib.RDFS.seeAlso])
+If everything went well, there now is a Resource object for our uri:
- import pprint
-
- pprint.pprint(r.__dict__)
-
+ resource, created = Resource.objects.get_or_create(uri, origin=origin)
+ pprint.pprint(resource.__dict__)
Process all the other Origins we know about
Origin.objects.GET_all()
-
-Result: 5 URIs crawled and 500 Resources discovered!
+Result: 5 URIs crawled and 500 Resources discovered and processed.
Why?
----
-* The Semantic Web is out there and there is really not enough tools yet to work with Linked Data.
-* SPARQL is not needed to get the RAW data from resources, this library demonstrates that. Just the basic Linked Data Stack: URIs, Content Negotiation, RDF needed.
-* ldtools intends to make it easy to handle the data you get from an URI: read what's in there, follow links you discover
-* Modification of objects and ability to write back to its origin will follow.
+* The Semantic Web is out there and there is really not enough tools yet to work with Linked Data
+* SPARQL is not needed to get the RAW data from resources, this library demonstrates that. Just the basic Linked Data Stack: URIs, Content Negotiation, RDF needed
+* ldtools intends to make it easy to handle the data you get from an URI and to follow links you discover
+* Based on that, you can modify your objects and PUT them back to their origin
Contact
View
@@ -1,5 +1,5 @@
# -*- coding: utf-8 -*-
-__version__ = "0.4.6"
+__version__ = "0.5"
__useragent__ = ('ldtools-%s (http://github.com/dmr/ldtools, daniel@nwebs.de)'
% __version__)
View
@@ -1,5 +1,5 @@
# -*- coding: utf-8 -*-
-__version__ = "0.4.6"
+__version__ = "0.5"
import os
from setuptools import setup, find_packages

0 comments on commit 3fb78c5

Please sign in to comment.