Merge pull request #21 from peterhuene/add-store-back

Add the Store type back to the API.

Author: Peter Huene

README.md

@@ -69,29 +69,33 @@ namespace Tutorial
     {
         static void Main(string[] args)
         {
-            using var host = new Host();
+            using var store = new Store();
+
+            using var module = store.LoadModuleText(
+              "hello",
+              "(module (func $hello (import \"\" \"hello\")) (func (export \"run\") (call $hello)))"
+            );
+
+            using var host = new Host(store);
 
             host.DefineFunction(
                 "",
                 "hello",
                 () => Console.WriteLine("Hello from C#!")
             );
 
-            using var module = host.LoadModuleText(
-              "hello",
-              "(module (func $hello (import \"\" \"hello\")) (func (export \"run\") (call $hello)))"
-            );
-
             using dynamic instance = host.Instantiate(module);
             instance.run();
         }
     }
 }
 ```
 
-This host defines a function called `hello` that simply prints a hello message.
+A `Store` is created and the WebAssembly module, in text format, is loaded into the store.
+
+A `Host` defines a function called `hello` that simply prints a hello message.
 
-It then loads the module into the host in WebAssembly text format and invokes the module's `run` export.
+The module is instantiated into the host and the module's `run` export is invoked.
 
 To run the application, simply use `dotnet`:
 

docs/articles/intro.md

@@ -65,16 +65,16 @@ namespace Tutorial
     {
         static void Main(string[] args)
         {
-            using var host = new Host();
+            using var store = new Store();
+            using var module = store.LoadModuleText("hello", "(module (func $hello (import \"\" \"hello\")) (func (export \"run\") (call $hello)))");
+            using var host = new Host(store);
 
             host.DefineFunction(
                 "",
                 "hello",
                 () => Console.WriteLine("Hello from C#!")
             );
 
-            using var module = host.LoadModuleText("hello", "(module (func $hello (import \"\" \"hello\")) (func (export \"run\") (call $hello)))");
-
             using dynamic instance = host.Instantiate(module);
             instance.run();
         }

examples/global/Program.cs

@@ -7,7 +7,9 @@ class Program
     {
         static void Main(string[] args)
         {
-            using var host = new Host();
+            using var store = new Store();
+            using var module = store.LoadModuleText("global.wat");
+            using var host = new Host(store);
 
             var global = host.DefineMutableGlobal("", "global", 1);
 
@@ -19,8 +21,6 @@ static void Main(string[] args)
                 }
             );
 
-            using var module = host.LoadModuleText("global.wat");
-
             using dynamic instance = host.Instantiate(module);
             instance.run(20);
         }

examples/hello/Program.cs

@@ -7,16 +7,16 @@ class Program
     {
         static void Main(string[] args)
         {
-            using var host = new Host();
+            using var store = new Store();
+            using var module = store.LoadModuleText("hello.wat");
+            using var host = new Host(store);
 
             host.DefineFunction(
                 "",
                 "hello",
                 () => Console.WriteLine("Hello from C#, WebAssembly!")
             );
 
-            using var module = host.LoadModuleText("hello.wat");
-
             using dynamic instance = host.Instantiate(module);
             instance.run();
         }

examples/memory/Program.cs

@@ -7,7 +7,9 @@ class Program
     {
         static void Main(string[] args)
         {
-            using var host = new Host();
+            using var store = new Store();
+            using var module = store.LoadModuleText("memory.wat");
+            using var host = new Host(store);
 
             host.DefineFunction(
                 "",
@@ -18,8 +20,6 @@ static void Main(string[] args)
                 }
             );
 
-            using var module = host.LoadModuleText("memory.wat");
-
             using dynamic instance = host.Instantiate(module);
             instance.run();
         }