Golden example: todo-rs (Axum + SQLx + SQLite)

kipina-codebench/golden-examples/todo-rs/src/handlers.rs

@@ -0,0 +1,122 @@
+//! Käsittelijät — CRUD-operaatiot todo-entiteetille.
+
+use axum::extract::{Path, State};
+use axum::http::StatusCode;
+use axum::Json;
+use sqlx::SqlitePool;
+
+use crate::models::{CreateTodo, Todo, UpdateTodo};
+
+/// Luo uusi tehtävä.
+pub async fn create_todo(
+    State(pool): State<SqlitePool>,
+    Json(input): Json<CreateTodo>,
+) -> Result<(StatusCode, Json<Todo>), StatusCode> {
+    let priority = input.priority.unwrap_or(1);
+    let status = input.status.unwrap_or_else(|| "pending".to_string());
+
+    let result = sqlx::query_as::<_, Todo>(
+        "INSERT INTO todos (title, description, due_date, priority, status)
+         VALUES (?, ?, ?, ?, ?)
+         RETURNING id, title, description, due_date, priority, status",
+    )
+    .bind(&input.title)
+    .bind(&input.description)
+    .bind(&input.due_date)
+    .bind(priority)
+    .bind(&status)
+    .fetch_one(&pool)
+    .await
+    .map_err(|_| StatusCode::INTERNAL_SERVER_ERROR)?;
+
+    Ok((StatusCode::CREATED, Json(result)))
+}
+
+/// Listaa kaikki tehtävät.
+pub async fn list_todos(
+    State(pool): State<SqlitePool>,
+) -> Result<Json<Vec<Todo>>, StatusCode> {
+    let todos = sqlx::query_as::<_, Todo>("SELECT id, title, description, due_date, priority, status FROM todos")
+        .fetch_all(&pool)
+        .await
+        .map_err(|_| StatusCode::INTERNAL_SERVER_ERROR)?;
+
+    Ok(Json(todos))
+}
+
+/// Hae tehtävä id:llä.
+pub async fn get_todo(
+    State(pool): State<SqlitePool>,
+    Path(id): Path<i64>,
+) -> Result<Json<Todo>, StatusCode> {
+    let todo = sqlx::query_as::<_, Todo>(
+        "SELECT id, title, description, due_date, priority, status FROM todos WHERE id = ?",
+    )
+    .bind(id)
+    .fetch_optional(&pool)
+    .await
+    .map_err(|_| StatusCode::INTERNAL_SERVER_ERROR)?;
+
+    match todo {
+        Some(t) => Ok(Json(t)),
+        None => Err(StatusCode::NOT_FOUND),
+    }
+}
+
+/// Päivitä tehtävä id:llä.
+pub async fn update_todo(
+    State(pool): State<SqlitePool>,
+    Path(id): Path<i64>,
+    Json(input): Json<UpdateTodo>,
+) -> Result<Json<Todo>, StatusCode> {
+    let existing = sqlx::query_as::<_, Todo>(
+        "SELECT id, title, description, due_date, priority, status FROM todos WHERE id = ?",
+    )
+    .bind(id)
+    .fetch_optional(&pool)
+    .await
+    .map_err(|_| StatusCode::INTERNAL_SERVER_ERROR)?;
+
+    let existing = existing.ok_or(StatusCode::NOT_FOUND)?;
+
+    let title = input.title.unwrap_or(existing.title);
+    let description = input.description.or(existing.description);
+    let due_date = input.due_date.or(existing.due_date);
+    let priority = input.priority.unwrap_or(existing.priority);
+    let status = input.status.unwrap_or(existing.status);
+
+    let updated = sqlx::query_as::<_, Todo>(
+        "UPDATE todos SET title = ?, description = ?, due_date = ?, priority = ?, status = ?
+         WHERE id = ?
+         RETURNING id, title, description, due_date, priority, status",
+    )
+    .bind(&title)
+    .bind(&description)
+    .bind(&due_date)
+    .bind(priority)
+    .bind(&status)
+    .bind(id)
+    .fetch_one(&pool)
+    .await
+    .map_err(|_| StatusCode::INTERNAL_SERVER_ERROR)?;
+
+    Ok(Json(updated))
+}
+
+/// Poista tehtävä id:llä.
+pub async fn delete_todo(
+    State(pool): State<SqlitePool>,
+    Path(id): Path<i64>,
+) -> Result<StatusCode, StatusCode> {
+    let result = sqlx::query("DELETE FROM todos WHERE id = ?")
+        .bind(id)
+        .execute(&pool)
+        .await
+        .map_err(|_| StatusCode::INTERNAL_SERVER_ERROR)?;
+
+    if result.rows_affected() == 0 {
+        return Err(StatusCode::NOT_FOUND);
+    }
+
+    Ok(StatusCode::NO_CONTENT)
+}

