Bazaar howto

A HupWiki-ből...

(Változatok közti eltérés)
a (GUI lehetőségek: typo)
a (typo)
107. sor: 107. sor:
=== Változások visszavonása ===
=== Változások visszavonása ===
-
Ha egy fájlt feleeslegesen felvettünk a projectünkbe, a '''bzr remove''' paranccsal távolíthatjuk el azt:
+
Ha egy fájlt feleslegesen felvettünk a projectünkbe, a '''bzr remove''' paranccsal távolíthatjuk el azt:
  bzr remove felesleges.txt
  bzr remove felesleges.txt

A lap 2009. március 26., 12:12-kori változata

Tartalomjegyzék

Bevezetés

A Bazaar egy nyílt forráskódú elosztott verziókezelő rendszer. Ennek a leírásnak az a célja, hogy egyszerű példákon keresztül megismertesse a Bazaar használatának alapjait. Nem teljes körű leírás és nem helyettesíti az eredeti dokumentációt.

Bazaar telepítése

A legtöbb modern disztribúció csomagként tartalmazza (a csomag neve általában bzr), így érdemes onnan telepíteni. Mindazonáltal Python nyelven íródott, így könnyen hordozható és fordítás nélkül használható.

MS Windows alatt külön telepítő készlet áll rendelkezésre, attól függően hogy milyen megoldásban szeretnénk telepíteni. Javaslot a standalone csomag. Aki hozzá van szokva a grafikus felülethez, az telepítse fel a TortoiseBzr modult is.

Alapfogalmak

  • tároló (repository): A forráskód tárolására szolgál, általában egy távoli gépen.
  • munkapéldány (working copy): Tárolóból a felhasználó gépére kerülő forráskód, amelyet szerkeszthet és műveleteket végezhet rajta.

Vesd össze Verziókezelő rendszer Fogalmak bekezdésével

Kezdeti lépések

A Bazaar verziókezelő rendszer szöveges módú kliensprogramját bzr -nek hívják. A kiadandó parancsokat vastag betűvel írjuk, az előtte álló $ jel a promptot jelöli, nem kell beírni.

Help

A bzr-ben komoly segítség lapul. Érdemes és hasznos nézegetni, mert nem csak a parancsok szintaxisa van leírva, hanem jópár használathoz szükséges alapfogalom és elgondolás is. Lekérdezése

$ bzr help

Egy konkrét parancs funkcióját és paramétereit a következő képpen kérdezhetjük meg.

$ bzr help commit

vagy

$ bzr commit --help

Ismerkedés szempontjából a következő két parancsot érdemes megnézni

A commands kilistázza a bazaar összes verziókezelő parancsát

$ bzr help commands

A topics tulajdonképpen a tartalomjegyzéke a bzr-ben szereplő dokumentációnak.

$ bzr help topics

Név és email-cím megadása

A munkához szükséges megadni a nevünket és email-címünket, amelyeket a szerver a naplózásban felhasznál. Ezt a következő módon tehetjük meg:

$ bzr whoami "Nevem Senki <nevem@senki.hu>"

Ha bármikor szeretnénk lekérdezni, hogy milyen nevet és email-címet adtunk meg, a következő módon tehetjük meg:

$ bzr whoami
Nevem Senki <nevem@senki.hu>

link

Konfigurációs fájlok helye

A Bazaar által használt konfigurációs fájlokat a $HOME/.bazaar (Linux/Unix), illetve a C:\Documents and Settings\<username>\Application Data\Bazaar\2.0 (Windows) könyvtárban keresd.

A Bazaar használata

Bazaar project készítése

Tegyük fel, hogy már rendelkezésre áll egy projectünk, amelyet szeretnénk a Bazaar verziókezelővel használni. A project könyvtára a példa kedvéért legyen myproject, a parancsok utáni linkek a magyarázathoz vezetnek.

cd myproject
bzr init
bzr add .
bzr commit -m 'Bazaar inicializáció'
  • A bzr init segítségével inicializálod a project könyvtárát, a Bazaar létrehozza benne a project verziókövetéséhez szükséges könyvtárakat és fájlokat
  • A bzr add . hozzáadja a könyvtárban található összes fájlt verziókezelt projecthez, a . az aktuális könyvtárat jelöli
  • A bzr commit a megadott üzenettel beküldi a változásokat project könyvtárában található helyi tárolóba. A bzr commit után az aktuális állapot elmentődött a helyi tárolódba, már csak egy lépés kell, hogy ezt mások számára is elérhetővé tedd, de erről majd később. Az viszont jó tanács, hogy minden commit-hoz adj meg értelmes üzenetet, hogy mások számára is érthető legyen a változás.

