tes

tes

Eine Kiste für die Arbeit mit der Task Execution Service (TES)-Spezifikation.

Entdecken Sie die Dokumente » · Erfahren Sie mehr über TES »

Erste Schritte

Die tes Kiste enthält Typen (über die types ) und einen einfachen Client (über die client ) für die Arbeit mit der Task Execution Service (TES)-Spezifikation. Kurz gesagt handelt es sich bei TES um eine Spezifikation, die entwickelt wurde, um Ausführungseinheiten („Aufgaben“) einheitlich über eine einzige HTTP-Schnittstelle an mehrere Rechenumgebungen zu übermitteln. Dies ist vor allem dann von Interesse, wenn Clients oder Server entwickelt werden, die an der groß angelegten Übermittlung oder Überwachung von Jobs beteiligt sind.

Um tes in Ihren Kisten zu verwenden, fügen Sie sie einfach Ihrem Projekt hinzu.

 # Wenn Sie die Datei „types.cargo“ verwenden möchten, fügen Sie „tes“ hinzu. Wenn Sie auch die bereitgestellte Datei „client.cargo“ verwenden möchten, fügen Sie den Client „tes --features“ hinzu

Danach können Sie über das tes -Modul in Ihrem Rust-Code auf die Bibliothek zugreifen. Sie können sich zur Inspiration die Beispiele ansehen, aber ein einfaches Beispiel könnte so aussehen.

 use tes::v1::client;#[tokio::main]async fn main() {let url = std::env::args().nth(1).expect("url to be present"); let client = client::Builder::default().url_from_string(url).expect("URL konnte nicht geparst werden").try_build().expect("konnte nicht erstellt werden client");println!("{:#?}",
        Kunde
            .service_info().await.expect("Abrufen der Dienstinformationen fehlgeschlagen"));}

Mindestens unterstützte Rust-Version

Die minimal unterstützte Rust-Version ist derzeit 1.80.0 .

Es gibt einen CI-Job, der die deklarierte unterstützte Mindestversion überprüft.

Wenn ein Mitwirkender eine PR einreicht, die eine Funktion einer neueren Version von Rust verwendet, ist der Mitwirkende dafür verantwortlich, die unterstützte Mindestversion in Cargo.toml zu aktualisieren.

Mitwirkende können die unterstützte Mindestversion bei Bedarf auf die neueste stabile Version von Rust aktualisieren.

Um die Ermittlung der unterstützten Mindestversion zu erleichtern, installieren Sie das Tool cargo-msrv :

 Cargo installiert Cargo-MSRV

Und führen Sie den folgenden Befehl aus:

 Fracht msrv --min 1.80.0

Wenn die gemeldete Version neuer ist als die aktuell unterstützte Mindestversion der Kiste, ist ein Update erforderlich.

Entwicklung

Um eine Entwicklungsumgebung zu booten, verwenden Sie bitte die folgenden Befehle.

 # Klonen Sie das Repositorygit clone [email protected]:stjude-rust-labs/tes.gitcd tes# Erstellen Sie die Kiste im Release-Moduscargo build --release# Listen Sie die Beispiele aufcargo run --release --example

Tests

Bevor Sie Pull-Anfragen senden, stellen Sie bitte sicher, dass der Code die folgenden Prüfungen besteht (aus dem Stammverzeichnis).

 # Führen Sie den tests.cargo test --all-features des Projekts aus. # Führen Sie die Tests für examples.cargo test --examples --all-features# aus. Stellen Sie sicher, dass das Projekt keine Linting-Warnungen enthält.cargo clippy --all-features # Stellen Sie sicher, dass das Projekt „cargo fmt“ besteht.# Derzeit erfordert dies nächtliches Rustcargo +nightly fmt --check# Stellen Sie sicher, dass die Dokumente build.cargo doc sind

Mitwirken

Beiträge, Probleme und Funktionswünsche sind willkommen! Sehen Sie sich gerne die Seite „Probleme“ an.

Lizenz

Dieses Projekt wird nach Ihrem Ermessen entweder als Apache 2.0 oder MIT lizenziert. Bitte beachten Sie außerdem den Haftungsausschluss, der für alle von St. Jude Rust Labs zur Verfügung gestellten Crates und Befehlszeilentools gilt.

Copyright © 2024-Present St. Jude Children's Research Hospital.