xy2i/xy2.dev-backend

xy2.dev rust backend

xy2.dev backend

Setup

Dependencies

Install rust. You need

1. Install postgresql and setup an user and a database. After setting up an user, your connection string will be like postgresql://admin:admin@localhost, with username and password to replace.
2. Put this variable as DATABASE_URL in a .env file at the root of the project:

DATABASE_URL=postgresql://admin:admin@localhost

3. Install sqlx cli: cargo install sqlx-cli, providing the sqlx binary.
4. Run the database migrations: sqlx migrate run --database-url=postgresql://admin:admin@localhost
5. Run the app: cargo run

Set logging

Run the app with RUST_LOG variable set, for example: RUST_LOG="debug" cargo run. RUST_LOG can be set on a more precise level, see the doc for env_logger.

xy2.dev-backend's Issues

Switch to sqlx

sqlx is a library that uses pure sql, in contrast to diesel which is what we've been using.

I'm favoring switching to sqlx for these reasons:

• Simplicity. I want to do a few sql queries. With Diesel I wrote a lot of boilerplate.
• Easier to reason on. With Diesel I spent hours on two occasions trying to work around the DSL, and even after that I still don't understand it. The documentation available is some tutorials and the rust doc, which has made it hard for me to learn. We'll see if sqlx is better in this regard.

For these reasons we want to switch to sqlx.

• Figure out how sqlx works
• Integrate with current code
• Port our existing migrations

Error handling with error-chain?

Right now eveyrthing is in a main with panics if there are errors. I'd like to have a better mechanism for reporting errors without relying on the backtrace directly, so we can log them for example.

Apparently there's std::backtrace, but it's not stable yet and I don't want to use nightly. I looked for a library solution, and error-chain seems useful.

Docker for CI / easy deployment

It would be nice to have a Dockerfile Right now we have no CI, and it would also help with deployment.

I don't know how this stuff works in general, so need to read up and lay out a plan.