✎ Основы Mercurial. Часть 2.

Вы загрузили старую версию документа! Сохранив её, вы создадите новую текущую версию с этим содержимым.

====== Основы Mercurial. Часть 2. ======

<html>
<div class="content">
 <img src="http://habrastorage.org/storage/eebea7f1/5482efc4/01467053/55589e0f.png" align="left">Это вторая часть из серии Hg Init: Учебное пособие по Mercurial от Джоэля Спольски (<a href="http://www.joelonsoftware.com/">Joel Spolsky</a>). Возможно, вы захотите прочитать и первую часть [[hg_init:часть_1._переобучение_для_пользователей_subversion|]]. 
 
Даже если вы работаете в одиночку, то вам стоит использовать Mercurial. Так вы сможете получить все прелести контроля версий. Эта часть покажет насколько просто добавить каталог в Mercurial, чтобы с легкостью отслеживать предыдущие версии. 
 
<h4>Часть 2. Основы Mercurial</h4> 
 
<img src="http://habrastorage.org/storage/a2dc0ced/1ebe349c/adafba84/cf7127dd.png" align="left">Mercurial — это система контроля версий. Разработчики используют ее для администрирования исходного кода. У нее два основных назначения: 
<ol>
<li>Она хранит все предыдущие версии каждого файла</li>
<li>Она может объединить разные версии вашего кода, то есть сотрудники могут независимо работать над кодом и затем объединять свои изменения</li>
</ol> 
 
<a name="habracut"></a> 
 
Без Mercurial вы могли бы попытаться сохранить предыдущие версии, просто создавая много копий каталога с кодом: 
 
<img src="http://habrastorage.org/storage/c204c8c2/8cbde270/f057de30/d4010d6d.png"> 
 
Это муторно, требует много места на диске и создает путаницу. Лучше использовать систему контроля версий. 
 
Большинство людей работают с Mercurial через интерфейс командной строки. Так можно работать в Windows, Unix, и Mac. Команда для Mercurial — это <code>hg</code>: 
 
<img src="http://habrastorage.org/storage/d1a7ded2/0e111d9f/ff11aa6a/06d714d8.png"> 
 
Если выполнить <code>hg</code> без параметров, то вы получите список наиболее часто используемых команд. Вы можете также попробовать выполнить <code>hg help</code> для получения полного списка команд. 
 
Для того чтобы воспользоваться преимуществами контроля версий, вам нужен репозиторий. Репозиторий хранит все предыдущие версии всех ваших файлов. На самом деле, для экономии места на диске, все предыдущие версии не будут храниться — будет храниться только компактный список изменений. 
 
В старые времена заиметь репозиторий было большим делом. Вам было необходимо иметь центральный сервер и нужно было установить на него программное обеспечение. Mercurial — распределенная система, так что вы можете использовать ее без модного центрального сервера. Вы можете пользоваться Mercurial, используя один только свой компьютер. А заполучить репозиторий супер просто: вы просто идете в каталог с вашим кодом… 
 
<img src="http://habrastorage.org/storage/df024955/0a7c68ad/4d8a48b9/032e8174.png"> 
 
… и выполняете команду <code>hg init</code>: 
 
<img src="http://habrastorage.org/storage/6d17bad7/1023e58b/cbf778f1/de0f8775.png"> 
 
<blockquote><code>hg init</code> 
создает репозиторий. 
</blockquote> 
 
Минуточку, а разве что-то произошло? Выглядит так, словно ничего не поменялось. Нет, если вы присмотритесь получше, то увидите, что появился новый каталог <code>.hg</code>: 
 
<img src="http://habrastorage.org/storage/8f6b4eec/b4aa6daf/c822a60f/ea555032.png"> 
 
Это и есть репозиторий! Это каталог со всем, что нужно Mercurial для работы. Настройки, предыдущие версии файлов, теги, лишняя пара носков на случай дождя, и прочее. Не лазьте туда. Вам почти всегда не стоит возиться с этим каталогом самостоятельно. 
 
Ну хорошо, раз у нас теперь есть свежеиспеченный репозиторий, то мы захотим добавить в него все исходные файлы. Это тоже просто: нужно лишь выполнить <code>hg add</code>. 
 
<img src="http://habrastorage.org/storage/0deb8fc5/d3543931/6114cd9a/f166b892.png"> 
 
<blockquote><code>hg add</code> 
помечает файлы как запланированные для добавления в репозиторий. Файлы на самом деле не будут добавлены до тех пор, пока вы не зафиксируете изменения. 
</blockquote> 
 
