TortoiseSVN — клиент для системы контроля версий Subversion, выполненный как расширение оболочки Windows. TortoiseSVN выпущен под лицензией GPL. При щелчке на любой иконке появляется дополнительное подменю TSVN, позволяющее выполнять все необходимые subversion-действия (подгрузка, обновление, граф версий и т.п.). Из приятностей, входящих в базовую комплектацию: приятный русифицированный интерфейс, возможность работы с secure-subversion с сохранением пароля и юзера, тонкая настройка всех параметров, бесплатность и многое другое.

Также зовут черепахой

Команды TortoiseSVN
Программа, отображающая интерфейс пользователя TortoiseSVN, называется TortoiseProc.exe. Все команды указываются с параметрами /command:abcd, где abcd - это обязательное имя команды. Большинству из этих команд необходим как минимум один параметр с именем пути, задаваемый при помощи /path:"некоторый\путь". В следующей таблице 'команда' обозначает параметр /command:abcd и 'путь' обозначает параметр /path:"некоторый\путь".

Так как некоторые команды могут принимать списк целевых путей (например, фиксация нескольких конкретных файлов) в параметре /path можно задать несколько путей, разделённых символом *.

TortoiseSVN использует временные файлы для передачи множественных параметров между расширением оболочки и основной программой. Начиная с TortoiseSVN 1.5.0, параметр /notempfile считается устаревшим и его больше добавлять не надо.

Окно выполнения, используемое при фиксации, обновлении и множестве других команд, обычно остаётся открытым после завершения команды до тех пор, пока пользователь не нажмёт кнопку OK. Это может быть изменено установкой соответствующего параметра в диалоге настроек. Но использование этой настройки будет закрывать окно выполнения независимо от того, запущена ли команда из вашего пакетного командного файла или из контекстного меню TortoiseSVN.

Для указания другого местоположения конфигурационного файла, используйте параметр /configdir:"путь\до\конигурационной\папки". Этот параметр будет использован вместо пути по умолчанию, а также вместо настроек из реестра.

Для автоматического закрытия окна выполнения по окончанию команды без предварительного постоянного изменения настройки вы можете указать параметр /closeonend.

/closeonend:0 не закрывать диалог автоматически

/closeonend:1 закрывать автоматически, если нет ошибок

/closeonend:2 закрывать автоматически, если нет ошибок и конфликтов

/closeonend:3 закрывать автоматически, если нет ошибок, конфликтов и слияний

/closeonend:4 закрывать автоматически, если нет ошибок, конфликтов и слияний для локальных операций

В нижеприведённой таблице содержатся все команды, доступные при использовании командной строки TortoiseProc.exe. Как описано выше, они должны использоваться в виде /command:abcd. В таблице префикс /command опущен для экономии места.

Таблица D.1. Список доступных команд и параметров

Команда Описание
:about Показывает диалог 'О программе'. Он же отображается, если команда не указана.
:log Открывает диалог журнала. Параметр /path указывает файл или папку, для которых должен быть показан журнал. Могут быть заданы три дополнительных параметра: /startrev:xxx, /endrev:xxx и /strict
:checkout Открывает диалог извлечения. Параметр /path задаёт целевую папку, а /url задаёт URL, из которого будет происходить извлечение.
:import Открывает диалог импорта. Параметр /path задаёт папку с данными, которые должны быть импортированы.
:update Обновляет рабочую копию в /path до ведущей ревизии (HEAD). Если указан параметр /rev, то показывается диалог, запрашивающий, до какой ревизии должно происходить обновление у пользователя. Чтобы диалог не появлялся, укажите номер ревизии /rev:1234. Другие параметры: /nonrecursive и /ignoreexternals.
:commit Открывает диалог фиксации. Параметр /path задаёт целевую папку или список файлов для фиксации. Вы можете также задать параметр /logmsg для указания предопределённого сообщения журнала, которое будет передано в диалог фиксации. Или, если вы не желаете передавать сообщение журнала в командной строке, воспользуйтесь /logmsgfile:путь, где путь задаёт файл, содержащий сообщение журнала. Для предварительного заполнения поля 'ID ошибки' (в случае, если у вас настроена интеграция с системой отслеживания ошибок) вы можете применить параметр /bugid:"здесь id ошибки".
:add Добавляет файлы в /path под управление версиями.
:revert Отменяет локальные изменения в рабочей копии. Параметр /path указывает, какие элементы должны быть возвращены в прежнее состояние.
:cleanup Очищает прерванные или отменённые операции и разблокирует рабочую копию в /path.
:resolve Помечает конфликтные файлы, указанные в /path, как улаженные. Если задан параметр /noquestion, то улаживание производится, не спрашивая предварительно разрешения на выполнение у пользователя.
:repocreate Создаёт хранилище в папке, указанной параметром /path
:switch Открывает диалог переключения. Параметр /path задаёт целевую папку.
:export Экспортирует рабочую копию из /path в другую папку. Если /path указывает на неверсированную папку, диалог запросит URL, который надо будет экспортировать в папку, заданную параметром /path.
:merge Открывает диалог слияния. Параметр /path указывает целевую папку. Могут быть установлены три дополнительных параметра: /mergefrom:xxx, /mergeto:xxx и /fromurl:URL. Эти параметры будут подставлены в соответствующие поля в диалоге слияния.
:mergeall Открывает диалог 'Слить все'. Параметр /path задаёт целевую папку.
:copy Brings up the branch/tag dialog. The /path is the working copy to branch/tag from. And the /url is the target URL. You can also specify the /logmsg switch to pass a predefined log message to the branch/tag dialog. Or, if you don't want to pass the log message on the command line, use /logmsgfile:путь, where путь points to a file containing the log message.
:settings Открывает диалог настроек.
:remove Убирает файл(-ы) в /path из-под управления версиями.
:rename Переименовывает файл, заданный параметром /path. Новое имя для файла запрашивается при помощи диалога. Для подавления вопроса о переименовании похожих файлов за один приём, укажите /noquestion.
:diff Запускает указанную в настройках TortoiseSVN внешнюю программу сравнения. Параметр /path задаёт первый файл. Если указан параметр /path2, то программа сравнения запускается с этими двумя файлами. Если параметр /path2 опущен, то сравнение делается между файлом, задаваемым /path и его базой. Для явного задания номеров ревизий используйте параметры /startrev:xxx и /endrev:xxx. Если параметр /blame задан, а /path2 - нет, то сначала производится получение авторства для файлов в заданных ревизиях, после чего выполняется сравнение.
:showcompare Depending on the URLs and revisions to compare, this either shows a unified diff (if the option unified is set), a dialog with a list of files that have changed or if the URLs point to files starts the diff viewer for those two files.

