MathDemo - SnakeBridge v3 Example

This example demonstrates SnakeBridge v3 compile-time generation, discovery APIs, and live runtime calls via Snakepit.

Quick Start

cd examples/math_demo
mix deps.get
mix compile
mix run --no-start -e Demo.run

This demo wraps execution in SnakeBridge.script do ... end to ensure Python workers clean up on exit (prevents orphan warnings on subsequent runs). Defaults are exit_mode: :auto and stop_mode: :if_started; use SnakeBridge.script(opts) do ... end for custom lifecycle options.

What Happens

1. mix compile runs the SnakeBridge pre-pass.
2. Python libraries are read from the python_deps project key in mix.exs.
3. SnakeBridge scans, introspects, and generates modules under lib/snakebridge_generated/.
4. Generated source, manifest, and lock are committed to git.

Generated Structure

lib/snakebridge_generated/
├── json/
│   ├── __init__.ex
│   ├── decoder/
│   │   ├── __init__.ex
│   │   └── json_decoder.ex
│   ├── encoder/
│   │   ├── __init__.ex
│   │   └── json_encoder.ex
│   ├── scanner/
│   │   └── __init__.ex
│   └── tool/
│       └── __init__.ex
└── math/
    └── __init__.ex

.snakebridge/manifest.json
snakebridge.lock

Interactive Usage

iex -S mix

# Discovery
iex> Math.__functions__() |> length()
3

iex> Math.__search__("sq")
[%{name: :sqrt, summary: "Return the square root.", relevance: 0.9}]

iex> Json.__classes__()
[...]

iex> MathDemo.generated_structure()
{:ok, %{root: ".../lib/snakebridge_generated", libraries: ["json", "math"], files: ["json/__init__.ex", "json/decoder/__init__.ex", "json/encoder/__init__.ex", "math/__init__.ex", "..."]}}

iex> MathDemo.discover()
:ok

iex> MathDemo.compute_sample()
{:ok, %{cos: 1.0, sin: 0.84, sqrt: 1.41421356237}}

Key Files

Requirements

• Python 3.7+
• Snakepit runtime (enabled in config/config.exs)
• Auto-install runs during compile (auto_install: :dev)