scaffy-tool 0.2.0 → 1.0.1

package/registry/php/laravel/v12/questions.js

@@ -0,0 +1,45 @@
+export default [
+  {
+    type: 'input',
+    name: 'projectName',
+    message: 'Project name?',
+    default: 'my-laravel-app',
+    validate: value => {
+      if (!value || !value.trim()) {
+        return 'Project name is required';
+      }
+      if (!/^[a-z0-9_-]+$/.test(value)) {
+        return 'Project name can only contain lowercase letters, numbers, underscores, and hyphens';
+      }
+      return true;
+    },
+  },
+  {
+    type: 'select',
+    name: 'starterKit',
+    message: 'Starter kit?',
+    choices: [
+      { name: 'None', value: 'none' },
+      { name: 'Breeze', value: 'breeze' },
+      { name: 'Jetstream', value: 'jetstream' },
+    ],
+    default: 'none',
+  },
+  {
+    type: 'select',
+    name: 'database',
+    message: 'Database?',
+    choices: [
+      { name: 'SQLite', value: 'sqlite' },
+      { name: 'MySQL', value: 'mysql' },
+      { name: 'PostgreSQL', value: 'pgsql' },
+    ],
+    default: 'sqlite',
+  },
+  {
+    type: 'confirm',
+    name: 'docker',
+    message: 'Include Docker config (Laravel Sail)?',
+    default: false,
+  },
+];

package/registry/php/laravel/v12/scaffold.js

@@ -0,0 +1,46 @@
+export default async (answers, utils) => {
+  const { projectName, starterKit, database, docker } = answers;
+
+  utils.title('Creating Laravel v12 Project');
+
+  utils.step(1, 'Running Laravel installer');
+  await utils.run(
+    `composer create-project laravel/laravel:^12.0 ${projectName}`
+  );
+
+  if (starterKit === 'breeze') {
+    utils.step(2, 'Installing Laravel Breeze');
+    await utils.runInProject(
+      projectName,
+      'composer require laravel/breeze --dev'
+    );
+    await utils.runInProject(projectName, 'php artisan breeze:install');
+  }
+
+  if (starterKit === 'jetstream') {
+    utils.step(2, 'Installing Laravel Jetstream');
+    await utils.runInProject(projectName, 'composer require laravel/jetstream');
+    await utils.runInProject(
+      projectName,
+      'php artisan jetstream:install livewire'
+    );
+  }
+
+  utils.step(3, 'Configuring database');
+  await utils.setEnv(projectName, {
+    DB_CONNECTION: database,
+    DB_DATABASE:
+      database === 'sqlite' ? 'database/database.sqlite' : projectName,
+  });
+
+  if (docker) {
+    utils.step(4, 'Installing Laravel Sail');
+    await utils.runInProject(
+      projectName,
+      'composer require laravel/sail --dev'
+    );
+    await utils.runInProject(projectName, 'php artisan sail:install');
+  }
+
+  utils.success(`Laravel v12 project "${projectName}" created successfully!`);
+};

package/registry/php/laravel/v13/questions.js

@@ -0,0 +1,28 @@
+export default [
+  {
+    type: 'select',
+    name: 'starterKit',
+    message: 'Starter kit?',
+    choices: [
+      { name: 'None', value: 'none' },
+      { name: 'Breeze', value: 'breeze' },
+      { name: 'Jetstream', value: 'jetstream' },
+    ],
+  },
+  {
+    type: 'select',
+    name: 'database',
+    message: 'Database?',
+    choices: [
+      { name: 'SQLite', value: 'sqlite' },
+      { name: 'MySQL', value: 'mysql' },
+      { name: 'PostgreSQL', value: 'pgsql' },
+    ],
+  },
+  {
+    type: 'confirm',
+    name: 'docker',
+    message: 'Include Docker config (Laravel Sail)?',
+    default: false,
+  },
+];

package/registry/php/laravel/v13/scaffold.js