The options url1, url2, revision1 and revision2 must be specified. The options pegrevision, ignoreancestry, blame and unified are optional.

:conflicteditor Starts the conflict editor specified in the TortoiseSVN settings with the correct files for the conflicted file in /path.
:relocate Открывает диалог перебазирования. Параметр /path указывает путь рабочей копии, который будет перебазирован.
:help Открывает файл справки.
:repostatus Открывает диалог проверки на наличие изменений. Параметр /path указывает папку рабочей копии.
:repobrowser Запускает обозреватель хранилища, указывающий на URL из рабочей копии, заданной /path или же /path может указывать прямо на URL. Для указания ревизии, которую обозреватель хранилища должен показывать, можно использовать дополнительный параметр /rev:xxx. Если параметр /rev:xxx опущен, то по умолчанию используется ведущая ревизия (HEAD). Если параметр /path указывает на URL, то параметр /projectpropertiespath:путь/к/рабочей/копии задаёт путь, по которому должны считываться и применяться свойства проекта.
:ignore Добавляет все целевые файлы из /path в список игнорирования, т.е. добавляет к этим файлам свойство svn:ignore.
:blame Открывает диалог авторства для файла, указанного в /path.

Если заданы параметры /startrev и /endrev, то диалог запроса диапозона ревизий для получения информации об авторстве не отображается, вместо этого используются значения этих параметров.

Если задан параметр /line:nnn, TortoiseBlame откроется, отображая строку с указанным номером.

Также поддерживаются параметры /ignoreeol (игнорировать окончания строк), /ignorespaces (игнорировать непечатаемые знаки) и /ignoreallspaces (игнорировать все непечатаемые знаки).

:cat Сохраняет файл из URL или пути в рабочей копии, заданному в /path, в место, указанное в /savepath:путь. Ревизия передается при помощи /revision:xxx. Может быть использовано для получения файла нужной ревизии.
:createpatch Создаёт файл заплатки для пути, указанному в /path
:revisiongraph Отображает граф ревизий для пути, указанному в /path.
:lock Блокирует файл или все файлы в папке, указанной в /path. Отображается диалог блокирования, чтобы пользователь мог ввести комментарий для блокировки.
:unlock Разблокирует файл или все файлы в папке, указанной в /path.
:rebuildiconcache Восстанавливает кэш значков Windows. Используйте только в случае, если значки Windows испорчены. Побочный эффект этой команды (которого нельзя избежать) состоит в переупорядочивании значков на рабочем столе. Чтобы не появлялось окно сообщения, укажите /noquestion.
:properties Показывает диалог работы со свойствами для пути, указанному в /path.

Примеры (должны быть введены в одной строке):

TortoiseProc.exe /command:commit
/path:"c:\svn_wc\file1.txt*c:\svn_wc\file2.txt"
/logmsg:"test log message" /closeonend:0

TortoiseProc.exe /command:update /path:"c:\svn_wc\" /closeonend

TortoiseProc.exe /command:log /path:"c:\svn_wc\file1.txt"
/startrev:50 /endrev:60 /closeonend:0