Rocket est un cadre Web asynchrone pour la rouille en mettant l'accent sur la convivialité, la sécurité, l'extensibilité et la vitesse.
# [macro_use] fusée de caisse externe; # [get ("/ <name> / <ge>")] fn Bonjour (nom: & str, Âge: u8) -> String {format! ("Bonjour, {} annommé nommé an {}! ", Âge, nom)} # [lancement] fn Rocket () -> _ {Rocket :: build (). Mount (" / Hello ", routes! [Hello])}
Visiter localhost:8000/hello/John/58
, par exemple, déclenchera l'itinéraire hello
, ce qui donne la chaîne Hello, 58 year old named John!
être envoyé au navigateur. Si une chaîne <age>
a été transmise qui ne peut pas être analysée en tant que u8
, l'itinéraire ne sera pas appelé, entraînant une erreur 404.
La fusée est largement documentée:
Aperçu: Un bref aperçu de ce qui rend la fusée spéciale.
QuickStart: Comment commencer le plus rapidement possible.
Partage: Comment démarrer votre premier projet de fusée.
Guide: un guide détaillé et une référence à la fusée.
Documentation de l'API: les "RustDocs".
La documentation de la branche master
est disponible sur https://rocket.rs/master et https://api.rocket.rs/master.
La documentation de la version de version majeure ${x}
est disponible sur https://[api.]rocket.rs/v${x}
. Par exemple, les documents V0.4 sont disponibles sur https://rocket.rs/v0.4 et https://api.rocket.rs/v0.4.
Enfin, les documents API pour les branches GIT actifs sont disponibles sur https://api.rocket.rs/${branch}
. Par exemple, les documents API pour la branche master
sont disponibles sur https://api.rocket.rs/master. La branche Rustdocs est construite et déployée sur chaque engagement.
Le répertoire des exemples contient des caisses complètes qui présentent les fonctionnalités et l'utilisation de Rocket. Chaque exemple peut être compilé et exécuté avec du fret. Par exemple, la séquence suivante de commandes construit et exécute l'exemple hello
:
Exemples de CD / Bonjour cargo
Si vous avez besoin d'aide en dehors de la documentation, vous pouvez:
Posez des questions via les questions de discussions GitHub.
Discutez avec nous sur #rocket:mozilla.org
sur la matrice (rejoindre via l'élément).
Les contributions sont absolument, bien accueillies et encouragées! Si vous souhaitez contribuer au code, veuillez d'abord lire la contribution pour les directives complètes. De plus, vous pourriez:
Soumettez une demande de fonctionnalité ou un rapport de bogue en tant que problème.
Demandez une amélioration de la documentation en tant que problème.
Commentez les problèmes qui nécessitent des commentaires.
Réponse les questions dans les questions de discussions GitHub.
Partagez un projet dans les discussions GitHub Show & Tell.
Rocket est sous licence dans l'une ou l'autre des éléments suivants, à votre option:
Licence Apache, version 2.0, (licence-apache ou https://www.apache.org/licenses/license-2.0)
Licence MIT (Licence-mit ou https://openseource.org/licenses/mit)
À moins que vous ne soyez explicitement indiqué autrement, toute contribution intentionnellement soumise pour inclusion dans Rocket par vous sera double licence en vertu de la licence MIT et de la licence Apache, version 2.0, sans aucune condition ou condition supplémentaire.
Les documents du site Web Rocket sont sous licence en termes distincts. Toute contribution intentionnellement soumise pour inclusion dans les documents du site Web de Rocket par vous sera autorisé en vertu de ces conditions.