sausage-plugin part 2: import! with typed clients (sausage_interface::client_rs), TCP endpoints with rpc.endpoint, examples

Part 1 fixes: complete stdout writes, buffered stdin, Rust type names in schemas, enum variant docs, -32603 for serde errors in handlers, crate docs and modules. End-to-end check of a generated consumer through a fake core.
2026-10-23 00:35:45 +01:00
parent ae1cb4cc99
commit 8d3c163992
42 changed files with 3020 additions and 856 deletions
@@ -0,0 +1,92 @@
+{
+  "components": {
+    "schemas": {
+      "AddParams": {
+        "description": "Parameters for a new note.",
+        "properties": {
+          "text": {
+            "description": "The complete note text, including any newlines.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "text"
+        ],
+        "type": "object"
+      },
+      "Added": {
+        "description": "The result after a note enters the list.",
+        "properties": {
+          "count": {
+            "description": "The number of notes, including the new note.",
+            "format": "uint",
+            "minimum": 0,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "count"
+        ],
+        "type": "object"
+      },
+      "Empty": {
+        "description": "Empty parameters for methods without arguments.",
+        "type": "object"
+      }
+    }
+  },
+  "info": {
+    "title": "notes",
+    "version": "0.1.0"
+  },
+  "methods": [
+    {
+      "description": "Add a note and return the new count.",
+      "name": "add",
+      "paramStructure": "by-name",
+      "params": [
+        {
+          "description": "The complete note text, including any newlines.",
+          "name": "text",
+          "required": true,
+          "schema": {
+            "description": "The complete note text, including any newlines.",
+            "type": "string"
+          }
+        }
+      ],
+      "result": {
+        "name": "result",
+        "schema": {
+          "$ref": "#/components/schemas/Added"
+        }
+      },
+      "summary": "Add a note and return the new count.",
+      "x-sausage-params": {
+        "$ref": "#/components/schemas/AddParams"
+      }
+    },
+    {
+      "description": "List all notes, oldest first.",
+      "name": "list",
+      "paramStructure": "by-name",
+      "params": [],
+      "result": {
+        "name": "result",
+        "schema": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        }
+      },
+      "summary": "List all notes, oldest first.",
+      "x-sausage-params": {
+        "$ref": "#/components/schemas/Empty"
+      }
+    }
+  ],
+  "openrpc": "1.2.6",
+  "x-sausage-endpoints": {},
+  "x-sausage-imports": {}
+}