[Python-modules-commits] [python-pyld] 82/276: Update readme.

Wolfgang Borgert debacle at moszumanska.debian.org
Wed Oct 8 23:47:56 UTC 2014


This is an automated email from the git hooks/post-receive script.

debacle pushed a commit to branch master
in repository python-pyld.

commit 96915c2213d907f8ab608e2fb00e6e93e5e93190
Author: Dave Longley <dlongley at digitalbazaar.com>
Date:   Tue May 8 23:30:17 2012 -0400

    Update readme.
---
 README.md          | 53 +++++++++++++++++++++++++++++++++++++++++++++--------
 lib/pyld/jsonld.py |  1 -
 2 files changed, 45 insertions(+), 9 deletions(-)

diff --git a/README.md b/README.md
index 89a7621..c056a14 100644
--- a/README.md
+++ b/README.md
@@ -1,18 +1,54 @@
-PyLD
-====
-
 Introduction
 ------------
 
-A Python implementation of a [JSON-LD][] processor.
+JSON, as specified in RFC4627, is a simple language for representing
+objects on the Web. Linked Data is a way of describing content across
+different documents or Web sites. Web resources are described using
+IRIs, and typically are dereferencable entities that may be used to find
+more information, creating a "Web of Knowledge". JSON-LD is intended to
+be a simple publishing method for expressing not only Linked Data in
+JSON, but for adding semantics to existing JSON.
+
+This library is an implementation of the [JSON-LD] specification
+in [Python].
+
+JSON-LD is designed as a light-weight syntax that can be used to express
+Linked Data. It is primarily intended to be a way to express Linked Data
+in Javascript and other Web-based programming environments. It is also
+useful when building interoperable Web Services and when storing Linked
+Data in JSON-based document storage engines. It is practical and
+designed to be as simple as possible, utilizing the large number of JSON
+parsers and existing code that is in use today. It is designed to be
+able to express key-value pairs, RDF data, RDFa [RDFA-CORE] data,
+Microformats [MICROFORMATS] data, and Microdata [MICRODATA]. That is, it
+supports every major Web-based structured data model in use today.
+
+The syntax does not require many applications to change their JSON, but
+easily add meaning by adding context in a way that is either in-band or
+out-of-band. The syntax is designed to not disturb already deployed
+systems running on JSON, but provide a smooth migration path from JSON
+to JSON with added semantics. Finally, the format is intended to be fast
+to parse, fast to generate, stream-based and document-based processing
+compatible, and require a very small memory footprint in order to operate.
+
+Commercial Support
+------------------
+
+Commercial support for this library is available upon request from 
+Digital Bazaar: support at digitalbazaar.com
 
 Requirements
 ------------
 
- * [Python][] (2.5 or later)
+ * [Python] (2.5 or later)
+
+Source
+------
 
-Usage
------
+The source code for the Python implementation of the JSON-LD API
+is available at:
+
+http://github.com/digitalbazaar/pyld
 
 This library includes a sample testing utility which may be used to verify
 that changes to the processor maintain the correct output.
@@ -22,7 +58,7 @@ To run the sample tests you will need to get the test suite files from the
 
 https://github.com/json-ld/json-ld.org
 
-Then run the runtests.py application and point it at the directory
+Then run the jsonld-tests.php application and point it at the directory
 containing the tests.
 
     python tests/runtests.py -d {PATH_TO_JSON_LD_ORG/test-suite/tests}
@@ -30,3 +66,4 @@ containing the tests.
 [Python]: http://www.python.org/
 [JSON-LD]: http://json-ld.org/
 [json-ld.org]: https://github.com/json-ld/json-ld.org
+
diff --git a/lib/pyld/jsonld.py b/lib/pyld/jsonld.py
index 5aef0c5..f69859a 100644
--- a/lib/pyld/jsonld.py
+++ b/lib/pyld/jsonld.py
@@ -1467,7 +1467,6 @@ class JsonLdProcessor:
             rval['@language'] = o['language']
         return rval
 
-
     def _makeLinkedList(self, value):
         """
         Converts a @list value into an embedded linked list of blank nodes in

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/python-modules/packages/python-pyld.git



More information about the Python-modules-commits mailing list