github-repository-sync 0.0.2__tar.gz → 0.0.3__tar.gz

{github_repository_sync-0.0.2 → github_repository_sync-0.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: github-repository-sync
-Version: 0.0.2
+Version: 0.0.3
 Summary: Synchronize local repositories for a GitHub organization.
 Author: Kaizten Analytics
 License-Expression: LicenseRef-Proprietary
@@ -130,6 +130,7 @@ state files.
 
 After repository processing starts, every run prints aggregate counts for:
 
+- all repositories returned for the GitHub organization;
 - repositories processed;
 - repositories already local and missing locally;
 - repositories cloned and pulled successfully;
@@ -144,6 +145,11 @@ upstream. Each repository is counted at most once in the error total, even if
 more than one operation failed. Dry runs additionally report the numbers of
 planned pulls and clones.
 
+The GitHub organization total is the first summary metric. It includes every
+repository returned by the current authenticated GitHub query, including
+archived and disabled repositories, and is not reduced by `--exclude-archived`
+or `--limit`.
+
 Failures during repository processing produce a nonzero exit status after the
 summary is printed. Startup failures, such as an invalid root or failed SSH
 preflight, occur before processing and therefore do not print a summary.

{github_repository_sync-0.0.2 → github_repository_sync-0.0.3}/README.md

@@ -119,6 +119,7 @@ state files.
 
 After repository processing starts, every run prints aggregate counts for:
 
+- all repositories returned for the GitHub organization;
 - repositories processed;
 - repositories already local and missing locally;
 - repositories cloned and pulled successfully;
@@ -133,6 +134,11 @@ upstream. Each repository is counted at most once in the error total, even if
 more than one operation failed. Dry runs additionally report the numbers of
 planned pulls and clones.
 
+The GitHub organization total is the first summary metric. It includes every
+repository returned by the current authenticated GitHub query, including
+archived and disabled repositories, and is not reduced by `--exclude-archived`
+or `--limit`.
+
 Failures during repository processing produce a nonzero exit status after the
 summary is printed. Startup failures, such as an invalid root or failed SSH
 preflight, occur before processing and therefore do not print a summary.

{github_repository_sync-0.0.2 → github_repository_sync-0.0.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "github-repository-sync"
-version = "0.0.2"
+version = "0.0.3"
 description = "Synchronize local repositories for a GitHub organization."
 readme = "README.md"
 requires-python = ">=3.10"

{github_repository_sync-0.0.2 → github_repository_sync-0.0.3}/src/github_repository_sync.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: github-repository-sync
-Version: 0.0.2
+Version: 0.0.3
 Summary: Synchronize local repositories for a GitHub organization.
 Author: Kaizten Analytics
 License-Expression: LicenseRef-Proprietary
@@ -130,6 +130,7 @@ state files.
 
 After repository processing starts, every run prints aggregate counts for:
 
+- all repositories returned for the GitHub organization;
 - repositories processed;
 - repositories already local and missing locally;
 - repositories cloned and pulled successfully;
@@ -144,6 +145,11 @@ upstream. Each repository is counted at most once in the error total, even if
 more than one operation failed. Dry runs additionally report the numbers of
 planned pulls and clones.
 
+The GitHub organization total is the first summary metric. It includes every
+repository returned by the current authenticated GitHub query, including
+archived and disabled repositories, and is not reduced by `--exclude-archived`
+or `--limit`.
+
 Failures during repository processing produce a nonzero exit status after the
 summary is printed. Startup failures, such as an invalid root or failed SSH
 preflight, occur before processing and therefore do not print a summary.

{github_repository_sync-0.0.2 → github_repository_sync-0.0.3}/src/github_repository_sync.py

@@ -820,21 +820,24 @@ def sync_existing_repository(repo_name: str, repo_path: Path, dry_run: bool) ->
     )
 
 
-def print_sync_summary(results: list[RepositoryResult], dry_run: bool) -> None:
+def print_sync_summary(
+    results: list[RepositoryResult], dry_run: bool, organization_repository_count: int
+) -> None:
     """Print aggregate counts and actionable repository details."""
     cloned = [result for result in results if result.cloned]
     needs_push = [result for result in results if result.needs_push]
 
-    print("ℹ️  Summary:")
+    print("🏁 Summary:")
     print("-----------")
+    print(f"🏢 Repositories in GitHub organization: {organization_repository_count}")
     print(f"📦 Repositories processed: {len(results)}")
-    print(f"📁 Repositories already local: {sum(result.was_local for result in results)}")
+    print(f"👌 Repositories already local: {sum(result.was_local for result in results)}")
     print(f"📁 Repositories missing locally: {sum(not result.was_local for result in results)}")
-    print(f"📦 Repositories cloned: {len(cloned)}")
+    print(f"⮺  Repositories cloned: {len(cloned)}")
     for result in cloned:
         print(f"- {result.repo_name}: {result.path}")
     print(f"📥 Repositories pulled: {sum(result.pulled for result in results)}")
-    print(f"� Repositories needing push/local attention: {len(needs_push)}")
+    print(f"⚠️  Repositories needing push/local attention: {len(needs_push)}")
     for result in needs_push:
         print(f"- {result.repo_name}: {result.path}")
     print(f"📁 Repositories skipped because dirty: {sum(result.skipped_dirty for result in results)}")
@@ -926,6 +929,7 @@ def main() -> int:
         org_repos = fetch_org_repositories(args.github_api, args.org, args.token)
         source = "GitHub API"
 
+    organization_repository_count = len(org_repos)
     active_repos = [
         repo
         for repo in org_repos
@@ -1037,7 +1041,7 @@ def main() -> int:
 
     print("\n")
 
-    print_sync_summary(results, args.dry_run)
+    print_sync_summary(results, args.dry_run, organization_repository_count)
     return 1 if state_write_error or any(result.errors for result in results) else 0
 
 

{github_repository_sync-0.0.2 → github_repository_sync-0.0.3}/tests/test_github_repository_sync.py

@@ -557,9 +557,12 @@ class SyncOrgRepositoriesTests(unittest.TestCase):
         stdout = io.StringIO()
 
         with redirect_stdout(stdout):
-            sync.print_sync_summary(results, dry_run=True)
+            sync.print_sync_summary(results, dry_run=True, organization_repository_count=8)
 
         output = stdout.getvalue()
+        output_lines = output.splitlines()
+        self.assertEqual(output_lines[2], "🏢 Repositories in GitHub organization: 8")
+        self.assertEqual(output_lines[3], "📦 Repositories processed: 3")
         self.assertIn("Repositories processed: 3", output)
         self.assertIn("Repositories already local: 1", output)
         self.assertIn("Repositories missing locally: 2", output)
@@ -657,6 +660,7 @@ class SyncOrgRepositoriesTests(unittest.TestCase):
         saved_state = save_state.call_args.args[1]
         self.assertGreater(saved_state["missing"].last_changed_at, old_clone_time)
         output = stdout.getvalue()
+        self.assertIn("Repositories in GitHub organization: 3", output)
         self.assertIn("[1/2] Processing local", output)
         self.assertIn("[2/2] Processing missing", output)
         self.assertIn("Repositories processed: 2", output)
@@ -777,6 +781,7 @@ class SyncOrgRepositoriesTests(unittest.TestCase):
         )
         output = stdout.getvalue()
         self.assertIn("Selected 2 of 3 repositories with --limit=2", output)
+        self.assertIn("Repositories in GitHub organization: 3", output)
         self.assertIn("1 repositories missing locally", output)
         self.assertIn("[1/2] Processing unknown", output)
         self.assertIn("[2/2] Processing new", output)
@@ -789,6 +794,7 @@ class SyncOrgRepositoriesTests(unittest.TestCase):
     def test_main_returns_nonzero_when_state_cannot_be_saved(self):
         with tempfile.TemporaryDirectory() as directory:
             stderr = io.StringIO()
+            stdout = io.StringIO()
             with (
                 mock.patch.object(
                     sys,
@@ -810,13 +816,14 @@ class SyncOrgRepositoriesTests(unittest.TestCase):
                 mock.patch.object(
                     sync, "save_repository_state", side_effect=OSError("read-only")
                 ),
-                redirect_stdout(io.StringIO()),
+                redirect_stdout(stdout),
                 redirect_stderr(stderr),
             ):
                 return_code = sync.main()
 
         self.assertEqual(return_code, 1)
         self.assertIn("could not save repository state", stderr.getvalue())
+        self.assertIn("Repositories in GitHub organization: 0", stdout.getvalue())
 
     def test_main_reports_missing_root(self):
         missing = Path("/tmp/github-repository-sync-definitely-missing")