dist v0.1.0

Author: cj-formata

README.md

@@ -13,61 +13,62 @@
 ```rust
 import "@weave";
 
-#[type]
-#[extends("Job")]
-First: {
-    #[run]
-    fn first() {
-        self.async_handle(async {
-            sleep(10ms);
-            const diff = Time.diff(self.get("start"));
-            self.set("first", diff);
-        });
-    }
-}
-
-#[type]
-#[extends("Job")]
-Second: {
-    #[run(0)]
-    fn second_0() {
-        const diff = Time.diff(self.get("start"));
-        self.set("second_0", diff);
-        sleep(2ms);
-    }
-
-    #[run(1)]
-    fn second_1() {
-        const diff = Time.diff(self.get("start"));
-        self.set("second_1", diff);
-    }
-}
-
 Weave workflow: {
+    str out: ""
+
     jobs: [
-        new First {},
-        new Second {},
+        () => {
+            let out = &self.out;
+            out.push("first");
+        },
+        {
+            #[run]
+            fn fourth() {
+                self.async_handle(async {
+                    sleep(5ms);
+                    let out = &self.weave().out;
+                    out.push("\nfourth");
+                });
+            }
+        },
+        {
+            #[run(0)]
+            fn second() {
+                let out = &self.weave().out;
+                out.push("\nsecond");
+            }
+
+            #[run(1)]
+            fn third() {
+                let out = &self.weave().out;
+                out.push("\nthird");
+            }
+        },
     ]
+
+    finalize: () => {
+        let out = &self.out;
+        out.push("\nfinal");
+    }
 }
 
 #[main]
 fn run_workflow() {
-    self.workflow.set("start", Time.now());
     self.workflow.run();
-
-    assert(self.workflow.delete("start"));
-    pln(stringify('toml', self.workflow.background));
+    pln(self.workflow.out);
 }
 ```
 ```bash
-stof test examples/simple
-first = 10.0
-second_0 = 0.0
-second_1 = 2.0
+stof run example.stof
+first
+second
+third
+fourth
+final
 ```
 
 ## Differentiators
-- Single File Simplicity
+- Simplicity
 - Built-in Validation & Healing
 - No Glue Code
 - Composability
@@ -76,6 +77,19 @@ second_1 = 2.0
 ## License
 Apache 2.0. See LICENSE for details.
 
+## Package Stof CLI Command
+Run this Stof CLI command to create a pkg file for use.
+```
+stof pkg . dist/weave.pkg
+```
+
+## Install (unpackage) StofWeave
+Run this Stof CLI command to unpack the weave.pkg file into you "stof" folder.
+After execution, StofWeave will be available as `import '@weave';` in your Stof code.
+```
+stof unpkg dist/weave.pkg
+```
+
 ## Feedback & Community
 - Open issues or discussions on [GitHub](https://github.com/dev-formata-io/stof)
 - Chat with us on [Discord](https://discord.gg/Up5kxdeXZt)

dist/weave.pkg

@@ -0,0 +1,63 @@
+//
+// Copyright 2025 Formata, Inc. All rights reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//    http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+
+#[type]
+#[extends('Job')]
+First: {
+    #[run]
+    fn first() {
+        self.async_handle(async {
+            sleep(10ms);
+            const diff = Time.diff(self.get('start'));
+            self.set('first', diff);
+        });
+    }
+}
+
+#[type]
+#[extends('Job')]
+Second: {
+    #[run(0)]
+    fn second_0() {
+        const diff = Time.diff(self.get('start'));
+        self.set('second_0', diff);
+        sleep(2ms);
+    }
+
+    #[run(1)]
+    fn second_1() {
+        const diff = Time.diff(self.get('start'));
+        self.set('second_1', diff);
+    }
+}
+
+#[test]
+fn run_workflow() {
+    const workflow = <Weave>.new([
+        new First {},
+        new Second {},
+    ]);
+    workflow.set('start', Time.now());
+    workflow.run();
+
+    assert(workflow.delete('start'));
+    //pln(stringify('toml', workflow.data));
+
+    assert(workflow.data.first >= 10ms);
+    assert(workflow.data.second_0 < workflow.data.second_1);
+    assert(workflow.data.second_1 >= 2ms);
+}

examples/async/mod.stof

@@ -0,0 +1,23 @@
+//
+// Copyright 2025 Formata, Inc. All rights reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//    http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+import: [
+    {
+        path: '../../pkg.stof'
+        format: 'pkg'
+    },
+    'mod'
+]

examples/async/pkg.stof

@@ -29,10 +29,18 @@ import: [
     },
     {
         path: 'simple/mod'
-        as: 'SimpleTests'
+        as: 'SimpleFlow'
+    },
+    {
+        path: 'async/mod'
+        as: 'AsyncFlow'
+    },
+    {
+        path: 'readme/mod'
+        as: 'ReadmeFlow'
     },
     {
         path: 'prompts/mod'
-        as: 'PromptTests'
+        as: 'Prompting'
     },
 ]

examples/pkg.stof

@@ -0,0 +1,61 @@
+//
+// Copyright 2025 Formata, Inc. All rights reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//    http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+
+Weave workflow: {
+    str out: ""
+
+    jobs: [
+        () => {
+            let out = &self.out;
+            out.push("first");
+        },
+        {
+            #[run]
+            fn fourth() {
+                self.async_handle(async {
+                    sleep(5ms);
+                    let out = &self.weave().out;
+                    out.push("\nfourth");
+                });
+            }
+        },
+        {
+            #[run(0)]
+            fn second() {
+                let out = &self.weave().out;
+                out.push("\nsecond");
+            }
+
+            #[run(1)]
+            fn third() {
+                let out = &self.weave().out;
+                out.push("\nthird");
+            }
+        },
+    ]
+
+    finalize: () => {
+        let out = &self.out;
+        out.push("\nfinal");
+    }
+}
+
+#[test]
+fn run_workflow() {
+    self.workflow.run();
+    assert_eq(self.workflow.out, "first\nsecond\nthird\nfourth\nfinal");
+}

examples/readme/mod.stof

@@ -0,0 +1,23 @@
+//
+// Copyright 2025 Formata, Inc. All rights reserved.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//    http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+//
+
+import: [
+    {
+        path: '../../pkg.stof'
+        format: 'pkg'
+    },
+    'mod'
+]