Bir kütüphane ve bir ikili ile pas paketi?

Hem yeniden kullanılabilir bir kitaplık (programın çoğu uygulandığı yerde) hem de onu kullanan bir yürütülebilir dosya içeren bir Rust paketi yapmak istiyorum.

Rust modül sisteminde herhangi bir anlambilimi karıştırmadım, dosyam Cargo.tomlneye benzemeli?

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();
}

Ayrıca, ikili kaynakları src/binve diğer kaynaklarınızı da içine koyabilirsiniz src. İçeri bir örnek görebilirsiniz projemde . Herhangi bir değişiklik yapmanız gerekmez Cargo.tomlve her kaynak dosya aynı adlı bir ikili dosyaya derlenir.

Diğer yanıtlayıcının yapılandırması daha sonra:

$ 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));
}

Ve yürütün:

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

Ayrıca, src/main.rsdefacto yürütülebilir olarak kullanılacak bir tane oluşturabilirsiniz . Ne yazık ki, bu cargo dockomutla çakışıyor :

Bir kitaplık ve bir ikili dosyanın aynı ada sahip olduğu bir paket belgelenemez. Birini yeniden adlandırmayı veya hedefi şu şekilde işaretlemeyi düşünündoc = false

Alternatif bir çözüm, her iki şeyi de tek bir pakete sıkıştırmaya çalışmak değildir. Dostça yürütülebilir bir dosyaya sahip biraz daha büyük projeler için, bir çalışma alanı kullanmak çok güzel buldum

İçinde bir kütüphane bulunan bir ikili proje yaratırız:

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

Cargo.toml

Bu, [workspace]anahtarı kullanır ve kütüphaneye bağlıdır:

[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)
}

Ve yürütün:

$ 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)

Bu şemanın iki büyük faydası vardır:

1. İkili dosya artık yalnızca geçerli olan bağımlılıkları kullanabilir. Örneğin, kullanıcı deneyimini geliştirmek için komut satırı ayrıştırıcıları veya terminal biçimlendirmesi gibi birçok kasa ekleyebilirsiniz. Bunların hiçbiri kütüphaneye “bulaşmayacak”.

2. Çalışma alanı, her bir bileşenin gereksiz yapılarını önler. cargo buildHem mylibraryve hem de the-binarydizinde çalışırsak , kitaplık iki kez oluşturulmaz - her iki proje arasında paylaşılır.

lib.rsVe main.rsKaynaklar klasörünü bir araya getirebilirsiniz . Çatışma yok ve kargo her iki şeyi de inşa edecek.

Belgesel çatışmasını çözmek için aşağıdakilere ekleyin Cargo.toml:

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