mostro-core 0.7.0

Mostro Core library
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
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97

# Mostro Core

Mostro Core is a Rust-based library that provides peer-to-peer functionality for decentralized applications. It serves as the foundation for building Mostro daemon.

## Requirements

- Rust 1.86.0 or later
- Cargo (Rust's package manager)
- [cargo-release](https://crates.io/crates/cargo-release) for releasing new versions
- [git-cliff](https://crates.io/crates/git-cliff) for generating the changelog

### Installing git-cliff

git-cliff is used to automatically generate changelogs from git commits. You can install it using one of the following methods:

#### Using Cargo (Recommended)

```bash
cargo install git-cliff
```

#### Using Package Managers

- **Ubuntu/Debian**: `sudo apt install git-cliff`
- **macOS (Homebrew)**: `brew install git-cliff`
- **Arch Linux**: `sudo pacman -S git-cliff`
- **Fedora**: `sudo dnf install git-cliff`

#### Using Pre-built Binaries

Download the latest release from the [git-cliff releases page](https://github.com/orhun/git-cliff/releases) and extract the binary to your PATH.

#### Verify Installation

```bash
git cliff --version
```

### Using git-cliff with a GitHub Personal Access Token (PAT)

When `git-cliff` queries GitHub (e.g., for PR titles, authors, or labels), you may need a PAT to avoid rate limits or access private repos.

1. Create a PAT in GitHub Settings → Developer settings → Personal access tokens. For public repositories, the default scopes are sufficient; for private repos, include the `repo` scope.
2. Export the token as an environment variable before running `git-cliff`:

    ```bash
    export GITHUB_TOKEN="<your-personal-access-token>"
    ```

3. Run `git-cliff`, pointing it at the repository if needed:

```bash
git cliff --github-repo "MostroP2P/mostro-core"
```

Alternatively, you can pass the token via CLI flag or config:

```bash
# CLI flag
git cliff --github-repo "MostroP2P/mostro-core" --github-token "$GITHUB_TOKEN"

# In cliff.toml
[remote.github]
owner = "MostroP2P"
repo = "mostro-core"
token = "${GITHUB_TOKEN}"
```

Security tip: Prefer environment variables over hardcoding tokens in files. Rotate or revoke PATs regularly.

## Features

- Peer-to-peer networking capabilities
- Secure communication protocols
- Efficient data synchronization
- Cross-platform compatibility

## Import prelude to use mostro core

```rust
use mostro_core::prelude::*;
```

## Contribute

You may be interested in contributing to Mostro. If you're looking for somewhere to start contributing, check out the [good first issue](https://github.com/MostroP2P/mostro-core/labels/good%20first%20issue) list.

More info in our [contributing guide](contributing.md) and the focused [Repository Guidelines](AGENTS.md) for agent contributors.

## Documentation

- Protocol documentation: [https://mostro.network/protocol](https://mostro.network/protocol/)
- Frequently Asked Questions: in [English](https://mostro.network/docs-english/), in [Spanish](https://mostro.network/docs-spanish/).

## License

Mostro is licensed under the [MIT license](LICENSE).