Остался еще один шаг… вам нужно зафиксировать ваши изменения. Какие изменения? Факт добавления всех этих файлов. 
 
Почему вы вынуждены фиксировать изменения? При работе с Mercurial фиксирование изменений означает: «Эй, вот как файлы сейчас выглядят, так их и запомни, пожалуйста». Это как создание копии всего каталога… каждый раз, когда у вас есть что-то измененное, и оно вам типа нравится, то вы фиксируете изменения. 
 
<blockquote><code>hg commit</code> 
сохраняет текущее состояние всех файлов в репозиторий. 
</blockquote> 
 
<img src="http://habrastorage.org/storage/1b0b9bd3/265a2c06/84473f38/64028691.png"> 
 
Mercurial запустит редактор для того, чтобы вы могли напечатать комментарий к изменениям. Вам нужно просто написать что-нибудь, что напомнит вам о сделанных изменениях. 
 
<img src="http://habrastorage.org/storage/d47213d9/eab868b9/894d01ae/68290364.png"> 
 
После сохранения и выхода из редактора ваши изменения будут зафиксированы. 
 
Вы можете выполнить <code>hg log</code> для просмотра истории изменений. Это как блог для вашего репозитория: 
 
<img src="http://habrastorage.org/storage/63c37c68/7c4b9074/79365c85/9158e135.png"> 
 
<blockquote><code>hg log</code> 
отображает историю изменений, зафиксированных в репозитории. 
</blockquote> 
 
Давайте изменим файл и посмотрим, что получится. 
 
<img src="http://habrastorage.org/storage/a4976b63/e1120125/f2d75af8/175793cf.png"> 
 
Так как мы сделали изменение, то можем его зафиксировать при помощи <code>hg commit</code>: 
 
<img src="http://habrastorage.org/storage/1b0b9bd3/265a2c06/84473f38/64028691.png"> 
 
Обратите внимание, что Mercurial догадался, что только один файл, a.txt, изменен: 
 
<img src="http://habrastorage.org/storage/7e7e4f7c/44a2a982/429514a6/ea1f8d40.png"> 
 
А теперь, после того как я закоммитил (зафиксировал изменения), давайте посмотрим на историю: 
 
<img src="http://habrastorage.org/storage/30655b31/b8a4769b/cabb993c/cd4bad09.png"> 
 
Как любой нынешний блоггер, Mercurial помещает самое новое в начало. 
 
Я собираюсь сделать еще одно изменение, просто чтобы потешить себя. 
 
<img src="http://habrastorage.org/storage/ce916884/653f2957/8d61c6eb/daeab3db.png"> 
 
Коммичу (фиксирую изменения): 
 
<img src="http://habrastorage.org/storage/1b0b9bd3/265a2c06/84473f38/64028691.png"> 
 
Мое сообщение к коммиту: 
 
<img src="http://habrastorage.org/storage/64909d63/4d121c11/5243ddb9/f16bd56c.png"> 
 
А что у нас теперь в истории? 
 
<img src="http://habrastorage.org/storage/f8759acb/815f0236/1614fff7/7b5449b8.png"> 
 
Хорошо, это было весело. Я сделал несколько изменений и каждый раз, сделав значимое изменение, я фиксировал его в репозитории. 
 
Я знаю, вы сейчас думаете: «ДЖОЭЛЬ, ВСЕ ЭТО ВЫГЛЯДИТ ПУСТОЙ ТРАТОЙ ВРЕМЕНИ». К чему вся эта катавасия с коммитами? 
 
Терпение, мой юный друг. Ты вот-вот узнаешь, как извлечь выгоду из всего этого. 
 
Для начала: скажем, вы сделали большую ошибку в процессе редактирования. 
 
<img src="http://habrastorage.org/storage/1e32f444/b934daf5/5dab5b35/d90f3dec.png"> 
 
А затем, боже ж мой, в дополнение ко всему вы удалили пару очень важных файлов. 
 
<img src="http://habrastorage.org/storage/74f57309/93aecdca/9cb11413/afb87796.png"> 
 
Во времена, когда не было Mercurial, это все могло бы стать неплохим поводом для похода к системному администратору. Там, со слезами на глазах, вы бы задали ему пронзительно грустный вопрос: «Почему система резервного копирования „временно“ не работает все последние восемь месяцев». 
 
