Merge pull request #3 from pyramation/create-gen-app

Create gen app

Author: pyramation

.github/workflows/run-tests.yml

@@ -28,3 +28,6 @@ jobs:
 
       - name: Test inquirerer
         run: cd packages/inquirerer && yarn test
+
+      - name: Test create-gen-app
+        run: cd packages/create-gen-app && yarn test

README.md

@@ -14,9 +14,7 @@
    <a href="https://www.npmjs.com/package/inquirerer"><img height="20" src="https://img.shields.io/github/package-json/v/pyramation/inquirerer?filename=packages%2Finquirerer%2Fpackage.json"></a>
 </p>
 
-This library is designed to facilitate the creation of command-line utilities by providing a robust framework for capturing user input through interactive prompts. It supports a variety of question types, making it highly flexible and suitable for a wide range of applications.
-
-_This is the new and improved version of [pyramation/inquirer](https://github.com/pyramation/inquirerer-v1). Soon this will completely replace it!_
+This library is designed to facilitate the creation of command-line utilities by providing a robust framework for capturing user input through interactive prompts. It supports a variety of question types, making it highly flexible and suitable for a wide range of applications. 
 
 ## Install
 

packages/create-gen-app/README.md

@@ -0,0 +1,150 @@
+# create-gen-app
+
+<p align="center" width="100%">
+    <img height="90" src="https://user-images.githubusercontent.com/545047/190171475-b416f99e-2831-4786-9ba3-a7ff4d95b0d3.svg" />
+</p>
+
+<p align="center" width="100%">
+  
+  <a href="https://github.com/pyramation/inquirerer/actions/workflows/run-tests.yml">
+    <img height="20" src="https://github.com/pyramation/inquirerer/actions/workflows/run-tests.yml/badge.svg" />
+  </a>
+   <a href="https://github.com/pyramation/inquirerer/blob/main/LICENSE"><img height="20" src="https://img.shields.io/badge/license-MIT-blue.svg"></a>
+   <a href="https://www.npmjs.com/package/inquirerer"><img height="20" src="https://img.shields.io/npm/dt/inquirerer"></a>
+   <a href="https://www.npmjs.com/package/inquirerer"><img height="20" src="https://img.shields.io/github/package-json/v/pyramation/inquirerer?filename=packages%2Finquirerer%2Fpackage.json"></a>
+</p>
+
+A TypeScript library for cloning and customizing template repositories with variable replacement.
+
+## Features
+
+- Clone GitHub repositories or any git URL
+- Extract template variables from filenames and file contents using `__VARIABLE__` syntax
+- Load custom questions from `.questions.json` or `.questions.js` files
+- Interactive prompts using inquirerer with CLI argument support
+- Stream-based file processing for efficient variable replacement
+
+## Installation
+
+```bash
+npm install create-gen-app
+```
+
+## Usage
+
+### Basic Usage
+
+```typescript
+import { createGen } from 'create-gen-app';
+
+await createGen({
+  templateUrl: 'https://github.com/user/template-repo',
+  outputDir: './my-new-project',
+  argv: {
+    PROJECT_NAME: 'my-project',
+    AUTHOR: 'John Doe'
+  }
+});
+```
+
+### Template Variables
+
+Variables in your template should be wrapped in double underscores:
+
+**Filename variables:**
+```
+__PROJECT_NAME__/
+  __MODULE_NAME__.ts
+```
+
+**Content variables:**
+```typescript
+// __MODULE_NAME__.ts
+export const projectName = "__PROJECT_NAME__";
+export const author = "__AUTHOR__";
+```
+
+### Custom Questions
+
+Create a `.questions.json` file in your template repository:
+
+```json
+{
+  "questions": [
+    {
+      "name": "PROJECT_NAME",
+      "type": "text",
+      "message": "What is your project name?",
+      "required": true
+    },
+    {
+      "name": "AUTHOR",
+      "type": "text",
+      "message": "Who is the author?"
+    }
+  ]
+}
+```
+
+Or use `.questions.js` for dynamic questions:
+
+```javascript
+/**
+ * @typedef {Object} Questions
+ * @property {Array} questions - Array of question objects
+ */
+
+module.exports = {
+  questions: [
+    {
+      name: 'PROJECT_NAME',
+      type: 'text',
+      message: 'What is your project name?',
+      required: true
+    }
+  ]
+};
+```
+
+## API
+
+### `createGen(options: CreateGenOptions): Promise<string>`
+
+Main function to create a project from a template.
+
+**Options:**
+- `templateUrl` (string): URL or path to the template repository
+- `outputDir` (string): Destination directory for the generated project
+- `argv` (Record<string, any>): Command-line arguments to pre-populate answers
+- `noTty` (boolean): Whether to disable TTY mode for non-interactive usage
+
+### `extractVariables(templateDir: string): Promise<ExtractedVariables>`
+
+Extract all variables from a template directory.
+
+### `promptUser(extractedVariables: ExtractedVariables, argv?: Record<string, any>, noTty?: boolean): Promise<Record<string, any>>`
+
+Prompt the user for variable values using inquirerer.
+
+### `replaceVariables(templateDir: string, outputDir: string, extractedVariables: ExtractedVariables, answers: Record<string, any>): Promise<void>`
+
+Replace variables in all files and filenames.
+
+## Variable Naming Rules
+
+Variables can contain:
+- Letters (a-z, A-Z)
+- Numbers (0-9)
+- Underscores (_)
+- Must start with a letter or underscore
+
+Examples of valid variables:
+- `__PROJECT_NAME__`
+- `__author__`
+- `__CamelCase__`
+- `__snake_case__`
+- `__VERSION_1__`
+
+## License
+
+MIT