@@ -0,0 +1,46 @@
+export default async (answers, utils) => {
+  const { projectName, starterKit, database, docker } = answers;
+
+  utils.title('Creating Laravel v13 Project');
+
+  utils.step(1, 'Running Laravel installer');
+  await utils.run(
+    `composer create-project laravel/laravel:^13.0 ${projectName}`
+  );
+
+  if (starterKit === 'breeze') {
+    utils.step(2, 'Installing Laravel Breeze');
+    await utils.runInProject(
+      projectName,
+      'composer require laravel/breeze --dev'
+    );
+    await utils.runInProject(projectName, 'php artisan breeze:install');
+  }
+
+  if (starterKit === 'jetstream') {
+    utils.step(2, 'Installing Laravel Jetstream');
+    await utils.runInProject(projectName, 'composer require laravel/jetstream');
+    await utils.runInProject(
+      projectName,
+      'php artisan jetstream:install livewire'
+    );
+  }
+
+  utils.step(3, 'Configuring database');
+  await utils.setEnv(projectName, {
+    DB_CONNECTION: database,
+    DB_DATABASE:
+      database === 'sqlite' ? 'database/database.sqlite' : projectName,
+  });
+
+  if (docker) {
+    utils.step(4, 'Installing Laravel Sail');
+    await utils.runInProject(
+      projectName,
+      'composer require laravel/sail --dev'
+    );
+    await utils.runInProject(projectName, 'php artisan sail:install');
+  }
+
+  utils.success(`Laravel v13 project "${projectName}" created successfully!`);
+};

package/registry/php/laravel/v13/test/questions.test.js

@@ -0,0 +1,48 @@
+import questions from '../questions.js';
+
+describe('Laravel v13 questions plugin', () => {
+  test('returns expected question set', () => {
+    expect(Array.isArray(questions)).toBe(true);
+
+    const projectNameQuestion = questions.find(q => q.name === 'projectName');
+    expect(projectNameQuestion).toBeDefined();
+    expect(projectNameQuestion.default).toBe('my-laravel-app');
+
+    const starterKitQuestion = questions.find(q => q.name === 'starterKit');
+    expect(starterKitQuestion).toBeDefined();
+    expect(Array.isArray(starterKitQuestion.choices)).toBe(true);
+    expect(starterKitQuestion.choices.length).toBe(3);
+    expect(starterKitQuestion.default).toBe('none');
+
+    const databaseQuestion = questions.find(q => q.name === 'database');
+    expect(databaseQuestion).toBeDefined();
+    expect(Array.isArray(databaseQuestion.choices)).toBe(true);
+    expect(databaseQuestion.default).toBe('sqlite');
+
+    const dockerQuestion = questions.find(q => q.name === 'docker');
+    expect(dockerQuestion).toBeDefined();
+    expect(dockerQuestion.type).toBe('confirm');
+    expect(dockerQuestion.default).toBe(false);
+  });
+
+  test('project name validator rejects empty input', () => {
+    const projectNameQuestion = questions.find(q => q.name === 'projectName');
+    expect(projectNameQuestion.validate('   ')).toBe(
+      'Project name is required'
+    );
+  });
+
+  test('project name validator rejects invalid characters', () => {
+    const projectNameQuestion = questions.find(q => q.name === 'projectName');
+    const result = projectNameQuestion.validate('MyProject');
+    expect(typeof result).toBe('string');
+    expect(result).toContain('lowercase');
+  });
+
+  test('project name validator accepts valid names', () => {
+    const projectNameQuestion = questions.find(q => q.name === 'projectName');
+    expect(projectNameQuestion.validate('my-laravel-app')).toBe(true);
+    expect(projectNameQuestion.validate('my_laravel_app')).toBe(true);
+    expect(projectNameQuestion.validate('mylaravelapp123')).toBe(true);
+  });
+});

package/registry/php/laravel/v13/test/scaffold.test.js

