/rocket-rust-realworld

Rust + Rocket RealWorld framework implementation

Primary LanguageRustMIT LicenseMIT

RealWorld Example App

Build Status Crates.io codecov

RealWorld

This codebase was created to demonstrate a fully fledged fullstack application built with Rocket including CRUD operations, authentication, routing, pagination, and more.

We've gone to great lengths to adhere to the Rocket community styleguides & best practices.

For more information on how to this works with other frontends/backends, head over to the RealWorld repo.

CHANGELOG

Main branch is based on async version of Rocket (v0.5.0-rc.1).

There is also a branch based on non-async (v0.4) version of Rocket.

Please see the CHANGELOG for a release history.

Getting started

Install nightly

# install rustup
curl https://sh.rustup.rs -sSf | sh

rustup install nightly

# start postgresql and seed the database
psql -f init.sql
cargo install diesel_cli --no-default-features --features "postgres"
diesel migration run

cargo run

Testing

Simply run:

cargo test

You can also check postman/newman. See /tests directory.

How it works

diesel cli uses .env file. Rocket sets database configuration from .env file. Checkout Rocket's amazing guide

Features

By default random suffixes feature is enabled, so one could easily create multiple articles with the same title. To disable it:

cargo run --no-default-features

TODO

  1. Bettter error handling