Fix v0.1.551 verification gaps: CHANGELOG, CRUD e2e, template versions

Author: Tuntii

CHANGELOG.md

@@ -7,14 +7,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-## [0.1.551] - 2026-07-05
-
-### Added
-
-- **`cargo rustapi generate crud`**: SQLx-sqlite-backed list/get/create/update/delete handlers with schema bootstrap (`src/db.rs`) instead of `TODO` stubs.
-- **`file_upload` example** (`crates/rustapi-rs/examples/file_upload.rs`) demonstrating multipart uploads with the public `rustapi_rs::prelude` API.
-- **Slim vs full dependency guidance** in [Getting Started](docs/GETTING_STARTED.md).
-
 ### Changed
 
 - Default `rustapi-rs` dependency tree slimmed from ~259 to ~158 transitive crates by removing always-on `tracing-subscriber` and gating `rust-i18n` behind the `i18n` feature (English fallbacks by default).
@@ -26,6 +18,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - **Security Audit** (`cargo audit`) passes on the current lockfile (no high-severity `quick-xml` advisories).
 
+## [0.1.551] - 2026-07-05
+
+### Added
+
+- **`cargo rustapi generate crud`**: SQLx-sqlite-backed list/get/create/update/delete handlers with schema bootstrap (`src/db.rs`) instead of `TODO` stubs.
+- **`file_upload` example** (`crates/rustapi-rs/examples/file_upload.rs`) demonstrating multipart uploads with the public `rustapi_rs::prelude` API.
+- **Slim vs full dependency guidance** in [Getting Started](docs/GETTING_STARTED.md).
+
 ### Documentation
 
 - Refreshed [Performance Benchmarks](docs/PERFORMANCE_BENCHMARKS.md) with a new `perf_snapshot` run.

crates/cargo-rustapi/src/commands/generate.rs

@@ -269,29 +269,34 @@ async fn ensure_db_module(table: &str) -> Result<()> {
 use sqlx::sqlite::SqlitePoolOptions;
 use sqlx::SqlitePool;
 
-const SCHEMA: &str = "CREATE TABLE IF NOT EXISTS {table} (
+/// Table name used by generated CRUD handlers.
+pub const TABLE: &str = "{table}";
+
+/// Singular resource label for error messages.
+pub const SINGULAR: &str = "{singular}";
+
+const COLUMNS_DDL: &str = "
     id INTEGER PRIMARY KEY AUTOINCREMENT,
     name TEXT NOT NULL,
     description TEXT,
     created_at TEXT NOT NULL,
     updated_at TEXT NOT NULL
-)";
+";
 
-/// Open a SQLite pool and ensure the `{table}` table exists.
+/// Open a SQLite pool and ensure the resource table exists.
 pub async fn init_pool(database_url: &str) -> Result<SqlitePool, sqlx::Error> {{
     let pool = SqlitePoolOptions::new()
         .max_connections(5)
         .connect(database_url)
         .await?;
-    sqlx::query(SCHEMA).execute(&pool).await?;
+    let schema = format!(
+        "CREATE TABLE IF NOT EXISTS {{}} ({{}})",
+        TABLE,
+        COLUMNS_DDL.trim()
+    );
+    sqlx::query(&schema).execute(&pool).await?;
     Ok(pool)
 }}
-
-/// Table name used by generated CRUD handlers.
-pub const TABLE: &str = "{table}";
-
-/// Singular resource label for error messages.
-pub const SINGULAR: &str = "{singular}";
 "#,
         table = table,
         singular = singular,
