GIT — Git

GIT Репозиторий Git просматривается как папка: изменённые файлы, ветки, история.

Открыть репозиторий

Кнопка GIT на панели переходит к избранному проекту; её правая кнопка мыши даёт список: известные репозитории, «Коммит…», «История…», ветки, «Stash…» и «Отложенное», «Теги…», «Удалённые репозитории». Папка на диске, которая ещё не является репозиторием, предлагает там «Клонировать репозиторий сюда…». Проекты добавляются сами при входе в них, а проект, папка которого исчезла, забывается — кроме случая, когда отсутствует сам диск: отключённая флешка ничего не заставляет забыть.

Состояние папки

Каждая строка окрашена в свой цвет: с конфликтами, не отслеживается, изменён, проиндексирован, игнорируется. Файл описывается git по двум осям — индекс и рабочая копия, — а в одной строке нельзя показать обе: цвет определяет то, что осталось сделать. Строка пути показывает текущую ветку.

Подготовить и сделать коммит

«Коммит…» открывает вид изменений: по файлу в строке, столбец Отслеживается показывает, что git о нём знает. Строки отмечаются, как везде, — щелчком, Ctrl+щелчком, Shift+щелчком — сообщение пишется внизу, и Коммит уходит с тем, что выбрано. Ничего не выбрано — ничего не уходит: кнопка об этом сообщает.

Кнопка Неотслеживаемые на панели коммита скрывает то, что git не отслеживает: папка, полная одноразовых файлов, больше не заслоняет два нужных, и Ctrl+A больше их не захватывает. Отжатая, она показывает, сколько скрыто.

Показать различия

«Показать различия» открывает diff блок за блоком между рабочей копией, индексом (проиндексирован) и коммитом — до и после там названы. Двоичный файл просто сообщает об этом, а не показывает мусор.

Действия

• Коммит с его сообщением.
• Игнорировать: файл попадает в .gitignore.
• Откатить: окно сообщает, сколько новых файлов будет удалено с диска и у скольких восстановится состояние из репозитория. Незафиксированная работа теряется — об этом написано.
• Копировать › буфер обмена: строка изменений является файлом на диске и копируется как таковой — чтобы вставить его в другом месте, в том числе за пределами Meneaufile. Ни вырезать, ни вставить: список пересобирается git, из него нельзя убрать строку, и в него ничего не записывается.
• Открыть в его расположении: файл находится не там, где его строка, — она живёт в списке, а он — в рабочей копии, там, где его редактируют. Туда и ведёт этот пункт.

Ветки и история

Создать ветку, переключиться на неё, слить — пункт носит имя ветки и отвечает Вливать нечего: уже актуально или Слияние остановлено: часть файлов конфликтует. «История…» перечисляет коммиты: их короткий хеш, тему, автора, дату. Боковая полоса слева рисует граф, каждая строка на своём месте, а слияние проводит черту к соседнему столбцу. Двойной щелчок открывает подробности коммита: его полное сообщение и затронутые им файлы.

Дерево merge request’ов

Дерево merge request’ов… в меню кнопки GIT рисует открытые MR проекта GitLab, на который указывает удалённый репозиторий. Каждый стоит под веткой, от которой он отходит, с отступом на шаг, как оглавление: этап показывает порядок одобрения, а щелчок по карточке открывает MR в браузере.

• Происхождение читается по коммитам. MR, ответвлённый от другого, стоит под ним, даже если оба нацелены на main: «после !28» говорит, какой одобрить первым, а «цель main» предупреждает, что он всё ещё нацелен на main — слияние его первым унесло бы с собой коммиты другого.
• Значки показывают состояние по данным GitLab: черновик, конфликты, нужен rebase, ждёт одобрения, открытые обсуждения, идёт pipeline, готов.
• Кнопка Checkout в правом верхнем углу каждой карточки переключает рабочую копию на ветку MR, чтобы опробовать или просмотреть его перед одобрением. Ветка сначала загружается с сервера; незавершённую работу можно отложить, как при любой смене ветки. Галочка отмечает ветку, на которой вы уже находитесь.
• Персональный токен доступа с правом read_api создаётся в GitLab: User settings › Access › Personal access tokens › Generate token. Meneaufile запрашивает его один раз и хранит в сейфе, в отдельной карточке; карточка NET с паролем учётной записи за токен не принимается.

Обмен с удалённым репозиторием

«Pull» и «Push» с числом задействованных коммитов рядом с надписью — ноль не пишется. Ветка, которой ещё нет на другой стороне, уходит вместе со своей вышестоящей. Удалённые репозитории объявляются и убираются из того же меню. Когда сервер запрашивает данные для проверки подлинности, Meneaufile тоже запрашивает их, а не зависает, ничего не говоря.

Отложить

«Stash…» убирает текущую работу без коммита, с необязательным описанием; «Отложенное» — Отложенная работа — перечисляет то, что ждёт, и оттуда работу возобновляют или выбрасывают. «Теги…» так же ставят и убирают.

Кто написал эту строку

«Авторство строк» в меню файла приписывает каждую строку её коммиту и автору. Это вопрос, который задаёшь себе перед удивительной строкой, а список коммитов на него не отвечает.

Конфликты

Файл с конфликтом открывается на своих версиях: общая версия, наша, их и результат, который вы собираете. «Взять всё» переносит одну сторону целиком, «Разрешить» сохраняет — и файл выходит из категории с конфликтами.

Клонировать

Из папки: адрес (https://… или git@хост:org/depot.git), имя создаваемой папки и полная или неполная история — последние N коммитов.

Бандлы

Файл .bundle — это репозиторий Git, упакованный в один файл: так можно унести проект на флешке или передать его кому-то без сервера. Двойной щелчок показывает, что в нём, — его ветки, его теги, — а Клонировать сюда… превращает его в обычный репозиторий, рядом с ним, без сети. В репозитории Создать бандл… в меню GIT упаковывает его целиком в папку другого вида.

Если git отсутствует

Meneaufile вызывает системный git. Если его нет или он вне PATH, программа сообщает об этом, а не терпит неудачу без причины.

Руководство Meneaufile на русском языке.