feat: display summary of excluded directories at end of run

Show the total count and combined size of newly excluded directories
after each run, making it easy to see the impact at a glance.

Inspired by stevegrunwell#84, props @Vadorequest.

Author: django23

CHANGELOG.md

@@ -11,6 +11,7 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 * Support glob patterns in sentinel definitions, enabling wildcards like `*.xcodeproj` ([stevegrunwell/asimov#64], props @mdab121)
 * Exclude Xcode DerivedData when `*.xcodeproj` is present ([stevegrunwell/asimov#64], props @mdab121)
 * Exclude well-known global cache directories (`~/.cache`, `~/.gradle/caches`, `~/.m2/repository`, `~/.npm/_cacache`, `~/.nuget/packages`, `~/.kube/cache`, etc.) without requiring sentinel files (inspired by [stevegrunwell/asimov#69], props @pkuczynski)
+* Display a summary of total count and size of newly excluded directories at the end of each run (inspired by [stevegrunwell/asimov#84], props @Vadorequest)
 * Exclude Next.js build cache (`.next`)
 * Exclude Nuxt build cache (`.nuxt`)
 * Exclude Angular CLI cache (`.angular`)
@@ -129,5 +130,6 @@ Initial public release.
 [#56]: https://github.com/stevegrunwell/asimov/pull/56
 [stevegrunwell/asimov#64]: https://github.com/stevegrunwell/asimov/pull/64
 [stevegrunwell/asimov#69]: https://github.com/stevegrunwell/asimov/pull/69
+[stevegrunwell/asimov#84]: https://github.com/stevegrunwell/asimov/issues/84
 [stevegrunwell/asimov#87]: https://github.com/stevegrunwell/asimov/pull/87
 [stevegrunwell/asimov#97]: https://github.com/stevegrunwell/asimov/pull/97

asimov

@@ -1,6 +1,10 @@
 #!/usr/bin/env bash
 set -Eeu -o pipefail
 
+# Temp file for tracking excluded directory sizes (cleaned up on exit).
+ASIMOV_SIZE_LOG="$(mktemp)"
+trap 'rm -f "$ASIMOV_SIZE_LOG"' EXIT
+
 # Look through the local filesystem and exclude development dependencies
 # from Apple Time Machine backups.
 #
@@ -125,7 +129,9 @@ exclude_file() {
         tmutil addexclusion "${path}"
 
         sizeondisk=$(du -hs "${path}" | cut -f1)
+        rawsize=$(du -sk "${path}" | cut -f1)
         echo "- ${path} has been excluded from Time Machine backups (${sizeondisk})."
+        echo "${rawsize}" >> "$ASIMOV_SIZE_LOG"
     done
 }
 
@@ -188,3 +194,21 @@ for dir in "${ASIMOV_FIXED_DIRS[@]}"; do
         echo "$dir"
     fi
 done | exclude_file
+
+# Print summary.
+_excluded_count=$(wc -l < "$ASIMOV_SIZE_LOG" | tr -d ' ')
+if [[ "$_excluded_count" -gt 0 ]]; then
+    _total_kb=$(awk '{s+=$1} END {print s}' "$ASIMOV_SIZE_LOG")
+
+    if [[ "$_total_kb" -ge 1048576 ]]; then
+        _total_human="$(awk "BEGIN {printf \"%.1fG\", ${_total_kb}/1048576}")"
+    elif [[ "$_total_kb" -ge 1024 ]]; then
+        _total_human="$(awk "BEGIN {printf \"%.1fM\", ${_total_kb}/1024}")"
+    else
+        _total_human="${_total_kb}K"
+    fi
+
+    printf '\n\033[0;32mDone! Excluded %d directories, totalling %s.\033[0m\n' "$_excluded_count" "$_total_human"
+else
+    printf '\n\033[0;32mDone! No new directories to exclude.\033[0m\n'
+fi

tests/behavior.bats

@@ -207,3 +207,29 @@ load test_helper
   second_count="$(count_exclusions)"
   [[ "$second_count" -eq 1 ]]
 }
+
+# =============================================================================
+# Summary output
+# =============================================================================
+
+@test "prints summary with count when directories are excluded" {
+  create_project "Code/Project-A" "package.json" "node_modules"
+  create_project "Code/Project-B" "composer.json" "vendor"
+  run_asimov
+  [[ "$output" == *"Excluded 2 directories"* ]]
+}
+
+@test "prints no-exclusion message when nothing to exclude" {
+  run_asimov
+  [[ "$output" == *"No new directories to exclude"* ]]
+}
+
+@test "prints no-exclusion message when all directories already excluded" {
+  create_project "Code/My-Project" "package.json" "node_modules"
+  run_asimov
+  assert_excluded "${HOME}/Code/My-Project/node_modules"
+
+  # Run again — everything is already excluded
+  run_asimov
+  [[ "$output" == *"No new directories to exclude"* ]]
+}