PYBAG Графический интерфейс¶
Содержание.
Программа с графическим интерфейсом может работать только из инициализированной папки. Если вы запустили программу из не инициализированного места то будет задан вопрос об инициализации. Во время инициализации создаются необходимые директории и файлы в папке с расположением программы.
Главное окно¶
В этом окне вы делаете все операции. Вы можете выбрать команду из меню или использовать панель инструментов. На панели инструментов есть команды для сравнения и синхронизации файлов, фильтры и форсирование операций. В главном окне программы вы можете настроить все нужные параметры синхронизации. В списке файлов отображаются результаты сравнения и рекомендованные действия над файлами, либо результаты синхронизации. В окне отчета вы можете видеть информацию о процессе а также результаты. Вы можете скрывать и отображать окно информации через меню:
, очищать выходное окно командой меню . Если вы дважды щелкните мышкой на разделителе выходного окна то оно скроется. В списке файлов вы можете через контекстное меню (вызывается правой кнопкой мыши) вы можете производить различные операции над файлами и изменять колонки. Двойной щелчек мышью на элементе списка показывает окно со свойствами элемента.Доступные установки в главном окне
- Select roots for synchronization
Здесь вы можете выбрать корни для синхронизации. По умолчанию выбраны все корни. Смитри также меню Roots (корни).
- Auto Conflict
Устанавливает правила для автоматического разрешения конфликтов.
- Verbosity
Устанавливает уровень детализации выводимой информации.
-1
- Ничего не выводить. Только файл с логом программы.0
- Только глобальные ошибки.1
- Очень маленькая детализация, Только информация об успехе операции или об ошибках.2
- Как1
и еще конфликты.3
- Нормальный уровень детализации. Общая информация и конфликты, ошибки, предупреждения.4
- Большая детализация. Как3
и еще операции над файлами.5
- Подробнейшая детализация (очень большой лог файл). Как4
и еще часть информации из логов.
- Emulation
Включает / выключает режим эмуляции. При включеной эмуляции - в файлах не производится ни каких изменений, так же не сохраняются настройки программы.
- Logging
Включает / выключает логирование в файл
pybag.log
.- Debug logging
Включает / выключает добавление отладочной информации в файл лога.
- Modify date delta
Устанавливает допустимую разницу в дате модификации файлов (difference) - используется при сравнении. Если разность времени модификации файлов меньше этого значения то файлы считаются одинаковыми.
- Backup full synch
Используется для полной синхронизации резервных корней. В этом режиме оригиналы и корни синхронизируются полностью (в стандартном режиме отслеживаются только изменения в оригиналах).
- Time shift
Отображает режим сдвига по времени: направление сдвига (Bag - в портфель, Origin - в оригиналы, None - нет сдвига), и время сдвига в секундах для портфеля «b:0.0» и для оригинала «o:0.0».
- List path filter ( … )
Здесь можно указать фильтр для списка файлов. Фильтр применяется для колонки с путем к файлу Path. Вы можете использовать или простой шаблон ( «*» - означает любое количество символов, «?» - означает любой один символ) или регулярное выражение (оно должно начинаться с восклицательного знака «!»). Фильтр применяется при нажатии клавиши ВВОД или кнопки «Обновть список» (Refresh list).
Меню¶
File
- Read and compare
Прочитать и сравнить файлы. Эта команда полезна если файлы поменялись после последнего сравнения. Это команда принудительно читает файлы заново.
- Compare
Сравнить файлы. Если нужно то файлы будут прочитаны (только один раз).
- Synchronize
Синхронизировать файлы. Если нужно то файлы будут автоматически прочитаны и сравнены. Команда –sync.
- Add root …
Добавить новый корень. После добавления вы должны синхронизировать портфель, для копирования файлов. Команда –add.
- Remove root …
Удалить корни из портфеля. Также удаляет все файлы удаляемого корня в портфеле. Ничего не изменяет в оригиналах. Эта команда не удаляет такие папки как «/» или «C:». Команда –remove.
- Distribute …
Распространение программы. Команда –dist.
- Relocate …
Изменение положения оригиналов (если вы скопировали оригиналы в другое место чем ранее то просто укажите этой командой новое расположение оригиналов). Команда –relocate.
- Show tips
Показать окно с советами.
- Save output …
Сохранить вывод программы (отчет) в файл. Кодировка файла - utf-8.
- Exit
Выйти из программы.
View
- Item properties
Показать свойства выделеного объекта в списке файлов.
- Output
Показать / скрыть окно с выводом программы.
- Clear output
Очистить вывод программы.
- Emulation
Включить / выключить режим эмуляции. Опция -m.
- Logging
Включить / выключить логирование. Опция -l.
- Debug logging
Включить / выключить логирование отладочной информации. Опция -t.
- Verbosity >>>
Выбрать уровень детализации отчета (выпадающее меню). Опция -v.
Roots
- Select all roots
Выбрать все корни для синхронизации.
- Unselect all roots
Снять весь выбор.
- Select default
Выбрать корни помеченные как «по умолчанию».
Action
- Force to bag
Форсирование копирования в портфель. Если в оригинале пусто то ничего не делать.
- Force to origin
Форсирование копирования в оригинал. Если в портфеле пусто то ничего не делать.
- Force delete
Форсировать удаление.
- Force unchanged
Оставить элемент не изменным.
- Restore default action
Восстановить действие рекомендуемое PYBAG (которое было после сравнения).
- Time shift >>>
Подменю сдвига по времени.
- Time shift >>> Time shift to bag
Сдвиг времени в портфеле. Т.е. установить файлам в портфеле дату модификацию такую же как и у оригинальных файлов.
- Time shift >>> Time shift to origin
Сдвиг времени в оригинале. Т.е. установить файлам в оригинале дату модификацию такую же как и у файлов в портфеле.
- Time shift >>> Reset time shift
Сбросить сдвиг по времени.
Filter
- Show OK synchronization
Показать элементы успешно синхронизированные.
- Show warnings
Показать элементы с предупреждениями.
- Show conflicts
Показать конфликты.
- Show errors
Показать ошибки.
- Show copied to bag
Показать элементы копируемые в портфель.
- Show copied to origin
Показать элементы копируемые в оригинал.
- Show new
Показать новые элементы.
- Show changed
Показать измененые элементы.
- Show deleted
Показать удаляемые элементы.
- Show ignored
Показать игнорируемые.
- Show unchanged
Показать не изменившиеся.
- Show forced
Показать элементы с форсированным действием.
- Show files
Показать файлы.
- Show directories
Показать директории.
- Show symlinks
Показать символьные ссылки.
- Show unknown
Показать неизвестные элементы.
- Show time shifted items
Показать фалы со сдвигом по времени.
Options
- Statistics …
Показать статистику для портфеля. Команда –stat.
- Preferences …
Показать диалог настроек.
Help
Панель инструментов¶
Сравнить файлы. Если нужно то файлы будут прочитаны (только один раз). |
|
Синхронизировать файлы. Если нужно то файлы будут автоматически прочитаны и сравнены. Команда –sync. |
|
Фильтр. Показать элементы успешно синхронизированные. |
|
Фильтр. Показать элементы с предупреждениями. |
|
Фильтр. Показать конфликты. |
|
Фильтр. Показать ошибки. |
|
Фильтр. Показать элементы копируемые в портфель. |
|
Фильтр. Показать элементы копируемые в оригинал. |
|
Фильтр. Показать новые элементы. |
|
Фильтр. Показать измененые элементы. |
|
Фильтр. Показать удаляемые элементы. |
|
Фильтр. Показать игнорируемые. |
|
Фильтр. Показать игнорируемые. |
|
Фильтр. Показать элементы с форсированным действием. |
|
Фильтр. Показать файлы. |
|
Фильтр. Показать директории. |
|
Фильтр. Показать символьные ссылки. |
|
Фильтр. Показать неизвестные элементы. |
|
Фильтр. Показывать файлы со сдвигом по времени. |
|
Форсировать. Оставить элемент не изменным. |
|
Форсирование копирования в портфель. Если в оригинале пусто то ничего не делать. |
|
Форсирование копирования в оригинал. Если в портфеле пусто то ничего не делать. |
|
Форсировать удаление. |
|
Восстановить действие рекомендуемое PYBAG (которое было после сравнения). |
|
Auto Conflict |
Выбрать правило для автоматического разрешения конфликтов. |
Verbosity |
Выбрать уровень детализации отчета. Опция -v. |
Emulation |
Включить / выключить режим эмуляции. Опция -m. |
Logging |
Включить / выключить логирование. Опция -l. |
Debug logging |
Включить / выключить логирование отладочной информации. Опция -t. |
Modify date delta |
Установить допустимую разницу дат модификации файлов при которой они считаются одинаковыми. |
Backup mode synchronize |
Устанавливает использование полной синхронизации для резервных корней. |
Список файлов¶
Список файлов отображает информацию об объектах, их состояние и действия над ними. Список заполняется после сравнения или синхронизации. Можно использовать фильтр для выбора нужной информации. Для фильтрации списка можно использовать панель инструментов или меню Filter. Вы можете выбрать колонки которые вы хотите что бы отображались. Для настройки колонок используйте контекстное меню при щелчке правой кнопкой мыши на заголовке столбца либо меню настроек To left или в право To right. Команда контекстного меню Reset to config возвращает все установки колонок к установкам которые сохранены в файле конфигурации (Эти установки меняются в настройках ).
. В контекстном меню вы можеть показать / скрыть любую колонку или переместить выбранную в левоЕсли вы щелкните правой кнопкой по выделеному элементу то вы сможете указать в ручную действие необходимое для него:
Force to bag - Копировать в портфель.
Force to origin - Копировать в оригинал.
Force delete - Удалить.
Force unchanged - Оставить без изменений.
Restore default action - Восстановить действие по умолчанию.
Item properties - Показать свойства элемента.
Доступные колонки.
Заголовой колонки |
Описание колонки |
Колонка в файле конфигурации |
---|---|---|
Error |
Значок ошибок (e - ошибка, c - конфликт, w - предупреждение). |
err |
State |
Иконка состояния. |
stateicon |
Action |
Иконка действия. |
actionicon |
Path |
Путь элемента в портфеле. |
path |
Description |
Описание. |
desc |
Direction |
|
dir |
Forced |
Состояние форсирования (! - действие форсировано). |
forced |
Type |
|
type |
Size DB |
Размер элемента из базы данных ( DB ), байт. |
sizedb |
CRC32 DB |
Контрольная сумма CRC32 из DB. |
crc32db |
Symlink DB |
Символьная ссылка из DB. |
symlinkdb |
MDate DB |
Дата модификации элемента из DB, вещественное число. |
mdatedb |
GMT Date DB |
Дата модификации элемента из DB, GMT. |
gmdatedb |
Local Date DB |
Дата модификации элемента из DB, местное время. |
lmdatedb |
Size bag |
Размер объекта в портфеле, байт. |
sizebag |
CRC32 bag |
Контрольная сумма CRC32 из портфеля. |
crc32bag |
Symlink bag |
Символьная ссылка из портфеля. |
symlinkbag |
MDate bag |
Дата модификации элемента в портфеле, вещественное число. |
mdatebag |
GMT Date bag |
Дата модификации элемента в портфеле, GMT. |
gmdatebag |
Local Date bag |
Дата модификации элемента в портфеле, местное время. |
lmdatebag |
Size origin |
Размер элемента в оригинале байт. |
sizeorigin |
CRC32 origin |
Контрольная сумма CRC32 в оригинале. |
crc32origin |
Symlink origin |
Символьная ссылка в оригинале. |
symlinkorigin |
MDate origin |
Дата модификации в оригинале, вещественное число. |
mdateorigin |
GMT Date origin |
Дата модификации в оригинале, GMT. |
gmdateorigin |
Local Date origin |
Дата модификации в оригинале, местное время. |
lmdateorigin |
TS |
|
timeshift |
State icon (значок состояния)
Отображает информацию о типе элемента и ошибках.
Файл. |
|
Директория. |
|
Символьная ссылка. |
|
Неизвестный тип. |
|
Этот знак означает что PYBAG не знает какой значек показать (можете сообщить об этой ситуации автору). |
|
|
Элементы после синхроницации - ошибок нет. |
|
Элементы с предупреждениями. Они будут синхронизированы но вы можете захотеть посмотреть более подродно их описание. |
|
Элементы с конфликтами. Показываются только не разрешенный конфликты (которые программа сама не разрешила). Элементы не будут синхронизированы. Для синхронизации форсируйте нужное действие. Описание конфликтов в колонке описания.. |
|
Item with errors. Will be not synchronized. Элементы с ошибками (обычно чтения, записи). Более подробная информация в окне отчета программы. |
Action icon (значок действия)
Необходимые действия после сравнения или результаты синхронизации.
Элемент изменен и будет скопирован в портфель. |
|
Элемент изменен и будет скопирован в оригинал. |
|
Новый элемент в оригинале, будет скопирован в портфель. |
|
Новый элемент в портфеле, будет скопирован в оригинал. |
|
Элемент будет удален. |
|
Элемент не изменен, действий не требуется. |
|
Элемент не изменен, сдвиг времени в портфеле - установить дату модификации объекта в портфеле такой же как и у оригинала. |
|
Элемент не изменен, сдвиг времени в оригинале - установить дату модификации объекта в оригинале такой же как и в портфеле. |
|
Эта рамочка показывает что действие форсировано (в ручную или при автоматическом разрешении конфликтов). |
|
Во время синхронизации ошибок не было. |
|
|
Ошибки синхронизации. |
Программа не может определить какой значек нужен. |
Диалог настроек¶
Здесь можно сделать все настройки по умолчанию для PYBAG.
Диалог имеет три закладки:
Global preferences (Глобальные настройки)
Roots preferences (Настройки корней)
Columns preferences (Настройки колонок)
Примечание
Для того чтобы изменения настроек сохранились - режим эмуляции должен быть выключен.
Если режим эмуляции включен то настройки сохранены не будут.
Сохранение настроек происходит только при нажатии кнопки Применить
( OK
).
Если нажмете Отменить
( Cancel
) то все изменения будут отменены.
Глобальные настройки
Здесь задаются настройки которые будут использоваться программой при запуске.
Настройки корней
Здесь изменяются настройки корней. Выберите необходимый корень и поменяйте его настройки.
Настройки колонок
Здесь отображаются настройки колонок, которые сохранены в файле конфигурации. Вы можете изменять порядок расположения колонок, показывать / скрывать их, изменять их ширину.
Вы можете:
сбросить все настройки обратно к настройкам файла конфигурации нажав кнопку From config.
сбросить установки к установкам по умолчанию - те настройки которые заложены в программу с самого начала, нажав Reset to default.
взять настройки из главного окна программы - Get current.
Если вы отметите Save columns changes when exit from PYBAG то все изменения колонок в главном окне программы будут сохранятся в файл конфигурации при выходе из программы (режим эмуляции должен быть отключен, иначе настройки не сохранятся).
Если вы меняете видимость колонок ( Visible ) или их ширину ( Width ) то нажмите кнопку Применить Apply. После изменения и сохранения настроек в файл конфигурации, в главном окне изменения не отображаются, они сохранены в конфигурационный файл. Для применения изменений в главном окне программы вы должны нажать правую кнопку мышки на заголовке любой колонки и в контекстном меню выбрать Reset to config.
Диалог добавления корня¶
Для добавления нового корня (root) выберите тип пути. Это может быть директория (directory) либо файл (file) или символьная ссылка (symlink). После выбора типа пути настройте свойства корня. Нажмите кнопку … для выбора пути (или введите путь вручную). PНажмите кнопку Add root. В окне выходной информации главного окна вы можете прочитать об успехе операции. Для реального добавления корня нужно что бы режим эмуляции был отключен.
Диалог удаления корня¶
Выберите корень который вы хотите удалить и нажмите кнопку Да (OK). Корень будет удален и все файлы корня в портфеле тоже будут удалены. Для реального удаления корня нужно что бы режим эмуляции был отключен.
Дилог распространения программы¶
Распространение PYBAG в указанное местоположение. Есть несколько вариантов распространения. Во всех вариантах файл программы PYBAG копируется в место назначения.
Для начала вы должны выбрать что вы хотите:
- Initialize
Только инициализация места назначения - создание необходимых для работы файлов и папок.
- Copy additional files
Копировать все файлы (кроме специальных для программы PYBAG) найденых в месте расположения программы.
- Initialize and copy files
Как два предыдущих вместе.
На следующем шаге выберите корни которые вы хотите распространить. Можете ничего не выбирать если не хотите распространять корни. Нажмите кнопку OK. About success you can read in output window.
Если вы распространяете PYBAG с корнями в место где уже есть другая копия PYBAG то будет перезаписан только файл программы. Корни будут добавлены к уже существующим. Если такие корни уже есть в месте назначения то они будут прорпущены.
Выбор типа распространения.
Выбор корней.
Изменение положения оригиналов¶
Relocate (изменение места) - позволяет изменить расположение оригиналов. Вы скопировали оригинальные файлы в другое место и хотите указать корням в портфеле новое положение для синхронизации. Выберите корень для изменения положения оригиналов и нажмите OK после чего укажите путь где находятся ваши оригиналы.
Properties dialog¶
В этом окне отображается информация о выбранном элементе. Показывается информация из оригиналов, портфеля и базы данных PYBAG.
Диалог свойств элемента¶
В этом диалоге отображается статистическая информация о каждом корне в отдельности и суммарная информация по всем корням.