- PVSM.RU - https://www.pvsm.ru -
[Пятничное]
Всегда хотел сделать свой график активности пользовательского профиля на Гитхабе. Например, выкладывать коммиты каждый день так, чтобы через год этот график превратился в какую-нибудь картинку, пусть и с ограничением по размерам в 52×7 квадратиков-пикселей (52 недели в году × 7 дней в неделе).
Проблема была в том, что даже при полной автоматизации процесса всё равно ждать целый год. А тут я почитал документацию Гитхаба и понял, что задача решается проще и более того — за один раз. А значит, надо делать не откладывая. Обычно названия проектам придумывать сложно, но тут оно пришло само. Кай рисовал льдинками, а Герда рисует коммитами [1]!
Используется существующее на данный момент (преднамеренное?) поведение Гитхаба при построении графика активности, учитывающее предоставленные клиентом локальные даты коммитов. Подробнее эту тему можно изучить в справке сервиса [3].
А поскольку Гитхаб доверяет локальным датам, указанным в коммите, можно отправить ему сколько угодно коммитов с какими угодно датами:
echo "С Новым годом тебя, часовой пояс +3!" >> gerda.md
git add gerda.md
git commit -m "Правки к Новому году" --date="0001-01-01T00:00:00+0300"
Таким образом, наша задача состоит в автоматизации самого процесса создания коммитов с нужными датами. Говоря проще, надо написать скрипт, который генерирует скрипт, который создаёт нужные коммиты. По пути ещё надо не забыть, что график профиля использует недели с воскресным, а не понедельничным первым днём.
Лучше всего скриптам скармливать картинки в более-менее человекочитаемом формате, например, массивом строк или вообще реальные файлы изображений. Я для простоты парсинга сделал строки. Гитхаб отображает пять разных оттенков цвета в графике, чем темнее оттенок, тем больше активность пользователя в заданный день. Возьмём для примера три:
Например, напишем слово „ПРИВЕТ“ (используем звёздочку в качестве антиалиасинга для „плавных“ переходов):
$commits = [
/* columns
' 10→| 20→| 30→| 40→| 50→| ' ← exactly 52 characters */
' ####### #####* # # ##### ###### ####### ', // Sun
' # # # # # ## # # # # ', // Mon
' # # # # # # # # * # # ', // Tue
' # # #####* # # # ##### ##### # ', // Wed
' # # # # # # # # # # ', // Thu
' # # # ## # # # # # ', // Fri
' # # # # # #####* ###### # ', // Sat
];
Лучше оставлять по паре недель (пробелов) слева и справа — чтобы меньше мешала текущая активность.
Теперь самое сложное — разобрать этот массив, соотнеся каждый символ в нём с каким-то определённым днём. У меня получилось так:
/**
* Генерация набора коммитов.
*
* @param string[] $map Карта коммитов в виде массива из 7 строк по 52 символа каждая
* @param DateTime $firstSunday Дата последнего воскресенья год назад
* @return array
*/
function generateCommits($map, $firstSunday)
{
$commits = [];
$count = 7 * 52;
$date = clone $firstSunday;
// Идём по всем символам карты коммитов, вычисляя неделю и день недели
for ($day = 0, $weekDay = 0; $day < $count; $day++) {
$week = intval($day / 7);
$char = substr($map[$weekDay], $week, 1);
if ($char !== ' ') {
$commits[$date->format('Y-m-d')] = $char === '#' ? 20 : 10;
}
// Переходим к следующему дню
$date->add(new DateInterval('P1D'));
$weekDay = ($weekDay + 1) % 7;
}
return $commits;
}
В результате получаем ассоциативный массив (словарь), где ключ — день недели, а значение — количество коммитов, необходимых в этот день:
$commits = [
// ...
'2016-01-31' => 10,
'2016-02-01' => 20,
'2016-02-02' => 20,
'2016-02-03' => 10,
// ...
]
Дальше всё совсем просто: проходим по этому словарю и пишем в результирующий шелл-скрипт нужное количество коммитов для каждого дня (для часового пояса я использовал московское время). В качестве подопытного файла используем маркдаун-документ, в текст которого с каждым коммитом добавляем день или какую-нибудь другую информацию (у меня это маркированный список с номером коммита в этот день):
git init
echo "# Gerda" > gerda.md
echo "n## 2016-01-31" >> gerda.md
echo "* Gerda №1" >> gerda.md
git add gerda.md
git commit -m "Gerda №1" --date="2016-01-31T12:00:00+0300"
# ... так 10 раз ...
echo "n## 2016-02-01" >> gerda.md
echo "* Gerda №1" >> gerda.md
git add gerda.md
git commit -m "Gerda №1" --date="2016-02-01T12:00:00+0300"
# ... так 20 раз ...
echo "n## 2016-02-02" >> gerda.md
echo "* Gerda №1" >> gerda.md
git add gerda.md
git commit -m "Gerda №1" --date="2016-02-02T12:00:00+0300"
# ... так 20 раз ...
echo "n## 2016-02-03" >> gerda.md
echo "* Gerda №1" >> gerda.md
git add gerda.md
git commit -m "Gerda №1" --date="2016-02-03T12:00:00+0300"
# ... так 10 раз ...
Программирование логики готово. Вынесем все нужные настройки в один файл settings.php
, чтобы отделить данные от логики:
// Streak graph picture
$commits = [ ... ];
// Repository origin
$origin = 'https://github.com/maximal/gerda.git';
// Output shell file
$commandFile = 'repo' . DIRECTORY_SEPARATOR . 'make-commits.sh';
Разумеется, чтобы Гитхаб понял, от какого пользователя были произведены коммиты, в настройках Гита должны стоять ваш логин и почтовый ящик:
# ~/.gitconfig
[user]
name = my_github_username
email = my_github_email@ya.ru
### ...
Придумываем нужный нам график активности. Пишем желаемую картинку в настройках. Запускаем то, что получилось:
Ой, пятница от радости выпрыгнула за ограничение в 52 символа. Поправим:
Скрипт с коммитами создан, запустим его:
cd repo
./make-commits.sh
По окончании работы скрипта (как правило, там пара тысяч коммитов: придётся подождать минутку), Гитхаб спросит ваш пароль. Вводить пароли в чужие (а иногда и в свои) скрипты некруто, поэтому, если хотите, можете завершить скрипт на этом шаге и запушить потом самостоятельно (в сгенерированном скрипте честно-честно только команда git push
):
git remote add origin https://github.com/<MY>/<REPO>.git
git push -u origin master -f
Ждём пару минут (разумно полагать, что эти данные у Гитхаба кешируются), обновляем страницу профиля.
Готово.
Весь исходный код и его описание лежат на (сюрприз!) Гитхабе: https://github.com/sijeko/gerda [1]
Будут пулреквесты — заходите на огонёк.
Живая картинка активности на примере моего профиля: https://github.com/maximal [4]
Чего программа не умеет, и что можно доработать:
Автор: MaximAL
Источник [5]
Сайт-источник PVSM.RU: https://www.pvsm.ru
Путь до страницы источника: https://www.pvsm.ru/php-2/232871
Ссылки в тексте:
[1] Герда рисует коммитами: https://github.com/sijeko/gerda
[2] Image: https://habrahabr.ru/post/319298/#habracut
[3] справке сервиса: https://help.github.com/articles/why-are-my-contributions-not-showing-up-on-my-profile/
[4] https://github.com/maximal: https://github.com/maximal
[5] Источник: https://habrahabr.ru/post/319298/?utm_source=habrahabr&utm_medium=rss&utm_campaign=best
Нажмите здесь для печати.