@sonukapoor/branch-gen

BranchGen

BranchGen is a command-line tool designed to simplify the process of creating git branches with standardized naming conventions. This tool is highly configurable, ensuring it meets the diverse requirements of teams and workflows.

Key Features

• Customizable Branch Naming: Supports prefixes like feature, bugfix, hotfix for branch types.
• Automated Versioning: Automatically appends version numbers to branch names to avoid conflicts (configurable).
• Validation for Naming Standards: Ensures branch names and ticket IDs conform to specified patterns.
• Retry Logic: Prompts users to retry if the branch already exists (if automated versioning is disabled).
• Remote Branch Integration: Ensures compatibility with existing remote branches.

Installation

Coming soon...

Configuration

BranchGen uses a configuration file named branchgen-config.json to customize its behavior. If the file is not found, default settings are applied.

Default Configuration

{
  "prefixes": ["feature", "bugfix", "hotfix"],
  "separator": "/",
  "maxBranchNameLength": 15,
  "ticketPattern": "^[A-Z]+-[0-9]+$",
  "defaultSourceBranch": "main",
  "branchNameSeparator": "-",
  "useAutomatedVersioning": true,
  "requireTicket": false,
  "requireBranchName": true
}

Options Explained

• prefixes: List of branch types available for selection (e.g., feature, bugfix).
• separator: Character used to separate the branch type from the rest of the branch name.
• maxBranchNameLength: Maximum length allowed for a branch name.
• ticketPattern: Regex pattern for validating ticket IDs (e.g., PROJ-123).
• defaultSourceBranch: Default branch to check out before creating a new branch.
• branchNameSeparator: Character used to replace spaces in branch names.
• useAutomatedVersioning: Enables/disables automated numbering for duplicate branch names.
• requireTicket: Enforces ticket ID input.
• requireBranchName: Enforces branch name input.

Usage

Run the script and follow the prompts to generate a branch name and create the branch.

Example Workflow

• Select a branch type (e.g., feature).
• Enter a ticket ID if required (e.g., PROJ-123).
• Provide a branch name (e.g., add new feature).
• Choose a source branch from the list of remote branches.
• BranchGen checks out the source branch, pulls the latest changes, and creates the new branch.

Handling Duplicate Branch Names

• If useAutomatedVersioning is enabled, BranchGen appends version numbers (e.g., feature/PROJ-123-add-new-feature-1).
• If useAutomatedVersioning is disabled, you are prompted to retry with a different branch name.

Error Handling

• No Remote Branches Found: If no remote branches exist, the script exits with an error.
• Invalid Ticket ID: If the ticket ID does not match the specified pattern, the script prompts for a valid ID.
• Branch Name Too Long: If the branch name exceeds the maximum allowed length, you are prompted to retry.

Contributing

Contributions are welcome! Feel free to submit issues or pull requests.

License

This project is licensed under the MIT License. See the LICENSE file for details.