Add batch processing support for parallel repository execution in gh repo-stats

Author: sukumarp2022

README.md

@@ -44,6 +44,9 @@ Options:
                                      potential naming conflicts if those orgs are to be merged during migration
      -y, --token-type              : Type of Personal Access, can either be "user" or "app"
                                      Default: user
+     -b, --batch                   : Number of repositories to process in parallel
+                                     Creates temp CSV files, then merges and sorts by repo name
+                                     Default: 0 (disabled, sequential processing)
 
 Description:
   Scans an organization or list of organizations for all repositories and gathers size statistics for each repository
@@ -90,7 +93,7 @@ tinyfists,actions-experiments,false,2023-03-10T16:15:27Z,2022-10-28T19:38:34Z,ab
 - `Latest_Commit_Branch`: Branch name where the most recent commit was made
 - `Default_Branch`: Default branch of the repository (e.g., main, master), or "No default branch" if none exists
 - `isFork`: Whether the repository is a fork
-- `isArchive`: Whether the repository is archived
+- `isArchived`: Whether the repository is archived
 - `Repo_Size_mb`: Size of the repository in megabytes
 - `Record_Count`: Number of database records this repository represents
 - `Collaborator_Count`: Number of users who have contributed to this repository
@@ -115,6 +118,43 @@ tinyfists,actions-experiments,false,2023-03-10T16:15:27Z,2022-10-28T19:38:34Z,ab
   - 1.5 GB or larger size on disk
 - `Created`: Date/time when the repository was created
 
+## Batch Processing (Parallel Execution)
+
+For organizations with many repositories, you can use the `-b` or `--batch` option to process repositories in parallel, significantly reducing the total execution time.
+
+### How It Works
+
+1. **Fetches all repository names** first with a lightweight query
+2. **Distributes repositories** across the specified number of parallel workers
+3. **Creates temporary CSV files** in `./temp_files/` directory (one per worker)
+4. **Merges and sorts** all results alphabetically by repository name into the final output file
+5. **Cleans up** temporary files automatically after completion (or on interruption)
+
+### Usage Examples
+
+```shell
+# Process with 4 parallel workers
+gh repo-stats -o my-org-name --batch 4
+
+# Combine with other options
+gh repo-stats -o my-org-name -b 8 -c fields-config.csv
+```
+
+### Progress Tracking
+
+When batch mode is enabled, you'll see a real-time progress bar:
+
+```
+🚀 Progress: [████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░] 30% | ✅ 30/100 repos | ⚡ 4 active | 🔄 Processing...
+```
+
+### Notes
+
+- The output is automatically sorted alphabetically by repository name
+- Temporary files are cleaned up automatically on completion or interruption (Ctrl+C)
+- If interrupted, the script will terminate all background workers and clean up temp files
+- Recommended batch size: 4-8 workers (higher values may hit API rate limits faster)
+
 ## Field Configuration
 
 You can customize which fields are included in the output by using a field configuration CSV file with the `-c` or `--config` option. This is useful when you only need specific fields and want to reduce the output size.