Parser

CHANGES.txt

@@ -0,0 +1,2 @@
+0.1, 2013-02-13 -- Initial release.
+

MANIFEST.in

@@ -0,0 +1,5 @@
+include *.txt
+include *.md
+include Makefile
+graft flojay
+

README

@@ -0,0 +1,56 @@
+# flojay 
+
+flojay provides incremental serialization of Python data structures as
+JSON documents, and an event-based JSON parser to allow for incremtnal
+deserialization. It can be used to create and process JSON documents
+that are larger than working memory.
+
+It is based on [yajl](http://lloyd.github.com/yajl/) version 2, a
+copy of which is included in this distribution.
+
+# example
+
+    import flojay
+    import sys
+
+    # Produce JSON from a generator, printing partial results
+    # as they become available
+
+    encoder = flojay.JSONEncoder()
+    json_generator = encoder.iterencode(xrange(100))
+    for hunk in json_generator:
+        print hunk
+
+
+    # Read an array of JSON numbers from stdin input,
+    # summing the values as they are read
+
+
+    class ExampleCallbacks(object):
+        def __init__(self):
+            self.sum = 0
+
+        def handle_start_array(self):
+            pass
+
+        def handle_end_array(self):
+            pass
+
+        def handle_number(self, value):
+            self.sum += value
+
+    callbacks = ExampleCallbacks()
+
+    parser = flojay.JSONEventParser(callbacks)
+
+    while 1:
+        row = sys.stdin.readline()
+        if len(row) == 0:
+            break
+        parser.parse(row)
+        print "The current total is: %d" % (callbacks.sum,)
+
+
+# Thank also to
+
+Lloyd Hilaiel -- creator of yajl -- https://github.com/lloyd

README.md

@@ -49,4 +49,8 @@ copy of which is included in this distribution.
             break
         parser.parse(row)
         print "The current total is: %d" % (callbacks.sum,)
-
+
+
+# Thank also to
+
+Lloyd Hilaiel -- creator of yajl -- https://github.com/lloyd

docs/README.md

@@ -0,0 +1,52 @@
+# flojay 
+
+flojay provides incremental serialization of Python data structures as
+JSON documents, and an event-based JSON parser to allow for incremtnal
+deserialization. It can be used to create and process JSON documents
+that are larger than working memory.
+
+It is based on [yajl](http://lloyd.github.com/yajl/) version 2, a
+copy of which is included in this distribution.
+
+# example
+
+    import flojay
+    import sys
+
+    # Produce JSON from a generator, printing partial results
+    # as they become available
+
+    encoder = flojay.JSONEncoder()
+    json_generator = encoder.iterencode(xrange(100))
+    for hunk in json_generator:
+        print hunk
+
+
+    # Read an array of JSON numbers from stdin input,
+    # summing the values as they are read
+
+
+    class ExampleCallbacks(object):
+        def __init__(self):
+            self.sum = 0
+
+        def handle_start_array(self):
+            pass
+
+        def handle_end_array(self):
+            pass
+
+        def handle_number(self, value):
+            self.sum += value
+
+    callbacks = ExampleCallbacks()
+
+    parser = flojay.JSONEventParser(callbacks)
+
+    while 1:
+        row = sys.stdin.readline()
+        if len(row) == 0:
+            break
+        parser.parse(row)
+        print "The current total is: %d" % (callbacks.sum,)
+

setup.py

@@ -5,23 +5,34 @@
     ('yajl.c', 'yajl_gen.c', 'yajl_alloc.c', 'yajl_lex.c', 'yajl_tree.c', \
      'yajl_encode.c', 'yajl_version.c', 'yajl_buf.c', 'yajl_parser.c')]
 
-flojay = Extension('flojay',
+flojay_extension = Extension('flojay',
                     define_macros=[
                         ('MAJOR_VERSION', '0'),
                         ('MINOR_VERSION', '1')],
                     extra_compile_args=['--std=c99'],
                     include_dirs=['flojay/lloyd-yajl/src'],
                     sources=yajl_sources + ['flojay/flojay.c'])
 
+setup(
+    name='flojay',
+    version='0.1',
+    description='Streaming and event-based JSON parser based on yajl',
+    author='Robert Church',
+    author_email='[email protected]',
+    url = "http://github/myemma/flojay/",
+    ext_modules=[flojay_extension],
+    packages=['flojay'],
+    install_requires=['nose==1.1.2'],
+    keywords = ["json", "stream", "ajax", "webapp", "website", "data", "messaging"],
+    classifiers = [
+        "Programming Language :: Python",
+        "Development Status :: 2 - Pre-Alpha",
+        "Environment :: Other Environment",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: BSD License",
+        "Operating System :: OS Independent",
+        "Topic :: Software Development :: Libraries :: Python Modules",
+        "Topic :: Internet",
+        ],
+    )
 
-setup(name='flojay',
-      version='0.1',
-      description='Streaming or event-based JSON parser based on yajl',
-      author='Robert Church',
-      author_email='[email protected]',
-      url='',
-      ext_modules=[flojay],
-      packages=['flojay'],
-      install_requires=[
-          'nose==1.1.2',
-      ])