Отмена ошибки

Разберите каждую правку по таблице «где ошибка». Порядок важен: что мешает забрать правку Бориса?

about.html — git restore; черновик — git stash push -m …; затем git pull --ff-only и git stash pop.

Хеш ошибочного коммита найдёт git log -S 9000 --oneline. Дальше git revert --no-edit <хеш>, git push, и git pull --ff-only у Бориса.

Блоки работают только в отдельной учебной папке ~/git-course. При неожиданном состоянии они отказывают до записи; ошибка после начала подготовки может оставить часть действий выполненной. Сначала прочитайте сообщение, не удаляйте существующие файлы. Для продолжения после предыдущей главы выбирайте только нужный блок.

Перед главой 7

Конец главы 6: оба клона совпадают с общим репозиторием. Выполняется после блока «Перед главой 6». Если в клонах нет своих неотправленных коммитов, блок сам заберёт в них последние изменения (git pull --ff-only).

bash <<'SETUP'
rp_before7() {
  # --- Проверки: ничего не меняют ---
  fail() { echo "Отказ: $1"; echo "Ничего не изменено."; return 1; }
  course_repo() {
    [ -d "$1/.git" ] || { fail "$1 — нет такого репозитория Git"; return 1; }
    git -C "$1" log --max-parents=0 --format=%s 2>/dev/null | grep -qx 'Первая версия учебного сайта' \
      || { fail "$1 — не учебный репозиторий курса"; return 1; }
  }
  quiet() {  # папка, ожидаемая ветка, разрешённые неотслеживаемые файлы через пробел
    local x f
    [ "$(git -C "$1" symbolic-ref --short -q HEAD)" = "$2" ] || { fail "в $1 текущая ветка не $2"; return 1; }
    for x in MERGE_HEAD REVERT_HEAD CHERRY_PICK_HEAD REBASE_HEAD; do
      git -C "$1" rev-parse -q --verify "$x" >/dev/null && { fail "в $1 не завершена операция Git ($x) — завершите или отмените её"; return 1; }
    done
    for x in rebase-merge rebase-apply; do
      [ -e "$(git -C "$1" rev-parse --git-path "$x")" ] && { fail "в $1 не завершён rebase"; return 1; }
    done
    [ -z "$(git -C "$1" status --porcelain --untracked-files=no)" ] || { fail "в $1 есть незакоммиченные изменения"; return 1; }
    for f in $(git -C "$1" ls-files --others --exclude-standard); do
      case " $3 " in *" $f "*) ;; *) fail "в $1 лишний неотслеживаемый файл $f"; return 1 ;; esac
    done
  }
  last_is() { [ "$(git -C "$1" log -1 --format=%s)" = "$2" ] || { fail "в $1 последний коммит не «$2»"; return 1; }; }
  no_branch() { ! git -C "$1" show-ref --verify -q "refs/heads/$2" || { fail "в $1 уже есть ветка $2"; return 1; }; }
  absent() { [ ! -e "$1" ] || { fail "$1 уже существует — переименуйте её сами, если хотите начать заново"; return 1; }; }
  clone_ok() {  # клон курса: связан с общим репозиторием, все его коммиты уже там
    course_repo "$1" || return 1
    [ "$(git -C "$1" remote get-url origin 2>/dev/null)" = "$HOME/git-course/remote/site.git" ] \
      || { fail "$1 не связан с ~/git-course/remote/site.git"; return 1; }
    git -C ~/git-course/remote/site.git merge-base --is-ancestor "$(git -C "$1" rev-parse main)" main 2>/dev/null \
      || { fail "в $1 есть коммиты, которых нет в общем репозитории — отправьте или разберите их"; return 1; }
  }
  command -v git >/dev/null || { fail "не найден git"; return 1; }
  local c
  for c in anna-site boris-site; do  # сначала проверить оба клона
    clone_ok ~/git-course/$c || return 1
    quiet ~/git-course/$c main "" || return 1
  done
  # --- Подготовка: после первой записи при ошибке скрипт останавливается ---
  (
    set -e
cd ~/git-course/anna-site
git pull -q --ff-only
cd ~/git-course/boris-site
git pull -q --ff-only
  )
  if [ $? -ne 0 ]; then
    echo "Ошибка после начала подготовки: часть шагов могла выполниться."
    echo "Посмотрите git status и git log --oneline --all -5. Начать заново: переименуйте ~/git-course"
    echo "(mv ~/git-course ~/git-course-old) и выполните блоки этого файла с начала."
    return 1
  fi
  echo "anna-site: $(git -C ~/git-course/anna-site log -1 --format=%h), boris-site: $(git -C ~/git-course/boris-site log -1 --format=%h)"
  echo "Готово: оба клона совпадают с общим репозиторием."
}
rp_before7 </dev/null
SETUP

