bridgerust 0.1.3

# BridgeRust

**Write Rust once, deploy to Python and Node.js.**

BridgeRust is a unified framework for building cross-language Rust libraries. It eliminates the complexity of managing separate bindings for PyO3 (Python) and napi-rs (Node.js) by providing a single, unified macro system.

**Website:** [bridgerust.dev](https://bridgerust.dev)

## 🚀 Features

- **Unified Logic**: One `#[bridgerust::export]` macro handles both Python and Node.js generation.
- **Zero Config**: No need to manually configure PyO3 or napi-rs builds.
- **Type Safety**: Automatic type mapping between Rust, Python, and TypeScript.

## 🎯 Best Use Cases

BridgeRust is currently **SDK-Ready** and ideal for:

1. **Unified SDKs / Clients**: Perfect for database drivers (like Embex) or API clients. Seamlessly handles `async/await` and complex JSON objects.
2. **CPU-Intensive Data Processing**: Expose high-performance Rust logic (parsers, encryption, image processing) to interpreted languages with minimal overhead.
3. **Shared Logic Cores**: Write business validation rules once in Rust structs/enums and reuse them across your Node.js backend and Python data pipelines.

## 📦 Usage

Add to your `Cargo.toml`:

```toml
[dependencies]
bridgerust = "0.1"
```

Annotate your Rust functions:

```rust
use bridgerust::export;

#[export]
pub fn greet(name: String) -> String {
    format!("Hello, {}!", name)
}
```

## 🏗️ Building

BridgeRust creates standard Python wheels and Node.js native modules.

### Using the CLI (Recommended)

```bash
# Install the CLI
cargo install --path cli/bridge

# Initialize a new project
bridge new my-project

# Development (Live Reload)
bridge dev

# Build for all targets
bridge build --all

# Run tests
bridge test --all

# Run benchmarks
bridge benchmark

# Publish packages
bridge publish --all
```

### Manual Building

```bash
# Build for Python
cargo build --features python

# Build for Node.js
cargo build --features nodejs
```

## 📚 Documentation

- [Quick Reference](https://github.com/bridgerust/bridgerust/blob/main/docs/QUICK_REFERENCE.md) - Cheat sheet for common patterns
- [Getting Started Guide](https://github.com/bridgerust/bridgerust/blob/main/docs/getting-started-bridgerust.md) - Complete tutorial
- [Migration Guide](https://github.com/bridgerust/bridgerust/blob/main/docs/MIGRATION_GUIDE.md) - Migrate from PyO3/napi-rs
- [Examples](https://github.com/bridgerust/bridgerust/blob/main/docs/EXAMPLES.md) - Code examples and patterns
- [Troubleshooting](https://github.com/bridgerust/bridgerust/blob/main/docs/TROUBLESHOOTING.md) - Common issues and solutions
- [CLI Documentation](https://github.com/bridgerust/bridgerust/blob/main/cli/bridge/README.md) - CLI tool reference
- [E2E Test Examples](https://github.com/bridgerust/bridgerust/blob/main/tests/e2e/README.md) - Integration test examples

## 🎯 Quick Example

```rust
use bridgerust::export;

#[export]
pub fn greet(name: String) -> String {
    format!("Hello, {}!", name)
}

#[export]
pub struct Point {
    pub x: f64,
    pub y: f64,
}
```

Build and use from both Python and Node.js with a single command!