Системный администратор, которого все зовут <a href="http://ru.wikipedia.org/wiki/%D0%A2%D0%B0%D0%BA%D0%BE">Тако</a>, слишком скромен и не обедает с остальной командой. В тех редких случаях, когда он не сидит в своем кресле на колесиках, можно увидеть треугольное пятно цвета <a href="http://ru.wikipedia.org/wiki/%D0%A1%D0%B0%D0%BB%D1%8C%D1%81%D0%B0_(%D1%81%D0%BE%D1%83%D1%81)">сальсы</a> там, где падали, пролетев между ног, капли от его мексиканских закусок. Эти капли гарантируют, что никто не возьмет его кресло, хотя это <a href="http://hermanmiller.com/Products/Aeron-Chairs">одно из превосходных кресел от Herman Miller</a>, купленных учредителями компании для себя любимых, а не обычное бюджетное офисное нечто, из-за которого у всех болят спины. 
 
В любом случае, резервной копии нет, ага. 
 
Благодаря Mercurial, если вам не нравится то, что вы сделали, вы можете выполнить удобную команду <code>hg revert</code>, которая немедленно вернет ваш каталог к виду, в котором он был в момент последнего коммита. 
 
<img src="http://habrastorage.org/storage/faad2087/64fce902/eb83246d/28a37ffa.png"> 
 
<blockquote><code>hg revert</code> 
возвращает измененные файлы к зафиксированному в репозитории виду. 
</blockquote> 
 
Я использовал аргумент <code>--all</code>, потому что хотел вернуть все файлы к прежнему состоянию. 
 
Таким образом, когда вы работаете над исходным кодом, используя Mercurial, вы: 
<ol>
<li>Делаете изменения</li>
<li>Оцениваете, подходят ли они</li>
<li>Если подходят, то выполняете <code>commit</code></li>
<li>Если не подходят, то выполняете <code>revert</code></li>
<li>GOTO 1</li>
</ol> 
 
(Я знаю. Пользуюсь командной строкой, в Windows, да еще и оператором GOTO — я самый стрёмный программер из всех, когда-либо живших.) 
 
Со временем вы можете забыть, на чем остановились и что поменяли с момента прошлого коммита. Mercurial отслеживает все это для вас. Все что вам нужно, это выполнить <code>hg status</code> и Mercurial даст вам список измененных файлов. 
 
<blockquote><code>hg status</code> 
отображает список измененных файлов. 
</blockquote> 
 
Предположим, я создал один файл, отредактировал другой и удалил третий. 
 
<img src="http://habrastorage.org/storage/3e908ca1/4cb8b4cf/daa03ab7/07f0f673.png"> 
 
<code>hg status</code> отображает список измененных файлов, добавляя значок в начале каждой строки. Этот значок сообщает о том, что же произошло. «M» означаете «Modified» — файл был изменен. "!" означает отсутствие — файл должен быть здесь, но куда-то делся. "?" означает что, состояние не определено — Mercurial ничего не знает про этот файл. Пока не знает. 
 
Давайте разбираться с изменениями поочередно. Вот что поменялось в файле a.txt? Вы ведь можете забыть, что изменили. Чёрт, да я едва помню что я обычно ем на завтрак. А особенно внушает опасения то, что это всегда хрустящие колечки <a href="http://www.nestle.ru/products/breakfast/forchildren/cheerios/default.aspx">CHEERIOS</a>. В любом случае, a.txt изменен. Что поменялось? 
 
А есть команда для этого: <code>hg diff</code> сообщит вам в точности, что произошло с файлом с прошлого коммита. 
 
<blockquote><code>hg diff</code> 
показывает, что изменилось в файле. 
</blockquote> 
 
<img src="http://habrastorage.org/storage/cadb3342/3816d012/1d850a8a/8548d3b2.png"> 
 
Формат результата немного непонятный, но самое важное, что вы можете видеть строки, начинающиеся с минуса (это то, что было удалено), и строки, начинающиеся с плюса (это то, что добавлено). Таким образом, вы можете видеть, что «Normal people» было заменено на «Civilians». 
 
Теперь про тот пропавший файл favicon.ico. Как уже было сказано, если вы на самом деле не планировали его удалять, то можете выполнить команду <code>hg revert</code> для восстановления. Но, предположим, что вы на самом деле хотели его удалить. При каждом удалении (или добавлении) файла вы обязаны сообщить об этом событии Mercurial. 
 
<blockquote><code>hg remove</code> 
помечает файлы как запланированные для удаления из репозитория. Файлы на диске не будут удалены до тех пор, пока вы не зафиксируете изменения. 
</blockquote> 
 
<img src="http://habrastorage.org/storage/1adbcbec/9083b063/0f042dfc/a90411e4.png"> 
 
