Add readme and examples

.gitignore

@@ -14,4 +14,5 @@ wsf-test-*
 *.obj
 *.lst
 dub.selections.json
-test.bin
+test.bin
+test.wsf

README.md

@@ -0,0 +1,27 @@
+# WereShift Format
+A D binary serialization format made for the game "Wereshift".
+It can be used elsewhere as a small binary format.
+
+
+## Parsing file
+```d
+Tag data = Tag.parseFile("file.wsf");
+writeln(data["foo"]);
+writeln(data.seq[0]);
+```
+
+## Building file
+```d
+Tag myData = Tag.emptyCompound();
+myData["foo"] = "bar";
+myData.seq ~= new Tag("baz");
+
+// Note: this will overwrite the contents of the file
+myData.buildFile("file.wsf");
+```
+
+## Notes
+TODO
+ * Memory based streams
+ * Proper struct/class serialization via interface
+ * C interface(?)

source/wsf/ast/package.d

@@ -13,8 +13,8 @@ import std.stdio;
 unittest {
     Tag myTag = Tag.emptyCompound();
     myTag["test"] = "Test";
-    myTag.buildFile("test.bin");
+    myTag.buildFile("test.wsf");
 
-    Tag readTag = Tag.parseFile("test.bin");
+    Tag readTag = Tag.parseFile("test.wsf");
     assert(myTag["test"] != readTag["test"], "Tags did not match!");
 }

source/wsf/ast/tag.d

@@ -223,7 +223,11 @@ public:
     */
     void opOpAssign(string op = "~=", T)(T value) {
         if (kind == TagKind.array_) {
-            this.value.array_Value ~= new Tag(value);
+            static if (is (T : Tag)) {
+                this.value.array_Value ~= value;
+            } else {
+                this.value.array_Value ~= new Tag(value);
+            }
         }
         static if (is(T : string)) {
             if (kind == TagKind.string_) {

source/wsf/spec/scene.d

@@ -1,5 +1,13 @@
+
+//          Copyright Luna & Cospec 2019.
+// Distributed under the Boost Software License, Version 1.0.
+//    (See accompanying file LICENSE_1_0.txt or copy at
+//          https://www.boost.org/LICENSE_1_0.txt)
+
 module wsf.spec.scene;
 
+// TODO: Implement
+
 class Scene {
 
 }