Add packaging options

Author: wetneb

README.md

@@ -0,0 +1,22 @@
+Commons extension (name not final)
+==================================
+
+This is a skeleton of OpenRefine extension for Wikimedia Commons, in the form of an independent Maven project.
+It works with OpenRefine 3.6+.
+
+
+Building it
+-----------
+
+Run
+```
+mvn package
+```
+
+This creates a zip file in the `target` folder, which can then be [installed in OpenRefine](https://docs.openrefine.org/manual/installing#installing-extensions).
+
+Developing it
+-------------
+
+To avoid having to unzip the extension in the corresponding directory every time you want to test it, you can also use another set up: simply create a symbolic link from your extensions folder in OpenRefine to the local copy of this repository.
+You will still need to restart OpenRefine every time you make changes.

module/MOD-INF/controller.js

@@ -3,5 +3,9 @@
  * Function invoked to initialize the extension.
  */
 function init() {
+   
+  // Register our GREL functions so that they are visible in OpenRefine
+  var CFR = Packages.com.google.refine.grel.ControlFunctionRegistry;
 
+  CFR.registerFunction("extractCategories", new Packages.org.openrefine.extensions.commons.functions.ExtractCategories());
 }

pom.xml

@@ -81,6 +81,25 @@
           </filesets>
         </configuration>
       </plugin>
+      <plugin>
+        <artifactId>maven-assembly-plugin</artifactId>
+        <version>3.0.0</version>
+        <configuration>
+          <appendAssemblyId>false</appendAssemblyId>	
+          <descriptors>
+            <descriptor>src/assembly/extension.xml</descriptor>
+          </descriptors>
+        </configuration>
+        <executions>
+          <execution>
+            <id>make-assembly</id>
+            <phase>package</phase>
+            <goals>
+              <goal>single</goal>
+            </goals>
+          </execution>
+        </executions>
+      </plugin>
     </plugins>
   </build>
 
@@ -101,16 +120,19 @@
       <groupId>com.fasterxml.jackson.core</groupId>
       <artifactId>jackson-core</artifactId>
       <version>${jackson.version}</version>
+      <scope>provided</scope>
     </dependency>
     <dependency>
       <groupId>org.openrefine.dependencies.wdtk</groupId>
       <artifactId>wdtk-datamodel</artifactId>
       <version>${wdtk.version}</version>
+      <scope>provided</scope>
     </dependency>
     <dependency>
       <groupId>org.openrefine.dependencies.wdtk</groupId>
       <artifactId>wdtk-util</artifactId>
       <version>${wdtk.version}</version>
+      <scope>provided</scope>
     </dependency>
     <dependency>
       <groupId>org.slf4j</groupId>

src/assembly/extension.xml

@@ -0,0 +1,22 @@
+<assembly xmlns="http://maven.apache.org/ASSEMBLY/2.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://maven.apache.org/ASSEMBLY/2.0.0 http://maven.apache.org/xsd/assembly-2.0.0.xsd">
+    <id>openrefine-commons-${openrefine.version}</id>
+    <includeBaseDirectory>false</includeBaseDirectory>
+    <formats>
+        <format>zip</format>
+    </formats>
+    <fileSets>
+        <fileSet>
+            <directory>module/</directory>
+            <outputDirectory>module/</outputDirectory>
+            <excludes>
+                <exclude>**/*.java</exclude>
+            </excludes>
+        </fileSet>
+        <fileSet>
+            <directory>src/main/resources/module</directory>
+            <outputDirectory>module</outputDirectory>
+        </fileSet>
+    </fileSets>
+</assembly>

src/test/conf/tests.xml

@@ -0,0 +1,14 @@
+<!DOCTYPE suite SYSTEM "https://testng.org/testng-1.0.dtd" >
+ 
+<suite name="Commons extension">
+  <test name="tests">
+    <groups>
+      <run>
+        <exclude name="broken" />
+      </run>
+    </groups>
+    <packages>
+      <package name="org.openrefine.extensions.commons.*" />
+    </packages>
+  </test>
+</suite>