обзор hg — полезный бонус для mercurial У Git есть GitHub, а у Mercurial — обзор hg. На самом деле я сравнил козу с мясником.
Обзор кода.
Если вы искали открытую, бесплатную, быструю, небольшую, удобную и красивую систему для проверки кода, то, скорее всего, вы потерпели неудачу.
Из существующих проектов я смотрел ReviewBoard, но, как и все, созданное крутыми компаниями, он сложен в установке, настройке и предполагает не совсем привычный для нас сценарий поведения.
И вот появился проект, который дает нам инструмент, но как им пользоваться – решать нам.
Общий:
- Обзор после фиксации
- Распределенная архитектура
- веб интерфейс
- Приятный (!) внешний вид.
Монтаж.
Установка происходит так же, как и все другие невстроенные расширения для Mercurial: > cd some_cool_place
> hg clone bitbucket.org/sjl/hg-review
Добавляем в наш ~/.
hgrc: [extensions]
review = [path to]/hg-review/review/
Готовый.
Настройка.
Для начала скажу, что hg review работает так: Мы должны создать своего рода общедоступный репозиторий, куда все разработчики смогут помещать/забирать код. Далее мы включаем поддержку проверки кода для нашего основного репозитория и одновременно указываем наш публичный репозиторий для хранения всех обзоров.
При работе hg review будет брать код на проверку из нашего основного репозитория разработки, а все комментарии будут помещаться в репозиторий рецензий.
Почему это делается именно так? Потому что это позволяет нам не засорять наш основной репозиторий лишними, ненужными коммитами.
Ведь в процессе своей работы он будет генерировать определённый набор файлов и в принципе каждый комментарий может стать причиной коммита.
Вместо этого при инициализации в вашем репозитории будет создан файл .
hgreview с одной единственной строкой: указанием репозитория для хранения обзора.
Кроме того, в вашем локальном репозитории будет создан каталог проверки в .
hg/, который будет служить рабочей копией этого удаленного репозитория для проверки.
То есть для обеспечения всей функциональности наш основной репозиторий пострадает только один раз, когда будет коммит с созданием .
hgreview.
Этот файл необходим для того, чтобы другие разработчики не заморачивались с поддерживаемым обзором hg.
Мы идем в существующий репозиторий, где хотим просмотреть код. > hg review --init --remote-path [url-of-remote-public-review-repo]
Готовый.
Другим разработчикам будет достаточно выполнить один раз: > hg review --init
Эта команда на основе информации из .
hgreview создаст скрытый репозиторий и подготовит всё к работе.
Теперь, чтобы использовать систему, которую мы запустим > hg review --web
когда нам это нужно.
Все действия, необходимые для функционирования системы, можно выполнить из веб-интерфейса.
Добавляем комментарии, нажимаем «Push to default» и наши комментарии попадут в публичный репозиторий для проверки.
Соответственно, чтобы подобрать новые комментарии, мы делаем «тянуть по умолчанию».
Давайте воспользуемся этим.
Итак, основные возможности, которые нам предоставляет hg review:
- Комментарии к наборам изменений
- Подписи (да/нет/нейтрально) для наборов изменений
- Самое интересное: комментарии к строкам кода из ревизии.
Мы можем комментировать чужой код, читать комментарии к своему коду и синхронизировать эти изменения с помощью веб-интерфейса.
Проект сравнительно молодой, в основном делается одним человеком, но то, что у нас уже есть, дает надежду, что мы получим очень и очень полезный инструмент.
Недостатки (надеюсь временные).
На данный момент мы обнаружили несколько недостатков, в том числе:
- Сравнительно медленная работа.
Для его работы используются только простые инструменты (текстовые файлы, которые лучше всего поддерживаются VCS) и инструменты самого Mercurial, такие как commit, push, pull, что очень идеологично и правильно.
Будем надеяться, что есть способы повысить оперативность.
Но все это не критично для армии.
Я гарантирую это!
- Вы можете редактировать комментарии, оставленные другим пользователем.
Инструментов авторизации нет, поскольку идентификация пользователя осуществляется по имени пользователя из файла настроек Mercurial. Кроме того, для тех, кто совсем не в курсе, предупреждение: поскольку Mercurial придерживается принципа неизменности истории, удалить упоминание о редактировании комментария невозможно.
это можно отследить, если посмотреть журнал hg в репозитории обзоров.
Возможно, это поможет.
- Если вы не видите изменений набора изменений diff, убедитесь, что у вас не установлен diff = git в .
hgrc.
Ссылки.
Демо: обзор.
stevelosh.com Репозиторий: bitbucket.org/sjl/hg-review/src Документация: sjl.bitbucket.org/hg-review Теги: #проверка кода #проверка кода #hg #Mercurial #открытый исходный код
-
Если Вы Нашли Scrum
19 Oct, 24 -
Как Греф Боролся С Программистами
19 Oct, 24 -
Сумасшедший Искусственный Интеллект
19 Oct, 24