Это не официальный сайт wikipedia.org 01.01.2023

Mercurial — Википедия

Mercurial

Mercurial (с англ. — «ртутный, подвижный»), он же Hg (от обозначения химического элемента ртути) — кроссплатформенная распределённая система управления версиями, разработанная для эффективной работы с очень большими репозиториями кода. В первую очередь она является консольной программой.

Mercurial
Логотип программы Mercurial
Скриншот программы Mercurial
Тип распределённая система управления версиями[d]
Разработчик Matt Mackall
Написана на Python, Си и Rust
Операционная система кроссплатформенность
Первый выпуск 19 апреля 2005[1]
Последняя версия
Лицензия GNU GPL 2+[d][4]
Сайт mercurial-scm.org
Логотип Викисклада Медиафайлы на Викискладе

Mercurial появился в результате того же конфликта, что привёл к созданию Git. Автором новой системы стал Мэт Мэкол (Matt Mackall).

ОписаниеПравить

Система Mercurial написана на Python, хотя чувствительные к производительности части (например, своя реализация diff) выполнены в качестве модулей-расширений на C[5]. Для повышения производительности также используется Rust.[6] Mercurial первоначально была написана для Linux, позже портирована под Windows, Mac OS X и большинство Unix-систем. Репозитории Mercurial управляются при помощи утилиты командной строки hg, но есть и GUI-интерфейсы.

Наряду с традиционными возможностями систем контроля версий, Mercurial поддерживает полностью децентрализованную работу (отсутствует понятие основного хранилища кода), ветвление (возможно вести несколько веток одного проекта и копировать изменения между ветками), слияние репозиториев (чем и достигается «распределённость» работы). Поддерживается обмен данными между репозиториями через HTTP/HTTPS, SSH и вручную при помощи упакованных наборов изменений.

Утилита hg обладает компактным интерфейсом, и Mercurial считается более простой в освоении системой, чем, например, git[7].

КонцепцииПравить

Рабочий процессПравить

Mercurial является распределённой (децентрализованной) системой контроля версий. Это означает, что рабочий процесс, как правило, выглядит следующим образом:

  1. На личном компьютере создаётся новый репозиторий (путём клонирования существующего репозитория, создания нового и т. п.);
  2. В рабочем каталоге данного репозитория изменяются/добавляются/удаляются файлы;
  3. Выполняется фиксация (commit) изменений в данный репозиторий (то есть в локальный репозиторий на личном компьютере);
  4. Шаги 2 и 3 повторяются столько раз, сколько необходимо;
  5. Забираются (pull) чужие наборы изменений;
  6. Производится слияние изменений (merge);
  7. Отдаются (push) собственные.

То есть вся повседневная работа происходит в локальном репозитории, а когда возникает необходимость, производится отправка результатов своей работы в один или несколько других репозиториев. Количество шагов при работе с отдалёнными репозиториями можно сократить, если настроить Mercurial на автоматическую отправку изменений в другие репозитории при выполнении фиксации[8].

Консольная программаПравить

Консольная программа реализована таким образом, что название любой команды можно сокращать до тех пор, пока её имя остаётся однозначным. Плюс некоторые команды имеют псевдонимы. Например, вместо hg commit можно написать hg commi, hg comm или hg com, но если написать hg c, то Mercurial откажется выполнять эту команду, сообщив, что «команда 'c' неоднозначна» и приведя список команд, которые попадают под это сокращение. Использовать hg co в качестве сокращения для hg commit нельзя, так как это псевдоним для команды hg update, однако доступно сокращение hg ci.

Логическая структура наборов измененийПравить

 
Пример представления графа ревизий. Справа от него видны список ревизий, комментарии и их хеш

При вызове команды hg commit выполняется фиксация изменений. При этом программа сохраняет в репозиторий набор изменений (англ. changeset или ревизия). Физически происходят те же изменения, что и у вас, но сохраняются они в служебные файлы, а не в копии (подробнее в За кулисами).

