Documentation

Pipit runs Go source. These docs cover embedding and operating the interpreter; for the language itself, use the Go documentation.

Tutorials

Start with Getting started: embed Pipit in a small Go application, evaluate an expression, then try a script through the CLI.

How-to guides

• Embedding tasks: expose functions, select imports, reuse bytecode, and manage sessions.
• Attach a debugger: pause and inspect a script from Go.
• Run isolated code: provision experimental Linux workers and recover after a crash.
• Grant file access: use named roots with the isolated broker.
• Verify a release: check signatures and software bills of materials.
• Run the self-hosting checks: compare native and interpreted compiler output.

Reference

• Embedding reference: operations, state, errors, and options.
• CLI reference: commands, flags, and defaults.
• Debug Adapter Protocol: launch fields, capabilities, and editor configuration examples.
• Compatibility: supported behaviour and known differences from Go.
• Self-hosting report: generated measurements and results.

Explanation

• Execution security: host access and what each execution mode means.
• Architecture: how the compiler and runtime fit together.

For project policies, see Contributing and Security policy. Runnable scripts also live in examples.