kipina-codebench/golden-examples/todo-rs/src/lib.rs

@@ -0,0 +1,38 @@
+//! Kirjastomoduuli — julkinen API integraatiotesteille.
+
+pub mod handlers;
+pub mod models;
+
+use axum::routing::{delete, get, post, put};
+use axum::Router;
+use sqlx::SqlitePool;
+use tower_http::cors::CorsLayer;
+
+/// Luo reititin annetulla tietokantapoolilla.
+pub fn app(pool: SqlitePool) -> Router {
+    Router::new()
+        .route("/todos", post(handlers::create_todo))
+        .route("/todos", get(handlers::list_todos))
+        .route("/todos/{id}", get(handlers::get_todo))
+        .route("/todos/{id}", put(handlers::update_todo))
+        .route("/todos/{id}", delete(handlers::delete_todo))
+        .layer(CorsLayer::permissive())
+        .with_state(pool)
+}
+
+/// Alusta tietokantataulu.
+pub async fn init_db(pool: &SqlitePool) {
+    sqlx::query(
+        "CREATE TABLE IF NOT EXISTS todos (
+            id          INTEGER PRIMARY KEY AUTOINCREMENT,
+            title       TEXT NOT NULL,
+            description TEXT,
+            due_date    TEXT,
+            priority    INTEGER NOT NULL DEFAULT 1,
+            status      TEXT NOT NULL DEFAULT 'pending'
+        )",
+    )
+    .execute(pool)
+    .await
+    .expect("Taulun luonti epäonnistui");
+}

kipina-codebench/golden-examples/todo-rs/src/main.rs

@@ -0,0 +1,22 @@
+//! Axum CRUD — yksi endpoint-setti per entiteetti, SQLite-tietokanta.
+
+use sqlx::sqlite::SqlitePoolOptions;
+use todo_rs::{app, init_db};
+
+#[tokio::main]
+async fn main() {
+    let pool = SqlitePoolOptions::new()
+        .max_connections(5)
+        .connect("sqlite:./app.db?mode=rwc")
+        .await
+        .expect("Tietokantayhteys epäonnistui");
+
+    init_db(&pool).await;
+
+    let listener = tokio::net::TcpListener::bind("127.0.0.1:3000")
+        .await
+        .expect("Portin kuuntelu epäonnistui");
+
+    println!("Palvelin käynnissä: http://127.0.0.1:3000");
+    axum::serve(listener, app(pool)).await.unwrap();
+}

kipina-codebench/golden-examples/todo-rs/src/models.rs

@@ -0,0 +1,34 @@
+//! Tietomallit — Todo, CreateTodo, UpdateTodo serde-rakenteina.
+
+use serde::{Deserialize, Serialize};
+
+/// Tehtävä — otsikko, kuvaus, deadline, prioriteetti ja status.
+#[derive(Debug, Serialize, Deserialize, sqlx::FromRow)]
+pub struct Todo {
+    pub id: i64,
+    pub title: String,
+    pub description: Option<String>,
+    pub due_date: Option<String>,
+    pub priority: i64,
+    pub status: String,
+}
+
+/// Uuden tehtävän luonti. Pakolliset: title.
+#[derive(Debug, Deserialize)]
+pub struct CreateTodo {
+    pub title: String,
+    pub description: Option<String>,
+    pub due_date: Option<String>,
+    pub priority: Option<i64>,
+    pub status: Option<String>,
+}
+
+/// Tehtävän päivitys — kaikki kentät valinnaisia.
+#[derive(Debug, Deserialize)]
+pub struct UpdateTodo {
+    pub title: Option<String>,
+    pub description: Option<String>,
+    pub due_date: Option<String>,
+    pub priority: Option<i64>,
+    pub status: Option<String>,
+}