02.17 Работа с git

• Правила работы с git, которые следует соблюдать при решении Д/З
  1. «Одно изменение — один коммит».
     • Какие бывают изменения в Д/З?
       • Дописал недописанное
       • Исправил багу
       • Добавил тест
       • …
  2. «Дескриптивное описание»
     • Если изменение атомарно — достаточно однострочника

     • Если в нескольких файлах или изменение неатомарно (например, добавил тест, словил ошибку, сделал коммит с ошибкой и тестом) — нужно и атомарное, и развёрнутое описание

     • Также развёрнутое описание нужно, чтобы пояснить, что именно сделано
  3. «Ответственная публикация» (см. лекцию)

• (Внимание! Не является лекарстД/З!)

  • Заводим --bare-репозиторий в каталоге repo (он будет «публичным)

  • дважды клонируем его в локальные репозитории repo1 и repo2

  • в repo1 создаём файл, делаем коммит, смотрим статус, делаем push

  • в repo2 делаем pull, правим файл, делаем коммит и push

  • в repo1 делаем pull

  • если будет время — вместо pull делаем fetch и merge origin/имя_ветки (вариант — master или main)

  • Должно получиться три репозитория с одинаковой историей
• Иллюстрации по структуре объектов git-репозитория:
  • Первый коммит с простой структурой (файлы в одном каталоге):

    

  • Первый коммит с файлами в нескольких каталогах:

    

  • История из нескольких последовательных коммитов:

    

• Замечания по структуре объектов

  • Заголовок, в котором лежит строка вида «b"тип_объекта размер"», отделяется от содержимого нулевым байтом. Удобно пользоваться методом .partition(b'\x00')

  • Объект типа blob — это просто содержимое файла

  • Объект типа tree:

    • b'tree размер'	b'\x00'
      b'атрибуты имя'	b'\x00'	ID = bytes[20]
      b'атрибуты имя'	b'\x00'	ID = bytes[20]
      …
      b"атрибуты имя"	b'\x00'	ID = bytes[20]

  • Объект типа commit — текстовый, строки до первой пустой — служебные, вида b"Поле содержание" (нам важно поле parent, если оно есть)

    • Полей "parent" в коммите может быть любое (?) число, точно бывает 0, 1 и 2 штуки

  • Коммит ID, соответствующие HEAD различных веток, лежат в файле .git/refs/heads/имя_ветки

• Простой просмотр (вывод b''-сроки) произвольного объекта из .git/objects/??/*

  • понадобится zlib.decompress()

• Простой просмотр всех объектов (в комндной строке — каталог, скорее всего ../../.git/objects)

  • понадобится glob.iglob()

• Просмотр объекта типа commit

• Просмотр объекта типа tree с выводом имён файлов и их commit ID

• В результате должно получиться примерно это

  • TODO: переписать пример на Pathlib

• Задача_0: сделать коммит и push для отметки посещаемости.

• Задача_1: напишите программу-просмотрщик git-репозитория, оформите её функциональность в виде нескольких коммитов. Коммиты должны соответствовать добавлению к программе следующих возможностей: (примеры показывают формат вывода)

  1. Первый параметр — путь к каталогу с репозиторием. Без других параметров программа выводит имена всех веток; дальнейшие требования относятся к запуску программы со вторым параметром — именем ветки.

     master
     lomaster

  2. Вывести объект-последний коммит (последний коммит указанной ветки).

     tree 3182cbd0e8b2baecbdc693008ed832b25546e225
     parent f97190bd4dea21041d1cd7fcf822cd4ac6e7716b
     author Ivan Samovarov <isamovarov@mail.ru>
     committer Elec Tropoezd <elec@tropoe.zd>
     
     Added a very important feature.

  3. Вывести объект-дерево, на который указывает последний коммит ветки (поддеревья обрабатывать не нужно).

     blob cf1ab25da0349f84a3fdd40032f0ce99db813b8b    LICENSE
     blob f99151731324e7ac98281272c68f2b599dbf868d    Makefile
     tree b6e86ab64d77628cff4cfcaaf9133533733f8553    Tests

  4. Пройти по истории от последнего к начальному коммиту ветки, для каждого коммита вывести объект-дерево
     • В случае нескольких родительских коммитов выбирать первый, топологией не заморачиваться.
     • "TREE" большими буквами выделяет строку, где сказано, дерево для какого коммита выводится.

       TREE for commit f5980e79c7f010f38d249390248936dd0ae58a3a
       blob cf1ab25da0349f84a3fdd40032f0ce99db813b8b    LICENSE
       blob f99151731324e7ac98281272c68f2b599dbf868d    Makefile
       tree b6e86ab64d77628cff4cfcaaf9133533733f8553    Tests
       TREE for commit f97190bd4dea21041d1cd7fcf822cd4ac6e7716b
       blob cf1ab25da0349f84a3fdd40032f0ce99db813b8b    LICENSE
       blob 2cb7f6e3ff1a5d1ab379d953dbc7b5738d1dfed3    Makefile
       tree b6e86ab64d77628cff4cfcaaf9133533733f8553    Tests

Д/З

• Доделать задачу и опубликовать её по стандартным правилам

• При публикации следовать рекомендациям оформления commit message

  * Сделать тесты Можно (и нужно) исправить старые commit message с помощью reword