Differenze

Queste sono le differenze tra la revisione selezionata e la versione attuale della pagina.

--- jsaone [2014/05/12 18:01] – usage pietro
+++ jsaone [2019/02/05 18:16] (versione attuale) – on github pietro
@@ Linea 1: / Linea 1: @@
-{{:jsaone:jsaone-0.1.tar.gz|Click here to download version 0.1 of jsaone.}}
+{{:jsaone:jsaone-0.2.tar.gz|Click here to download version 0.2 of jsaone.}}
-{{:jsaone:python-jsaone_0.1-2_amd64.deb|Click here for the (64 bit) Debian/Ubuntu package (Python 2).}}
+{{:jsaone:python-jsaone_0.2-1_amd64.deb|Click here for the (64 bit) Debian/Ubuntu package (Python 2).}}
-{{:jsaone:python3-jsaone_0.1-2_amd64.deb|Click here for the (64 bit) Debian/Ubuntu package (Python 3).}}
+{{:jsaone:python3-jsaone_0.2-1_amd64.deb|Click here for the (64 bit) Debian/Ubuntu package (Python 3).}}
 ====== What is jsaone? ======
@@ Linea 21: / Linea 21: @@
 totalling 174 MB:
-^ Parser  ^  Iteration 1 ^ Iteration 2 ^
+^ Parser                          ^  Iteration 1 ^ Iteration 2 ^
-| standard (non-incremental) json |   9.511     |   9.273     |
+| standard (non-incremental) json |    9.511     |    9.273    |
-| cythonized jsaone               |  19.055     |  18.956     |
+| cythonized jsaone               |   19.055     |   18.956    |
-| ijson (with yajl2 backend)      |  62.250     |  64.538     |
+| ijson (with yajl2 backend)      |   62.250     |   64.538    |
-| pure python jsaone              |  421.641     |  421.821     |
+| pure python jsaone              |  421.641     |  421.821    |
@@ Linea 31: / Linea 31: @@
 Clearly those numbers are affected by the speed of the CPU and of the medium/stream.
-In general the faster the CPU (compared to the storage medium/stream), the
+In particular, since the test was made on a file from a local hard disk, the
-faster will be the standard json compared to incremental ones (including
+bottleneck was clearly the CPU, and hence it is disadvantageous for incremental
-jsaone).
+parsers (including jsaone). If the bottleneck is given by the medium/stream,
+jsaone should even outperform the standard json, which will start processing
+only after the entire stream is received.
 === Why "jsaone" ===
@@ Linea 51: / Linea 53: @@
   - you can extract/clone the git repo, then move in the "jsaone" folder and give the command
-  python setup.py build_ext --inplace
+  python3 setup.py build_ext --inplace
+(replace "**python3**" with "**python**" if you are using Python 2).
@@ Linea 60: / Linea 64: @@
   with open('/path/to/my/file.json') as f:
       gen = jsaone.load(f)
-      for i in gen:
+      for key, val in gen:
           ...
 === Development ===
-You can browse the git repo [[http://www.pietrobattiston.it/gitweb?p=jsaone.git|here]] or clone with
+You can browse the git repo [[https://github.com/toobaz/jsaone|here]] or clone with
-  git clone git://pietrobattiston.it/jsaone
+  git clone https://github.com/toobaz/jsaone.git
 For bugs and enhancements, just write me - <me@pietrobattiston.it> - ideally pointing to a git branch solving the issue/providing an enhancement.
+Jsaone should be able to parse any compliant json string... so if you find one on which it fails, please let me know!
 === License ===
-Released under the GPL 3.
+Released under the GPL 3. Feel free to contact me if this is a problem for you (and GPL 2 is not).