Проверка Кода В Mercurial



обзор hg — полезный бонус для mercurial У Git есть GitHub, а у Mercurial — обзор hg. На самом деле я сравнил козу с мясником.



Проверка кода в Mercurial



Обзор кода.

Если вы искали открытую, бесплатную, быструю, небольшую, удобную и красивую систему для проверки кода, то, скорее всего, вы потерпели неудачу.

Из существующих проектов я смотрел ReviewBoard, но, как и все, созданное крутыми компаниями, он сложен в установке, настройке и предполагает не совсем привычный для нас сценарий поведения.

И вот появился проект, который дает нам инструмент, но как им пользоваться – решать нам.

Общий:

  • Обзор после фиксации
  • Распределенная архитектура
  • веб интерфейс
  • Приятный (!) внешний вид.


Проверка кода в Mercurial



Монтаж.

Установка происходит так же, как и все другие невстроенные расширения для Mercurial:

> cd some_cool_place > hg clone bitbucket.org/sjl/hg-review

Добавляем в наш ~/.

hgrc:

[extensions] review = [path to]/hg-review/review/

Готовый.



Проверка кода в Mercurial



Настройка.

Для начала скажу, что hg review работает так: Мы должны создать своего рода общедоступный репозиторий, куда все разработчики смогут помещать/забирать код. Далее мы включаем поддержку проверки кода для нашего основного репозитория и одновременно указываем наш публичный репозиторий для хранения всех обзоров.

При работе hg review будет брать код на проверку из нашего основного репозитория разработки, а все комментарии будут помещаться в репозиторий рецензий.

Почему это делается именно так? Потому что это позволяет нам не засорять наш основной репозиторий лишними, ненужными коммитами.

Ведь в процессе своей работы он будет генерировать определённый набор файлов и в принципе каждый комментарий может стать причиной коммита.

Вместо этого при инициализации в вашем репозитории будет создан файл .

hgreview с одной единственной строкой: указанием репозитория для хранения обзора.

Кроме того, в вашем локальном репозитории будет создан каталог проверки в .

hg/, который будет служить рабочей копией этого удаленного репозитория для проверки.

То есть для обеспечения всей функциональности наш основной репозиторий пострадает только один раз, когда будет коммит с созданием .

hgreview. Этот файл необходим для того, чтобы другие разработчики не заморачивались с поддерживаемым обзором hg.

Проверка кода в Mercurial

Мы идем в существующий репозиторий, где хотим просмотреть код.

> hg review --init --remote-path [url-of-remote-public-review-repo]

Готовый.

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

> hg review --init

Эта команда на основе информации из .

hgreview создаст скрытый репозиторий и подготовит всё к работе.

Теперь, чтобы использовать систему, которую мы запустим

> hg review --web

когда нам это нужно.

Все действия, необходимые для функционирования системы, можно выполнить из веб-интерфейса.

Добавляем комментарии, нажимаем «Push to default» и наши комментарии попадут в публичный репозиторий для проверки.

Соответственно, чтобы подобрать новые комментарии, мы делаем «тянуть по умолчанию».



Давайте воспользуемся этим.

Итак, основные возможности, которые нам предоставляет hg review:
  • Комментарии к наборам изменений
  • Подписи (да/нет/нейтрально) для наборов изменений
  • Самое интересное: комментарии к строкам кода из ревизии.

Имея эти возможности, организовать конкретный рабочий процесс – это уже наша работа.

Мы можем комментировать чужой код, читать комментарии к своему коду и синхронизировать эти изменения с помощью веб-интерфейса.

Проект сравнительно молодой, в основном делается одним человеком, но то, что у нас уже есть, дает надежду, что мы получим очень и очень полезный инструмент.

Проверка кода в Mercurial



Недостатки (надеюсь временные).

На данный момент мы обнаружили несколько недостатков, в том числе:
  • Сравнительно медленная работа.

    Для его работы используются только простые инструменты (текстовые файлы, которые лучше всего поддерживаются VCS) и инструменты самого Mercurial, такие как commit, push, pull, что очень идеологично и правильно.

    Будем надеяться, что есть способы повысить оперативность.

    Но все это не критично для армии.

    Я гарантирую это!

  • Вы можете редактировать комментарии, оставленные другим пользователем.

    Инструментов авторизации нет, поскольку идентификация пользователя осуществляется по имени пользователя из файла настроек Mercurial. Кроме того, для тех, кто совсем не в курсе, предупреждение: поскольку Mercurial придерживается принципа неизменности истории, удалить упоминание о редактировании комментария невозможно.

    это можно отследить, если посмотреть журнал hg в репозитории обзоров.



Возможно, это поможет.
  • Если вы не видите изменений набора изменений diff, убедитесь, что у вас не установлен diff = git в .

    hgrc.



Проверка кода в Mercurial



Ссылки.

Демо: обзор.

stevelosh.com Репозиторий: bitbucket.org/sjl/hg-review/src Документация: sjl.bitbucket.org/hg-review Теги: #проверка кода #проверка кода #hg #Mercurial #открытый исходный код

Вместе с данным постом часто просматривают: