https://github.com/LukeMathWalker/zero-to-production
Code for "Zero To Production In Rust", a book on API development using Rust.
https://github.com/LukeMathWalker/zero-to-production
book rust
Last synced: about 1 month ago
JSON representation
Code for "Zero To Production In Rust", a book on API development using Rust.
- Host: GitHub
- URL: https://github.com/LukeMathWalker/zero-to-production
- Owner: LukeMathWalker
- License: apache-2.0
- Created: 2020-08-23T10:18:19.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-09-01T09:52:06.000Z (8 months ago)
- Last Synced: 2025-03-26T01:07:16.129Z (about 1 month ago)
- Topics: book, rust
- Language: Rust
- Homepage: https://www.zero2prod.com
- Size: 1.12 MB
- Stars: 5,992
- Watchers: 79
- Forks: 533
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
Awesome Lists containing this project
- awesome-ccamel - LukeMathWalker/zero-to-production - Code for "Zero To Production In Rust", a book on API development using Rust. (Rust)
- StarryDivineSky - LukeMathWalker/zero-to-production
README
# Zero To Production In Rust
[Zero To Production In Rust](https://zero2prod.com) is an opinionated introduction to backend development using Rust.
This repository serves as supplementary material for [the book](https://zero2prod.com/): it hosts several snapshots of the codebase for our email newsletter project as it evolves throughout the book.
## Chapter snapshots
The [`main`](https://github.com/LukeMathWalker/zero-to-production) branch shows the project at the end of the book.
You can browse the project at the end of previous chapters by switching to their dedicated branches:
- [Chapter 3, Part 0](https://github.com/LukeMathWalker/zero-to-production/tree/root-chapter-03-part0)
- [Chapter 3, Part 1](https://github.com/LukeMathWalker/zero-to-production/tree/root-chapter-03-part1)
- [Chapter 4](https://github.com/LukeMathWalker/zero-to-production/tree/root-chapter-04)
- [Chapter 5](https://github.com/LukeMathWalker/zero-to-production/tree/root-chapter-05)
- [Chapter 6, Part 0](https://github.com/LukeMathWalker/zero-to-production/tree/root-chapter-06-part0)
- [Chapter 6, Part 1](https://github.com/LukeMathWalker/zero-to-production/tree/root-chapter-06-part1)
- [Chapter 7, Part 0](https://github.com/LukeMathWalker/zero-to-production/tree/root-chapter-07-part0)
- [Chapter 7, Part 1](https://github.com/LukeMathWalker/zero-to-production/tree/root-chapter-07-part1)
- [Chapter 7, Part 2](https://github.com/LukeMathWalker/zero-to-production/tree/root-chapter-07-part2)
- [Chapter 8](https://github.com/LukeMathWalker/zero-to-production/tree/root-chapter-08)
- [Chapter 9](https://github.com/LukeMathWalker/zero-to-production/tree/root-chapter-09)
- [Chapter 10, Part 0](https://github.com/LukeMathWalker/zero-to-production/tree/root-chapter-10-part0)
- [Chapter 10, Part 1](https://github.com/LukeMathWalker/zero-to-production/tree/root-chapter-10-part1)
- [Chapter 10, Part 2](https://github.com/LukeMathWalker/zero-to-production/tree/root-chapter-10-part2)
- [Chapter 10, Part 3](https://github.com/LukeMathWalker/zero-to-production/tree/root-chapter-10-part3)
- [Chapter 11](https://github.com/LukeMathWalker/zero-to-production/tree/root-chapter-11)
## Pre-requisites
You'll need to install:
- [Rust](https://www.rust-lang.org/tools/install)
- [Docker](https://docs.docker.com/get-docker/)
There are also some OS-specific requirements.
### Windows
```bash
cargo install -f cargo-binutils
rustup component add llvm-tools-preview
```
```
cargo install --version="~0.7" sqlx-cli --no-default-features --features rustls,postgres
```
### Linux
```bash
# Ubuntu
sudo apt-get install lld clang libssl-dev postgresql-client
# Arch
sudo pacman -S lld clang postgresql
```
```
cargo install --version="~0.7" sqlx-cli --no-default-features --features rustls,postgres
```
### MacOS
```bash
brew install michaeleisel/zld/zld
```
```
cargo install --version="~0.7" sqlx-cli --no-default-features --features rustls,postgres
```
## How to build
Launch a (migrated) Postgres database via Docker:
```bash
./scripts/init_db.sh
```
Launch a Redis instance via Docker:
```bash
./scripts/init_redis.sh
```
Launch `cargo`:
```bash
cargo build
```
You can now try with opening a browser on http://127.0.0.1:8000/login after
having launch the web server with `cargo run`.
There is a default `admin` account with password
`everythinghastostartsomewhere`. The available entrypoints are listed in
[src/startup.rs](https://github.com/LukeMathWalker/zero-to-production/blob/6bd30650cb8670a146819a342ccefd3d73ed5085/src/startup.rs#L92)
## How to test
Launch a (migrated) Postgres database via Docker:
```bash
./scripts/init_db.sh
```
Launch a Redis instance via Docker:
```bash
./scripts/init_redis.sh
```
Launch `cargo`:
```bash
cargo test
```