Add HTTP server example

Author: jaepil

examples/http/README.md

@@ -0,0 +1,78 @@
+# Compute API Example
+
+## Running the API
+
+```bash
+uvicorn main:app --reload
+```
+
+## API Endpoints
+
+### GET Endpoint
+
+- URL: `/compute`
+- Query Parameters:
+  - `input` (required): The expression to compute
+  - `timeout` (optional, default: 10.0): Timeout for computation in seconds
+
+Examples:
+
+```bash
+# Basic usage (URL-encoded)
+curl "http://localhost:8000/compute?input=21%2B21"
+
+# Alternative URL-encoded formats
+curl "http://localhost:8000/compute?input=21%20%2B%2021"
+curl "http://localhost:8000/compute?input=21+21"  # Some clients handle this
+
+# With custom timeout (URL-encoded)
+curl "http://localhost:8000/compute?input=21%2B21&timeout=5.0"
+```
+
+```bash
+# With function call
+curl "http://localhost:8000/compute?input=say_hello(\"Monic\")&timeout=5.0"
+```
+
+### POST Endpoint
+
+- URL: `/compute`
+- Request Body (JSON):
+
+  ```json
+  {
+    "input": "string",  // Required: Expression to compute
+    "timeout": float    // Optional: Timeout for computation (default: 10.0)
+  }
+  ```
+
+Example:
+
+```bash
+curl -X POST http://localhost:8000/compute \
+     -H "Content-Type: application/json" \
+     -d '{"input": "21 + 21", "timeout": 5.0}'
+```
+
+```bash
+curl -X POST http://localhost:8000/compute \
+     -H "Content-Type: application/json" \
+     -d '{"input": "say_hello(\"Monic\")", "timeout": 5.0}'
+```
+
+### Response
+
+Both endpoints return a JSON response:
+
+```json
+{
+  "result": 42
+}
+```
+
+## Notes
+
+- The `input` field is required for both GET and POST requests
+- You can optionally specify a `timeout` to limit computation time
+- The API uses the Monic Framework's expression parser and interpreter
+- For GET requests, use URL encoding for special characters like `+`

examples/http/main.py

@@ -0,0 +1,67 @@
+#
+# Monic Framework
+#
+# Copyright (c) 2024 Cognica, Inc.
+#
+
+# pylint: disable=redefined-builtin
+
+from fastapi import FastAPI, Query
+from pydantic import BaseModel
+
+from monic.expressions import (
+    ExpressionsContext,
+    ExpressionsParser,
+    ExpressionsInterpreter,
+    register,
+)
+
+
+app = FastAPI(title="Compute API")
+
+
+class ComputeInput(BaseModel):
+    input: str
+    timeout: float = 10.0
+
+
+@register
+def say_hello(name: str) -> str:
+    return f"Hello, {name}!"
+
+
+@app.get("/compute")
+async def compute_get(
+    input: str = Query(..., description="Expression to compute"),
+    timeout: float = Query(10.0, description="Timeout for computation"),
+):
+    """
+    Compute endpoint supporting GET method
+    Returns the computed result of the input expression
+    """
+    parser = ExpressionsParser()
+    context = ExpressionsContext(timeout=timeout)
+    interpreter = ExpressionsInterpreter(context=context)
+    result = interpreter.execute(parser.parse(input))
+
+    return {"result": result}
+
+
+@app.post("/compute")
+async def compute_post(compute_input: ComputeInput):
+    """
+    Compute endpoint supporting POST method
+    Returns the computed result of the input expression
+    """
+    parser = ExpressionsParser()
+    context = ExpressionsContext(timeout=compute_input.timeout)
+    interpreter = ExpressionsInterpreter(context=context)
+    result = interpreter.execute(parser.parse(compute_input.input))
+
+    return {"result": result}
+
+
+if __name__ == "__main__":
+    import uvicorn
+
+    uvicorn.run(app, host="0.0.0.0", port=8000)