Homer Command Line Interface

CLI for Managing Tags and Branches in Git Repositories

❓ Why Homer?

If Herodotus (often considered the "Father of History") is to Python (a programming language known for its readability and storytelling-like structure), then a comparable figure for JavaScript would be Homer (the ancient Greek poet famous for epic tales like The Iliad and The Odyssey).

Herodotus & Python: Herodotus was a historian who emphasized storytelling, much like how Python is designed to be readable and structured in a way that emphasizes clarity.

Homer & JavaScript: Homer’s works were dynamic, widely influential, and foundational to Western literature—just as JavaScript is to web development. JavaScript is also more dynamic and flexible, much like how Homer’s oral traditions evolved with time.

🚀 Project Setup

Follow these steps to set up the project:

Prerequisites

• Ensure you have nvm installed.
• Ensure you have Node.js and npm installed.

Installation Steps

1. Install and Use the Correct Node Version

Run the following command to install and use the correct Node.js version (uses the version in .nvmrc):

nvm install && nvm use

2. Install Dependencies

Run the following command to install the necessary dependencies:

npm install

3. Link the CLI

Run the following command to link the package so that you can use the homer CLI globally:

npm link

🎉 You're all set! Now you can start using the CLI. 🚀

📌 Usage

Run homer to display the available commands:

homer

❓ Help

homer -h
homer --help

🔹 Display Version

homer -v
homer --version

⚙️ Commands

🏷️ Tag Management

Create a pre-release tag:

homer tag

• In the main branch, this command creates and increments -dev tags.
• In release/X.X branches, this command creates and increments -rc tags.
• In all other branches, this command creates and increments tags using the branch name (e.g., v1.2.0-OTS25-101.1).

Create a final release tag:

homer tag final

• In release/X.X branches, this command creates final tags (e.g., v1.2.0).

🔀 Branch Management

Create a new minor release branch:

homer fork minor

• Creates a minor release branch (e.g., release/1.2).
• Creates next -rc tag in release branch (e.g., v1.2.0-rc.0).
• Increments main branch with next -dev tag (e.g., v1.3.0-dev.0).

Create a new major release branch:

homer fork major

• Creates a major release branch (e.g., release/2.0).
• Creates next -rc tag in release branch (e.g., v2.0.0-rc.0).
• Increments main branch with next -dev tag (e.g., v2.1.0-dev.0).