4 stable releases
1.0.3 | Oct 30, 2023 |
---|
#541 in HTTP server
65KB
1.5K
SLoC
Web Service Tutorial in Rust
Overview
This project serves as a comprehensive tutorial for building a web service using the Rust programming language. It covers various aspects, from setting up a PostgreSQL database to handling JSON responses.
Technologies Used
- Rust: The core programming language used for this project.
- Tokio: An asynchronous runtime for Rust.
- SQLx: A Rust library for connecting to PostgreSQL databases.
- Dotenv: A Rust crate for handling
.env
files. - Serde: A Rust crate for serializing and deserializing data structures.
- Actix-Web: A Rust framework for building web services.
- Chrono: A time manipulation library for Rust.
Documentation
To generate documentation for this project:
cargo doc --open
Alternatively, you can find documentation for each crate on docs.rs.
Getting Started
Prerequisites
- Ensure you have Docker Compose installed. If not, you can download it from Docker Desktop.
Setup
-
Environment Variables: Copy the sample environment file and configure the variables.
cp env.example .env
-
Docker Compose: Start the Docker containers.
docker compose up -d
-
Test Routes: Open your browser or use a tool like Postman to hit the following route:
http://127.0.0.1:8080/blogs
Database GUI (PgAdmin4)
- Access the PgAdmin4 interface at
http://localhost:16543
. - Username:
test@test.com
- Password:
test
For detailed instructions on adding a PostgreSQL server in PgAdmin4, refer to the PG Admin guide.
SQL Schema
The init.sql
file contains the SQL statements that define the database schema. Feel free to explore it to understand the database structure.
Authentication
The SKIP_AUTH
environment variable controls JWT authentication. Set it to true
to disable JWT during development.
Additional Resources
Dependencies
~62MB
~1M SLoC