Table of Contents

1. Discription
2. Overview
3. Project Structure
4. Features
5. Quick Start
   1. Use Ngrs
   2. Example
   3. Initialization
      1. Using with `init`
      2. Using with `with<sub>guile</sub>`

Discription

NGRS is a New Rust bindings for GNU Guile Scheme.

Overview

`ngrs` provides both low-level raw bindings and high-level safe abstractions for embedding GNU Guile Scheme in Rust applications. This project enables seamless integration of Scheme scripting capabilities into Rust programs with a focus on memory safety and ergonomic APIs.

Project Structure

• ngrs - High-level safe Rust wrappers with idiomatic interfaces, Contains raw.

• raw - Low-level FFI bindings to Guile's C API

Features

•  Make bindings and convert for base values.

•  Implement eval(eval_expr), eval_string, eval_file(load), apply(apply_scm), apply(call₀~n), define

•  Create safe type wrappers for composite values List, Vector, HashMap and special base values procedure, Symbol, Keywords (or at least provide a method to convert them to Rust types)

•  Add module operations to facilitate writing interactive modules for Guile in Rust.

•  Write bindings to convert Rust structs into Guile foreign types

Quick Start

Use Ngrs

Add this to your Cargo.toml .

[dependencies]
ngrs = "0.1"

Example

use ngrs::{Runtime, with_guile};

fn main() {
    // Initialize Guile
    Runtime::initialize();

    with_guile(|vm:Runtime| {
        // Your Code Here
        println!("Hello guile from Rust!");
        let args = vec!["Test Guile".to_string(),];
        vm.shell(args);
    });
}

Initialization

Before using any Guile functionality, you must initialize the Guile environment:

use ngrs::Runtime

fn main() {
    // Initialize Guile
    Runtime::initialize();

    // Your code here
}

Using with `init`

This way has Less platforms support.

use ngrs::Runtime;

fn main() {
    Runtime::initialize();
    let runtime = Runtime::new();

    // Your Guile-dependent code here
}

Using with `with<sub>guile</sub>`

For more control over the Guile context:

use ngrs::with_guile;

fn main() {
    Runtime::initialize();

    with_guile(|vm:Runtime| {
        // Your Guile-dependent code here
    });
}