Как правило, все наборы изменений, которые были зафиксированы, отображают в виде большой связной сети (графа), где каждый набор изменений связан с одним или двумя другими.

Узнать идентификаторы родительских наборов изменений, с которыми связаны зафиксированные наборы изменений, можно с помощью команды hg log --debug. У каждого набора изменений будет два родителя (благодаря чему возможно ветвление внутри репозитория, см. hg -v help branch). Значение «-1:0000000000000000000000000000000000000000» означает отсутствие родителя. Например, у самого первого набора изменений в репозитории данное значение будет проставлено для обоих родителей, а у последующих данное значение будет проставлено для второго родителя (если для них в репозитории не использовалось ветвление), а для первого родителя будет проставлен идентификатор от предыдущего набора изменений.

Рабочий каталог также полезно представлять в виде такого же набора изменений (который пока не зафиксирован, но, возможно, вскоре также будет зафиксирован). Рабочий каталог также связан с одним или двумя родительскими наборами изменений, узнать о которых можно с помощью команды hg parents. После фиксации изменений данные родители станут родителями для нового (уже зафиксированного) набора изменений.

Идентификация наборов измененийПравить

Ревизии распознают по следующим признакам[9]:

  • номеру ревизии;
  • идентификатору набора изменений;
  • меткам (тег);
  • имени ветки.

Номер ревизииПравить

Номер ревизии представляет собой целое число, отражающее порядок, в котором наборы изменений были добавлены в хранилище. Номер ревизии начинается с нуля, присваивается набору изменений автоматически и может использоваться для идентификации наборов изменений. Номер ревизии для одного и того же набора изменений может различаться в каждом из клонов хранилища. В выводе команды hg log номер ревизии можно увидеть перед двоеточием (например, «4:e1be1898f374»).

Идентификатор набора измененийПравить

Идентификатор набора изменений представляет собой SHA-1-хеш, состоящий из цифр и букв «a, b, c, d, e, f», например, «e1be1898f3747386c41c8a5c5776e87373f6d3d3». Идентификатор набора изменений присваивается каждому набору изменений автоматически, вычисляется на основе содержимого этого набора изменений, поэтому соответствует одному и тому же набору изменений во всех репозиториях. Вероятность коллизии, когда для двух разных наборов изменений будет сгенерирован один и тот же SHA-1-хеш, крайне мала.

Mercurial не требует ввода полной строки идентификатора при использовании его в командах, ему достаточно лишь той его начальной части, которая однозначно идентифицирует требуемый набор изменений (в противном случае, Mercurial сообщит о неоднозначности). В выводе команды hg log идентификатор набора изменений можно увидеть после двоеточия (например, «4:e1be1898f374»). Без параметра --debug команда hg log выводит не полный, а сокращённый (из 12 символов) идентификатор набора изменений.

МеткиПравить

В дополнение к номеру ревизии и идентификатору набора изменений, Mercurial предоставляет возможность присваивать каждому набору изменений одно или более произвольных символических имён, называемых метками (или тегами). Присваиваются метки с помощью команды hg tag, а посмотреть все добавленные метки можно с помощью команды hg tags. Имя метки не может содержать некоторые символы (например ": "), о чём, в случае необходимости, Mercurial сообщит при выполнении команды hg tag.

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

Название веткиПравить

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