@@ -0,0 +1,105 @@
+import { describe, it, expect, jest, beforeEach } from '@jest/globals';
+
+describe('Laravel v13 scaffold', () => {
+  let scaffold;
+  let mockUtils;
+
+  beforeEach(async () => {
+    const mod = await import('../scaffold.js');
+    scaffold = mod.default;
+
+    mockUtils = {
+      run: jest.fn().mockResolvedValue(),
+      runInProject: jest.fn().mockResolvedValue(),
+      setEnv: jest.fn(),
+      createFile: jest.fn(),
+      appendToFile: jest.fn(),
+      log: jest.fn(),
+      success: jest.fn(),
+      warn: jest.fn(),
+      error: jest.fn(),
+      title: jest.fn(),
+      step: jest.fn(),
+      divider: jest.fn(),
+    };
+  });
+
+  it('runs the laravel v13 installer', async () => {
+    await scaffold(
+      {
+        projectName: 'my-app',
+        starterKit: 'none',
+        database: 'sqlite',
+        docker: false,
+      },
+      mockUtils
+    );
+    expect(mockUtils.run).toHaveBeenCalledWith(
+      expect.stringContaining('laravel/laravel:^13.0 my-app')
+    );
+  });
+
+  it('installs breeze when selected', async () => {
+    await scaffold(
+      {
+        projectName: 'my-app',
+        starterKit: 'breeze',
+        database: 'sqlite',
+        docker: false,
+      },
+      mockUtils
+    );
+    expect(mockUtils.runInProject).toHaveBeenCalledWith(
+      'my-app',
+      expect.stringContaining('breeze')
+    );
+  });
+
+  it('installs jetstream when selected', async () => {
+    await scaffold(
+      {
+        projectName: 'my-app',
+        starterKit: 'jetstream',
+        database: 'sqlite',
+        docker: false,
+      },
+      mockUtils
+    );
+    expect(mockUtils.runInProject).toHaveBeenCalledWith(
+      'my-app',
+      expect.stringContaining('jetstream')
+    );
+  });
+
+  it('sets database env vars', async () => {
+    await scaffold(
+      {
+        projectName: 'my-app',
+        starterKit: 'none',
+        database: 'mysql',
+        docker: false,
+      },
+      mockUtils
+    );
+    expect(mockUtils.setEnv).toHaveBeenCalledWith(
+      'my-app',
+      expect.objectContaining({ DB_CONNECTION: 'mysql' })
+    );
+  });
+
+  it('installs sail when docker is true', async () => {
+    await scaffold(
+      {
+        projectName: 'my-app',
+        starterKit: 'none',
+        database: 'sqlite',
+        docker: true,
+      },
+      mockUtils
+    );
+    expect(mockUtils.runInProject).toHaveBeenCalledWith(
+      'my-app',
+      expect.stringContaining('sail')
+    );
+  });
+});

package/registry/php/symfony/plugin.json

@@ -0,0 +1,35 @@
+{
+  "name": "Symfony",
+  "alias": ["symfony"],
+  "language": "php",
+  "latest": "v7",
+  "versions": ["v7"],
+  "description": "High-performance PHP framework for web applications and APIs",
+  "requires": [
+    {
+      "tool": "php",
+      "checkCommand": "php --version",
+      "parseVersion": "PHP ([0-9]+\\.[0-9]+\\.[0-9]+)",
+      "minVersion": "8.2.0",
+      "installGuide": {
+        "mac": "brew install php",
+        "linux": "sudo apt install php8.2",
+        "windows": "https://windows.php.net",
+        "docs": "https://php.net"
+      }
+    },
+    {
+      "tool": "composer",
+      "checkCommand": "composer --version",
+      "parseVersion": "Composer version ([0-9]+\\.[0-9]+\\.[0-9]+)",
+      "minVersion": "2.0.0",
+      "installGuide": {
+        "mac": "brew install composer",
+        "linux": "sudo apt install composer",
+        "windows": "https://getcomposer.org/download",
+        "docs": "https://getcomposer.org"
+      }
+    }
+  ],
+  "maintainer": "community"
+}

package/registry/php/symfony/v7/questions.js

@@ -0,0 +1,19 @@
+export default [
+  {
+    type: 'select',
+    name: 'database',
+    message: 'Database?',
+    choices: [
+      { name: 'MySQL', value: 'mysql' },
+      { name: 'PostgreSQL', value: 'postgresql' },
+      { name: 'SQLite', value: 'sqlite' },
+      { name: 'None', value: 'none' },
+    ],
+  },
+  {
+    type: 'confirm',
+    name: 'docker',
+    message: 'Include Docker config?',
+    default: false,
+  },
+];

package/registry/php/symfony/v7/scaffold.js

