git_fleet_manager 0.1.0

A command line tool for managing several git repositories at once

GitFleetManager

GitFleetManager is a command-line tool for managing multiple Git repositories at once. It allows you to perform common Git operations such as checking the status, pulling, pushing, and viewing commit logs across multiple repositories in a specified directory.

Features

• Recursive Repository Discovery: Automatically finds all Git repositories in a directory and its subdirectories.
• Selective Repository Management: Use a .gitr file to specify which repositories to manage.
• Batch Operations:
  • Check the status of all repositories.
  • Pull changes from remote repositories.
  • Push changes to remote repositories.
  • View commit logs for all repositories.

Installation

1. Install GitFleetManager using pip:

   pip install git-fleet-manager
   

2. Verify the installation:

   gfm --version
   

3. GitFleetManager is now ready to use. Run the gfm command from anywhere in your terminal.

Usage

Run the gfm command with the desired subcommand and options.

Commands

status

Check the status of all repositories in the specified directory.

gfm status [directory]

• directory: The directory to scan for repositories (default: current directory).

pull

Pull changes for all repositories in the specified directory.

gfm pull [directory]

• directory: The directory to scan for repositories (default: current directory).

push

Push changes for all repositories in the specified directory.

gfm push [directory]

• directory: The directory to scan for repositories (default: current directory).

log

View the commit log for all repositories in the specified directory.

gfm log [directory] [--max-commits MAX_COMMITS]

• directory: The directory to scan for repositories (default: current directory).
• --max-commits: The maximum number of commits to display for each repository (default: 10).

--version

Display the current version of GitFleetManager.

gfm --version

.gitr File

If a .gitr file exists in the specified directory, only the repositories listed in the file will be managed. The file should contain one repository path per line, relative to the directory containing the .gitr file.

Example .gitr file:

repo1
subdir/repo2

Examples

1. Check the status of all repositories in the current directory:

   gfm status
   

2. Pull changes for all repositories in /projects:

   gfm pull /projects
   

3. Push changes for repositories listed in a .gitr file:

   gfm push /projects
   

4. View the last 5 commits for all repositories:

   gfm log /projects --max-commits 5
   

5. Display the version of GitFleetManager:

   gfm --version
   

Project Structure

git_fleet_manager/
├── git_utils.py       # Utility functions for Git operations
├── cli.py             # Command-line interface for GitFleetManager
└── __init__.py        # Package initialization and versioning

Source Code

The source code is available on GitHub at https://github.com/diefenbach/GitFleetManager.

Contributing

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

License

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

Acknowledgments

GitFleetManager was developed to simplify the management of multiple Git repositories, making it easier to perform batch operations efficiently.