«R» означает «Removed», то есть, помечен для удаления. Во время следующего коммита Mercurial удалит этот файл. (История для этого файла сохранится в репозитории, так что, конечно, мы всегда сможем получить его назад.) И, наконец, нужно добавить этот новый файл b.txt: 
 
<img src="http://habrastorage.org/storage/c5e7f2af/f381ca0f/f30fd73b/48e0a4ff.png"> 
 
«A» означает «Added», то есть, помечен для добавления. Заметили, что я разленился писать <code>hg status</code> каждый раз? Для Mercurial достаточно минимального набора букв, однозначно определяющего команду, а на <code>st</code> начинается только одна команда. 
 
Разобравшись с вопросиками и восклицательными знаками, я могу продолжить и внести изменения: 
 
<img src="http://habrastorage.org/storage/3304169d/c5c0285c/c62c0461/b51d2474.png"> 
 
На что еще стоит обратить внимание в выводе <code>hg log</code>: строка changeset отображает номер каждого коммита. На самом деле даже два номера: короткий удобный вроде «0» для первой ревизии и длинный непонятный шестнадцатеричный, на который вы можете пока не обращать внимания. 
 
Запомните, что Mercurial хранит в репозитории достаточно информации для воссоздания любой версии любого файла. 
 
Прежде всего, при помощи простой команды <code>hg cat</code> вы можете вывести содержимое любой версии любого файла в консоль. К примеру, вот как увидеть, что сейчас находится в файле a.txt: 
 
<img src="http://habrastorage.org/storage/765630ca/414f3878/ec7f20ab/3bc776b0.png"> 
 
<blockquote><code>hg cat</code> 
отображает содержимое любого файла для любой ревизии. 
</blockquote> 
 
Для того чтобы увидеть как файл выглядел раньше, я могу просто указать нужный номер набора изменений (changeset из лога) при помощи аргумента <code>-r</code> («revision», то есть ревизия): 
 
<img src="http://habrastorage.org/storage/c268d14f/b5655b3d/3b7bf975/f3251569.png"> 
 
Если у файла сложное содержимое или большая длина, а изменился он лишь немного, то я могу использовать команду <code>hg diff</code> с аргументом <code>r</code> для вывода разницы между двумя ревизиями. К примеру, вот как посмотреть разницу между ревизиями 0 и 1: 
 
<img src="http://habrastorage.org/storage/206febdc/576f891d/25c37414/7901a60f.png"> 
 
И наконец,- надеюсь, что вы еще не свалились от усталости,- прежде чем закончить эту часть, я хочу показать вам еще одну маленькую фишку: при помощи команды <code>hg update</code> вы можете перемещаться вперед и назад ко времени создания любой ревизии. Ну, по сути в будущее вы перемещаться не сможете, хотя это было бы супер круто, да. Вы, имея всего четыре ревизии, смогли бы выполнить <code>hg update -r 103994</code> и получить реально крутую версию ваших исходников. С гравицапой и прочими футуристическими штучками. Но, конечно, это невозможно. 
 
Что на самом деле возможно, так это вернуться к любой ревизии. Следите за руками: 
 
<img src="http://habrastorage.org/storage/0c666f35/3ec21ad5/a99e8dc1/86a101c4.png"> 
 
<blockquote><code>hg update</code> 
приводит рабочий каталог к состоянию, как у заданной ревизии. 
</blockquote> 
 
Фактически, для перемещении вперед и назад между ревизиями <code>hg update</code> вносит в файлы запомненные изменения. Если файл был добавлен или удален, то эта команда добавляет или удаляет его на диске. Выполнение <code>hg update</code> без дополнительных параметров приводит рабочий каталог к состоянию как у самой свежей ревизии. 
 
<h5>Проверь себя</h5> 
 
Отлично! Эта часть закончена. Вот все, что вы должны уметь делать на данный момент: 
<ol>
<li>Создать репозиторий</li>
<li>Добавить или удалить файлы из репозитория</li>
<li>После внесения изменений просмотреть, что было сделано, а затем</li>
<li>… зафиксировать изменения, если они вам нравятся</li>
<li>… или откатить изменения, если не нравятся</li>
<li>Просмотреть предыдущие версии файлов или привести рабочий каталог к состоянию как у некоторой ревизии.</li>
</ol> 
</html>

**Продолжение здесь:**
[[Hg Init: Часть 3. Привыкаем работать в команде|Hg Init: Часть 3. Привыкаем работать в команде]]

Сводка изменений

Примечание: редактируя эту страницу, вы соглашаетесь на использование своего вклада на условиях следующей лицензии: CC0 1.0 Universal