Оба хеша в итоговой строке должны совпасть.

Стеш в разборе главы 7

Борис отправляет правку расписания — нужно для пункта 4 разбора главы 7.

bash <<'SETUP'
rp_stash7() {
  # --- Проверки: ничего не меняют ---
  fail() { echo "Отказ: $1"; echo "Ничего не изменено."; return 1; }
  course_repo() {
    [ -d "$1/.git" ] || { fail "$1 — нет такого репозитория Git"; return 1; }
    git -C "$1" log --max-parents=0 --format=%s 2>/dev/null | grep -qx 'Первая версия учебного сайта' \
      || { fail "$1 — не учебный репозиторий курса"; return 1; }
  }
  quiet() {  # папка, ожидаемая ветка, разрешённые неотслеживаемые файлы через пробел
    local x f
    [ "$(git -C "$1" symbolic-ref --short -q HEAD)" = "$2" ] || { fail "в $1 текущая ветка не $2"; return 1; }
    for x in MERGE_HEAD REVERT_HEAD CHERRY_PICK_HEAD REBASE_HEAD; do
      git -C "$1" rev-parse -q --verify "$x" >/dev/null && { fail "в $1 не завершена операция Git ($x) — завершите или отмените её"; return 1; }
    done
    for x in rebase-merge rebase-apply; do
      [ -e "$(git -C "$1" rev-parse --git-path "$x")" ] && { fail "в $1 не завершён rebase"; return 1; }
    done
    [ -z "$(git -C "$1" status --porcelain --untracked-files=no)" ] || { fail "в $1 есть незакоммиченные изменения"; return 1; }
    for f in $(git -C "$1" ls-files --others --exclude-standard); do
      case " $3 " in *" $f "*) ;; *) fail "в $1 лишний неотслеживаемый файл $f"; return 1 ;; esac
    done
  }
  last_is() { [ "$(git -C "$1" log -1 --format=%s)" = "$2" ] || { fail "в $1 последний коммит не «$2»"; return 1; }; }
  no_branch() { ! git -C "$1" show-ref --verify -q "refs/heads/$2" || { fail "в $1 уже есть ветка $2"; return 1; }; }
  absent() { [ ! -e "$1" ] || { fail "$1 уже существует — переименуйте её сами, если хотите начать заново"; return 1; }; }
  clone_ok() {  # клон курса: связан с общим репозиторием, все его коммиты уже там
    course_repo "$1" || return 1
    [ "$(git -C "$1" remote get-url origin 2>/dev/null)" = "$HOME/git-course/remote/site.git" ] \
      || { fail "$1 не связан с ~/git-course/remote/site.git"; return 1; }
    git -C ~/git-course/remote/site.git merge-base --is-ancestor "$(git -C "$1" rev-parse main)" main 2>/dev/null \
      || { fail "в $1 есть коммиты, которых нет в общем репозитории — отправьте или разберите их"; return 1; }
  }
  command -v git >/dev/null || { fail "не найден git"; return 1; }
  clone_ok ~/git-course/boris-site || return 1
  quiet ~/git-course/boris-site main || return 1
  # --- Подготовка: после первой записи при ошибке скрипт останавливается ---
  (
    set -e
cd ~/git-course/boris-site
git pull -q --ff-only
sed -i 's|<li>Вторник, 19:00 — Git: основы</li>|<li>Вторник, 19:00 — Git: основы (ауд. 12)</li>|' schedule.html
git commit -q -am "Указать аудиторию для вторника"
git push -q
  )
  if [ $? -ne 0 ]; then
    echo "Ошибка после начала подготовки: часть шагов могла выполниться."
    echo "Посмотрите git status и git log --oneline --all -5. Начать заново: переименуйте ~/git-course"
    echo "(mv ~/git-course ~/git-course-old) и выполните блоки этого файла с начала."
    return 1
  fi
  git -C ~/git-course/boris-site log --oneline -1
  echo "Готово: Борис отправил правку расписания."
}
rp_stash7 </dev/null
SETUP