@@ -0,0 +1,74 @@
+export default async (answers, utils) => {
+  const { projectName, projectType, database, docker } = answers;
+
+  utils.title('Creating Symfony v7 Project');
+
+  // ─── Step 1: Install ───────────────────────────────────
+  utils.step(1, 'Running Symfony installer');
+
+  await utils.run(
+    `composer create-project symfony/skeleton:"7.*" ${projectName}`
+  );
+
+  // ─── Step 2: Database ──────────────────────────────────
+  if (database !== 'none') {
+    utils.step(2, 'Configuring database');
+    await utils.runInProject(projectName, 'composer require symfony/orm-pack');
+    await utils.runInProject(
+      projectName,
+      'composer require --dev symfony/maker-bundle'
+    );
+
+    const dsnMap = {
+      mysql: `mysql://root:password@127.0.0.1:3306/${projectName}?serverVersion=8.0`,
+      postgresql: `postgresql://root:password@127.0.0.1:5432/${projectName}?serverVersion=15`,
+      sqlite: `sqlite:///%kernel.project_dir%/var/data.db`,
+    };
+
+    await utils.setEnv(projectName, {
+      DATABASE_URL: dsnMap[database],
+    });
+  }
+
+  // ─── Step 3: Docker ────────────────────────────────────
+  if (docker) {
+    utils.step(3, 'Creating Docker config');
+
+    const dockerCompose = `version: '3.8'
+services:
+  php:
+    image: php:8.2-fpm
+    volumes:
+      - .:/var/www/html
+    ports:
+      - "9000:9000"
+${
+  database === 'mysql'
+    ? `  db:
+    image: mysql:8.0
+    environment:
+      MYSQL_ROOT_PASSWORD: password
+      MYSQL_DATABASE: ${projectName}
+    ports:
+      - "3306:3306"`
+    : ''
+}
+${
+  database === 'postgresql'
+    ? `  db:
+    image: postgres:15
+    environment:
+      POSTGRES_PASSWORD: password
+      POSTGRES_DB: ${projectName}
+    ports:
+      - "5432:5432"`
+    : ''
+}
+`;
+    await utils.createFile(`${projectName}/docker-compose.yml`, dockerCompose);
+  }
+
+  utils.success(`Symfony v7 project "${projectName}" created successfully!`);
+  utils.log(`  cd ${projectName}`);
+  utils.log(`  symfony server:start`);
+};

package/registry/python/django/plugin.json

@@ -0,0 +1,35 @@
+{
+  "name": "Django",
+  "alias": ["django"],
+  "language": "python",
+  "latest": "v5",
+  "versions": ["v5"],
+  "description": "High-level Python web framework for rapid development",
+  "requires": [
+    {
+      "tool": "python",
+      "checkCommand": "python3 --version",
+      "parseVersion": "Python ([0-9]+\\.[0-9]+\\.[0-9]+)",
+      "minVersion": "3.10.0",
+      "installGuide": {
+        "mac": "brew install python",
+        "linux": "sudo apt install python3",
+        "windows": "https://python.org/downloads",
+        "docs": "https://python.org"
+      }
+    },
+    {
+      "tool": "pip",
+      "checkCommand": "pip3 --version",
+      "parseVersion": "pip ([0-9]+\\.[0-9]+)",
+      "minVersion": "22.0.0",
+      "installGuide": {
+        "mac": "brew install python",
+        "linux": "sudo apt install python3-pip",
+        "windows": "https://pip.pypa.io/en/stable/installation",
+        "docs": "https://pip.pypa.io"
+      }
+    }
+  ],
+  "maintainer": "community"
+}

package/registry/python/django/v5/questions.js

@@ -0,0 +1,24 @@
+export default [
+  {
+    type: 'select',
+    name: 'database',
+    message: 'Database?',
+    choices: [
+      { name: 'SQLite  — default, no setup needed', value: 'sqlite' },
+      { name: 'PostgreSQL', value: 'postgresql' },
+      { name: 'MySQL', value: 'mysql' },
+    ],
+  },
+  {
+    type: 'confirm',
+    name: 'restFramework',
+    message: 'Include Django REST Framework?',
+    default: false,
+  },
+  {
+    type: 'confirm',
+    name: 'docker',
+    message: 'Include Docker config?',
+    default: false,
+  },
+];

package/registry/python/django/v5/scaffold.js

