Added course's notes
This commit is contained in:
1 parent
e07993262c
commit
dcd2c072ae
191 files changed
+42866
-12
No files matched your search
Executable
+93
@@ -0,0 +1,93 @@
|
||||
#!/usr/bin/env bash
|
||||
# sync.sh — copy this notes extension to every other course
|
||||
#
|
||||
# _extensions/notes/sync.sh [--dry-run] [--force]
|
||||
#
|
||||
# Run it from the course where you changed the extension: its
|
||||
# _extensions/notes/ is copied to the Notes folder's own _extensions/notes/
|
||||
# and to <every course>/_extensions/notes/ (the Notes folder is the one
|
||||
# holding _course/).
|
||||
#
|
||||
# Each copy keeps a .sync-manifest: the checksums of what it received. A copy
|
||||
# whose files no longer match it was edited in place; sync.sh then skips it
|
||||
# and shows what differs, so a change made in another course is never lost.
|
||||
# Bring that change here first, or overwrite it with --force.
|
||||
# A copy with a higher `version:` in _extension.yml is skipped the same way.
|
||||
#
|
||||
# --dry-run only report what would happen
|
||||
# --force overwrite edited or newer copies too
|
||||
|
||||
set -euo pipefail
|
||||
|
||||
dry=false force=false
|
||||
for a in "$@"; do
|
||||
case "$a" in
|
||||
--dry-run) dry=true ;;
|
||||
--force) force=true ;;
|
||||
-h|--help) sed -n '2,/^$/{s/^# \{0,1\}//;p}' "$0"; exit 0 ;;
|
||||
*) echo "sync: unknown option $a" >&2; exit 1 ;;
|
||||
esac
|
||||
done
|
||||
|
||||
src="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||
MANIFEST=.sync-manifest
|
||||
|
||||
root="$src"
|
||||
while [ "$root" != "/" ] && [ ! -d "$root/_course" ]; do root="$(dirname "$root")"; done
|
||||
[ -d "$root/_course" ] || { echo "sync: no folder holding _course/ above $src" >&2; exit 1; }
|
||||
|
||||
# checksums of an extension copy, manifest excluded
|
||||
sums() { (cd "$1" && find . -type f ! -name "$MANIFEST" -printf '%P\n' | LC_ALL=C sort | xargs -d '\n' md5sum); }
|
||||
version() { sed -n 's/^version:[[:space:]]*//p' "$1/_extension.yml" 2>/dev/null | tr -d '"'"'"; }
|
||||
newer() { [ "$1" != "$2" ] && [ "$(printf '%s\n%s\n' "$1" "$2" | sort -V | tail -n 1)" = "$1" ]; }
|
||||
|
||||
src_sums="$(sums "$src")"
|
||||
src_version="$(version "$src")"
|
||||
$dry || printf '%s\n' "$src_sums" > "$src/$MANIFEST"
|
||||
|
||||
targets=()
|
||||
[ -d "$root/_extensions/notes" ] && targets+=("$root/_extensions/notes")
|
||||
for d in "$root"/*/_extensions/notes; do [ -d "$d" ] && targets+=("$d"); done
|
||||
|
||||
status=0
|
||||
for t in "${targets[@]}"; do
|
||||
t="$(cd "$t" && pwd)"
|
||||
[ "$t" = "$src" ] && continue
|
||||
name="${t#"$root"/}"
|
||||
cur="$(sums "$t")"
|
||||
|
||||
if [ "$cur" = "$src_sums" ]; then
|
||||
echo "up to date $name"
|
||||
$dry || printf '%s\n' "$src_sums" > "$t/$MANIFEST"
|
||||
continue
|
||||
fi
|
||||
reason=""
|
||||
if [ ! -f "$t/$MANIFEST" ]; then
|
||||
reason="never synced, may hold its own changes"
|
||||
elif [ "$cur" != "$(cat "$t/$MANIFEST")" ]; then
|
||||
reason="edited since its last sync"
|
||||
elif newer "$(version "$t")" "$src_version"; then
|
||||
reason="has a newer version ($(version "$t") > $src_version)"
|
||||
fi
|
||||
if [ -n "$reason" ] && ! $force; then
|
||||
echo "SKIPPED $name: $reason"
|
||||
diff -rq --exclude="$MANIFEST" "$src" "$t" | sed "s|$root/||g; s|^| |" || true
|
||||
status=1
|
||||
continue
|
||||
fi
|
||||
|
||||
if $dry; then
|
||||
echo "would update $name${reason:+ (forced: $reason)}"
|
||||
continue
|
||||
fi
|
||||
# mirror: drop files the source no longer has, then copy everything over
|
||||
(cd "$t" && find . -type f ! -name "$MANIFEST" -printf '%P\n') | while IFS= read -r f; do
|
||||
[ -e "$src/$f" ] || rm -f "$t/$f"
|
||||
done
|
||||
cp -a "$src/." "$t/"
|
||||
printf '%s\n' "$src_sums" > "$t/$MANIFEST"
|
||||
echo "updated $name${reason:+ (forced: $reason)}"
|
||||
done
|
||||
|
||||
[ $status -eq 0 ] || echo "some copies were skipped: bring their changes here, or rerun with --force"
|
||||
exit $status
|
||||
Reference in new issue
Block a user