https://github.com/Bechma/realworld-actix-fullstack

Realworld Fullstack with Rust + Tera + SQLx
https://github.com/Bechma/realworld-actix-fullstack

actix-web fullstack realworld rust sqlx

Last synced: 3 months ago
JSON representation

Realworld Fullstack with Rust + Tera + SQLx

• Host: GitHub
• URL: https://github.com/Bechma/realworld-actix-fullstack
• Owner: Bechma
• Created: 2022-12-12T22:00:03.000Z (almost 2 years ago)
• Default Branch: master
• Last Pushed: 2024-01-13T00:47:20.000Z (10 months ago)
• Last Synced: 2024-01-13T14:30:52.727Z (10 months ago)
• Topics: actix-web, fullstack, realworld, rust, sqlx
• Language: Rust
• Homepage: https://realworld-fullstack.shuttleapp.rs/
• Size: 407 KB
• Stars: 19
• Watchers: 1
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Realworld with Actix + Tera + SQLx

You can check it online in https://realworld-fullstack.shuttleapp.rs/

## How to run it

It's important to have docker installed. I'm using a brand new serverless approach for rust applications:

[shuttle](https://www.shuttle.rs/). At this moment is in alpha but it looks promising:

```bash

cargo install cargo-shuttle

cp Secrets.toml.example Secrets.toml

cargo shuttle run

```

## How to test it

You will need a postgres database up and running locally in order to execute tests:

```bash

docker run -e POSTGRES_PASSWORD=postgres -p 5432:5432 --name postgres postgres

cargo test

```

## How to deploy it

1. Test the deploy locally:

```bash

cargo shuttle login --api-key YOUR_API_KEY_HERE

SQLX_OFFLINE=true cargo shuttle run

```

2. Once everything is fine, the next step is to create the secrets:

```bash

# Remember to change the secret to a random and secure hex string

cp Secrets.toml.example Secrets.toml

```

3. Change the name of the project in `Shuttle.toml` and deploy it

```bash

# As the time of writting, they don't have a nice testing environment, so we can't test it during deployment

cargo shuttle deploy --no-test

```

## Extra notes

* I wanted to write 0 javascript, so the experience is like a MPA. Everything is written in Rust with Jinja2 style templates(Tera). Very fast, although the limitation of pure HTML is a major drawback if this is a real realworld application that needs to be maintained and extended.

* All features are applied. However, instead of following a JWT authentication, I used session based.

* In HTML, there's `` to make get requests to other pages and `` to make get or post requests. This limitation forced me to only make routes with GET and POST.

* The tests can be expanded more, however, during compilation time SQLx makes sure that all queries are well writen and returns what we expect(so that's somewhat tested =D).