create-backlist 7.3.0 → 7.4.0

package/src/generators/python.js

@@ -1,86 +1,86 @@
-import chalk from 'chalk';
-import { execa } from 'execa';
-import fs from 'fs-extra';
-import path from 'node:path';
-import { analyzeFrontend } from '../analyzer.js';
-import { renderAndWrite, getTemplatePath } from './template.js';
-
-export async function generatePythonProject(options) {
-  const { projectDir, projectName, frontendSrcDir } = options;
-
-  try {
-    console.log(chalk.blue('  -> Analyzing frontend for Python (FastAPI) backend...'));
-    const endpoints = await analyzeFrontend(frontendSrcDir);
-    const modelsToGenerate = new Map();
-    endpoints.forEach(ep => {
-      if (ep.schemaFields && ep.controllerName !== 'Default' && !modelsToGenerate.has(ep.controllerName)) {
-        modelsToGenerate.set(ep.controllerName, { name: ep.controllerName, fields: Object.entries(ep.schemaFields).map(([key, type]) => ({ name: key, type })) });
-      }
-    });
-
-    if (!modelsToGenerate.has('User')) {
-      modelsToGenerate.set('User', { name: 'User', fields: [{ name: 'name', type: 'String' }, { name: 'email', type: 'String' }] });
-    }
-
-    console.log(chalk.blue('  -> Scaffolding Python (FastAPI) project structure...'));
-    const appDir = path.join(projectDir, 'app');
-    const coreDir = path.join(appDir, 'core');
-    const dbDir = path.join(appDir, 'db');
-    const modelsDir = path.join(appDir, 'models');
-    const schemasDir = path.join(appDir, 'schemas');
-    const routesDir = path.join(appDir, 'routers');
-
-    await fs.ensureDir(appDir);
-    await fs.ensureDir(coreDir);
-    await fs.ensureDir(dbDir);
-    await fs.ensureDir(modelsDir);
-    await fs.ensureDir(schemasDir);
-    await fs.ensureDir(routesDir);
-
-    const controllers = Array.from(modelsToGenerate.keys());
-
-    await renderAndWrite(getTemplatePath('python-fastapi/main.py.ejs'), path.join(projectDir, 'app', 'main.py'), { projectName, controllers });
-    await renderAndWrite(getTemplatePath('python-fastapi/requirements.txt.ejs'), path.join(projectDir, 'requirements.txt'), {});
-
-    await renderAndWrite(getTemplatePath('python-fastapi/app/core/config.py.ejs'), path.join(coreDir, 'config.py'), { projectName });
-    await renderAndWrite(getTemplatePath('python-fastapi/app/core/security.py.ejs'), path.join(coreDir, 'security.py'), {});
-
-    await renderAndWrite(getTemplatePath('python-fastapi/app/db.py.ejs'), path.join(appDir, 'db.py'), {});
-
-    await renderAndWrite(getTemplatePath('python-fastapi/app/models/user.py.ejs'), path.join(modelsDir, 'user.py'), {});
-    await renderAndWrite(getTemplatePath('python-fastapi/app/schemas/user.py.ejs'), path.join(schemasDir, 'user.py'), {});
-
-    await renderAndWrite(getTemplatePath('python-fastapi/app/routers/auth.py.ejs'), path.join(routesDir, 'auth.py'), {});
-
-    for (const [modelName, modelData] of modelsToGenerate.entries()) {
-      if (modelName.toLowerCase() !== 'user') {
-        await renderAndWrite(getTemplatePath('python-fastapi/app/routers/model_routes.py.ejs'), path.join(routesDir, `${modelName.toLowerCase()}_routes.py`), { modelName, schema: modelData });
-      }
-    }
-
-    console.log(chalk.magenta('  -> Setting up virtual environment and installing dependencies...'));
-    await execa('python', ['-m', 'venv', 'venv'], { cwd: projectDir });
-
-    const pipPath = process.platform === 'win32' ? path.join('venv', 'Scripts', 'pip') : path.join('venv', 'bin', 'pip');
-    await execa(path.join(projectDir, pipPath), ['install', '-r', 'requirements.txt'], { cwd: projectDir });
-
-    await renderAndWrite(getTemplatePath('python-fastapi/Dockerfile.ejs'), path.join(projectDir, 'Dockerfile'), {});
-    await renderAndWrite(getTemplatePath('python-fastapi/docker-compose.yml.ejs'), path.join(projectDir, 'docker-compose.yml'), { projectName });
-
-    const envContent = `DATABASE_URL="postgresql://postgres:password@db:5432/${projectName}"\nJWT_SECRET="a_very_secret_key_change_this"`;
-    await fs.writeFile(path.join(projectDir, '.env'), envContent);
-    await fs.writeFile(path.join(projectDir, '.env.example'), envContent);
-
-    console.log(chalk.green('  -> Python (FastAPI) backend generation is complete!'));
-    console.log(chalk.yellow('\nTo run your new Python backend with Docker:'));
-    console.log(chalk.cyan('  1. Make sure Docker Desktop is running.'));
-    console.log(chalk.cyan('  2. Run: `docker-compose up --build`'));
-    console.log(chalk.cyan('  3. API will be available at http://localhost:8000 and docs at http://localhost:8000/docs'));
-
-  } catch (error) {
-    if (error.code === 'ENOENT') {
-      throw new Error(`'${error.command}' command not found. Please ensure Python and venv are installed and in your system's PATH.`);
-    }
-    throw error;
-  }
-}
+import chalk from 'chalk';
+import { execa } from 'execa';
+import fs from 'fs-extra';
+import path from 'node:path';
+import { analyzeFrontend } from '../analyzer.js';
+import { renderAndWrite, getTemplatePath } from './template.js';
+
+export async function generatePythonProject(options) {
+  const { projectDir, projectName, frontendSrcDir } = options;
+
+  try {
+    console.log(chalk.blue('  -> Analyzing frontend for Python (FastAPI) backend...'));
+    const endpoints = await analyzeFrontend(frontendSrcDir);
+    const modelsToGenerate = new Map();
+    endpoints.forEach(ep => {
+      if (ep.schemaFields && ep.controllerName !== 'Default' && !modelsToGenerate.has(ep.controllerName)) {
+        modelsToGenerate.set(ep.controllerName, { name: ep.controllerName, fields: Object.entries(ep.schemaFields).map(([key, type]) => ({ name: key, type })) });
+      }
+    });
+
+    if (!modelsToGenerate.has('User')) {
+      modelsToGenerate.set('User', { name: 'User', fields: [{ name: 'name', type: 'String' }, { name: 'email', type: 'String' }] });
+    }
+
+    console.log(chalk.blue('  -> Scaffolding Python (FastAPI) project structure...'));
+    const appDir = path.join(projectDir, 'app');
+    const coreDir = path.join(appDir, 'core');
+    const dbDir = path.join(appDir, 'db');
+    const modelsDir = path.join(appDir, 'models');
+    const schemasDir = path.join(appDir, 'schemas');
+    const routesDir = path.join(appDir, 'routers');
+
+    await fs.ensureDir(appDir);
+    await fs.ensureDir(coreDir);
+    await fs.ensureDir(dbDir);
+    await fs.ensureDir(modelsDir);
+    await fs.ensureDir(schemasDir);
+    await fs.ensureDir(routesDir);
+
+    const controllers = Array.from(modelsToGenerate.keys());
+
+    await renderAndWrite(getTemplatePath('python-fastapi/main.py.ejs'), path.join(projectDir, 'app', 'main.py'), { projectName, controllers });
+    await renderAndWrite(getTemplatePath('python-fastapi/requirements.txt.ejs'), path.join(projectDir, 'requirements.txt'), {});
+
+    await renderAndWrite(getTemplatePath('python-fastapi/app/core/config.py.ejs'), path.join(coreDir, 'config.py'), { projectName });
+    await renderAndWrite(getTemplatePath('python-fastapi/app/core/security.py.ejs'), path.join(coreDir, 'security.py'), {});
+
+    await renderAndWrite(getTemplatePath('python-fastapi/app/db.py.ejs'), path.join(appDir, 'db.py'), {});
+
+    await renderAndWrite(getTemplatePath('python-fastapi/app/models/user.py.ejs'), path.join(modelsDir, 'user.py'), {});
+    await renderAndWrite(getTemplatePath('python-fastapi/app/schemas/user.py.ejs'), path.join(schemasDir, 'user.py'), {});
+
+    await renderAndWrite(getTemplatePath('python-fastapi/app/routers/auth.py.ejs'), path.join(routesDir, 'auth.py'), {});
+
+    for (const [modelName, modelData] of modelsToGenerate.entries()) {
+      if (modelName.toLowerCase() !== 'user') {
+        await renderAndWrite(getTemplatePath('python-fastapi/app/routers/model_routes.py.ejs'), path.join(routesDir, `${modelName.toLowerCase()}_routes.py`), { modelName, schema: modelData });
+      }
+    }
+
+    console.log(chalk.magenta('  -> Setting up virtual environment and installing dependencies...'));
+    await execa('python', ['-m', 'venv', 'venv'], { cwd: projectDir });
+
+    const pipPath = process.platform === 'win32' ? path.join('venv', 'Scripts', 'pip') : path.join('venv', 'bin', 'pip');
+    await execa(path.join(projectDir, pipPath), ['install', '-r', 'requirements.txt'], { cwd: projectDir });
+
+    await renderAndWrite(getTemplatePath('python-fastapi/Dockerfile.ejs'), path.join(projectDir, 'Dockerfile'), {});
+    await renderAndWrite(getTemplatePath('python-fastapi/docker-compose.yml.ejs'), path.join(projectDir, 'docker-compose.yml'), { projectName });
+
+    const envContent = `DATABASE_URL="postgresql://postgres:password@db:5432/${projectName}"\nJWT_SECRET="a_very_secret_key_change_this"`;
+    await fs.writeFile(path.join(projectDir, '.env'), envContent);
+    await fs.writeFile(path.join(projectDir, '.env.example'), envContent);
+
+    console.log(chalk.green('  -> Python (FastAPI) backend generation is complete!'));
+    console.log(chalk.yellow('\nTo run your new Python backend with Docker:'));
+    console.log(chalk.cyan('  1. Make sure Docker Desktop is running.'));
+    console.log(chalk.cyan('  2. Run: `docker-compose up --build`'));
+    console.log(chalk.cyan('  3. API will be available at http://localhost:8000 and docs at http://localhost:8000/docs'));
+
+  } catch (error) {
+    if (error.code === 'ENOENT') {
+      throw new Error(`'${error.command}' command not found. Please ensure Python and venv are installed and in your system's PATH.`);
+    }
+    throw error;
+  }
+}

