A small Django application that makes developing with the 4Store RDF database easier.
Project description
- Contact:
- m@66laps.com
django-4store is a small Django application that makes developing apps with the 4Store RDF database easier.
Installation
django-4store is on PyPi for easy_install or buildout:
$ easy_install django-4store
Alternatively, clone the repository and place it either in your Django project or within your $PYTHONPATH:
$ git clone git://github.com/66laps/django-4store.git
Configuration
Edit your settings.py and add fourstore to the end of INSTALLED_APPS.
You must also add two additional settings to settings.py:
FOURSTORE_KBNAME = "demo" # Name of 4store knowledge base FOURSTORE_PORT = 6667 # Port for 4store HTTP server
It is recommended (but not required) that you also set a constant to the SPARQL endpoint at the same time:
SPARQL_ENDPOINT = "http://localhost:6667"
Code that depends on this endpoint URL will continue to work during testing (see Test Cases.)
Management Commands
Two management commands are provided that wrap the standard 4s-* commands for convenience.
The first, 4store-import will create and import the specified files into the 4store knowledge base (in settings.py):
$ python manage.py 4store-import rdf/card.rdf rdf/myself.n3
The flag --recursive can be specified to recursively add any RDF files in a directory.
Note that importing data will overwrite any existing content in the knowledge base.
The second command, 4store will start the HTTP server on the port specified in settings.py:
$ python manage.py 4store ...
Test Cases
A subclass of django.test.Testcase is included. This provides a mechanism for starting an isolated 4store server and automatically importing test fixtures.
For example, the following test case can be used to test any 4store dependant code:
from django.conf import settings from HTTP4Store import HTTP4Store from fourstore.test import Base4StoreTest class MySemanticTestCase(Base4StoreTest): kbfixtures = ["card.rdf", "someone.n3"] def test_something(self): store = HTTP4Store(settings.SPARQL_ENDPOINT) response = store.sparql("SELECT * WHERE { ?s ?p ?o . } ") self.assertEquals(..., response)
Test fixtures should be placed within the fixtures directory of the app under testing (note the class variable is kbfixtures).
The Django setting attribute settings.SPARQL_ENDPOINT is automatically updated to the current endpoint URL.
The server is reinitialised between tests and its operation is dependant on setUp and tearDown. If you need to override these methods, make sure that you still call the parent implementations:
class MySemanticTestCase(Base4StoreTest): ... def setUp(self): Base4StoreTest.setUp(self) // do something def tearDown(self): Base4StoreTest.tearDown(self) // do something
Test Suite
A test suite for django-4store is included:
$ python manage.py test fourstore
License
This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.