Fájlok kihagyása a verziókezelésből

Előfordulhat, hogy a projected olyan fájlokat is tartalmaz, amelyeket szeretnél kihagyni a verziókezelésből. Ilyenek például a biztonsági másolatok, a lefordított project objektum-fájljai (*.o), vagy az ideiglenes állományok. Ha szeretnéd használni ezt a lehetőséget, akkor a projected főkönyvtárában hozz létre egy .bzrignore nevű fájlt, amelyben sorold fel a kihagyandó fájlokat, akár mintákat alkalmazva:

*.o
*~
*.tmp
*.py[co]

Persze adott helyzetben jóval egyszerűbb lehet a bzr ignore minta parancs használata, amely a minta-t kihagyja a verziókezelésből, a bzr ignored paranccsal lekérdezheted a kihagyásra ítélt fájlok/minták listáját, adott fájlt/mintát törölni vagy szerkeszteni pedig közvetlenül a fájl módosításával tudsz. Persze azért arról ne feledkezz meg, hogy érdemes ezt a fájlt is bevonni a verziókezelésbe:

bzr add .bzrignore
bzr commit -m "Fájlkihagyási minták hozzáadása"

Változások áttekintése

A verziókezelő használata során szükség lehet arra, hogy megtekintsd a projected állapotát, és az abban bekövetkezett változásokat. A bzr status megmutatja a munkakönyvtáradban található fájlok állapotát. Jelzi például, ha valamelyik fájlt még nem vontad be a verziókezelésbe (unknown), ha hozzáadtad a projecthez, de még nem volt commit (added), vagy ha módosítottad a legutolsó commit óta (modified). A bzr diff segítségével lekérdezheted két elmentett változat közötti különbséget. Természetesen nem kapsz hibát akkor, ha bináris fájlokat (pl. képeket) is használsz a verziókezelésben, bár a diff természetesen nem fogja kijelezni a kép két változata közötti eltérést. A bzr log kilistázza a projected a commitok naplóját, megtalálod benne a beküldő nevét, a beküldés idejét, és a beküldéshez mellékelt leírást. Egy adott fájl régebbi változatát a bzr cat paranccsal tekintheted meg, a bzr viz pedig grafikusan mutatja a változások listáját, ez utóbbi külső bővítmény segítségével érhető el.

Címkék használata

A project egy adott verzióját címkékkel azonosíthatod, így megjelölhetsz egy stabil kiadást, vagy beszédesebb nevet rendelhetsz hozzá. A címkék használata a bzr tag paranccsal lehetséges:

bzr tag release-1.0

Az így megadott címkére később hivatkozhatsz a megfelelő helyeken:

bzr diff -r tag:release-1.0

Ha meg szeretnéd tekinteni a projectben használt címkék listáját, használd a bzr tags parancsot.

Változások visszavonása

Ha egy fájlt feleslegesen felvettünk a projectünkbe, a bzr remove paranccsal távolíthatjuk el azt:

bzr remove felesleges.txt

Amikor valami miatt szükségessé válik, hogy a project egy régebbi változatát hívjuk elő, a bzr revert parancs siet a segítségünkre:

bzr revert -r 5

A fenti példában a project ötödik beküldött állapotát (commit) hívjuk elő, természetesen az azóta beküldött állapotok is megmaradnak a tárolóban.

Megszabadulhatunk véglegesen a beküldött állapotoktól a bzr uncommit paranccsal, de ezt kellő körültekintéssel használjuk!

Címkék használatakor egy adott címkét törölni a bzr tag ---delete, újradefiniálni pedig a bzr tag --force kiadásával lehetséges:

bzr tag --delete release-1.0

GUI lehetőségek

A Bazaar alapvetően parancssori megoldás, de ez nem jelenti azt hogy le kell mondani a grafikus felületről.

  • Olive: Phanatic munkája érdemel nagy figyelmet. Mivel Pythonban íródott, ez is hordozható (Linux, Windows)
  • TortosieBzr: A népszerű Tortoise kliensek tagja. Csak MS Windows alatt használható. BZR 1.6 verziójától belecsomagolják, az install készletbe. (Jelenleg azt írják hogy erősen béta verzió, de jól használható.)

Külső linkek

Grafikus kezelőprogramok

Hasznos leírások, tutorial-ok

Személyes eszközök