= Prepare for release 0.3.3

CHANGELOG.md

@@ -1,3 +1,17 @@
+Version 0.3.3 (2016-10-05)
+--------------------------
+
+- add optionally showing canonical name UUID
+- API change: no more AST node ID
+- add year range to ast node
+- improve benchmarks
+- parse names ending on hybrid sign (#88)
+- fix: sometimes warning ids are broken (#147)
+- hybrid abbreviation expansions (#310)
+- raw hybrid formula parsing (#311)
+- move to CircleCI
+- minor improvements
+
 Version 0.3.2 (2016-07-20)
 --------------------------
 
@@ -9,7 +23,7 @@ Version 0.3.1 (2016-06-06)
 
 - fix authors' prefix parsing bug (#301)
 - add JSON pretty rendering method
-- dandle punctuation in the end of a name (#302)
+- handle punctuation in the end of a name (#302)
 
 Version 0.3.0 (2016-05-23)
 --------------------------

README.rst

@@ -22,10 +22,10 @@ Try it as a command line tool under Linux/Mac:
 
 .. code:: bash
 
-    wget https://github.com/GlobalNamesArchitecture/gnparser/releases/download/release-0.3.2/gnparser-0.3.2.zip
-    unzip gnparser-0.3.2.zip
+    wget https://github.com/GlobalNamesArchitecture/gnparser/releases/download/release-0.3.3/gnparser-0.3.3.zip
+    unzip gnparser-0.3.3.zip
     sudo rm -rf /opt/gnparser
-    sudo mv gnparser-0.3.2 /opt/gnparser
+    sudo mv gnparser-0.3.3 /opt/gnparser
     sudo rm -f /usr/local/bin/gnparse
     sudo ln -s /opt/gnparser/bin/gnparse /usr/local/bin
     gnparse name "Homo sapiens Linnaeus"
@@ -47,7 +47,7 @@ Finally, run it right from your SBT console:
 
     $ mkdir -p project
     $ echo 'sbt.version=0.13.12' > project/build.properties
-    $ sbt ';set libraryDependencies += "org.globalnames" %% "gnparser" % "0.3.2";console'
+    $ sbt ';set libraryDependencies += "org.globalnames" %% "gnparser" % "0.3.3";console'
     scala> import org.globalnames.parser.ScientificNameParser.{instance => scientificNameParser}
     scala> scientificNameParser.fromString("Homo sapiens Linnaeus").renderCompactJson
 
@@ -190,7 +190,7 @@ SBT:
 
 .. code:: Scala
 
-    libraryDependencies += "org.globalnames" %% "gnparser" % "0.3.2"
+    libraryDependencies += "org.globalnames" %% "gnparser" % "0.3.3"
 
 Maven:
 
@@ -199,20 +199,20 @@ Maven:
     <dependency>
         <groupId>org.globalnames</groupId>
         <artifactId>gnparser_2.11</artifactId>
-        <version>0.3.2</version>
+        <version>0.3.3</version>
     </dependency>
 
     <dependency>
         <groupId>org.globalnames</groupId>
         <artifactId>gnparser_2.10</artifactId>
-        <version>0.3.2</version>
+        <version>0.3.3</version>
     </dependency>
 
 Release Package
 ---------------
 
 `Release
-package <https://github.com/GlobalNamesArchitecture/gnparser/releases/tag/release-0.3.2>`_
+package <https://github.com/GlobalNamesArchitecture/gnparser/releases/tag/release-0.3.3>`_
 should be sufficient for all usages but development. It is not needed
 for including parser into Java or Scala code -- `declare dependency
 instead <#dependency-declaration-for-java-or-scala>`_.
@@ -228,11 +228,11 @@ Released Files
 ===============================   ===============================================
 File                              Description
 ===============================   ===============================================
-``gnparser-assembly-0.3.2.jar``   `Fat Jar <#fat-jar>`_
-``gnparser-0.3.2.zip``            `Command line tool, web and socket
+``gnparser-assembly-0.3.3.jar``   `Fat Jar <#fat-jar>`_
+``gnparser-0.3.3.zip``            `Command line tool, web and socket
                                   server <#command-line-tool-and-socket-server>`_
-``release-0.3.2.zip``             Source code's zip file
-``release-0.3.2.tar.gz``          Source code's tar file
+``release-0.3.3.zip``             Source code's zip file
+``release-0.3.3.tar.gz``          Source code's tar file
 ===============================   ===============================================
 
 Fat Jar
@@ -243,9 +243,9 @@ necessary to run a program. Such jar would include Scala and all
 required libraries.
 
 `Fat
-jar <https://github.com/GlobalNamesArchitecture/gnparser/releases/download/release-0.3.2/gnparser-assembly-0.3.2.jar>`_
+jar <https://github.com/GlobalNamesArchitecture/gnparser/releases/download/release-0.3.3/gnparser-assembly-0.3.3.jar>`_
 for ``gnparser`` can be found in the `current
-release <https://github.com/GlobalNamesArchitecture/gnparser/releases/tag/release-0.3.2>`_.
+release <https://github.com/GlobalNamesArchitecture/gnparser/releases/tag/release-0.3.3>`_.
 
 Command Line Tool and Socket Server
 -----------------------------------
@@ -255,18 +255,18 @@ Installation on Linux/Mac
 
 .. code:: bash
 
-    wget https://github.com/GlobalNamesArchitecture/gnparser/releases/download/release-0.3.2/gnparser-0.3.2.zip
-    unzip gnparser-0.3.2.zip
+    wget https://github.com/GlobalNamesArchitecture/gnparser/releases/download/release-0.3.3/gnparser-0.3.3.zip
+    unzip gnparser-0.3.3.zip
     sudo rm -rf /opt/gnparser
-    sudo mv gnparser-0.3.2 /opt/gnparser
+    sudo mv gnparser-0.3.3 /opt/gnparser
     sudo rm -f /usr/local/bin/gnparse
     sudo ln -s /opt/gnparser/bin/gnparse /usr/local/bin
 
 Installation on Windows
 ~~~~~~~~~~~~~~~~~~~~~~~
 
 1. Download
-   `gnparser-0.3.2.zip <https://github.com/GlobalNamesArchitecture/gnparser/releases/download/release-0.3.2/gnparser-0.3.2.zip>`_
+   `gnparser-0.3.3.zip <https://github.com/GlobalNamesArchitecture/gnparser/releases/download/release-0.3.3/gnparser-0.3.3.zip>`_
 2. Extract it to a place where you usually store program files
 3. Update your `PATH <https://java.com/en/download/help/path.xml>`_ to
    point to bin subdirectory
@@ -342,7 +342,7 @@ To avoid declaring multiple dependencies Jython, JRuby and R need a
 `reference gnparser fat-jar <#fat-jar>`_.
 
 If you decide to follow examples get the code from the
-`release <https://github.com/GlobalNamesArchitecture/gnparser/releases/tag/release-0.3.2>`_
+`release <https://github.com/GlobalNamesArchitecture/gnparser/releases/tag/release-0.3.3>`_
 or `clone it from GitHub <#getting-code-for-development>`_
 
 Scala
@@ -397,7 +397,7 @@ To run it execute the command:
 .. code:: bash
 
     java -jar $JYTHON_HOME/jython.jar \
-      -Dpython.path=/path/to/gnparser-assembly-0.3.2.jar \
+      -Dpython.path=/path/to/gnparser-assembly-0.3.3.jar \
       examples/jython/parser.py
 
 (JYTHON\_HOME needs to be defined or replaced by path to Jython jar)
@@ -425,7 +425,7 @@ To run it execute the command:
 
 .. code:: bash
 
-    jruby -J-classpath /path/to/gnparser-assembly-0.3.2.jar \
+    jruby -J-classpath /path/to/gnparser-assembly-0.3.3.jar \
       examples/jruby/parser.rb
 
 Getting Code for Development

build.sbt

@@ -1,7 +1,7 @@
 import sbt.Keys._
 
 val commonSettings = Seq(
-  version := "0.3.3-SNAPSHOT",
+  version := "0.3.3",
   scalaVersion := "2.11.8",
   organization := "org.globalnames",
   homepage := Some(new URL("http://globalnames.org/")),

examples/spark/README.rst

@@ -13,7 +13,7 @@ is an SBT subproject. To run it complete steps as follows:
 
 1. build a fat-jar of the example with ``sbt ";++2.10.6;exampleSpark/assembly"``
 
-2. run it with Spark by executing ``$SPARK_HOME/bin/spark-submit ./examples/spark/target/scala-2.10/gnparser-example-spark-assembly-0.3.2.jar``
+2. run it with Spark by executing ``$SPARK_HOME/bin/spark-submit ./examples/spark/target/scala-2.10/gnparser-example-spark-assembly-0.3.3.jar``
 
 Python
 ~~~~~~
@@ -25,8 +25,8 @@ Python
 .. code:: bash
 
     $SPARK_HOME/bin/pyspark \
-      --jars "`pwd`/spark-python/target/scala-2.10/gnparser-spark-python-assembly-0.3.2.jar" \
-      --driver-class-path="`pwd`/spark-python/target/scala-2.10/gnparser-spark-python-assembly-0.3.2.jar"`
+      --jars "`pwd`/spark-python/target/scala-2.10/gnparser-spark-python-assembly-0.3.3.jar" \
+      --driver-class-path="`pwd`/spark-python/target/scala-2.10/gnparser-spark-python-assembly-0.3.3.jar"`
 
 3. add Python snippet to call the wrapper: