//! # mrubyedge-cli

//!

//! Command-line interface for mruby/edge - a lightweight, WebAssembly-focused mruby VM implementation.

//!

//! ## About mruby/edge

//!

//! mruby/edge is an mruby-compatible virtual machine implementation written in Rust,

//! specifically designed for WebAssembly environments. It aims to provide:

//!

//! - **WebAssembly-first design**: Optimized for running Ruby code in browsers and edge computing environments

//! - **Lightweight runtime**: Minimal footprint and binary size suitable for constrained environments

//! - **mruby compatibility**: Executes mruby bytecode (`.mrb` files) and Ruby source code

//! - **Rust safety**: Built with Rust for memory safety and reliability

//!

//! ## Installation

//!

//! Install mrubyedge-cli using cargo:

//!

//! ```sh

//! cargo install mrubyedge-cli

//! ```

//!

//! Or build from source:

//!

//! ```sh

//! git clone https://github.com/mrubyedge/mrubyedge.git

//! cd mrubyedge

//! cargo build --release -p mrubyedge-cli

//! ```

//!

//! ## Getting Started

//!

//! Create a simple Ruby script `hello.rb`:

//!

//! ```ruby

//! puts "Hello from mruby/edge!"

//! puts RUBY_ENGINE

//! ```

//!

//! Run it with mrbedge:

//!

//! ```sh

//! mrbedge hello.rb

//! # or explicitly

//! mrbedge run hello.rb

//! ```

//!

//! ## Main Features

//!

//! ### `run` - Execute Ruby Scripts

//!

//! The `run` subcommand executes Ruby source files (`.rb`) or compiled mruby bytecode (`.mrb`).

//!

//! **Usage:**

//! ```sh

//! mrbedge run <file>

//! # or simply

//! mrbedge <file>

//! ```

//!

//! **Examples:**

//! ```sh

//! # Run Ruby source

//! mrbedge run script.rb

//!

//! # Run compiled bytecode

//! mrbedge run script.mrb

//! ```

//!

//! ### `compile-mrb` - Compile Ruby to Bytecode

//!

//! Compiles Ruby source code into mruby bytecode format for faster loading and distribution.

//!

//! **Usage:**

//! ```sh

//! mrbedge compile-mrb <input.rb> -o <output.mrb>

//! ```

//!

//! **Examples:**

//! ```sh

//! # Compile a single file

//! mrbedge compile-mrb app.rb -o app.mrb

//!

//! # Run the compiled bytecode

//! mrbedge run app.mrb

//! ```

//!

//! ### `wasm` - Generate WebAssembly Modules

//!

//! Compiles Ruby code directly into a standalone WebAssembly module that can run in browsers

//! or any WebAssembly runtime.

//!

//! **Usage:**

//! ```sh

//! mrbedge wasm <input.rb> -o <output.wasm>

//! ```

//!

//! **Examples:**

//! ```sh

//! # Generate WebAssembly module

//! mrbedge wasm app.rb -o app.wasm

//!

//! # Use in browser or Node.js

//! # The generated WASM can be loaded and executed in any WASM runtime

//! ```

//!

//! **Use Cases:**

//! - Serverless edge computing

//! - Browser-based applications

//! - Microservices with minimal overhead

//! - Cross-platform portable executables

//!

//! **WASI Support:**

//!

//! The `wasm` command can generate both WASI-enabled and non-WASI WebAssembly binaries.

//! By default, it produces WASI-enabled modules. To disable WASI support, use the `--no-wasi` flag.

//!

//! **Import/Export Functions:**

//!

//! You can specify WebAssembly function imports and exports using RBS (Ruby Signature) files.

//! Place RBS files with specific naming conventions alongside your Ruby script:

//!

//! For a Ruby script named `foo.rb`:

//! - **`foo.import.rbs`**: Defines external functions to import from the WebAssembly host

//! - **`foo.export.rbs`**: Defines Ruby functions to export as WebAssembly functions

//!

//! **Example:**

//! ```ruby

//! # app.rb

//! def calculate(x, y)

//! x + y

//! end

//! ```

//!

//! ```rbs

//! # app.export.rbs

//! def calculate: (Integer, Integer) -> Integer

//! ```

//!

//! ```rbs

//! # app.import.rbs

//! def external_log: (String) -> void

//! ```

//!

//! The generated WebAssembly module will expose `Kernel#calculate` and can call `Kernel#external_log`

//! from the host environment.

//!

//! NOTE: Inlined RBS for imports and exports annotations will be supported in future releases.

//!

//! ## Additional Resources

//!

//! - [GitHub Repository](https://github.com/mrubyedge/mrubyedge)

//! - [API Documentation](https://docs.rs/mrubyedge-cli)

//! - [Core VM Documentation](https://docs.rs/mrubyedge)

pub mod rbs_parser;

pub mod subcommands;

pub mod template;