Практика главы 7

Если в папке Анны остался черновик про пятницу из разбора, сначала сохраните его: cd ~/git-course/anna-site && git add schedule.html && git commit -m "Добавить консультацию в пятницу" && git push. Неотслеживаемый notes.txt в клоне Анны можно оставить — это единственный разрешённый лишний файл.

bash <<'SETUP'
rp_practice7() {
  # --- Проверки: ничего не меняют ---
  fail() { echo "Отказ: $1"; echo "Ничего не изменено."; return 1; }
  course_repo() {
    [ -d "$1/.git" ] || { fail "$1 — нет такого репозитория Git"; return 1; }
    git -C "$1" log --max-parents=0 --format=%s 2>/dev/null | grep -qx 'Первая версия учебного сайта' \
      || { fail "$1 — не учебный репозиторий курса"; return 1; }
  }
  quiet() {  # папка, ожидаемая ветка, разрешённые неотслеживаемые файлы через пробел
    local x f
    [ "$(git -C "$1" symbolic-ref --short -q HEAD)" = "$2" ] || { fail "в $1 текущая ветка не $2"; return 1; }
    for x in MERGE_HEAD REVERT_HEAD CHERRY_PICK_HEAD REBASE_HEAD; do
      git -C "$1" rev-parse -q --verify "$x" >/dev/null && { fail "в $1 не завершена операция Git ($x) — завершите или отмените её"; return 1; }
    done
    for x in rebase-merge rebase-apply; do
      [ -e "$(git -C "$1" rev-parse --git-path "$x")" ] && { fail "в $1 не завершён rebase"; return 1; }
    done
    [ -z "$(git -C "$1" status --porcelain --untracked-files=no)" ] || { fail "в $1 есть незакоммиченные изменения"; return 1; }
    for f in $(git -C "$1" ls-files --others --exclude-standard); do
      case " $3 " in *" $f "*) ;; *) fail "в $1 лишний неотслеживаемый файл $f"; return 1 ;; esac
    done
  }
  last_is() { [ "$(git -C "$1" log -1 --format=%s)" = "$2" ] || { fail "в $1 последний коммит не «$2»"; return 1; }; }
  no_branch() { ! git -C "$1" show-ref --verify -q "refs/heads/$2" || { fail "в $1 уже есть ветка $2"; return 1; }; }
  absent() { [ ! -e "$1" ] || { fail "$1 уже существует — переименуйте её сами, если хотите начать заново"; return 1; }; }
  clone_ok() {  # клон курса: связан с общим репозиторием, все его коммиты уже там
    course_repo "$1" || return 1
    [ "$(git -C "$1" remote get-url origin 2>/dev/null)" = "$HOME/git-course/remote/site.git" ] \
      || { fail "$1 не связан с ~/git-course/remote/site.git"; return 1; }
    git -C ~/git-course/remote/site.git merge-base --is-ancestor "$(git -C "$1" rev-parse main)" main 2>/dev/null \
      || { fail "в $1 есть коммиты, которых нет в общем репозитории — отправьте или разберите их"; return 1; }
  }
  command -v git >/dev/null || { fail "не найден git"; return 1; }
  clone_ok ~/git-course/anna-site || return 1
  quiet ~/git-course/anna-site main "notes.txt" || return 1
  clone_ok ~/git-course/boris-site || return 1
  quiet ~/git-course/boris-site main || return 1
  # --- Подготовка: после первой записи при ошибке скрипт останавливается ---
  (
    set -e
cd ~/git-course/anna-site && git pull -q --ff-only
cd ~/git-course/boris-site && git pull -q --ff-only
cd ~/git-course/anna-site
sed -i 's/^PORT=8082/PORT=9000/' site.conf
git commit -q -am "Перейти на порт 9000"
git push -q
cd ~/git-course/boris-site
git pull -q --ff-only
sed -i 's|<li>Четверг, 19:00 — практика</li>|<li>Четверг, 19:00 — практика (ауд. 14)</li>|' schedule.html
git commit -q -am "Указать аудиторию для четверга"
git push -q
cd ~/git-course/anna-site
sed -i 's|<ul>|&\n<li>Понедельник — выходной</li>|' schedule.html
sed -i '/Почта для вопросов/d' about.html
git status --short
  )
  if [ $? -ne 0 ]; then
    echo "Ошибка после начала подготовки: часть шагов могла выполниться."
    echo "Посмотрите git status и git log --oneline --all -5. Начать заново: переименуйте ~/git-course"
    echo "(mv ~/git-course ~/git-course-old) и выполните блоки этого файла с начала."
    return 1
  fi
  echo "Готово: ситуация практики главы 7 создана."
}
rp_practice7 </dev/null
SETUP