@@ -0,0 +1,107 @@
+export default async (answers, utils) => {
+  const { projectName, database, restFramework, docker } = answers;
+
+  utils.title('Creating Django v5 Project');
+
+  // ─── Step 1: Install Django ────────────────────────────
+  utils.step(1, 'Installing Django');
+  await utils.run('pip3 install "django>=5.0,<6.0"');
+
+  // ─── Step 2: Create Project ────────────────────────────
+  utils.step(2, 'Creating Django project');
+  await utils.run(`django-admin startproject ${projectName}`);
+
+  // ─── Step 3: Database ──────────────────────────────────
+  if (database === 'postgresql') {
+    utils.step(3, 'Installing PostgreSQL driver');
+    await utils.runInProject(projectName, 'pip3 install psycopg2-binary');
+  }
+
+  if (database === 'mysql') {
+    utils.step(3, 'Installing MySQL driver');
+    await utils.runInProject(projectName, 'pip3 install mysqlclient');
+  }
+
+  // ─── Step 4: REST Framework ────────────────────────────
+  if (restFramework) {
+    utils.step(4, 'Installing Django REST Framework');
+    await utils.runInProject(projectName, 'pip3 install djangorestframework');
+
+    const settingsPath = `${projectName}/${projectName}/settings.py`;
+    await utils.appendToFile(
+      settingsPath,
+      `\n# Django REST Framework\nINSTALLED_APPS += ['rest_framework']\n`
+    );
+  }
+
+  // ─── Step 5: requirements.txt ──────────────────────────
+  utils.step(5, 'Generating requirements.txt');
+
+  const requirements = [`django>=5.0,<6.0`];
+  if (database === 'postgresql') requirements.push('psycopg2-binary');
+  if (database === 'mysql') requirements.push('mysqlclient');
+  if (restFramework) requirements.push('djangorestframework');
+
+  await utils.createFile(
+    `${projectName}/requirements.txt`,
+    requirements.join('\n') + '\n'
+  );
+
+  // ─── Step 6: Docker ────────────────────────────────────
+  if (docker) {
+    utils.step(6, 'Creating Docker config');
+
+    const dockerfile = `FROM python:3.12-slim
+
+WORKDIR /app
+
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+COPY . .
+
+EXPOSE 8000
+CMD ["python", "manage.py", "runserver", "0.0.0.0:8000"]
+`;
+
+    const dockerCompose = `version: '3.8'
+services:
+  web:
+    build: .
+    ports:
+      - "8000:8000"
+    volumes:
+      - .:/app
+${
+  database === 'postgresql'
+    ? `  db:
+    image: postgres:15
+    environment:
+      POSTGRES_PASSWORD: password
+      POSTGRES_DB: ${projectName}
+    ports:
+      - "5432:5432"`
+    : ''
+}
+${
+  database === 'mysql'
+    ? `  db:
+    image: mysql:8.0
+    environment:
+      MYSQL_ROOT_PASSWORD: password
+      MYSQL_DATABASE: ${projectName}
+    ports:
+      - "3306:3306"`
+    : ''
+}
+`;
+
+    await utils.createFile(`${projectName}/Dockerfile`, dockerfile);
+    await utils.createFile(`${projectName}/docker-compose.yml`, dockerCompose);
+  }
+
+  utils.success(`Django v5 project "${projectName}" created successfully!`);
+  utils.log(`  cd ${projectName}`);
+  utils.log(`  python manage.py migrate`);
+  utils.log(`  python manage.py runserver`);
+};

package/registry/python/fastapi/plugin.json

@@ -0,0 +1,35 @@
+{
+  "name": "FastAPI",
+  "alias": ["fastapi"],
+  "language": "python",
+  "latest": "v1",
+  "versions": ["v1"],
+  "description": "Modern, fast Python web framework for building APIs",
+  "requires": [
+    {
+      "tool": "python",
+      "checkCommand": "python3 --version",
+      "parseVersion": "Python ([0-9]+\\.[0-9]+\\.[0-9]+)",
+      "minVersion": "3.10.0",
+      "installGuide": {
+        "mac": "brew install python",
+        "linux": "sudo apt install python3",
+        "windows": "https://python.org/downloads",
+        "docs": "https://python.org"
+      }
+    },
+    {
+      "tool": "pip",
+      "checkCommand": "pip3 --version",
+      "parseVersion": "pip ([0-9]+\\.[0-9]+)",
+      "minVersion": "22.0.0",
+      "installGuide": {
+        "mac": "brew install python",
+        "linux": "sudo apt install python3-pip",
+        "windows": "https://pip.pypa.io/en/stable/installation",
+        "docs": "https://pip.pypa.io"
+      }
+    }
+  ],
+  "maintainer": "community"
+}

package/registry/python/fastapi/v1/questions.js

@@ -0,0 +1,25 @@
+export default [
+  {
+    type: 'select',
+    name: 'database',
+    message: 'Database?',
+    choices: [
+      { name: 'None', value: 'none' },
+      { name: 'PostgreSQL — SQLAlchemy + Alembic', value: 'postgresql' },
+      { name: 'MySQL     — SQLAlchemy + Alembic', value: 'mysql' },
+      { name: 'SQLite    — SQLAlchemy + Alembic', value: 'sqlite' },
+    ],
+  },
+  {
+    type: 'confirm',
+    name: 'async',
+    message: 'Use async database drivers?',
+    default: true,
+  },
+  {
+    type: 'confirm',
+    name: 'docker',
+    message: 'Include Docker config?',
+    default: false,
+  },
+];