Load/Save state support.

Author: bladecoder

.vscode/settings.json

@@ -0,0 +1,11 @@
+{
+    "python.testing.unittestArgs": [
+        "-v",
+        "-s",
+        ".",
+        "-p",
+        "test_*.py"
+    ],
+    "python.testing.pytestEnabled": false,
+    "python.testing.unittestEnabled": true
+}

bink/native/arm64/libbink.dylib

@@ -136,6 +136,40 @@ def choose_path_string(self, path: str):
             LIB.bink_cstring_free(err_msg)
             raise RuntimeError(err)
 
+    def save_state(self) -> str:
+        """Saves the current state of the story and returns it as a string.
+        The returned state can be loaded later using load_state()."""
+        err_msg = ctypes.c_char_p()
+        save_string = ctypes.c_char_p()
+        ret = LIB.bink_story_save_state(
+            self._story,
+            ctypes.byref(save_string),
+            ctypes.byref(err_msg))
+
+        if ret != BINK_OK:
+            err = err_msg.value.decode('utf-8')
+            LIB.bink_cstring_free(err_msg)
+            raise RuntimeError(err)
+
+        result = save_string.value.decode('utf-8')
+        LIB.bink_cstring_free(save_string)
+
+        return result
+
+    def load_state(self, save_state: str):
+        """Loads a previously saved state into the story.
+        This allows resuming the story from a saved point."""
+        err_msg = ctypes.c_char_p()
+        ret = LIB.bink_story_load_state(
+            self._story,
+            save_state.encode('utf-8'),
+            ctypes.byref(err_msg))
+
+        if ret != BINK_OK:
+            err = err_msg.value.decode('utf-8')
+            LIB.bink_cstring_free(err_msg)
+            raise RuntimeError(err)
+
     def __del__(self):
         LIB.bink_story_free(self._story)
 

bink/native/arm64/libbink.so

@@ -0,0 +1,28 @@
+-> back_in_london
+
+=== back_in_london ===
+
+We arrived into London at 9.45pm exactly.
+
+*   "There is not a moment to lose!"[] I declared.
+    -> hurry_outside 
+
+*   "Monsieur, let us savour this moment!"[] I declared.
+    My master clouted me firmly around the head and dragged me out of the door. 
+    -> dragged_outside 
+
+*   [We hurried home] -> hurry_outside
+
+
+=== hurry_outside ===
+We hurried home to Savile Row -> as_fast_as_we_could
+
+
+=== dragged_outside === 
+He insisted that we hurried home to Savile Row 
+-> as_fast_as_we_could
+
+
+=== as_fast_as_we_could === 
+<> as fast as we could.
+-> END

bink/native/x86_64/bink.dll

@@ -0,0 +1 @@
+{"inkVersion":21,"root":[[{"->":"back_in_london"},["done",{"#n":"g-0"}],null],"done",{"back_in_london":[["^We arrived into London at 9.45pm exactly.","\n",["ev",{"^->":"back_in_london.0.2.$r1"},{"temp=":"$r"},"str",{"->":".^.s"},[{"#n":"$r1"}],"/str","/ev",{"*":".^.^.c-0","flg":18},{"s":["^\"There is not a moment to lose!\"",{"->":"$r","var":true},null]}],["ev",{"^->":"back_in_london.0.3.$r1"},{"temp=":"$r"},"str",{"->":".^.s"},[{"#n":"$r1"}],"/str","/ev",{"*":".^.^.c-1","flg":18},{"s":["^\"Monsieur, let us savour this moment!\"",{"->":"$r","var":true},null]}],"ev","str","^We hurried home","/str","/ev",{"*":".^.c-2","flg":20},{"c-0":["ev",{"^->":"back_in_london.0.c-0.$r2"},"/ev",{"temp=":"$r"},{"->":".^.^.2.s"},[{"#n":"$r2"}],"^ I declared.","\n",{"->":"hurry_outside"},{"#f":5}],"c-1":["ev",{"^->":"back_in_london.0.c-1.$r2"},"/ev",{"temp=":"$r"},{"->":".^.^.3.s"},[{"#n":"$r2"}],"^ I declared.","\n","^My master clouted me firmly around the head and dragged me out of the door.","\n",{"->":"dragged_outside"},{"#f":5}],"c-2":["^ ",{"->":"hurry_outside"},"\n",{"#f":5}]}],null],"hurry_outside":["^We hurried home to Savile Row ",{"->":"as_fast_as_we_could"},"\n",null],"dragged_outside":["^He insisted that we hurried home to Savile Row","\n",{"->":"as_fast_as_we_could"},null],"as_fast_as_we_could":["<>","^ as fast as we could.","\n","end",null]}],"listDefs":{}}

bink/native/x86_64/libbink.dylib

@@ -1,6 +1,6 @@
 [metadata]
 name = bink
-version = 0.4.0
+version = 0.5.0
 author = Rafael Garcia
 description = Runtime for Ink, a scripting language for writing interactive narrative
 long_description = file: README.rst