Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/rwf2/Rocket

A web framework for Rust.
https://github.com/rwf2/Rocket

framework rocket rust web web-development web-framework

Last synced: 10 days ago
JSON representation

A web framework for Rust.

Host: GitHub
URL: https://github.com/rwf2/Rocket
Owner: rwf2
License: other
Created: 2016-03-18T02:50:18.000Z (over 8 years ago)
Default Branch: master
Last Pushed: 2024-04-12T19:45:49.000Z (7 months ago)
Last Synced: 2024-04-13T20:26:05.331Z (7 months ago)
Topics: framework, rocket, rust, web, web-development, web-framework
Language: Rust
Homepage: https://rocket.rs
Size: 7.15 MB
Stars: 23,300
Watchers: 269
Forks: 1,516
Open Issues: 68
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE-APACHE
- Code of conduct: .github/CODE_OF_CONDUCT.md

Awesome Lists containing this project

awesome-ccamel - rwf2/Rocket - A web framework for Rust. (Rust)
awesome-github-repos - rwf2/Rocket - A web framework for Rust. (Rust)
awesome-rust - Rocket - of-use, expressability, and speed (Libraries / Web programming)
my-awesome - rwf2/Rocket - development,web-framework pushed_at:2024-09 star:24.4k fork:1.6k A web framework for Rust. (Rust)

README

        # Rocket

[![Build Status](https://github.com/rwf2/Rocket/workflows/CI/badge.svg)](https://github.com/rwf2/Rocket/actions)

[![Rocket Homepage](https://img.shields.io/badge/web-rocket.rs-red.svg?style=flat&label=https&colorB=d33847)](https://rocket.rs)

[![Current Crates.io Version](https://img.shields.io/crates/v/rocket.svg)](https://crates.io/crates/rocket)

[![Matrix: #rocket:mozilla.org](https://img.shields.io/badge/style-%23rocket:mozilla.org-blue.svg?style=flat&label=[m])](https://chat.mozilla.org/#/room/#rocket:mozilla.org)

Rocket is an async web framework for Rust with a focus on usability, security,

extensibility, and speed.

```rust

#[macro_use] extern crate rocket;

#[get("//")]

fn hello(name: &str, age: u8) -> String {

    format!("Hello, {} year old named {}!", age, name)

}

#[launch]

fn rocket() -> _ {

    rocket::build().mount("/hello", routes![hello])

}

```

Visiting `localhost:8000/hello/John/58`, for example, will trigger the `hello`

route resulting in the string `Hello, 58 year old named John!` being sent to the

browser. If an `` string was passed in that can't be parsed as a `u8`, the

route won't get called, resulting in a 404 error.

## Documentation

Rocket is extensively documented:

  * [Overview]: A brief look at what makes Rocket special.

  * [Quickstart]: How to get started as quickly as possible.

  * [Getting Started]: How to start your first Rocket project.

  * [Guide]: A detailed guide and reference to Rocket.

  * [API Documentation]: The "rustdocs".

[Quickstart]: https://rocket.rs/guide/quickstart

[Getting Started]: https://rocket.rs/guide/getting-started

[Overview]: https://rocket.rs/overview/

[Guide]: https://rocket.rs/guide/

[API Documentation]: https://api.rocket.rs

Documentation for the `master` branch is available at https://rocket.rs/master

and https://api.rocket.rs/master.

Documentation for major release version `${x}` is available at

`https://[api.]rocket.rs/v${x}`. For example, the v0.4 docs are available at

https://rocket.rs/v0.4 and https://api.rocket.rs/v0.4.

Finally, API docs for active git branches are available at

`https://api.rocket.rs/${branch}`. For example, API docs for the `master` branch

are available at https://api.rocket.rs/master. Branch rustdocs are built and

deployed on every commit.

## Examples

The [examples](examples#readme) directory contains complete crates that showcase

Rocket's features and usage. Each example can be compiled and run with Cargo.

For instance, the following sequence of commands builds and runs the `hello`

example:

```sh

cd examples/hello

cargo run

```

## Getting Help

If you find yourself needing help outside of the documentation, you may:

  * Ask questions via [GitHub discussions questions].

  * Chat with us at [`#rocket:mozilla.org`] on Matrix (join [via Element]).

[`#rocket:mozilla.org`]: https://chat.mozilla.org/#/room/#rocket:mozilla.org

[via Element]: https://chat.mozilla.org/#/room/#rocket:mozilla.org

[GitHub discussions questions]: https://github.com/rwf2/Rocket/discussions/categories/questions

## Contributing

Contributions are absolutely, positively welcomed and encouraged! If you're

interested in contributing code, please first read [CONTRIBUTING] for complete

guidelines. Additionally, you could:

  1. Submit a feature request or bug report as an [issue].

  2. Ask for improved documentation as an [issue].

  3. Comment on [issues that require feedback].

  4. Answers questions in [GitHub discussions questions].

  5. Share a project in [GitHub discussions show & tell].

[issue]: https://github.com/rwf2/Rocket/issues

[issues that require feedback]: https://github.com/rwf2/Rocket/issues?q=is%3Aissue+is%3Aopen+label%3A%22feedback+wanted%22

[pull requests]: https://github.com/rwf2/Rocket/pulls

[CONTRIBUTING]: CONTRIBUTING.md

[GitHub discussions show & tell]: https://github.com/rwf2/Rocket/discussions/categories/show-tell

## License

Rocket is licensed under either of the following, at your option:

 * Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or https://www.apache.org/licenses/LICENSE-2.0)

 * MIT License ([LICENSE-MIT](LICENSE-MIT) or https://opensource.org/licenses/MIT)

Unless you explicitly state otherwise, any contribution intentionally submitted

for inclusion in Rocket by you shall be dual licensed under the MIT License and

Apache License, Version 2.0, without any additional terms or conditions.

The Rocket website docs are licensed under [separate terms](docs/LICENSE). Any

contribution intentionally submitted for inclusion in the Rocket website docs by

you shall be licensed under those terms.