index.md

Olive Documentation

This is the technical reference and user guide for the Olive systems programming language.

Where to Start?

• Introduction: The philosophy and goals of the Olive project.
• Getting Started: How to install Olive and run your first program.
• Basic Syntax: Variables, numbers, strings, and loops.
• Functions: How to group code into reusable blocks.

Core Language

• Ownership: How Olive manages memory without a garbage collector.
• Generics: Writing flexible, reusable code with type parameters.
• Structs and Enums: Building your own data types.
• Traits: Defining shared behavior between different types.
• Async: Writing fast, concurrent programs with async and await.
• Error Handling: How to deal with things that go wrong.

Ecosystem and Advanced

• Modules: Organizing your code and using the standard library.
• C / Rust Interop (FFI): Calling C/C++ or Rust code and using unsafe blocks.
• Python Interoperability: High-performance zero-copy Python integration.
• CLI Reference: The full list of commands for the pit toolchain.
• Debugger: Breakpoints, stepping, and variable inspection via VS Code or pit debug.
• Optimizations: How code is optimized for performance.
• Compiler Internals: A look under the hood at how Olive works.