В конце блок покажет M about.html, M schedule.html (и ?? notes.txt, если он остался).

Лист ученика: 07-undo.md. Хеши — из проверочного запуска.

Практика

Папка ~/git-course/anna-site. Сначала разберём, где что:

git status --short
git diff about.html

 M about.html
 M schedule.html
…
-<p>Почта для вопросов: course@example.invalid.</p>

1. Случайная правка в папке — вернуть файл:

git restore about.html

2. Нужный черновик мешает забрать изменения — убрать на время:

git stash push -m "Черновик: понедельник"
git pull --ff-only
git stash pop

Updating 7550449..7c40f94
Fast-forward
 schedule.html | 2 +-
…
Dropped refs/stash@{0} (…)

Правка Бориса (аудитория 14) и черновик Анны — в разных строках, pop соединил их без конфликта.

3. Отправленный ошибочный коммит — отменить новым коммитом:

git log -S 9000 --oneline

7550449 Перейти на порт 9000

git revert --no-edit 7550449   # подставьте свой хеш из git log -S
git push
grep PORT site.conf

[main aac7e0a] Revert "Перейти на порт 9000"
…
To /root/git-course/remote/site.git
   7c40f94..aac7e0a  main -> main
PORT=8082

revert прошёл, хотя в папке есть черновик: отменяемый коммит меняет site.conf, а черновик — schedule.html.

4. У Бориса:

cd ~/git-course/boris-site
git pull --ff-only
grep PORT site.conf

PORT=8082

Итог в anna-site: git status --short → M schedule.html (черновик), git stash list пуст.

Допустимо: закоммитить черновик вместо stash, если он готов, — но тогда это осознанный коммит с сообщением, а не «временный». Недопустимо: git reset --hard (уничтожит черновик), git push --force (затрёт коммит Бориса), git checkout -- ./git restore . без разбора (выбросит и черновик вместе с ошибкой).

Воспроизведено: Git 2.43.0, Ubuntu 24.04.

Проверка понимания

1. Подходит: revert безопасен всегда, просто в истории останутся ошибка и её отмена. Пока коммит не отправлен, можно и «переделать» его (git commit --amend, git reset без --hard) — это вне курса, и риск у них есть: неверный ключ reset выбросит правки. Главное правило — переписывать можно только то, что никто, кроме вас, ещё не получил.
2. git restore файл выбрасывает незакоммиченную правку безвозвратно — нужно убедиться, что выбрасываете ошибку. git restore --staged файл только убирает файл из индекса; правка остаётся в папке, ничего не теряется.