* Bundle libpostal_data program, executable via Loader.load() for convenience (issue #939)

Author: saudet

CHANGELOG.md

@@ -1,4 +1,5 @@
 
+ * Bundle `libpostal_data` program, executable via `Loader.load()` for convenience ([issue #939](https://github.com/bytedeco/javacpp-presets/issues/939))
  * Enable all stable target architectures in the presets for LLVM ([pull #937](https://github.com/bytedeco/javacpp-presets/pull/937))
  * Virtualize `QObject` and its subclasses from Qt to allow customization ([issue bytedeco/javacpp#419](https://github.com/bytedeco/javacpp/issues/419))
  * Bundle programs from Clang and LLVM, executable via `Loader.load()` for convenience ([issue #833](https://github.com/bytedeco/javacpp-presets/issues/833))

libpostal/README.md

@@ -10,17 +10,22 @@ This directory contains the JavaCPP Presets module for:
 libpostal is a C library for parsing/normalizing street addresses around the world using statistical NLP and open data.
 The goal of this project is to understand location-based strings in every language, everywhere.
 
+
 Data Files
 ----------
-
 libpostal needs to download a few gigabytes of data from S3. The basic files are on-disk representations of the data structures necessary to perform expansion.
 For address parsing, since model training takes a few days, the libpostal team publishes the fully trained model to S3 and will update it automatically as new addresses get added to OSM, OpenAddresses, etc.
 Same goes for the language classifier model. Data files are automatically downloaded when you run the build with enabled data download.
 To check for and download any new data files, you can either run ```make```, or run:
 
-```libpostal_data download all $YOUR_DATA_DIR```
+```java
+String libpostal_data = Loader.load(org.bytedeco.libpostal.libpostal_data.class);
+ProcessBuilder pb = new ProcessBuilder("bash", libpostal_data, "download", "all", "/path/to/libpostal/data/");
+pb.inheritIO().start().waitFor();
+```
+
+Replace `"/path/to/libpostal/data/"` with the path where the training data should be stored.
 
-Replace $YOUR_DATA_DIR with the path where the training data should be stored.
 
 Documentation
 -------------
@@ -36,7 +41,7 @@ Here is a simple example of the libpostal parser and normalization functionality
 We can use [Maven 3](http://maven.apache.org/) to download and install automatically all the class files as well as the native binaries.
 To run this sample code, after creating the `pom.xml` and `Example.java` source files below, simply execute on the command line:
 ```bash
- $ mvn compile exec:java -Dexec.args="/PATH_TO_LIBPOSTAL_TRAINING_DATA_DIRECTORY"
+ $ mvn compile exec:java
 ```
 
 ### The `pom.xml` build file
@@ -45,15 +50,15 @@ To run this sample code, after creating the `pom.xml` and `Example.java` source
     <modelVersion>4.0.0</modelVersion>
     <groupId>org.bytedeco.libpostal</groupId>
     <artifactId>example</artifactId>
-    <version>1.5.3</version>
+    <version>1.5.4-SNAPSHOT</version>
     <properties>
         <exec.mainClass>Example</exec.mainClass>
     </properties>
     <dependencies>
         <dependency>
             <groupId>org.bytedeco</groupId>
             <artifactId>libpostal-platform</artifactId>
-            <version>1.1-alpha-1.5.3</version>
+            <version>1.1-alpha-1.5.4-SNAPSHOT</version>
         </dependency>
     </dependencies>
     <build>
@@ -70,7 +75,11 @@ import static org.bytedeco.libpostal.global.postal.*;
 
 public class Example {
     public static void main(String[] args) throws Exception {
-        String dataDir = args.length >= 1 ? new String(args[0]) : "/PATH_TO_LIBPOSTAL_TRAINING_DATA_DIRECTORY";
+        String dataDir = args.length >= 1 ? new String(args[0]) : "data/";
+        String libpostal_data = Loader.load(org.bytedeco.libpostal.libpostal_data.class);
+        ProcessBuilder pb = new ProcessBuilder("bash", libpostal_data, "download", "all", dataDir);
+        pb.inheritIO().start().waitFor();
+
         boolean setup1 = libpostal_setup_datadir(dataDir);
         boolean setup2 = libpostal_setup_parser_datadir(dataDir);
         boolean setup3 = libpostal_setup_language_classifier_datadir(dataDir);

libpostal/samples/Example.java

@@ -4,7 +4,11 @@
 
 public class Example {
     public static void main(String[] args) throws Exception {
-        String dataDir = args.length >= 1 ? new String(args[0]) : "/PATH_TO_LIBPOSTAL_TRAINING_DATA_DIRECTORY";
+        String dataDir = args.length >= 1 ? new String(args[0]) : "data/";
+        String libpostal_data = Loader.load(org.bytedeco.libpostal.libpostal_data.class);
+        ProcessBuilder pb = new ProcessBuilder("bash", libpostal_data, "download", "all", dataDir);
+        pb.inheritIO().start().waitFor();
+
         boolean setup1 = libpostal_setup_datadir(dataDir);
         boolean setup2 = libpostal_setup_parser_datadir(dataDir);
         boolean setup3 = libpostal_setup_language_classifier_datadir(dataDir);

libpostal/samples/pom.xml

@@ -2,15 +2,15 @@
     <modelVersion>4.0.0</modelVersion>
     <groupId>org.bytedeco.libpostal</groupId>
     <artifactId>example</artifactId>
-    <version>1.5.3</version>
+    <version>1.5.4-SNAPSHOT</version>
     <properties>
         <exec.mainClass>Example</exec.mainClass>
     </properties>
     <dependencies>
         <dependency>
             <groupId>org.bytedeco</groupId>
             <artifactId>libpostal-platform</artifactId>
-            <version>1.1-alpha-1.5.3</version>
+            <version>1.1-alpha-1.5.4-SNAPSHOT</version>
         </dependency>
     </dependencies>
     <build>

libpostal/src/gen/java/org/bytedeco/libpostal/global/postal.java

@@ -1,4 +1,4 @@
-// Targeted by JavaCPP version 1.5.3: DO NOT EDIT THIS FILE
+// Targeted by JavaCPP version 1.5.4-SNAPSHOT: DO NOT EDIT THIS FILE
 
 package org.bytedeco.libpostal.global;
 

libpostal/src/gen/java/org/bytedeco/libpostal/libpostal_address_parser_options_t.java

@@ -1,4 +1,4 @@
-// Targeted by JavaCPP version 1.5.3: DO NOT EDIT THIS FILE
+// Targeted by JavaCPP version 1.5.4-SNAPSHOT: DO NOT EDIT THIS FILE
 
 package org.bytedeco.libpostal;
 
@@ -25,6 +25,9 @@ public class libpostal_address_parser_options_t extends Pointer {
     @Override public libpostal_address_parser_options_t position(long position) {
         return (libpostal_address_parser_options_t)super.position(position);
     }
+    @Override public libpostal_address_parser_options_t getPointer(long i) {
+        return new libpostal_address_parser_options_t(this).position(position + i);
+    }
 
     public native @Cast("char*") BytePointer language(); public native libpostal_address_parser_options_t language(BytePointer setter);
     public native @Cast("char*") BytePointer country(); public native libpostal_address_parser_options_t country(BytePointer setter);

libpostal/src/gen/java/org/bytedeco/libpostal/libpostal_address_parser_response_t.java

@@ -1,4 +1,4 @@
-// Targeted by JavaCPP version 1.5.3: DO NOT EDIT THIS FILE
+// Targeted by JavaCPP version 1.5.4-SNAPSHOT: DO NOT EDIT THIS FILE
 
 package org.bytedeco.libpostal;
 
@@ -29,6 +29,9 @@ public class libpostal_address_parser_response_t extends Pointer {
     @Override public libpostal_address_parser_response_t position(long position) {
         return (libpostal_address_parser_response_t)super.position(position);
     }
+    @Override public libpostal_address_parser_response_t getPointer(long i) {
+        return new libpostal_address_parser_response_t(this).position(position + i);
+    }
 
     public native @Cast("size_t") long num_components(); public native libpostal_address_parser_response_t num_components(long setter);
     public native @Cast("char*") BytePointer components(int i); public native libpostal_address_parser_response_t components(int i, BytePointer setter);

libpostal/src/gen/java/org/bytedeco/libpostal/libpostal_duplicate_options_t.java

@@ -1,4 +1,4 @@
-// Targeted by JavaCPP version 1.5.3: DO NOT EDIT THIS FILE
+// Targeted by JavaCPP version 1.5.4-SNAPSHOT: DO NOT EDIT THIS FILE
 
 package org.bytedeco.libpostal;
 
@@ -25,6 +25,9 @@ public class libpostal_duplicate_options_t extends Pointer {
     @Override public libpostal_duplicate_options_t position(long position) {
         return (libpostal_duplicate_options_t)super.position(position);
     }
+    @Override public libpostal_duplicate_options_t getPointer(long i) {
+        return new libpostal_duplicate_options_t(this).position(position + i);
+    }
 
     public native @Cast("size_t") long num_languages(); public native libpostal_duplicate_options_t num_languages(long setter);
     public native @Cast("char*") BytePointer languages(int i); public native libpostal_duplicate_options_t languages(int i, BytePointer setter);

libpostal/src/gen/java/org/bytedeco/libpostal/libpostal_fuzzy_duplicate_options_t.java

@@ -1,4 +1,4 @@
-// Targeted by JavaCPP version 1.5.3: DO NOT EDIT THIS FILE
+// Targeted by JavaCPP version 1.5.4-SNAPSHOT: DO NOT EDIT THIS FILE
 
 package org.bytedeco.libpostal;
 
@@ -27,6 +27,9 @@ public class libpostal_fuzzy_duplicate_options_t extends Pointer {
     @Override public libpostal_fuzzy_duplicate_options_t position(long position) {
         return (libpostal_fuzzy_duplicate_options_t)super.position(position);
     }
+    @Override public libpostal_fuzzy_duplicate_options_t getPointer(long i) {
+        return new libpostal_fuzzy_duplicate_options_t(this).position(position + i);
+    }
 
     public native @Cast("size_t") long num_languages(); public native libpostal_fuzzy_duplicate_options_t num_languages(long setter);
     public native @Cast("char*") BytePointer languages(int i); public native libpostal_fuzzy_duplicate_options_t languages(int i, BytePointer setter);

libpostal/src/gen/java/org/bytedeco/libpostal/libpostal_fuzzy_duplicate_status_t.java

@@ -1,4 +1,4 @@
-// Targeted by JavaCPP version 1.5.3: DO NOT EDIT THIS FILE
+// Targeted by JavaCPP version 1.5.4-SNAPSHOT: DO NOT EDIT THIS FILE
 
 package org.bytedeco.libpostal;
 
@@ -25,6 +25,9 @@ public class libpostal_fuzzy_duplicate_status_t extends Pointer {
     @Override public libpostal_fuzzy_duplicate_status_t position(long position) {
         return (libpostal_fuzzy_duplicate_status_t)super.position(position);
     }
+    @Override public libpostal_fuzzy_duplicate_status_t getPointer(long i) {
+        return new libpostal_fuzzy_duplicate_status_t(this).position(position + i);
+    }
 
     public native @Cast("libpostal_duplicate_status_t") int status(); public native libpostal_fuzzy_duplicate_status_t status(int setter);
     public native double similarity(); public native libpostal_fuzzy_duplicate_status_t similarity(double setter);