Initial commit

Author: WebFreak001

.gitignore

@@ -0,0 +1,9 @@
+.dub
+docs.json
+__dummy.html
+*.o
+*.obj
+*.a
+bin
+/d-open-location-code
+dub.selections.json

README.md

@@ -0,0 +1,47 @@
+# DOpenLocationCode
+
+Port of the [open-location-code](https://github.com/google/open-location-code) library (also known as [plus codes](https://plus.codes)) for identifying geo areas.
+
+This ports commit (a6eb95b)[https://github.com/google/open-location-code/commit/a6eb95b4d2f934e94dae4f092260caf7f3db7967]
+
+## Example
+
+normal usage:
+
+```d
+import openlocationcode;
+
+// get geo coordinates from plus code
+OpenLocationCode plusCode = OpenLocationCode.fromString("8FVC2222+22GCCCC");
+writeln(plusCode.decode());
+// -> 
+
+// get plus code from geo coordinates
+OpenLocationCode generatedPlusCode = OpenLocationCode.encode(lat, lon);
+writeln(generatedPlusCode.code);
+```
+
+---
+
+`nothrow @nogc` usage:
+
+```d
+import openlocationcode;
+
+// get geo coordinates from plus code
+string input = "8FVC2222+22GCCCC";
+if (!input.isValidCode)
+	return error;
+OpenLocationCode plusCode = OpenLocationCode.fromTrustedString(input);
+
+if (!plusCode.isFull)
+	return error;
+OpenLocationCodeArea area = plusCode.decodeTrustedFull();
+printf("area around %d, %d", area.centerLatitude, area.centerLongitude);
+
+// get plus code from geo coordinates
+ubyte[maxOLCLength] buffer;
+scope ubyte[] generatedPlusCodeString = OpenLocationCode.encode(buffer, lat, lon);
+printf("%s", cast(char[])generatedPlusCodeString);
+
+```

benchmark/.gitignore

@@ -0,0 +1 @@
+/benchmark

benchmark/dub.sdl

@@ -0,0 +1,2 @@
+name "benchmark"
+dependency "d-open-location-code" path=".."

benchmark/source/app.d

@@ -0,0 +1,53 @@
+import openlocationcode;
+
+import core.time : MonoTime;
+import std.random;
+import std.stdio;
+
+void main()
+{
+	enum loops = 1000000;
+
+	struct TestData
+	{
+		double lat, lon;
+		int length;
+		string code;
+
+		static TestData generate()
+		{
+			TestData ret;
+			ret.lat = uniform01!double * 180 - 90;
+			ret.lon = uniform01!double * 360 - 180;
+			ret.length = uniform(4, 15);
+			if (ret.length < 10 && ret.length % 2 == 1)
+				ret.length++;
+			ret.code = OpenLocationCode.encode(ret.lat, ret.lon, ret.length).code;
+			return ret;
+		}
+	}
+
+	TestData[] list;
+	list.length = loops;
+	foreach (i; 0 .. loops)
+		list[i] = TestData.generate();
+
+	writeln("Running encode benchmark");
+	ubyte[maxOLCLength] buffer = void;
+	// benchmark encode
+	auto start = MonoTime.currTime();
+	foreach (data; list)
+		cast(void) OpenLocationCode.encode(buffer[], data.lat, data.lon, data.length);
+	auto end = MonoTime.currTime();
+	auto dur = end - start;
+	writefln("Encode %s loops in %s;\n\t%s per call", loops, dur, dur / loops);
+
+	writeln("Running decode benchmark");
+	// benchmark decode
+	start = MonoTime.currTime();
+	foreach (data; list)
+		cast(void) OpenLocationCode.fromTrustedString(data.code).decodeTrustedFull();
+	end = MonoTime.currTime();
+	dur = end - start;
+	writefln("Decode %s loops in %s;\n\t%s per call", loops, dur, dur / loops);
+}

dub.json

@@ -0,0 +1,21 @@
+{
+	"name": "d-open-location-code",
+	"license": "Apache-2.0",
+	"targetType": "library",
+	"configurations": [
+		{
+			"name": "library"
+		},
+		{
+			"name": "unittest",
+			"targetType": "executable",
+			"preBuildCommands": [
+				"$DUB run --compiler=$$DC unit-threaded -c gen_ut_main -- -f bin/ut.d"
+			],
+			"mainSourceFile": "bin/ut.d",
+			"dependencies": {
+				"unit-threaded": "*"
+			}
+		}
+	]
+}