Неочевидные моментыПравить

  • Если в качестве идентификатора ревизии какой-либо команде передано число, то Mercurial будет считать, что ему передан номер ревизии и будет выполнять проверку на неоднозначность с сокращённым идентификатором наборов изменений только в том случае, если отсутствует набор изменений с указанным номером ревизии. Например, если в репозитории существует один набор изменений с номером ревизии «6» и другой набор изменений с идентификатором «647362ac74d76124267215af1a3f94aa9707dfdf» (начинается с цифры «6»), то команда hg log -r 6 выдаст информацию о первом наборе изменений, не сообщив о неоднозначности. Поэтому, если глобальный идентификатор начинается с цифры, полезно всегда сокращать его лишь до тех пор, пока в нём не встретится буква. Данное поведение наблюдалось в версии 2.2.1 под Mac OS X 10.7.4.
  • Если создать метку с именем, например, «5» в то время как в репозитории существует (или появится в будущем) набор изменений с номером ревизии «5», то Mercurial будет искать в первую очередь наборы изменений по номеру ревизии. Но если создать метку с именем, например, «e1be» в то время как в репозитории существует (или появится в будущем) набор изменений с идентификатором наборов изменений, начинающимся с «e1be», то Mercurial будет искать наборы изменений в первую очередь уже по меткам. Притом, в обоих случаях о неоднозначности сообщено не будет. По этой причине не рекомендуется создавать метки, состоящие только из цифр и/или букв «a, b, c, d, e, f». Данное поведение наблюдалось в версии 2.2.1 под Mac OS X 10.7.4.
  • Нельзя добавить в репозиторий пустую папку (для решения этой проблемы можно положить в папку любой файл, например, readme.txt). Такое поведение связано с тем, что Mercurial не отслеживает папки, а только файлы[10]. Поведение реализовано осознанно для упрощения системы и пока что изменений не планируется[10].

Отличительные особенностиПравить

В отличие от git, Mercurial предполагает более строгую модель работы, наиболее заметными аспектами которой являются[11][12]:

  • «Честные ветки» — любая ветвь может быть отслежена с самого начала;
  • Хранение изменений в виде revlog (в противовес blob у git);
  • Возможно слияние лишь двух ветвей за один проход (git допускает множественное слияние);
  • Невозможность отмены коммита — вместо этого следует послать исправляющий коммит, который наложится поверх неудачного;
  • Более строгий контроль различий по умолчанию следует единому стандарту, исключающему конфликты различных версий и клиентов.

Дополнительные средстваПравить

В комплекте с Mercurial поставляются CGI-сценарии для предоставления веб-интерфейса к репозиториям[13].

Есть графическая оболочка TortoiseHg[14], работающая как под Windows (с интеграцией в Explorer), так и под Linux (в виде отдельного приложения[15] или с интеграцией в Gnome/Nautilus[16]).

Atlassian также продвигает свой клиент SourceTree, предоставляющий доступ как к hg, так и к svn и git.

Ряд сред разработки имеет возможности для работы с Mercurial, например Microsoft Visual Studio[17][18], IntelliJ IDEA[19][20][21], Eclipse[22], Qt Creator (начиная с версии 2.0)[23], PIDA[24], NetBeans[25]. Возможна работа с Mercurial из Emacs c помощью входящего в Emacs универсального пакета VC.

Экспериментальная поддержка Mercurial есть в системе Trac[26]. Проект Redmine[27] также поддерживает репозитории Mercurial.

При помощи утилиты Tailor[28] или расширения convert[29] поддерживается конвертирование[30] репозиториев других систем контроля версий, включая CVS, Subversion, Git, Perforce, Darcs, GNU Arch, Bazaar.

Проекты, использующие MercurialПравить

Значительное количество проектов по разработке свободного программного обеспечения использует Mercurial в качестве основной системы контроля версий[31]. В их числе:

Поддерживаются Mercurial-зеркала основных репозиториев других проектов[33], например, GCC, Vim, Emacs и ядро Linux.

Среди проектов, длительное время использовавших Mercurial, но перешедших в 2019—2021 годы на Git — Adium, CLISP, Illumos, Coin3D, OpenJDK, SDL[34].

