Merge pull request #680 from briandowns/feature/fmt_module

add IO module

docs/docs/standard-lib/io.md

@@ -0,0 +1,43 @@
+---
+layout: default
+title: IO
+nav_order: 9
+parent: Standard Library
+---
+
+# IO
+{: .no_toc }
+
+## Table of contents
+{: .no_toc .text-delta }
+
+1. TOC
+{:toc}
+
+---
+
+## IO
+
+To make use of the IO module an import is required.
+
+```cs
+import IO;
+```
+
+### IO.print(...values) -> Nil
+
+Prints a given list of values to stdout.
+
+```cs
+IO.print(0);
+// 0
+```
+
+### IO.println(...values) -> Nil
+
+Prints a given list of values to stdout with an appended newline character.
+
+```cs
+IO.println("Dictu!");
+// Dictu!
+```

docs/docs/standard-lib/json.md

@@ -1,7 +1,7 @@
 ---
 layout: default
 title: JSON
-nav_order: 9
+nav_order: 10
 parent: Standard Library
 ---
 

docs/docs/standard-lib/log.md

@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Log
-nav_order: 10
+nav_order: 11
 parent: Standard Library
 ---
 

docs/docs/standard-lib/math.md

@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Math
-nav_order: 11
+nav_order: 12
 parent: Standard Library
 ---
 

docs/docs/standard-lib/object.md

@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Object
-nav_order: 12
+nav_order: 13
 parent: Standard Library
 ---
 

docs/docs/standard-lib/path.md

@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Path
-nav_order: 13
+nav_order: 14
 parent: Standard Library
 ---
 

docs/docs/standard-lib/process.md

@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Process
-nav_order: 14
+nav_order: 15
 parent: Standard Library
 ---
 

docs/docs/standard-lib/queue.md

@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Queue
-nav_order: 15
+nav_order: 16
 parent: Standard Library
 ---
 

docs/docs/standard-lib/random.md

@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Random
-nav_order: 16
+nav_order: 17
 parent: Standard Library
 ---
 

docs/docs/standard-lib/socket.md

@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Socket
-nav_order: 17
+nav_order: 18
 parent: Standard Library
 ---
 

docs/docs/standard-lib/sqlite.md

@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Sqlite
-nav_order: 18
+nav_order: 19
 parent: Standard Library
 ---
 

docs/docs/standard-lib/stack.md

@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Stack
-nav_order: 19
+nav_order: 20
 parent: Standard Library
 ---
 

docs/docs/standard-lib/system.md

@@ -1,7 +1,7 @@
 ---
 layout: default
 title: System
-nav_order: 20
+nav_order: 21
 parent: Standard Library
 ---
 

docs/docs/standard-lib/term.md

@@ -1,7 +1,7 @@
 ---
 layout: default
 title: Term
-nav_order: 21
+nav_order: 22
 parent: Standard Library
 ---
 

docs/docs/standard-lib/unittest.md

@@ -1,7 +1,7 @@
 ---
 layout: default
 title: UnitTest
-nav_order: 22
+nav_order: 23
 parent: Standard Library
 ---
 
@@ -508,4 +508,4 @@ SomeServiceClass(successObj).print(); // Success!
 
 const errorObj = mock(ExternalApi, {"someExternalCall": 500});
 SomeServiceClass(errorObj).print(); // <nothing>
-```
+```

docs/docs/standard-lib/uuid.md

@@ -1,7 +1,7 @@
 ---
 layout: default
 title: UUID
-nav_order: 23
+nav_order: 24
 parent: Standard Library
 ---
 

examples/io.du

@@ -0,0 +1,7 @@
+import IO;
+
+
+IO.print("asdf134\n");
+IO.println(IO.stderr);
+IO.println(IO.stdin);
+IO.println(IO.stdout);

src/optionals/io.c

@@ -0,0 +1,51 @@
+#include "io.h"
+
+
+static Value printIO(DictuVM *vm, int argCount, Value *args) {
+    if (argCount == 0) {
+        runtimeError(vm, "print() takes 1 or more arguments (%d given)", argCount);
+        return EMPTY_VAL;
+    }
+
+    for (int i = 0; i < argCount; ++i) {
+        printValue(args[i]);
+    }
+
+    return NIL_VAL;
+}
+
+static Value printlnIO(DictuVM *vm, int argCount, Value *args) {
+    if (argCount == 0) {
+        runtimeError(vm, "println() takes 1 or more arguments (%d given)", argCount);
+        return EMPTY_VAL;
+    }
+
+    for (int i = 0; i < argCount; ++i) {
+        printValue(args[i]);
+        printf("\n");
+    }
+
+    return NIL_VAL;
+}
+
+Value createIOModule(DictuVM *vm) {
+    ObjString *name = copyString(vm, "IO", 2);
+    push(vm, OBJ_VAL(name));
+    ObjModule *module = newModule(vm, name);
+    push(vm, OBJ_VAL(module));
+
+    defineNativeProperty(vm, &module->values, "stdin",  NUMBER_VAL(STDIN_FILENO));
+    defineNativeProperty(vm, &module->values, "stdout",  NUMBER_VAL(STDOUT_FILENO));
+    defineNativeProperty(vm, &module->values, "stderr",  NUMBER_VAL(STDERR_FILENO));
+
+    /**
+     * Define IO methods
+     */
+    defineNative(vm, &module->values, "print", printIO);
+    defineNative(vm, &module->values, "println", printlnIO);
+
+    pop(vm);
+    pop(vm);
+
+    return OBJ_VAL(module);
+}

src/optionals/io.h

@@ -0,0 +1,9 @@
+#ifndef _dictu_io_h
+#define _dictu_io_h
+
+#include "optionals.h"
+#include "../vm/vm.h"
+
+Value createIOModule(DictuVM *vm);
+
+#endif //_dictu_io_h

src/optionals/optionals.c

@@ -5,6 +5,7 @@ BuiltinModules modules[] = {
     {"Argparse", &createArgParseModule, false},
     {"Math", &createMathsModule, false},
     {"Env", &createEnvModule, true},
+    {"IO", &createIOModule, false},
     {"JSON", &createJSONModule, false},
     {"Log", &createLogModule, false},
     {"Path", &createPathModule, false},

src/optionals/optionals.h

@@ -6,6 +6,7 @@
 #include "argparse/argparse.h"
 #include "math.h"
 #include "env/env.h"
+#include "io.h"
 #include "system.h"
 #include "json.h"
 #include "log.h"