IT-Tom Generate Code

A powerful VSCode extension that streamlines code generation through customizable templates and JSON-driven content generation. Perfect for developers looking to automate repetitive coding tasks and maintain consistent code structure across projects.

✨ Features

• 🎯 Template Creation: Build reusable templates from existing code structures
• 🔄 Code Generation: Generate code from templates using JSON data input
• 📝 Smart Text Formatting: Support multiple text cases (kebab, camel, pascal, snake)
• 🎨 Dynamic Content Generation: Auto-generate model properties and HTML elements based on JSON data types
• 🔍 Targeted Updates: Insert code at specific locations using markers
• 📁 Structure Preservation: Maintains directory structure when creating templates

🚀 Getting Started

Installation

1. Launch Visual Studio Code
2. Open the Extensions view (Ctrl+Shift+X or Cmd+Shift+X)
3. Search for "IT-Tom Generate Code"
4. Click Install

Basic Usage

Creating Templates

1. New Template:

   • Select file(s)/folder(s) in the explorer
   • Right-click → "IT-Tom Build Template"
   • Enter project name
   • Template is created in _projectname_template folder

2. Update Existing Template:

   • Select text to use as marker
   • Right-click → "IT-Tom Set Key For Update"
   • Choose template to update

Generating Code

1. Using JSON:
   • Select JSON text (optional)
   • Right-click → "IT-Tom Generate Code"
   • Enter JSON if not selected
   • Select template
   • Fill in placeholders

📖 Template Configuration

Key Configuration Files

1. _pathFiles.json

Defines file handling rules. Each entry can be either a "create" or "update" configuration:

Create Configuration

{
  "pathTemplate": "src/models/user.ts",     // Source template file path
  "pathGenerate": "src/models/@{camel-area}/@{camel-model}.ts",  // Target generation path
  "actionType": "create"    // Specifies file creation
}

Update Configuration

{
  "pathUpdate": "src/app.module.ts",   // Target file to update
  "actionType": "update",              // Specifies file update
  "updateConfigs": [{
    "type": "before",                  // Insert position: "before" or "after"
    "key": "// <insert-modules-here>", // Marker for insertion point
    "contentInsert": "import { @{pascal-model}Module } from './@{kebab-model}/@{kebab-model}.module';",
    "isCheckExistNotUpdate": true      // Skip if content exists
  }]
}

Fields Explained:

• pathTemplate: Source file path in template directory
• pathGenerate: Target path for new file generation (supports placeholders)
• pathUpdate: Path to existing file to modify
• actionType: "create" or "update"
• updateConfigs: Array of update rules containing:
  • type: Position to insert ("before"/"after" the key)
  • key: Marker text in file
  • contentInsert: Content to insert (supports placeholders)
  • isCheckExistNotUpdate: Prevents duplicate content if true

2. _displaySetting.json

Defines code generation patterns for different data types:

{
  "__comment": "Key example @{<<fieldName>>}",
  "display": {
    "model": [
      { 
        "dataType": "String",          // Input data type
        "convert": "public @{fieldName}: string;"  // Property template
      },
      {
        "dataType": "Float", 
        "convert": "public @{fieldName}: double;"
      },
     
    ],
    "html": [
      {
        "dataType": "String",          // Input data type
        "convert": "<input name=\"@{fieldName}\" type=\"text\">"  // HTML template
      },
      {
        "dataType": "Float", 
        "convert": "<input name=\"@{fieldName}\" type=\"number\">"
      },
      {
        "dataType": "Integer",
        "convert": "@{display.htmlInteger}"
      },
    ],
     "htmlInteger": [
      {
        "name": "Select List",
        "dataType": "Integer",  
        "convert": "<select name=\"@{camel-fieldName}\" id=\"cars\">\n    <option value=\"volvo\">Volvo</option>\n    <option value=\"saab\">Saab</option>\n  </select>" // Html option Integer of html.dataType.Integer
      },
      {
        "name": "Numberic",
        "dataType": "Integer", 
        "convert": "<input name=\"@{fieldName}\" type=\"numberic\">"
      },
      {
        "dataType": "Currency",
        "convert": "<input name=\"@{fieldName}\" type=\"currency\">"
      },
    ]
  }
}

Fields Explained:

• display: Contains conversion rules grouped by context
  • model: Rules for generating model properties
  • html: Rules for generating HTML elements
• Each rule contains:
  • dataType: Input data type (String, Number, Boolean, etc.)
  • convert: Template with @{fieldName} placeholder or @{display.htmlInteger}
  • htmlInteger: Add an option for replacing the fieldName value in the JSON model.

🎯 Template Tags

Display Tags

Use in templates for dynamic code generation:

export class @{pascal-model} {
    @{display.model-for}  // Generates properties from JSON
    
    constructor() {
        // Constructor logic
    }
}

Text Format Tags

Input text supports the following formats: "user profile", "user-profile", "user_profile", and "userProfile". | Format Tag | Input Text Example | Output | Description | |------------|---------------|---------|-------------| | @{kebab-text} | userProfile | user-profile | Lowercase with hyphens | | @{camel-text} | user profile | userProfile | camelCase formatting | | @{pascal-text} | user-profile | UserProfile | PascalCase formatting | | @{snake-text} | user profile | user_profile | Lowercase with underscores | | @{upper-text} | user profile | USER_PROFILE | Uppercase without separators | | @{lower-text} | user profile | user_profile | Lowercase without separators | | @{label-text} | user profile | User Profile | Lable case formatting |

🔧 Action Types

Create Mode

• Purpose: Generate new files
• Configuration: Uses pathTemplate and pathGenerate
• Features: Supports placeholder substitution

Update Mode

• Purpose: Modify existing files
• Configuration: Uses pathUpdate and updateConfigs
• Features:
  • Insert before/after markers
  • Optional duplicate check (isCheckExistNotUpdate)

📋 Requirements

• Visual Studio Code 1.97.0 or higher
• Workspace with write permissions

🐛 Issue Reporting

Found a bug or have a suggestion? Please report it on our GitHub repository.

📝 Release Notes

0.0.7

• Initial release
• Template generation system
• JSON-based code generation
• Multiple text format support
• Dynamic content generation

🤝 Contributing

We welcome contributions! Please feel free to submit pull requests.

📄 License

This extension is licensed under the MIT License.