@@ -353,14 +358,15 @@ pub struct Update{type_name} {{
     Ok(())
 }
 
-async fn generate_sqlx_handler(name: &str, type_name: &str, table: &str) -> Result<()> {
+async fn generate_sqlx_handler(name: &str, type_name: &str, _table: &str) -> Result<()> {
     let handlers_dir = Path::new("src/handlers");
     ensure_handlers_module(handlers_dir, name).await?;
 
     let singular = singularize(name);
     let handler_content = format!(
         r#"//! {} handlers (SQLx SQLite)
 
+use crate::db::{{SINGULAR, TABLE}};
 use crate::models::{{Create{type_name}, Update{type_name}, {type_name}}};
 use rustapi_rs::prelude::*;
 use sqlx::SqlitePool;
@@ -378,9 +384,10 @@ fn db_error(err: sqlx::Error) -> ApiError {{
 #[rustapi_rs::tag("{type_name}")]
 #[rustapi_rs::summary("List all {name}")]
 pub async fn list(State(pool): State<SqlitePool>) -> Result<Json<Vec<{type_name}>>> {{
-    let rows = sqlx::query_as::<_, {type_name}>(
-        "SELECT id, name, description, created_at, updated_at FROM {table} ORDER BY id",
-    )
+    let rows = sqlx::query_as::<_, {type_name}>(&format!(
+        "SELECT id, name, description, created_at, updated_at FROM {{}} ORDER BY id",
+        TABLE
+    ))
     .fetch_all(&pool)
     .await
     .map_err(db_error)?;
@@ -392,14 +399,15 @@ pub async fn list(State(pool): State<SqlitePool>) -> Result<Json<Vec<{type_name}
 #[rustapi_rs::tag("{type_name}")]
 #[rustapi_rs::summary("Get {singular} by ID")]
 pub async fn get(Path(id): Path<i64>, State(pool): State<SqlitePool>) -> Result<Json<{type_name}>> {{
-    let row = sqlx::query_as::<_, {type_name}>(
-        "SELECT id, name, description, created_at, updated_at FROM {table} WHERE id = ?",
-    )
+    let row = sqlx::query_as::<_, {type_name}>(&format!(
+        "SELECT id, name, description, created_at, updated_at FROM {{}} WHERE id = ?",
+        TABLE
+    ))
     .bind(id)
     .fetch_optional(&pool)
     .await
     .map_err(db_error)?
-    .ok_or_else(|| ApiError::not_found(format!("{singular} {{id}} not found", id = id)))?;
+    .ok_or_else(|| ApiError::not_found(format!("{{}} {{id}} not found", SINGULAR, id = id)))?;
     Ok(Json(row))
 }}
 
@@ -412,9 +420,10 @@ pub async fn create(
     Json(body): Json<Create{type_name}>,
 ) -> Result<WithStatus<Json<{type_name}>, 201>> {{
     let now = now_ts();
-    let result = sqlx::query(
-        "INSERT INTO {table} (name, description, created_at, updated_at) VALUES (?, ?, ?, ?)",
-    )
+    let result = sqlx::query(&format!(
+        "INSERT INTO {{}} (name, description, created_at, updated_at) VALUES (?, ?, ?, ?)",
+        TABLE
+    ))
     .bind(&body.name)
     .bind(&body.description)
     .bind(&now)
@@ -424,9 +433,10 @@ pub async fn create(
     .map_err(db_error)?;
 
     let id = result.last_insert_rowid();
-    let row = sqlx::query_as::<_, {type_name}>(
-        "SELECT id, name, description, created_at, updated_at FROM {table} WHERE id = ?",
-    )
+    let row = sqlx::query_as::<_, {type_name}>(&format!(
+        "SELECT id, name, description, created_at, updated_at FROM {{}} WHERE id = ?",
+        TABLE
+    ))
     .bind(id)
     .fetch_one(&pool)
     .await
@@ -443,22 +453,24 @@ pub async fn update(
     State(pool): State<SqlitePool>,
     Json(body): Json<Update{type_name}>,
 ) -> Result<Json<{type_name}>> {{
-    let existing = sqlx::query_as::<_, {type_name}>(
-        "SELECT id, name, description, created_at, updated_at FROM {table} WHERE id = ?",
-    )
+    let existing = sqlx::query_as::<_, {type_name}>(&format!(
+        "SELECT id, name, description, created_at, updated_at FROM {{}} WHERE id = ?",
+        TABLE
+    ))
     .bind(id)
     .fetch_optional(&pool)
     .await
     .map_err(db_error)?
-    .ok_or_else(|| ApiError::not_found(format!("{singular} {{id}} not found", id = id)))?;
+    .ok_or_else(|| ApiError::not_found(format!("{{}} {{id}} not found", SINGULAR, id = id)))?;
 
     let name = body.name.unwrap_or(existing.name);
     let description = body.description.or(existing.description);
     let updated_at = now_ts();
 
-    sqlx::query(
-        "UPDATE {table} SET name = ?, description = ?, updated_at = ? WHERE id = ?",
-    )
+    sqlx::query(&format!(
+        "UPDATE {{}} SET name = ?, description = ?, updated_at = ? WHERE id = ?",
+        TABLE
+    ))
     .bind(&name)
     .bind(&description)
     .bind(&updated_at)
@@ -467,9 +479,10 @@ pub async fn update(
     .await
     .map_err(db_error)?;
 
-    let row = sqlx::query_as::<_, {type_name}>(
-        "SELECT id, name, description, created_at, updated_at FROM {table} WHERE id = ?",
-    )
+    let row = sqlx::query_as::<_, {type_name}>(&format!(
+        "SELECT id, name, description, created_at, updated_at FROM {{}} WHERE id = ?",
+        TABLE
+    ))
     .bind(id)
     .fetch_one(&pool)
     .await
@@ -482,21 +495,20 @@ pub async fn update(
 #[rustapi_rs::tag("{type_name}")]
 #[rustapi_rs::summary("Delete {singular}")]
 pub async fn delete(Path(id): Path<i64>, State(pool): State<SqlitePool>) -> Result<NoContent> {{
-    let result = sqlx::query("DELETE FROM {table} WHERE id = ?")
+    let result = sqlx::query(&format!("DELETE FROM {{}} WHERE id = ?", TABLE))
         .bind(id)
         .execute(&pool)
         .await
         .map_err(db_error)?;
     if result.rows_affected() == 0 {{
-        return Err(ApiError::not_found(format!("{singular} {{id}} not found", id = id)));
+        return Err(ApiError::not_found(format!("{{}} {{id}} not found", SINGULAR, id = id)));
     }}
     Ok(NoContent)
 }}
 "#,
         capitalize(name),
         name = name,
         type_name = type_name,
-        table = table,
         singular = singular,
     );
 

crates/cargo-rustapi/src/templates/api.rs

@@ -13,14 +13,15 @@ version = "0.1.0"
 edition = "2021"
 
 [dependencies]
-rustapi-rs = {{ version = "0.1"{features} }}
+rustapi-rs = {{ version = "{version}"{features} }}
 tokio = {{ version = "1", features = ["full"] }}
 serde = {{ version = "1", features = ["derive"] }}
 tracing = "0.1"
 tracing-subscriber = {{ version = "0.3", features = ["env-filter"] }}
 uuid = {{ version = "1", features = ["v4"] }}
 "#,
         name = name,
+        version = common::rustapi_rs_version(),
         features = common::features_to_cargo(features),
     );
     fs::write(format!("{name}/Cargo.toml"), cargo_toml).await?;

crates/cargo-rustapi/src/templates/full.rs

@@ -28,14 +28,15 @@ version = "0.1.0"
 edition = "2021"
 
 [dependencies]
-rustapi-rs = {{ version = "0.1"{features} }}
+rustapi-rs = {{ version = "{version}"{features} }}
 tokio = {{ version = "1", features = ["full"] }}
 serde = {{ version = "1", features = ["derive"] }}
 tracing = "0.1"
 tracing-subscriber = {{ version = "0.3", features = ["env-filter"] }}
 uuid = {{ version = "1", features = ["v4"] }}
 "#,
         name = name,
+        version = common::rustapi_rs_version(),
         features = common::features_to_cargo(&all_features),
     );
     fs::write(format!("{name}/Cargo.toml"), cargo_toml).await?;

crates/cargo-rustapi/src/templates/minimal.rs

@@ -13,12 +13,13 @@ version = "0.1.0"
 edition = "2021"
 
 [dependencies]
-rustapi-rs = {{ version = "0.1"{features} }}
+rustapi-rs = {{ version = "{version}"{features} }}
 tokio = {{ version = "1", features = ["full"] }}
 serde = {{ version = "1", features = ["derive"] }}
 tracing-subscriber = "0.3"
 "#,
         name = name,
+        version = common::rustapi_rs_version(),
         features = common::features_to_cargo(features),
     );
     fs::create_dir_all(format!("{name}/src")).await?;

crates/cargo-rustapi/src/templates/mod.rs

@@ -137,6 +137,11 @@ RUST_LOG=info
         Ok(())
     }
 
+    /// Workspace-aligned `rustapi-rs` version for generated `Cargo.toml` pins.
+    pub fn rustapi_rs_version() -> &'static str {
+        env!("CARGO_PKG_VERSION")
+    }
+
     pub fn features_to_cargo(features: &[String]) -> String {
         if features.is_empty() {
             String::new()

crates/cargo-rustapi/src/templates/web.rs

@@ -19,13 +19,14 @@ version = "0.1.0"
 edition = "2021"
 
 [dependencies]
-rustapi-rs = {{ version = "0.1"{features} }}
+rustapi-rs = {{ version = "{version}"{features} }}
 tokio = {{ version = "1", features = ["full"] }}
 serde = {{ version = "1", features = ["derive"] }}
 tracing = "0.1"
 tracing-subscriber = {{ version = "0.3", features = ["env-filter"] }}
 "#,
         name = name,
+        version = common::rustapi_rs_version(),
         features = common::features_to_cargo(&all_features),
     );
     fs::write(format!("{name}/Cargo.toml"), cargo_toml).await?;