GitRepo Automation

GitRepo Automation is a Visual Studio Code extension designed to streamline the setup of Git repositories. It automates the process of cloning repositories, installing dependencies, and starting projects, saving developers time and effort.

Features

• Clone multiple Git repositories at once.
• Automatically detect project types (e.g., Python, Node.js, Ruby, etc.).
• Install necessary dependencies for projects:
  • Python: Automatically handle requirements.txt, create virtual environments if needed.
  • Node.js: Supports npm and yarn for dependency management.
  • Ruby: Handles Gemfile with bundle install.
  • Java: Supports maven and gradle for builds.
  • Docker: Starts Docker containers with docker-compose.
• Handles errors with user-friendly prompts and solutions.
• Retry mechanisms for dependency installation and server startup.
• Terminal integration to run custom commands.

Usage

1. Clone Repositories

1. Open the command palette (Ctrl+Shift+P or Cmd+Shift+P on macOS).
2. Run the command: GitRepo Automation: Setup Multiple Git Projects.
3. Enter the Git repository URLs (comma-separated) in the input box.

2. Configure Projects

For each cloned repository, the extension:

• Prompts you to specify the project type.
• Installs dependencies based on the detected or selected project type.
• Provides options for Python projects:
  • Skip: Continue without installing dependencies.
  • Make and Continue: Create a requirements.txt file and install dependencies.
  • Exit: Stop the setup process for the project.

3. Run Projects

The extension attempts to:

• Start Python projects by running the specified Python file in a virtual environment.
• Start servers for Node.js, Ruby, and Java projects.
• Start Docker containers if applicable.

Supported Project Types

• Python:
  • Detects and installs packages from requirements.txt.
  • Automatically creates and activates virtual environments if dependencies fail to install.
• Node.js:
  • Installs dependencies using npm or yarn.
  • Starts the server using common commands (npm start, yarn start).
• Ruby:
  • Handles dependencies with bundle install.
  • Starts the Rails server (rails server).
• Java:
  • Builds projects with maven or gradle.
  • Runs the application using mvn exec:java or gradle run.
• Docker:
  • Starts containers using docker-compose.

Configuration

The extension does not require additional configuration. However, ensure:

• Git is installed and available in your system's PATH.
• Required tools (e.g., Python, Node.js, Docker) are installed or can be installed automatically.

Error Handling

The extension provides user-friendly prompts to handle errors:

• Suggests creating virtual environments for Python projects.
• Allows retrying dependency installation.
• Offers manual intervention options if automatic processes fail.

Development

Prerequisites

• Node.js and npm installed.
• vsce installed globally: npm install -g vsce.

Package the Extension

1. Navigate to the extension's root folder.
2. Run: vsce package.

Publish the Extension

1. Ensure you have created a publisher account on the VS Code Marketplace.
2. Publish using: vsce publish.

Contributing

Contributions are welcome!