Angelo.Scaffold 1.0.3

Angelo.Scaffold

Interactive scaffolding tool for Angelo.* packages.

Angelo.Scaffold provides a seamless way to scaffold files from Angelo packages into your project with smart merging capabilities, namespace adjustment, and an interactive terminal UI.

Installation

dotnet add package Angelo.Scaffold

Usage

Add a single line at the start of your Program.cs:

using Angelo.Scaffold.Extensions;

Scaffold.Enable();

var builder = WebApplication.CreateBuilder(args);
// ... rest of your code

When you run your app in Debug mode, a separate terminal window will open with the scaffolding interface.

Terminal Interface

Angelo Scaffold v1.0.0

╭──────────────────────────────────────────────────╮
│  Project     MyWebApp                            │
│  Location    C:\Projects\MyWebApp                │
╰──────────────────────────────────────────────────╯

Select an action
> Scan for Angelo packages
  Scaffold from package
  View scaffold history
  Re-scaffold (update)
  Exit

Workflow

1. Scan to discover installed Angelo packages with scaffold support
2. Select a package to scaffold from
3. Choose which files to scaffold
4. Review diffs for existing files
5. Confirm merges for special files (appsettings.json, DbContext, Program.cs)

Configuration

Scaffold.Enable(config =>
{
    config.DebugModeOnly = true;        // Only run in debug mode (default: true)
    config.CreateBackups = true;         // Backup files before overwriting (default: true)
    config.TerminalTitle = "My Scaffold"; // Custom terminal window title
});

Alternative: WebApplicationBuilder Extension

var builder = WebApplication.CreateBuilder(args);

builder.UseAngeloScaffold();

// ... rest of your code

Features

• Auto-discovery - Automatically scans for installed Angelo.* packages with scaffold support
• 1:1 Folder Mapping - Scaffold files maintain their folder structure
• Smart Merging - Intelligently merges JSON configs, Program.cs, and DbContext files
• Namespace Adjustment - Automatically adjusts namespaces to match your project
• Version Tracking - Keeps track of what was scaffolded for easy updates
• Backups - Creates backups before overwriting files
• Diff Comparison - Shows differences before overwriting existing files

Merge Strategies

License

MIT