Rust-Paket mit einer Bibliothek und einer Binärdatei?

Ich möchte ein Rust-Paket erstellen, das sowohl eine wiederverwendbare Bibliothek (in der der größte Teil des Programms implementiert ist) als auch eine ausführbare Datei enthält, die es verwendet.

Angenommen, ich habe keine Semantik im Rust-Modulsystem verwechselt. Wie sollte meine Cargo.tomlDatei aussehen?

Tok:tmp doug$ du -a

8   ./Cargo.toml
8   ./src/bin.rs
8   ./src/lib.rs
16  ./src

Cargo.toml:

[package]
name = "mything"
version = "0.0.1"
authors = ["me <me@gmail.com>"]

[lib]
name = "mylib"
path = "src/lib.rs"

[[bin]]
name = "mybin"
path = "src/bin.rs"

src / lib.rs:

pub fn test() {
    println!("Test");
}

src / bin.rs:

extern crate mylib; // not needed since Rust edition 2018

use mylib::test;

pub fn main() {
    test();
}

Sie können auch einfach Binärquellen src/binund den Rest Ihrer Quellen eingeben src. Sie können ein Beispiel in meinem Projekt sehen . Sie müssen Ihre Cargo.tomlüberhaupt nicht ändern , und jede Quelldatei wird zu einer Binärdatei mit demselben Namen kompiliert.

Die Konfiguration der anderen Antwort wird dann ersetzt durch:

$ tree
.
├── Cargo.toml
└── src
    ├── bin
    │   └── mybin.rs
    └── lib.rs

Cargo.toml

[package]
name = "example"
version = "0.0.1"
authors = ["An Devloper <an.devloper@example.com>"]

src / lib.rs

use std::error::Error;

pub fn really_complicated_code(a: u8, b: u8) -> Result<u8, Box<Error>> {
    Ok(a + b)
}

src / bin / mybin.rs

extern crate example; // Optional in Rust 2018

fn main() {
    println!("I'm using the library: {:?}", example::really_complicated_code(1, 2));
}

Und führen Sie es aus:

$ cargo run --bin mybin
I'm using the library: Ok(3)

Außerdem können Sie einfach eine erstellen src/main.rs, die als ausführbare defacto-Datei verwendet wird. Leider widerspricht dies dem cargo docBefehl:

Ein Paket, in dem eine Bibliothek und eine Binärdatei denselben Namen haben, kann nicht dokumentiert werden. Erwägen Sie, eines umzubenennen oder das Ziel als zu markierendoc = false

Eine alternative Lösung besteht darin, nicht zu versuchen, beide Dinge in einem Paket zusammenzufassen. Für etwas größere Projekte mit einer benutzerfreundlichen ausführbaren Datei fand ich es sehr schön, eine zu verwenden Arbeitsbereich zu verwenden

Wir erstellen ein Binärprojekt, das eine Bibliothek enthält:

the-binary
├── Cargo.lock
├── Cargo.toml
├── mylibrary
│   ├── Cargo.toml
│   └── src
│       └── lib.rs
└── src
    └── main.rs

Cargo.toml

Dies verwendet den [workspace]Schlüssel und hängt von der Bibliothek ab:

[package]
name = "the-binary"
version = "0.1.0"
authors = ["An Devloper <an.devloper@example.com>"]

[workspace]

[dependencies]
mylibrary = { path = "mylibrary" }

src / main.rs

extern crate mylibrary;

fn main() {
    println!("I'm using the library: {:?}", mylibrary::really_complicated_code(1, 2));
}

mylibrary / src / lib.rs

use std::error::Error;

pub fn really_complicated_code(a: u8, b: u8) -> Result<u8, Box<Error>> {
    Ok(a + b)
}

Und führen Sie es aus:

$ cargo run
   Compiling mylibrary v0.1.0 (file:///private/tmp/the-binary/mylibrary)
   Compiling the-binary v0.1.0 (file:///private/tmp/the-binary)
    Finished dev [unoptimized + debuginfo] target(s) in 0.73 secs
     Running `target/debug/the-binary`
I'm using the library: Ok(3)

Dieses System bietet zwei große Vorteile:

1. Die Binärdatei kann jetzt Abhängigkeiten verwenden, die nur für sie gelten. Sie können beispielsweise viele Kisten einfügen, um die Benutzererfahrung zu verbessern, z. B. Befehlszeilen-Parser oder Terminal-Formatierung. Keines davon "infiziert" die Bibliothek.

2. Der Arbeitsbereich verhindert redundante Builds jeder Komponente. Wenn wir cargo buildsowohl im Verzeichnis mylibraryals auch im the-binaryVerzeichnis ausführen , wird die Bibliothek nicht beide Male erstellt - sie wird von beiden Projekten gemeinsam genutzt.

Sie können lib.rsund main.rszu Quellordner zusammenfügen. Es gibt keinen Konflikt und Fracht wird beides bauen.

Um einen Dokumentationskonflikt zu lösen, fügen Sie Folgendes hinzu Cargo.toml:

[[bin]]
name = "main"
doc = false