Pull request (запрос на вливание изменений) - важная часть использования Git'а. В этой статье мы рассмотрим составление запроса на вливание изменений для нашего репозитория.
У вас должно быть хорошее понимание того, как работают запросы и какие шаги необходимо предпринять. После этого мы сможем рассмотреть создание запросов на вливание изменений для внешних репозиториев.
Создание нашей функции
Запрос на вливание изменений - это способ уведомить других людей о том, что функция завершена и готова к слиянию с нашим репозиторием. Вы создаете pull request, и, как правило, другой разработчик просматривает ваш код, а затем дает комментарии к нему.
Возьмем демонстрационный проект, который мы только что создали. Это обычный пустой git-проект. Давайте добавим в него новый файл index.js:
const http = require('http');
const hostname = '127.0.0.1';
const port = 3000;
const server = http.createServer((req, res) => {
res.statusCode = 200;
res.setHeader('Content-Type', 'text/plain');
res.end('Helo World');
});
server.listen(port, hostname, () => {
console.log(`Server running at http://${hostname}:${port}/`);
});
Таким образом мы запустили простой node server.
Давайте зафиксируем и перенесем эти изменения в новую ветку:
# Создаем новую ветку
git checkout -b feature_node
# Добавляем изменения
git add .
# Фиксируем код
git commit -m "Added a node server"
# Переносим в ветку
git push origin feature_node
Если мы теперь перейдем на GitHub, мы увидим там ветку, и GitHub уже спрашивает нас, хотим ли мы создать новый PR с этой веткой:
Создание pull request
Нажмите на зеленую кнопку, чтобы создать запрос на вливание изменений. Он всегда сливается с одной ветки на другую. В нашем случае мы хотим объединиться с основной веткой.
Вы должны добавить описательное название и некоторое содержание о том, для чего нужен этот запрос:
Внизу вы можете увидеть, какие файлы были изменены, чтобы быстро проверить, все ли в порядке. Если это так, нажмите зеленую кнопку, чтобы создать запрос на вливание изменений.
Как правило, здесь вы назначаете одного из членов вашей команды.
Теперь запрос на исправление создан. Ваш член команды может оценить то, что вы сделали, и добавить отзыв:
Вы также можете просмотреть его самостоятельно, если откроете вкладку "Измененные файлы". Там вы можете нажать на строки или выбрать несколько строк, чтобы написать комментарии:
Не забудьте нажать кнопку "начать рецензирование". Когда вы закончите все пункты обзора, вы можете нажать кнопку "Завершить рецензирование", чтобы добавить общее замечание и одобрить или отклонить запрос:
Свои собственные PR вы можете только комментировать, но при рецензировании чужих запросов вы можете утверждать/запрашивать изменения. Теперь вам будет предложено добавить эти изменения в обзор PR:
Вернитесь к своему коду и добавьте предложенное изменение, после чего вы можете решить проблему и повторно запросить обзор.
Как только другой рецензент одобрит ваше изменение, вы можете нажать кнопку слияния, и файл будет объединен в основную ветку: