add Utility Functions, GlibUtils and GlibUtilsTest (#106)

* add Utility Functions, GlubUtils and GlibUtilsTest

* rename to GLib and GLibTest

Author: i-n-g-o

src/org/freedesktop/gstreamer/glib/GLib.java

@@ -0,0 +1,34 @@
+/* 
+ * This file is part of gstreamer-java.
+ *
+ * gstreamer-java is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * gstreamer-java is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with gstreamer-java.  If not, see <http://www.gnu.org/licenses/>.
+ */
+package org.freedesktop.gstreamer.glib;
+
+import org.freedesktop.gstreamer.lowlevel.GlibAPI;
+
+public class GLib {
+    
+    public static boolean setEnv(String variable, final String value, boolean overwrite) {        
+        return GlibAPI.GLIB_API.g_setenv(variable, value, overwrite);       
+    }
+    
+    public static String getEnv(String variable) {       
+        return GlibAPI.GLIB_API.g_getenv(variable);       
+    }   
+    
+    public static void unsetEnv(String variable) {
+        GlibAPI.GLIB_API.g_unsetenv(variable);       
+    }
+}

src/org/freedesktop/gstreamer/lowlevel/GlibAPI.java

@@ -176,4 +176,45 @@ protected List<String> getFieldOrder() {
             });
         }
     }
+    
+    /*
+     * Miscellaneous Utility Functions
+     */
+    
+    /**
+     * Returns the value of an environment variable.
+     * 
+     * On UNIX, the name and value are byte strings which might or might not be 
+     * in some consistent character set and encoding. On Windows, they are in UTF-8. 
+     * On Windows, in case the environment variable's value contains references 
+     * to other environment variables, they are expanded.
+     * 
+     * @param variable the environment variable to get.     
+     * @return the value of the environment variable, or NULL if the 
+     *         environment variable is not found. 
+     */
+    String g_getenv(String variable);
+    
+    
+    /**
+     * Sets an environment variable. 
+     * 
+     * On UNIX, both the variable's name and value can be arbitrary byte strings, 
+     * except that the variable's name cannot contain '='. 
+     * On Windows, they should be in UTF-8.
+     * 
+     * @param variable the environment variable to set, must not contain '='. 
+     * @param value the value for to set the variable to. 
+     * @param overwrite whether to change the variable if it already exists.
+     * @return FALSE if the environment variable couldn't be set.
+     */
+    boolean g_setenv(String variable, String value, boolean overwrite);
+    
+    
+    /**
+     * Removes an environment variable from the environment.
+     * 
+     * @param variable the environment variable to remove, must not contain '='. 
+     */
+    void g_unsetenv(String variable);
 }

test/org/freedesktop/gstreamer/GLibTest.java

@@ -0,0 +1,46 @@
+/* 
+ * This file is part of gstreamer-java.
+ *
+ * gstreamer-java is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * gstreamer-java is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with gstreamer-java.  If not, see <http://www.gnu.org/licenses/>.
+ */
+package org.freedesktop.gstreamer;
+
+import org.freedesktop.gstreamer.glib.GLib;
+import static org.junit.Assert.assertEquals;
+import org.junit.Test;
+
+public class GLibTest {
+    
+    @Test
+    public void getEnv() {       
+        String user = GLib.getEnv("USER");
+        String pwd = GLib.getEnv("PWD");
+        System.out.println("user: " + user);
+        System.out.println("path: " + pwd);        
+    }
+    
+    @Test
+    public void setUnsetEnv() {
+        
+        // set environment
+        GLib.setEnv("TESTVAR", "foo", true);
+        
+        // get environment
+        assertEquals("could not set TESTVAR!", GLib.getEnv("TESTVAR"), "foo");
+        
+        // unset
+        GLib.unsetEnv("TESTVAR");
+        assertEquals("could not unset TESTVAR!", GLib.getEnv("TESTVAR"), null);
+    }
+}