imported code from sourceforge (r180)

Author: wikier

.gitignore

@@ -0,0 +1,2 @@
+*~
+*.pyc

AUTHORS.txt

@@ -0,0 +1,22 @@
+
+Authors
+-------
+                   
+    Ivan Herman <[email protected]>   
+    Sergio Fernández <[email protected]>
+    Carlos Tejo <[email protected]>
+
+
+Contributors
+------------
+
+    Obey Arthur Liu <[email protected]>, different patches
+    Christopher Lenz <[email protected]>, feature to allow developers to choose the json module
+    Pēteris Caune <[email protected]>, great feedback and patches
+    Bogdan Benea <[email protected]>, patch for the query regular expresion
+    William Waites <[email protected]>, patches for RDFLib3 
+    Christoph Burgmer <[email protected]>, patches for RDFLib3
+    Thomas Kluyver <[email protected]>, patches for Python 3.x
+    Diego Berrueta <[email protected]>, new function for printing results as table
+    Olivier Berger <[email protected]>, patch regarding raw response for unknown formats
+

ChangeLog.txt

@@ -0,0 +1,52 @@
+SPARQLWrapper's changelog:
+-------------------------
+
+YYYY-MM-DD  1.5.3   - Returing raw response in case of unknow content type returned
+                    - Fixed some issues with the last version of the SPARQL 1.1 Update Protocol
+
+2012-08-28  1.5.2   - Implemented update operation according the latest SPARQL 1.1 Protocol drafts (i.e., switching to 'update' parameter)
+
+2012-07-10  1.5.1   - Added the posibility to use two different endpoints for reading and writing operations
+                    - New print_results() function for users testing
+
+2012-02-01  1.5.0   - Update handling 500's coming from SPARQL endpoint (feature request #3198363)
+                    - Added Python 3.x support (feature request 3022722)
+                    - Warning when returned format would be different than the requested one
+
+2011-01-28  1.4.2   - Updated for working with RDFLib3 too (feature request #3117442)
+                    - fixed bug with prefixes' regex (#2320024)
+
+2010-01-11  1.4.1   - Supporting keep-alive in SPARQLWrapper if urlgrabber is available (ticket #2929881)
+                    - fixed bugs (#2949834)
+
+2009-12-14  1.4.0   - Added some suport for SPARUL
+                    - Improved HTTP related code
+                    - Many other minor bugs fixed
+
+2009-09-23  1.3.2   - Remove pyxml dependecy. Instead, use xml.dom.minidom
+                    - Updated setup installation (added rdflib dependency)
+                    - Udpated example.py (added XML, N3 and RDF examples)
+
+2009-09-11  1.3.1   - Remove simplejson dependency for python => 2.6 version
+                    - Added feature to choose the json module to use
+
+2009-05-06  1.3.0   - Added a new method to add custom parameters (deprecated old way to do it)
+
+2009-04-27  1.2.1   - Updated setup installation
+                    - Patched to work with JSON in Python>=2.6
+
+2008-07-10  1.2.0   - Allowed non-standard extensions (such as SPARUL).
+                    - Exceptions fixed.
+                    - Added another example.
+
+2008-03-24  1.1.0   - Renamed package name to SPARQLWrapper.
+                    - Added a basic catalog of exceptions.
+
+2008-03-07  1.0.1   - Fixed some cosmetic things.
+
+2008-02-14  1.0.0   - First stable release.
+                    - Main functionalities stabilized.
+                    - Project moved to SourceForge.
+
+2007-07-06  0.2.0   - First public release of the library.
+

LICENSE.txt

@@ -0,0 +1,18 @@
+SPARQL Python Wrapper is released under the W3C� SOFTWARE NOTICE AND LICENSE. 
+
+This work (and included software, documentation such as READMEs, or other related items) is being provided by the copyright holders under the following license. By obtaining, using and/or copying this work, you (the licensee) agree that you have read, understood, and will comply with the following terms and conditions.
+
+Permission to copy, modify, and distribute this software and its documentation, with or without modification, for any purpose and without fee or royalty is hereby granted, provided that you include the following on ALL copies of the software and documentation or portions thereof, including modifications:
+
+   1. The full text of this NOTICE in a location viewable to users of the redistributed or derivative work.
+   2. Any pre-existing intellectual property disclaimers, notices, or terms and conditions. If none exist, the W3C Software Short Notice should be included (hypertext is preferred, text is permitted) within the body of any redistributed or derivative code.
+   3. Notice of any changes or modifications to the files, including the date changes were made. (We recommend you provide URIs to the location from which the code is derived.)
+
+THIS SOFTWARE AND DOCUMENTATION IS PROVIDED "AS IS," AND COPYRIGHT HOLDERS MAKE NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO, WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF THE SOFTWARE OR DOCUMENTATION WILL NOT INFRINGE ANY THIRD PARTY PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS.
+
+COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF ANY USE OF THE SOFTWARE OR DOCUMENTATION.
+
+The name and trademarks of copyright holders may NOT be used in advertising or publicity pertaining to the software without specific, written prior permission. Title to copyright in this software and any associated documentation will at all times remain with copyright holders.
+
+See also http://www.w3.org/Consortium/Legal/copyright-software for further details
+

MANIFEST.in

@@ -0,0 +1,2 @@
+include *.txt
+exclude Makefile

Makefile

@@ -0,0 +1,13 @@
+# SPARQLWrapper Makefile
+
+NAME=SPARQLWrapper
+DESTDIR =
+DOCDIR=doc
+PYTHON=python
+
+doc:	clean
+	mkdir -p $(DOCDIR)
+	epydoc -v -n $(NAME) -o $(DOCDIR) --html SPARQLWrapper
+
+clean:
+	rm -rf $(DOCDIR)

README.md

@@ -0,0 +1,14 @@
+# SPARQL Endpoint interface to Python
+
+The distribution contains:
+
+* `SPARQLWrapper`: the Python library. You should copy the directory somewhere into your PYTHONPATH. Alternatively, you can also run the disutils scrips:
+
+    python setup.py install
+
+* `test`: some unit tests
+  
+* `script`: some scripts to run the library against some SPARQL end-points.
+  
+* `scripts/sparql.py`: to run a SPARQL SELECT query stored in an external file. The URIs for the SPARQL services have to be updated for local use.
+

SPARQLWrapper/KeyCaseInsensitiveDict.py

@@ -0,0 +1,34 @@
+# -*- coding: utf-8 -*-
+
+"""
+A simple implementation of a key case-insensitive dictionary.
+
+@authors: U{Ivan Herman<http://www.ivan-herman.net>}, U{Sergio Fernández<http://www.wikier.org>}, U{Carlos Tejo Alonso<http://www.dayures.net>}
+@organization: U{World Wide Web Consortium<http://www.w3.org>} and U{Foundation CTIC<http://www.fundacionctic.org/>}.
+@license: U{W3C® SOFTWARE NOTICE AND LICENSE<href="http://www.w3.org/Consortium/Legal/copyright-software">}
+"""
+
+class KeyCaseInsensitiveDict(dict):
+    """
+    A simple implementation of a key case-insensitive dictionary
+    """
+
+    def __init__(self, d={}):
+        for k, v in d.items():
+            self[k] = v
+
+    def __setitem__(self, key, value):
+        if (hasattr(key, "lower")):
+            key = key.lower()
+        dict.__setitem__(self, key, value)
+
+    def __getitem__(self, key):
+        if (hasattr(key, "lower")):
+            key = key.lower()
+        return dict.__getitem__(self, key)
+
+    def __delitem__(self, key):
+        if hasattr(key, "lower"):
+            key = key.lower()
+        dict.__delitem__(self, key)
+

SPARQLWrapper/SPARQLExceptions.py

@@ -0,0 +1,46 @@
+# -*- coding: utf-8 -*-
+
+"""
+
+SPARQL Wrapper exceptions
+
+@authors: U{Ivan Herman<http://www.ivan-herman.net>}, U{Sergio Fernández<http://www.wikier.org>}, U{Carlos Tejo Alonso<http://www.dayures.net>}
+@organization: U{World Wide Web Consortium<http://www.w3.org>} and U{Foundation CTIC<http://www.fundacionctic.org/>}.
+@license: U{W3C® SOFTWARE NOTICE AND LICENSE<href="http://www.w3.org/Consortium/Legal/copyright-software">}
+
+"""
+
+class SPARQLWrapperException(Exception):
+    """
+    Base class for SPARQL Wrapper exceptions
+    """
+
+    msg = "an exception has occured"
+    
+    def __init__(self, response=None):
+        if (response):
+            Exception.__init__(self, "%s: %s. \n\nResponse:\n%s" % (self.__class__.__name__, self.msg, response))
+        else:
+            Exception.__init__(self, "%s: %s." % (self.__class__.__name__, self.msg))
+
+class EndPointInternalError(SPARQLWrapperException):
+    """
+    Exception type for 500 Internal Server Error responses.
+    """
+
+    msg = "endpoint returned code 500 and response"
+
+class QueryBadFormed(SPARQLWrapperException):
+    """
+    Query Bad Formed exceptions
+    """
+
+    msg = "a bad request has been sent to the endpoint, probably the sparql query is bad formed"
+
+class EndPointNotFound(SPARQLWrapperException):
+    """
+    End Point Not Found exceptions
+    """
+
+    msg = "it was impossible to connect with the endpoint in that address, check if it is correct"
+

SPARQLWrapper/SPARQLUtils.py

@@ -0,0 +1,29 @@
+# -*- coding: utf8 -*-
+
+"""
+
+SPARQL Wrapper Utils
+
+@authors: U{Ivan Herman<http://www.ivan-herman.net>}, U{Sergio Fernández<http://www.wikier.org>}, U{Carlos Tejo Alonso<http://www.dayures.net>}
+@organization: U{World Wide Web Consortium<http://www.w3.org>} and U{Foundation CTIC<http://www.fundacionctic.org/>}.
+@license: U{W3C SOFTWARE NOTICE AND LICENSE<href="http://www.w3.org/Consortium/Legal/copyright-software">}
+
+"""
+
+import warnings
+
+def deprecated(func):
+    """
+        This is a decorator which can be used to mark functions
+        as deprecated. It will result in a warning being emmitted
+        when the function is used.
+        @see: http://code.activestate.com/recipes/391367/
+    """
+    def newFunc(*args, **kwargs):
+        warnings.warn("Call to deprecated function %s." % func.__name__, category=DeprecationWarning, stacklevel=2)
+        return func(*args, **kwargs)
+    newFunc.__name__ = func.__name__
+    newFunc.__doc__ = func.__doc__
+    newFunc.__dict__.update(func.__dict__)
+    return newFunc
+