SubWCRev je konzolový program Windows, ktorý je možné použiť na čítanie stavu pracovnej kópie Subversion a voliteľné vykonávanie zámeny kľúčových slov v súbore šablón. Toto sa často používa ako súčasť procesu zostavovania ako prostriedok na začlenenie informácií o pracovnej kópii do objektu, ktorý zostavujete. Spravidla sa môže použiť na vloženie čísla revízie do políčka “O programe”.
SubWCRev načíta stav Subversion všetkých súborov v pracovnej kópii, predvolene okrem externých súborov. Zaznamenáva najvyššie nájdené číslo revízie odovzdania a časovú pečiatku odovzdania tejto revízie. Zaznamenáva tiež, či existujú lokálne úpravy v pracovnej kópii, alebo zmiešané revízie aktualizácií. Na štandardnom displeji sa zobrazí číslo revízie, rozsah revízie aktualizácie a stav zmeny.
SubWCRev.exe sa volá z príkazového riadku alebo skriptu a ovláda sa pomocou parametrov príkazového riadku.
SubWCRev WorkingCopyPath [SrcVersionFile DstVersionFile] [-nmdfe]
WorkingCopyPath je cesta k kontrolovanej pracovnej kópii. SubWCRev môžete použiť iba na pracovné kópie, nie priamo na úložisko. Cesta môže byť absolútna alebo relatívna k aktuálnemu pracovnému priečinku.
Ak chcete, aby SubWCRev vykonával substitúciu kľúčových slov, aby sa polia ako revízia úložiska a URL ukladali do textového súboru, musíte zadať súbor so šablónou SrcVersionFile a výstupný súbor DstVersionFile, ktorý obsahuje nahradzovanú verziu šablóny.
Môžete určiť vzory ignorovania pre SubWCRev, aby ste zabránili spracovaniu konkrétnych súborov a ciest. Vzory sa načítajú zo súboru s názvom .subwcrevignore. Súbor sa číta zo zadanej cesty a tiež z koreňa pracovnej kópie. Ak súbor neexistuje, nebudú ignorované žiadne súbory ani cesty. Súbor .subwcrevignore môže obsahovať viac vzorov oddelených novými riadkami. Vzory sa porovnávajú s cestami relatívne ku koreňu úložiska a cestami relatívne k ceste súboru .subwcrevignore. Napríklad ignorovať všetky súbory v priečinku doc pracovnej kópie TortoiseSVN, súbor .subwcrevignore bude obsahovať nasledujúce riadky:
/trunk/doc /trunk/doc/*
Alebo za predpokladu, že súbor .subwcrevignore je v koreňovom priečinku pracovnej kópie, ktorá je overená z kmeňa použitím vzorov
doc doc/*
je to isté ako v príklade vyššie.
Ak chcete ignorovať všetky obrázky, môžete ich nastaviť takto:
*.png *.jpg *.ico *.bmp
Vo vzoroch ignorovania sa rozlišujú veľké a malé písmená, rovnako ako v Subversion.
Na vytvorenie súboru s počiatočnou bodkou v programe Windows Explorer, zadajte .subwcrevignore.. Všimnite si bodku na konci.
Existuje niekoľko voliteľných prepínačov, ktoré ovplyvňujú spôsob fungovania SubWCRev. Ak používate viac ako jednu, musia byť zadané ako jedna skupina, napr. -nm, nie -n -m.
Tabuľka 6.1. Zoznam dostupných prepínačov príkazového riadku
| Prepínač | Popis |
|---|---|
| -n | Ak je zadaný tento prepínač, SubWCRev sa ukončí s návratovou hodnotou ERRORLEVEL 7, ak miestna pracovná kópia obsahuje zmeny. Toto môže byť použité, aby sa vyhlo kompilovaniu neodovzdaných zmien. |
| -N | Ak je zadaný tento prepínač, SubWCRev ukončí s ERRORLEVEL 11 ak pracovná kópia obsahuje bezverziové položky, ktoré nie sú ignorované. |
| -m | Ak je zadaný tento prepínač, SubWCRev ukončí s ERRORLEVEL 8 ak pracovná kópia obsahuje zmiešané revízie. To možno použiť na zabránenie zostavenia čiastočne aktualizovanej pracovnej kópie. |
| -d | Ak je zadaný tento prepínač, SubWCRev ukončí s ERRORLEVEL 9 ak cieľový súbor už existuje. |
| -f | Ak je zadaný tento prepínač, SubWCRev zahrnie naposledy zmenenú revíziu priečinkov. Predvolené správanie je pri načítaní čísel revízií používať iba súbory. |
| -e | Ak je zadaný tento prepínač, SubWCRev preskúma priečinky, ktoré sú súčasťou svn:externals, ale iba ak sú z rovnakého úložiska. Predvolené správanie je ignorovanie externých užívateľov. |
| -E | Ak je uvedený tento prepínač, rovnaké ako -e, ale ignoruje externé subjekty s explicitnými revíziami, keď rozsah revízií v nich predstavuje iba danú explicitnú revíziu vo vlastnostiach. Takže to nevedie k zmiešaným revíziám. |
| -x | Ak je zadaný tento prepínač, SubWCRev vygeneruje čísla revízií v šestnástkovej sústave (HEX). |
| -X | Ak je zadaný tento prepínač, SubWCRev vygeneruje čísla revízií v šestnástkovej sústave (HEX), s predponou „0X“. |
| -F | Ak je zadaný tento prepínač, SubWCRev bude ignorovať akékoľvek súbory .subwcrevignore a zahrnie všetky súbory. |
| -q | Ak je zadaný tento prepínač, SubWCRev vykoná zámenu kľúčových slov bez zobrazenia stavu pracovnej kópie na štandardnom výstupe. |
Ak nie je chyba, SubWCRev vráti nulu. Ale v prípade chyby sa chybové hlásenie zapíše na stderr a zobrazí sa v konzole. Vrátené chybové kódy sú:
Tabuľka 6.2. Zoznam chybových kódov SubWCRev
| Kód chyby | Popis |
|---|---|
| 1 | Chyba syntaxe. Jeden alebo viac parametrov príkazového riadku je neplatných. |
| 2 | Súbor alebo priečinok uvedený v príkazovom riadku sa nenašiel. |
| 3 | Vstupný súbor nebolo možné otvoriť alebo sa nepodarilo vytvoriť cieľový súbor. |
| 4 | Pamäť sa nepodarilo vyhradiť. To by sa mohlo stať, keby napr. zdrojový súbor je príliš veľký. |
| 5 | Zdrojový súbor nie je možné správne skenovať. |
| 6 | Chyba SVN: Subversion sa vrátil s chybou, keď sa SubWCRev pokúsil nájsť informácie z pracovnej kópie. |
| 7 | Pracovná kópia má miestne úpravy. To si vyžaduje prepínač -n. |
| 8 | Pracovná kópia má zmiešané revízie. To si vyžaduje prepínač -m. |
| 9 | Výstupný súbor už existuje. To si vyžaduje prepínač -d. |
| 10 | Zadaná cesta nie je pracovnou kópiou alebo časťou alebo časťou. |
| 11 | Pracovná kópia obsahuje bezverziové súbory alebo priečinky. To si vyžaduje prepínač -N. |