Skip to content

Latest commit

 

History

History
95 lines (58 loc) · 2.54 KB

README.md

File metadata and controls

95 lines (58 loc) · 2.54 KB

sync-it-all

sync-it-all is a script for synchronizing all Git repositories in a specified directory. The script ensures all repositories are up-to-date with their remote counterparts by pulling the latest changes. It handles uncommitted changes automatically by stashing them before switching branches.

Features

  • Synchronize all Git repositories in a directory with their remote.
  • Automatically stashes uncommitted changes to ensure clean branch checkouts.
  • Generates optional log files for detailed sync operations.

Important

This script requires Git to be installed and available in your system's PATH.

Installation

  1. Download and Give Execute Permissions:

    You can download the script directly or use curl:

    sudo curl -L -o /usr/local/bin/sync-it-all https://raw.githubusercontent.com/mohammadxali/sync-it-all/main/sync-it-all.sh
sudo chmod +x /usr/local/bin/sync-it-all

  2. Verify Installation:

    Check that the script is available globally:

    sync-it-all --help

Usage

Basic Usage

To synchronize all repositories in a specified directory:

sync-it-all <directory>
  • <directory>: The path to the directory containing Git repositories to synchronize.

Example

Sync all repositories in the example directory:

sync-it-all example

Sync all repositories in the current directory:

sync-it-all .

Logging

To enable logging, use the --with-logs flag. This creates a timestamped .log file in the target directory.

sync-it-all <directory> --with-logs

Example

Sync all repositories in the example directory and generate a log file:

sync-it-all example --with-logs

Log File Example

If logging is enabled, the script creates a log file with a name like sync-log_<directory-name>_<timestamp>.log in the target directory. The log file contains details about the synchronization process, including any errors encountered.

How It Works

  1. Stashing Uncommitted Changes:

    • The script stashes any uncommitted changes before switching branches to ensure the workspace is clean.

  2. Branch Checkouts:

    • Attempts to switch to the main branch first. If main doesn't exist, it falls back to master.

  3. Pull Changes:

    • Once on the correct branch, it pulls the latest changes using git pull --rebase.

Options

  • --with-logs: Generate a .log file for the sync operation. Includes timestamps and repository details.
  • --help: Display the help message and exit.