create-projx 1.5.2 → 1.5.4

package/README.md

@@ -66,6 +66,7 @@ If this saves you even one hour, it's already paid for itself. (It's free.)
 ## Why teams pick Projx and stay
 
 - **It actually runs.** Every template is tested in CI before release. No "looks right" surprises.
+- **Tests ship with the code.** `gen entity` writes integration tests alongside every model — 11 tests per entity, against a real database. You start green, not scrambling.
 - **Auto-entity pattern.** Define a data model, get CRUD routes, validation, OpenAPI docs, and a typed UI for free. Backend, frontend, and mobile all stay in sync.
 - **Updates don't nuke your code.** `projx update` does a 3-tier merge — your custom controllers, pages, and config survive template upgrades. No rewrites.
 - **No lock-in.** Projx generates files and walks away. Delete the `.projx` config and it's just a normal repo.
@@ -96,7 +97,7 @@ Projx is a shared operating system for teams that ship with both:
 - **AI agents** get a deterministic CLI to call instead of guessing folder structures.
 - **Teams** get consistency across repos, less drift, and fewer surprise refactors.
 
-If you're an AI agent reading this, see [SKILL.md](SKILL.md) for trigger conditions, decision rules, and the canonical invocation. Short version:
+If you're an AI agent reading this, see [SKILL.md](SKILL.md) for trigger conditions, decision rules, and the canonical invocation.
 
 ## Quick Start
 
@@ -188,7 +189,7 @@ To skip root-level files (docker-compose, README), add `skip` to `.projx`:
 
 ```json
 {
-  "version": "1.4.2",
+  "version": "1.5.2",
   "components": ["fastapi", "frontend"],
   "skip": ["docker-compose.yml", "README.md"]
 }
@@ -273,12 +274,14 @@ When both `fastapi` and `fastify` exist, the entity generates in the **primary b
 
 Override with `--ai` (fastapi) or `--backend` (fastify).
 
-| Component                 | Generated                                                                   |
-| ------------------------- | --------------------------------------------------------------------------- |
-| Primary backend (fastapi) | `src/entities/<name>/_model.py` — auto-discovered by registry               |
-| Primary backend (fastify) | `src/modules/<name>/schemas.ts` + `index.ts` + Prisma model + app.ts import |
-| `frontend`                | `src/types/<name>.ts` — TypeScript interface + Create/Update variants       |
-| `mobile`                  | `lib/entities/<name>/model.dart` — Dart class with fromJson/toJson/copyWith |
+| Component                 | Generated                                                                                     |
+| ------------------------- | --------------------------------------------------------------------------------------------- |
+| Primary backend (fastapi) | `src/entities/<name>/_model.py` + `tests/test_<name>_entity.py` — model + 11 CRUD/auth tests  |
+| Primary backend (fastify) | `src/modules/<name>/schemas.ts` + `index.ts` + Prisma model + `tests/modules/<name>.test.ts`  |
+| `frontend`                | `src/types/<name>.ts` — TypeScript interface + Create/Update variants                         |
+| `mobile`                  | `lib/entities/<name>/model.dart` — Dart class with fromJson/toJson/copyWith                   |
+
+**Tests included**: every `gen entity` writes a working integration test file alongside the model — 11 tests for FastAPI (extending `BaseEntityApiTest`), 11 tests for Fastify (via `describeCrudEntity`). Both run against a real database (Postgres for Fastify, SQLite-in-memory for FastAPI today). New entities ship green from day one — no scrambling to bolt on tests at go-live.
 
 No migrations — run `alembic revision --autogenerate` or `prisma migrate dev` (via your package manager) when ready.
 
@@ -362,16 +365,6 @@ npm test        # run tests
 npm run build   # build CLI
 ```
 
-## Badge
-
-Add this to your project's README:
-
-```md
-[![Built with Projx](https://img.shields.io/badge/Built%20with-Projx-blue)](https://github.com/ukanhaupa/projx)
-```
-
----
-
 ## Try it now
 
 You're still reading. Stop reading. Run this:
@@ -382,7 +375,17 @@ npx create-projx my-app
 
 Pick whatever you need from the menu — backend-only, AI app, mobile, full-stack, just infra. 30 seconds. Free. No signup. If you don't like it, `rm -rf my-app` and we never speak of this again.
 
