Mercurial (Hg) – System kontroli wersji przewodnik

Wprowadzenie

Mercurial (Hg) to rozproszony system kontroli wersji, który pozwala na efektywne zarządzanie kodem źródłowym i historią zmian. Jest szybki, bezpieczny i prosty w obsłudze, co czyni go doskonałym wyborem dla programistów pracujących indywidualnie oraz w zespołach. W tym artykule omówimy kluczowe funkcje Mercurial, pokażemy jak utworzyć repozytorium oraz przedstawimy najważniejsze polecenia wraz z ich opisami.

---

Instalacja Mercurial

Aby rozpocząć pracę z Mercurial, należy go zainstalować na swoim systemie operacyjnym. Oto jak to zrobić:

Windows

1. Pobierz instalator ze strony: https://www.mercurial-scm.org/
2. Uruchom plik instalacyjny i postępuj zgodnie z instrukcjami.
3. Sprawdź poprawność instalacji:hg versionSprawdza, czy Mercurial jest poprawnie zainstalowany i wyświetla jego wersję.

Linux (Debian/Ubuntu)

sudo apt update
sudo apt install mercurial

macOS

brew install mercurial

Po instalacji można skonfigurować użytkownika:

hg config --edit

Otwiera plik konfiguracyjny Mercurial, w którym można ustawić nazwę użytkownika i adres e-mail.

---

Tworzenie i konfigurowanie repozytorium Mercurial

Tworzenie nowego repozytorium

Aby rozpocząć śledzenie zmian w projekcie, należy utworzyć repozytorium Mercurial:

hg init my_project
cd my_project

Tworzy nowe repozytorium Mercurial w katalogu my_project.

---

Podstawowe operacje w Mercurial

Dodawanie i zatwierdzanie plików

Dodanie plików do repozytorium:

hg add file.txt

Dodaje plik file.txt do śledzenia przez Mercurial.

Zatwierdzenie zmian:

hg commit -m "Dodano plik"

Tworzy nowy commit z podanym opisem.

Sprawdzanie statusu repozytorium

Aby zobaczyć, jakie zmiany zostały wprowadzone, użyj:

hg status

Wyświetla listę zmodyfikowanych, dodanych i usuniętych plików.

Wyświetlanie historii commitów

hg log

Pokazuje historię commitów wraz z ich identyfikatorami i opisami.

Podgląd zmian w plikach

hg diff

Porównuje aktualne zmiany z ostatnim commitem.

---

Zarządzanie wersjami w Mercurial

Przywracanie poprzednich wersji

hg update -r REVISION

Przywraca repozytorium do określonej wersji.

Cofanie niezatwierdzonych zmian

hg revert file.txt

Cofa zmiany w pliku file.txt do ostatniej zatwierdzonej wersji.

Porównywanie wersji plików

hg diff -r REVISION1 -r REVISION2

Pokazuje różnice między dwoma wersjami.

---

Praca z gałęziami (branches)

Tworzenie i przełączanie się na nową gałąź

hg branch feature-branch
hg update feature-branch

Tworzy nową gałąź feature-branch i przełącza się na nią.

Scalanie gałęzi

hg merge default
hg commit -m "Scalono zmiany"

Łączy zmiany z gałęzi default do aktualnej gałęzi.

Zamykanie gałęzi

hg commit --close-branch -m "Zamknięcie gałęzi feature-branch"

Oznacza gałąź jako zamkniętą, co oznacza, że nie będzie już aktywnie rozwijana.

---

Praca z repozytorium zdalnym

Klonowanie repozytorium

hg clone https://example.com/repo

Tworzy lokalną kopię zdalnego repozytorium.

Pobieranie zmian z repozytorium zdalnego

hg pull
hg update

Pobiera zmiany z repozytorium zdalnego i aktualizuje lokalną wersję.

Wysyłanie commitów do repozytorium zdalnego

hg push

Wysyła lokalne zmiany do repozytorium zdalnego.

---

Debugowanie i naprawa błędów

Cofanie ostatniego commita

hg rollback

Anuluje ostatni commit.

Ignorowanie plików w .hgignore

Aby wykluczyć określone pliki z repozytorium, dodaj je do .hgignore:

syntax: glob
*.log
node_modules/

Resetowanie repozytorium

hg update --clean

Usuwa wszystkie niezapisane zmiany i przywraca repozytorium do czystego stanu.

---

Najlepsze praktyki w Mercurial

• Regularnie wykonuj hg pull i hg push, aby synchronizować zmiany.
• Korzystaj z hg log do śledzenia historii commitów.
• Przed scalaniem gałęzi zawsze wykonuj hg diff, aby uniknąć konfliktów.
• Używaj .hgignore do wykluczania zbędnych plików.
• Dokumentuj zmiany w commitach (hg commit -m "Opis zmiany").

---

Podsumowanie

Mercurial (Hg) to wydajny i prosty w obsłudze system kontroli wersji. Dzięki intuicyjnym poleceniom umożliwia efektywne zarządzanie kodem źródłowym. Wdrożenie Mercurial w codziennej pracy programisty pozwala na łatwe śledzenie zmian i współpracę zespołową. Jeśli szukasz alternatywy dla innych systemów kontroli wersji, Mercurial jest świetnym wyborem!