mongo-embedded 0.1.0

A library to download, extract, and convert MongoDB Community Edition into an embedded server.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

# mongo-embedded

A Rust library that simplifies using MongoDB for local testing and development by automatically downloading, extracting, and running a MongoDB Community Edition binary.

It handles:
- **OS/Arch Detection**: Automatically selects the correct binary for Linux, macOS, and Windows.
- **Downloading**: Fetches the binary from the official MongoDB download center.
- **Extraction**: Unpacks `.tgz` or `.zip` archives.
- **Execution**: Starts the `mongod` process on a specified port.

## Usage

Add this to your `Cargo.toml`:

```toml
[dependencies]
mongo-embedded = "0.1.0"
tokio = { version = "1.0", features = ["full"] }
```

### Example

```rust
use mongo_embedded::MongoEmbedded;
use tokio::time::{sleep, Duration};

#[tokio::main]
async fn main() {
    // fastdl.mongodb.org version
    let version = "7.0.2"; 
    
    // Initialize
    let mongo = MongoEmbedded::new(version).unwrap()
        .set_port(12345); // Optional, default is 27017

    // Start
    println!("Starting MongoDB...");
    let mut process = mongo.start().await.expect("Failed to start MongoDB");
    
    // Your DB operations here...
    // MongoDB is running at mongodb://127.0.0.1:12345/

    sleep(Duration::from_secs(5)).await;
    
    // Stop
    process.kill().expect("Failed to kill MongoDB process");
}
```

## Configuration

The library uses the `directories` crate to find suitable locations for:
- **Cache**: Stores downloaded archives (e.g., `~/.cache/mongo-embedded` on Linux).
- **Data**: Stores the database files (e.g., `~/.local/share/mongo-embedded` on Linux).

## License

MIT