ПримечанияПравить

  1. https://lkml.org/lkml/2005/4/20/45
  2. https://www.mercurial-scm.org/repo/hg/rev/6.3.2
  3. Release Notes
  4. https://www.mercurial-scm.org/wiki/Relicensing
  5. Релиз распределённой системы управления версиями Mercurial 2.3  (неопр.). Дата обращения: 11 марта 2013. Архивировано 12 ноября 2012 года.
  6. PerformancePlan - Mercurial  (неопр.). www.mercurial-scm.org. Дата обращения: 15 марта 2021.
  7. Сравнение Git и Mercurial в FAQ сайта Google Code Архивная копия от 20 декабря 2009 на Wayback Machine (англ.)
  8. mercurial automatic push on every commit Архивная копия от 4 августа 2014 на Wayback Machine (англ.)
  9. Идентификация наборов изменений  (неопр.). Дата обращения: 12 марта 2013. Архивировано 16 марта 2013 года.
  10. 1 2 FAQ — Mercurial Архивировано 26 июня 2009 года.
  11. Сходство и различие между Mercurial и Git (рус.). Архивировано 2 августа 2018 года. Дата обращения: 5 июня 2018.
  12. Ещё раз о «Mercurial против Git» (с картинками) (рус.). Архивировано 2 августа 2018 года. Дата обращения: 5 июня 2018.
  13.  (недоступная ссылка с 04-06-13 [3524 дня] — Настройка сервера для работы с Mercurial история) (рус.)
  14. TortoiseHg — Mercurial  (неопр.). Дата обращения: 14 ноября 2008. Архивировано 3 ноября 2008 года.
  15. SourceForge.net: TortoiseHg — Develop (недоступная ссылка)
  16. SourceForge.net: TortoiseHg — Develop (недоступная ссылка)
  17. VisualHG — плагин-провайдер для Microsoft Visual Studio 2008/2010  (неопр.). Дата обращения: 8 февраля 2009. Архивировано из оригинала 5 февраля 2009 года.
  18. HgSccPackage — Mercurial-плагин для Microsoft Visual Studio 2008/2010  (неопр.). Дата обращения: 10 июня 2010. Архивировано из оригинала 3 июля 2020 года.
  19. Mercurial Integration for IDEA Архивировано 14 мая 2008 года.
  20. hg4idea
  21. JetBrains IntelliJ IDEA Plugin Repository
  22. Mercurial Eclipse  (неопр.). Дата обращения: 21 июля 2007. Архивировано из оригинала 21 июня 2007 года.
  23. Qt Creator: Using version control systems Архивировано 24 сентября 2011 года.
  24. Появление поддержки Mercurial в PIDA  (неопр.). Дата обращения: 21 июля 2007. Архивировано 4 сентября 2007 года.
  25. Mercurial-плагин для NetBeans  (неопр.). Дата обращения: 21 июля 2007. Архивировано 15 июля 2007 года.
  26. Mercurial Plugin for Trac  (неопр.). Дата обращения: 21 июля 2007. Архивировано 3 июля 2007 года.
  27. Repositories in Redmine  (неопр.). Дата обращения: 23 июля 2010. Архивировано 29 мая 2010 года.
  28. Tailor Архивировано 10 июля 2007 года.
  29. ConvertExtension Архивная копия от 25 октября 2008 на Wayback Machine в Mercurial Wiki
  30. RepositoryConversion Архивная копия от 18 июля 2007 на Wayback Machine в Mercurial Wiki
  31. Some projects that use Mercurial Архивная копия от 7 сентября 2008 на Wayback Machine (англ.)
  32. Reed, J Paul Version Control System Shootout Redux Redux  (неопр.) (12 апреля 2007). Дата обращения: 17 февраля 2019. Архивировано 17 ноября 2012 года.
  33. Projects with synchronized Mercurial repositories (англ.)
  34. SDL moving to GitHub  (неопр.). discourse.libsdl.org. Дата обращения: 11 февраля 2021. Архивировано 10 февраля 2021 года.

СсылкиПравить

ЛитератураПравить

  • Bryan O'Sullivan. Mercurial: The Definitive Guide. — O'Reilly Media, Inc., 2009. — 288 с. — ISBN 9780596800673.