# dart_monty

> Pure Dart bindings for Monty, a restricted sandboxed Python interpreter built in Rust.

High-level Dart/Flutter bindings for sandboxed Python scripting.
Builds on dart_monty_core (the low-level FFI/WASM glue) with a
runtime, extension API (Jinja, MessageBus, Sandbox), Flutter web
bridge auto-loading, OS-call composition, and host-function
dispatch with typed schemas.

IMPORTANT: Monty does NOT support `class`, decorators (`@foo`),
generators (`yield`), `match`/`case`, `del`, or arbitrary
imports. Use dicts + module-level functions in place of classes.
Stdlib: `math`, `re`, `json`, `datetime`, `pathlib`.

Run `Monty.typeCheck(code)` before `runtime.execute(code)` to
catch subset violations as typed errors before runtime — the
supported development loop.


## Overview

- [Overview](https://runyaga.github.io/dart_monty/index.md)
- [Documentation](https://runyaga.github.io/dart_monty/landing.md)

## User Guide

- [Installation](https://runyaga.github.io/dart_monty/user/install.md)
- [Deployment](https://runyaga.github.io/dart_monty/user/deployment.md)
- [REPL](https://runyaga.github.io/dart_monty/user/repl.md)
- [Extensions](https://runyaga.github.io/dart_monty/user/extensions.md)
- [API Reference](https://runyaga.github.io/dart_monty/user/api-reference.md)

## Tutorials

- [Host Functions Intro](https://runyaga.github.io/dart_monty/tutorials/host-functions-intro.md)
- [Host Functions Beginner](https://runyaga.github.io/dart_monty/tutorials/host-functions-beginner.md)
- [Host Functions Intermediate](https://runyaga.github.io/dart_monty/tutorials/host-functions-intermediate.md)
- [Host Functions Advanced](https://runyaga.github.io/dart_monty/tutorials/host-functions-advanced.md)
- [Bridge Middleware](https://runyaga.github.io/dart_monty/tutorials/bridge-middleware.md)
- [LLM Prompt Rules](https://runyaga.github.io/dart_monty/tutorials/llm-prompt-rules.md)

## Deep Dives

- [Architecture Overview](https://runyaga.github.io/dart_monty/architecture/overview.md)
- [Sandbox Architecture](https://runyaga.github.io/dart_monty/deep-dives/sandbox-architecture.md)
- [OsCall / VFS Layer](https://runyaga.github.io/dart_monty/deep-dives/oscall-vfs.md)
- [Error Hierarchy](https://runyaga.github.io/dart_monty/deep-dives/error-hierarchy.md)
- [Extension System](https://runyaga.github.io/dart_monty/deep-dives/extension-system.md)
- [Bridge Concurrency](https://runyaga.github.io/dart_monty/deep-dives/bridge-concurrency.md)

## Technical Reference

- [Native Crate (Rust)](https://runyaga.github.io/dart_monty/reference/native-crate.md)
- [Monty Rust API](https://runyaga.github.io/dart_monty/reference/monty-rust-api.md)
- [FFI Handle Lifecycle](https://runyaga.github.io/dart_monty/reference/ffi-handle-lifecycle.md)
- [Bridge Integration](https://runyaga.github.io/dart_monty/reference/bridge-integration.md)
- [Internals](https://runyaga.github.io/dart_monty/reference/internals.md)
- [API Coverage Plan](https://runyaga.github.io/dart_monty/reference/api-coverage-plan.md)

## Contributing

- [Development Setup](https://runyaga.github.io/dart_monty/contributor/setup.md)
- [Testing](https://runyaga.github.io/dart_monty/contributor/testing.md)