-Star the repo if it saved you time → [github.com/ukanhaupa/projx](https://github.com/ukanhaupa/projx)
+---
+
+## Badge
+
+Add this to your project's README:
+
+```md
+[![Built with Projx](https://img.shields.io/badge/Built%20with-Projx-blue)](https://github.com/ukanhaupa/projx)
+```
+
+---
 
 ## License
 

package/dist/index.js

@@ -2697,6 +2697,128 @@ function generateDartModel(config) {
   lines.push("");
   return lines.join("\n");
 }
+function pyHttpLiteral(type, variant = "create") {
+  switch (type) {
+    case "string":
+    case "text":
+      return variant === "create" ? '"sample text"' : variant === "update" ? '"updated text"' : '"alt text"';
+    case "number":
+      return variant === "create" ? "42" : variant === "update" ? "100" : "7";
+    case "boolean":
+      return variant === "create" ? "True" : "False";
+    case "date":
+      return variant === "alt" ? '"2026-02-01"' : '"2026-01-01"';
+    case "datetime":
+      return variant === "alt" ? '"2026-02-01T00:00:00"' : '"2026-01-01T00:00:00"';
+    case "json":
+      return "{}";
+  }
+}
+function pyOrmLiteral(type, variant = "create") {
+  switch (type) {
+    case "string":
+    case "text":
+      return variant === "create" ? '"sample text"' : variant === "update" ? '"updated text"' : '"alt text"';
+    case "number":
+      return variant === "create" ? "42" : variant === "update" ? "100" : "7";
+    case "boolean":
+      return variant === "create" ? "True" : "False";
+    case "date":
+      return variant === "alt" ? "date(2026, 2, 1)" : "date(2026, 1, 1)";
+    case "datetime":
+      return variant === "alt" ? "datetime(2026, 2, 1, 0, 0, 0)" : "datetime(2026, 1, 1, 0, 0, 0)";
+    case "json":
+      return "{}";
+  }
+}
+function tsLiteral(type, variant = "create") {
+  switch (type) {
+    case "string":
+    case "text":
+      return variant === "create" ? "'sample text'" : variant === "update" ? "'updated text'" : "'alt text'";
+    case "number":
+      return variant === "create" ? "42" : variant === "update" ? "100" : "7";
+    case "boolean":
+      return variant === "create" ? "true" : "false";
+    case "date":
+      return variant === "alt" ? "'2026-02-01'" : "'2026-01-01'";
+    case "datetime":
+      return variant === "alt" ? "'2026-02-01T00:00:00.000Z'" : "'2026-01-01T00:00:00.000Z'";
+    case "json":
+      return "{}";
+  }
+}
+function pickFilterField(fields) {
+  return fields.find((f) => f.type === "string" || f.type === "text") ?? fields.find((f) => f.type === "number") ?? fields.find((f) => f.type === "boolean") ?? fields[0];
+}
+function generateFastapiTest(config) {
+  const className = toPascal(config.name);
+  const snake = toSnake(config.name);
+  const apiUrl = `/api/v1${config.apiPrefix}/`;
+  const filterField = pickFilterField(config.fields);
+  const needsDate = config.fields.some((f) => f.type === "date");
+  const needsDatetime = config.fields.some((f) => f.type === "datetime");
+  const dateImports = [];
+  if (needsDate) dateImports.push("date");
+  if (needsDatetime) dateImports.push("datetime");
+  const lines = [];
+  if (dateImports.length > 0) {
+    lines.push(`from datetime import ${dateImports.join(", ")}`);
+    lines.push("");
+  }
+  lines.push(`from src.entities.${snake} import ${className}`);
+  lines.push(`from tests.base_entity_api_test import BaseEntityApiTest`);
+  lines.push("");
+  lines.push("");
+  lines.push(`class Test${className}Entity(BaseEntityApiTest):`);
+  lines.push(`    __test__ = True`);
+  lines.push(`    endpoint = "${apiUrl}"`);
+  lines.push(`    create_payload = {`);
+  for (const f of config.fields) {
+    lines.push(`        "${f.name}": ${pyHttpLiteral(f.type, "create")},`);
+  }
+  lines.push(`    }`);
+  const updateField = config.fields[0];
+  lines.push(`    update_payload = {"${updateField.name}": ${pyHttpLiteral(updateField.type, "update")}}`);
+  lines.push(`    invalid_payload: dict = {}`);
+  lines.push(`    filter_field = "${filterField.name}"`);
+  lines.push(`    filter_value = ${pyHttpLiteral(filterField.type, "create")}`);
+  lines.push(`    other_filter_value = ${pyHttpLiteral(filterField.type, "alt")}`);
+  lines.push("");
+  lines.push(`    def make_model(self, index: int, **overrides):`);
+  lines.push(`        data = {`);
+  for (const f of config.fields) {
+    lines.push(`            "${f.name}": ${pyOrmLiteral(f.type, "create")},`);
+  }
+  lines.push(`        }`);
+  lines.push(`        data.update(overrides)`);
+  lines.push(`        return ${className}(**data)`);
+  lines.push("");
+  return lines.join("\n");
+}
+function generateFastifyTest(config) {
+  const className = toPascal(config.name);
+  const basePath = `/api/v1${config.apiPrefix}`;
+  const updateField = config.fields[0];
+  const lines = [];
+  lines.push(`import { describeCrudEntity } from '../helpers/crud-test-base.js';`);
+  lines.push("");
+  lines.push(`describeCrudEntity({`);
+  lines.push(`  entityName: '${className}',`);
+  lines.push(`  basePath: '${basePath}',`);
+  lines.push(`  prismaModel: '${className}',`);
+  lines.push(`  createPayload: {`);
+  for (const f of config.fields) {
+    lines.push(`    ${f.name}: ${tsLiteral(f.type, "create")},`);
+  }
+  lines.push(`  },`);
+  lines.push(`  updatePayload: {`);
+  lines.push(`    ${updateField.name}: ${tsLiteral(updateField.type, "update")},`);
+  lines.push(`  },`);
+  lines.push(`});`);
+  lines.push("");
+  return lines.join("\n");
+}
 async function resolvePrimaryBackend(cwd, hasFastapi, hasFastify, backendFlag) {
   if (backendFlag) return backendFlag;
   if (hasFastapi && !hasFastify) return "fastapi";
@@ -2780,7 +2902,15 @@ async function gen(cwd, entityName, fieldsFlag, backendFlag) {
     } else {
       await mkdir5(entityDir, { recursive: true });
       await writeFile5(join12(entityDir, "_model.py"), generateFastAPIModel(config));
+      await writeFile5(join12(entityDir, "__init__.py"), "from ._model import *\n");
       generated.push(`${dir}/src/entities/${toSnake(config.name)}/_model.py`);
+      generated.push(`${dir}/src/entities/${toSnake(config.name)}/__init__.py`);
+      const testsDir = join12(cwd, dir, "tests");
+      const testFile = join12(testsDir, `test_${toSnake(config.name)}_entity.py`);
+      if (existsSync11(testsDir) && !existsSync11(testFile)) {
+        await writeFile5(testFile, generateFastapiTest(config));
+        generated.push(`${dir}/tests/test_${toSnake(config.name)}_entity.py`);
+      }
     }
   }
   if (genFastify) {
@@ -2820,6 +2950,12 @@ async function gen(cwd, entityName, fieldsFlag, backendFlag) {
           generated.push(`${dir}/prisma/schema.prisma (model added)`);
         }
       }
+      const testsModulesDir = join12(cwd, dir, "tests/modules");
+      const fastifyTestFile = join12(testsModulesDir, `${toKebab(config.name)}.test.ts`);
+      if (existsSync11(testsModulesDir) && !existsSync11(fastifyTestFile)) {
+        await writeFile5(fastifyTestFile, generateFastifyTest(config));
+        generated.push(`${dir}/tests/modules/${toKebab(config.name)}.test.ts`);
+      }
     }
   }
   if (hasFrontend) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-projx",
-  "version": "1.5.2",
+  "version": "1.5.4",
   "description": "Scaffold production-grade fullstack projects in seconds. FastAPI, Fastify, React, Flutter, Terraform — with auth, database, CI/CD, E2E tests, and Docker. One command, ready to deploy.",
   "type": "module",
   "bin": {