package/src/project-detector.js

@@ -0,0 +1,131 @@
+import fs from "fs-extra";
+import path from "node:path";
+
+const NEXTJS_SCAN_DIRS = [
+  "app",
+  "pages",
+  "src",
+  "components",
+  "lib",
+  "hooks",
+  "services",
+  "utils",
+  "features",
+  "modules",
+];
+
+const REACT_SCAN_DIRS = ["src"];
+
+export async function detectProjectType(projectRoot) {
+  const result = {
+    type: "unknown",
+    scanDirs: [],
+    apiRouteDirs: [],
+    framework: "unknown",
+  };
+
+  const pkgPath = path.join(projectRoot, "package.json");
+  let pkg = null;
+  if (await fs.pathExists(pkgPath)) {
+    try {
+      pkg = await fs.readJson(pkgPath);
+    } catch {}
+  }
+
+  const deps = pkg
+    ? { ...(pkg.dependencies || {}), ...(pkg.devDependencies || {}) }
+    : {};
+
+  const hasNext = !!deps.next || (await hasNextConfig(projectRoot));
+  const hasReact = !!deps.react;
+  const hasVite = !!deps.vite;
+
+  const hasAppDir = await fs.pathExists(path.join(projectRoot, "app"));
+  const hasPagesDir = await fs.pathExists(path.join(projectRoot, "pages"));
+  const hasSrcApp = await fs.pathExists(path.join(projectRoot, "src", "app"));
+  const hasSrcPages = await fs.pathExists(
+    path.join(projectRoot, "src", "pages")
+  );
+
+  if (hasNext) {
+    result.framework = "next";
+
+    if ((hasAppDir || hasSrcApp) && (hasPagesDir || hasSrcPages)) {
+      result.type = "nextjs-hybrid";
+    } else if (hasAppDir || hasSrcApp) {
+      result.type = "nextjs-app";
+    } else if (hasPagesDir || hasSrcPages) {
+      result.type = "nextjs-pages";
+    } else {
+      result.type = "nextjs-app";
+    }
+
+    const candidateDirs = [...NEXTJS_SCAN_DIRS];
+    for (const dir of candidateDirs) {
+      const abs = path.join(projectRoot, dir);
+      if (await fs.pathExists(abs)) {
+        result.scanDirs.push(abs);
+      }
+      const srcNested = path.join(projectRoot, "src", dir);
+      if (dir !== "src" && (await fs.pathExists(srcNested))) {
+        result.scanDirs.push(srcNested);
+      }
+    }
+
+    if (hasAppDir) {
+      const appApiDir = path.join(projectRoot, "app", "api");
+      if (await fs.pathExists(appApiDir)) result.apiRouteDirs.push(appApiDir);
+      result.apiRouteDirs.push(path.join(projectRoot, "app"));
+    }
+    if (hasSrcApp) {
+      const srcAppApiDir = path.join(projectRoot, "src", "app", "api");
+      if (await fs.pathExists(srcAppApiDir))
+        result.apiRouteDirs.push(srcAppApiDir);
+      result.apiRouteDirs.push(path.join(projectRoot, "src", "app"));
+    }
+    if (hasPagesDir) {
+      const pagesApiDir = path.join(projectRoot, "pages", "api");
+      if (await fs.pathExists(pagesApiDir))
+        result.apiRouteDirs.push(pagesApiDir);
+    }
+    if (hasSrcPages) {
+      const srcPagesApiDir = path.join(projectRoot, "src", "pages", "api");
+      if (await fs.pathExists(srcPagesApiDir))
+        result.apiRouteDirs.push(srcPagesApiDir);
+    }
+  } else if (hasReact) {
+    result.framework = hasVite ? "vite" : "react";
+    result.type = hasVite ? "vite-react" : "react";
+
+    for (const dir of REACT_SCAN_DIRS) {
+      const abs = path.join(projectRoot, dir);
+      if (await fs.pathExists(abs)) {
+        result.scanDirs.push(abs);
+      }
+    }
+  }
+
+  if (result.scanDirs.length === 0) {
+    const fallback = path.join(projectRoot, "src");
+    if (await fs.pathExists(fallback)) {
+      result.scanDirs.push(fallback);
+    }
+  }
+
+  result.scanDirs = [...new Set(result.scanDirs)];
+  result.apiRouteDirs = [...new Set(result.apiRouteDirs)];
+
+  return result;
+}
+
+async function hasNextConfig(projectRoot) {
+  const configs = [
+    "next.config.js",
+    "next.config.mjs",
+    "next.config.ts",
+  ];
+  for (const cfg of configs) {
+    if (await fs.pathExists(path.join(projectRoot, cfg))) return true;
+  }
+  return false;
+}