5.4. Verpánek¶
Verpánek neboli Workbench je primární aplikace TortoiseHg. Umožňuje procházet lokálními repozitáři, předávat (commit) změny do repozitáře , provádět vyhledávání a synchronizaci s jinými repozitáři a vykonávat různé provozní úlohy. Téměř každá procedura Mercurialu je dostupná z Verpánku. Všechna tlačítka pracují s aktuálním repozitářem.
V základní minimalistické konfiguraci (s vypnutými lištami) má okno Verpánku pouze jedno pole a to Přehled revizí na jedné či více kartách, jejichž ouška jsou řazena v pruhu nad polem seznamu.
Mezi pruh hlavního menu (Soubor, Zobrazit, Repozitář, Help) a Přehled revizí lze vložit nástrojové lišty - Editovací (Edit Toolbar), Parkovací (Dock Toolbar), Úkonovou (Task Toolbar), Synchronizační (Sync Toolbar) a Uživatelskou (Custom Toolbar). Složení jednotlivých lišt bude uvedeno níže. Lišty lze aktivovat/deaktivovat výběrem z kontextové nabídky, vytvořené poklepem „pravé“ myši v pruhu hlavního menu nebo výběrem ze sekvence
.Parkovací lišta obsahuje ikony tří procedur -
. První dvě procedury se zobrazují v samostatném přemistitelném okně. Okno poslední procedury je nepřemistitelné.Výběr ze sekvence
otevře strukturovanou pracovní plochu, jejíž konfigurace se mění podle právě zvoleného úkonu v Úkonové liště (Podrobnosti revizí, Commit, Synchronizovat a Hledat ).Tuto úkonovou plochu lze opatřit samostatnou lištou s oušky karet, obsahujících úkony z Úkonové lišty a to sekvencí
–> Poloha úkonových karet (east, west, off).Úkonovou plochu lze překrýt otevřením okna konzoly pro reflexi nebo zadávání příkazů aplikace
nebo . Použijeme k tomu sekvenci , nebo ikonu v editovací liště.Další užitečné zpestření pracovní plochy Verpánku poskytuje volba
, jež otevře okno se seznamem repozitářů vlevo od seznamu revizí a úkonové plochy,jež lze tažením přemístit i mimo plochu Verpánku.Hlavní panely Verpánku jsou tedy tyto:
- Přehled revizí
- Panel pod nástrojovými lištami v záhlaví s výčtem revizí vybraného repozitáře. Ve sloupcích jsou uváděny základní informace o každém changesetu neboli revizi repozitáře. Lze si nastavit, které sloupce mají být viditelné ( > Vybrat sloupce přehledu revizí) a v jakém pořadí.
- Seznam repozitářů neboli repozitórií
- Lze aktivovat ikonou nebo volbou > Zobrazit seznam repozitářů. Volba > Nastavení seznamu repozitářů > Show Paths umožní zobrazení nejenom jmen repozitářů ale i cest k nim.
- Úkonová plocha
Plocha pod přehledem revizí s poměnným obsahem. Nástroje úkonové plochy lze aktivovat ze třech míst:
- jako položku roletky –> Podrobnosti revize, Comit, Synchronizovat, Hledat
- výběrem ikony v Úkonové liště –> dtto
- výběrem ouška na okraji Úkonové plochy - zobrazení oušek lze zapnout/vypnout v prostředí > Settings > Verpánek > Úkonová lišta
- Výstupní konzola (Output Log)
- Tento nepřemistitelný panel, který vyvoláme tlačítkem s ikonou „Log“ nebo výběrem , poskytuje uživateli informaci o příkazech Mercurialu, které byly provedeny během stávající seance. Lze jej také použít jako příkazový řádek pro přímé zadávání příkazů Mercurialu. V určitých situacích také zobrazuje chybová hlášení. Okno panelu se také vypne zavřením Verpánku.
5.4.2. Editovací lišta¶
- Obnovit (refresh) aktuální repozitář
- Znovu načíst přehled revizí aktuálního repozitáře.
- Stop:
- Zastavit probíhající operaci.
- Přejít k aktuální revizi:
- Přejít k revizi, která je právě aktuální.
- Přejít k jiné revizi:
- Přejít k libovolné určené revizi.
- Zpět:
- Vrátit se k předchozí revizi.
- Vpřed
- Přejít k předchozí revizi.
- Lišta filtru se sadami revizí nebo větvemi
- Aktivovat nástrojovou lištu pro editaci filtru.
- Aktualizovat pracovní adresář
- Aktualizovat pracovní adresář k označené revizi.
- Sloučit (merge)
- Sloučit s dalším čelem vybrané větve.
5.4.3. Parkovací lišta¶
Tato lišta zobrazí nebo skryje původně přemistitelné panely Verpánku. Panel konzoly je aktuálně nepřemistitelný.
- Otevřít seznam repozitářů
- Ve skutečnosti jde o seznam repozitórií - kořenových adresářů se složkami .hg
- Otevřít frontu oprávek
- (Show Patch Queue)
- Otevřít konzolu
- Otevřít konzolu (output log), zobrazující výstup z příkazů Mercuriálu, které byly zadány buď některým nástrojem TortoiseHg nebo zadány v konzole.
5.4.4. Úkonová lišta¶
Lišta je sestavena z ikon, které aktivují úkonové karty v úkonové ploše: Podrobnosti revize, Commit, Hledat a Synchronizovat.
Rozdělení úkonové plochy se mění v závislosti na volbě úkonové karty. Tuto volbu lze realizovat i výběrem ouška karty na okraji úkonové plochy, pokud je viditelnost oušek aktivována.
- Podrobnosti revizí
- Pracovní plocha této karty se zkládá ze třech polí:
- Rozbalovací plochy (+/-) Changeset obsahuje údaje o číslu revize, zkrácený heš, souhrnný text zprávy komitu, jméno a email komitenta, datum komitu, informace o rodičích a dětech
- Textového pole se souhrnným i úplným textem zprávy komitu
- Diffové zobrazení změn vybraného souboru, uvedeného v textovém poli vlevo.
- Commit
- Zde je možné přidávat nové soubory a provádět komit do repozitáře. Až na informaci o changesetu je rozdělení tohoto pole obdobné, jako u Podrobnosti revizí.
- Synchronizovat
- Umožňuje podrobné nastavení cesty ke vzdálenému repozitáři. Karta obsahuje úplnou nabídku synchronizačních úloh.
- Hledat
- Slouží pro vyhledávání zadaného textu v souboru.
Mezi vybranou revizí nebo oprávkou v Přehledu revizí a úkonovou kartou Commit či Podrobnosti revizí existují tyto relace:
- Poklep na revizi „Pracovní adresář“ aktivuje kartu s úlohou Commit.
- Poklep na kteroukoliv jinou revizi aktivuje kartu Podrobnosti revizí.
5.4.5. Synchronizační lišta¶
Slouží k synchronizaci lokálního repozitáře s jinými repozitáři. Obsahuje čtyři ikony pro úkony Incoming, Pull, Outgoing, Push. Popisy těchto úkonů jsou uvedeny v kapitole 5.9 Synchronizace.
5.4.6. Pracovní lišta filtru¶
Tato lišta umožňuje rychlé filtrování vybraných changesetů. Je založena na proceduře Revision Sets Mercuriálu. Určení skladby revizí viz hg.1.html#revsets. Zobrazení této lišty aktivujeme buď tlačítkem s ikonou v editovací liště nebo přepínačem Ctrl+S. Lišta obsahuje následující sadu procedur (zleva doprava):
- Clear
- Smaže aktuální dotaz (query). Vlastně anuluje zadání filtru.
- Roletka
- Zde lze zapsat filtrovací podmínku do textového pole roletkového seznamu, obsahujícího předchozí filtrovací podmínky
- Aktivovat průzkum
- Aplikuje dotaz na zadanou sadu revizí.
- Otevřít editor průzkumu
- Otvírá dialogové okno „Revision Set Query“. Zde můžete upřesnit svůj dotaz.
- Smazat vybraný dotaz
- Smaže zadaný vyhledávací dotaz (query).
- Filtr
- Přepínač pro aktivaci filtru. Aktivní filtr prosévá changesety a barevně označí ty, které podmínce nevyhovují.
- Ukázat / Skrýt
- Ukázat/skrýt skryté changesety
- Graft
- Přepínač viditelnosti gráftu
- Větev
- Výběrový seznam s možností zadat typ větve - aktivní, uzavřené, všechny
- Custom Filter Combo
- Rozvinovací seznam jednotlivých typů větví (stable, default, hgtk).
V situaci, kdy je zobrazován seznam příchozích changesetů, vynoří se na počátku filtrovací lišty dvě tlačítka:
- Accept
- Přijmout (pull) changesety z prohlíženého svazku.
- Reject
- Odmítnout changesety z prohlíženého svazku.
Verpánek se pokusí nalézt zadanou vyhledávací frázi v repozitáři, porovnávaje ji s tagem, záložkou, názvem větve, hešem changesetu nebo s číslem revize. Není-li žádná shoda nalezena, zjistí Verpánek, zda fráze obsahuje závorky. Pokud ne, předpokládá Verpánek, že fráze je klíčovým slovem a provede hledání keyword (). Jsou-li závorky zjištěny, předpokládá Verpánek, že fráze je specifikací sady revizí a pokusí se sadu řešit.
Potřebujete-li provést hledání s klíčovým slovem, které obsahuje závorky, použijte příkaz keyword („fráze(foo)“).
5.4.7. Graf revizí¶
Sloupec s grafem zobrazuje vztah dítě-rodič mezi revizemi. Tento sloupec se automaticky zvětšuje podle počtu čar.
5.4.8. Výkonové implikace¶
Některá nastavení Verpánku mohou mít u velkých repozitářů vliv na výkon.
- Povolení sloupce Změny může být náročné na přepočet repozitářů s rozsáhlými pracovními kopiemi, což může vést ke zpomalení u rolování a oživení.
- Normálně se při rolování revizemi postupně načítají dávky changesetů, což může někdy způsobovat trhavé zobrazení. Načtení všech changesetů najednou může vést k ‚hladšímu‘ zobrazení.
5.4.11. Analýza zpráv komitů¶
V poli +/- Changeset na kartě Podrobnosti revizí jsou detekovány a podtrženy heše, adresy HTTP(s) a označení chybových zpráv, nalezené ve zprávách komitů. Tyto podtržené údaje jsou aktivní linky k changesetům v Přehledu revizí.
URL adresy HTTP a HTTPS se podobně změní na klikatelné linky které se otevřou ve vašem implicitním webovém prohlížeči.
Linky k Issue Tracker jsou povoleny, pokud je to nastaveno v sekci ‚tortoisehg‘ vašeho konfiguračního souboru. Protože lze nastavit pouze jeden issue tracker, je obvykle uváděn v souboru .hg/hgrc. Jsou dva klíče: issue.regex a issue.link. První definuje regex shody při výběru čísla problému, druhý definuje příkaz, který má být po určení čísla problému proveden.
Do issue.regex můžete vložit skupiny a odpovídajících {n} znaků (tokens) do issue.link (kde n je pozitivní celé číslo). {0} odkazuje na celý řetězec, porovnávaný issue.regexem, zatímco {1} odkazuje na první skupinu, atd. Nejsou-li v issue.linku nalezeny žádné {n} znaky, je připojen celý porovnávaný řetězec.
Příklady:
BitBucket:
issue.regex = #(\d+)\b
issue.link = https://bitbucket.org/<your project and repo>/issue/{1}/
Mercurial:
issue.regex = \bissue(\d+)\b
issue.link = https://bz.mercurial-scm.org/show_bug.cgi?id={1}
5.4.12. Výstupní konzola¶
V konzole, vestavěné do nepřemístitelného panelu (Output Log), lze spouštět příkazy Mercurialu (hg), TortoiseHg (thg), řadu speciálních příkazů a omezený počet příkazů konzoly. Příkazy se vždy provedou v kořenovém adresáři aktuálního repozitáře (repozitória). Prompt je aktualizován pro udržení souvislosti.
Začíná-li příkaz ‚hg‘, je proveden v prováděcím prostředí TortoiseHg; což znamená, že výstup je poslán do Output Log ale požadavky na vstupy jsou obslouženy dialogovými okny.
Začíná-li příkaz ‚thg‘, je zadaný příkaz proveden v novém okně pro tentýž proces. Například ‚thg ci‘ otevře nové okno s procedurou pro předání změn (commit) do aktuálního repozitáře.
Je-li zadaným příkazem ‚clear‘ nebo ‚cls‘ smaže se obsah konzoly.
Příkaz ‚exit‘ toto okno zavře.
Poznámka
Otherwise, the command line is forwarded to your platform’s default command shell with a limited execution context. There is no stdin while stdout and stderr are piped to the output log.
5.4.14. Nastavitelné možnosti¶
Nastavitelné parametry Verpánku lze zadat v dialogu Mercurial.ini
:
[tortoisehg].
authorcolor.USERNAME = color
5.4.15. Spuštění z příkazového řádku¶
thg log [OPTIONS] [FILE]
aliases: history, explorer, workbench
workbench application
use „thg -v help log“ to show global options