Home

mygit – Dokumentacja

📋 Spis treści

• O mygit
• Jak działa mygit
• Instalacja
• Podstawowe komendy
• Przykłady użycia
• Opcje komendy GET
• Web Panel
• Plik .mygitignore
• Rozwiązywanie problemów
• Pomoc i wsparcie

---

O mygit

mygit to lokalny system wersjonowania, który umożliwia tworzenie snapshotów (kopii zapasowych) projektów w formacie ZIP.
Jest prosty w użyciu i nie wymaga zewnętrznych serwerów.

Główne funkcje:

• 📦 Tworzenie snapshotów projektu
• 🔄 Zarządzanie historią wersji
• 🌐 Web panel do przeglądania repozytoriów
• ⭐ Oznaczanie ulubionych repozytoriów
• 🔍 Zaawansowane wyszukiwanie i sortowanie
• 📊 Statystyki użycia

---

Jak działa mygit

4 proste kroki:

1. Inicjalizacja – utwórz repozytorium

mygit init

2. Snapshot – zrób backup projektu jako ZIP

mygit save "opis zmian"

3. Przeglądanie – zobacz historię i przywróć pliki

mygit log

4. Pobieranie – pobierz snapshot

mygit get [repo[@snapshot]]

Opcjonalnie – nazwij swoje repozytorium dodając opis który w przyszłości pozwoli Ci przypomnieć o czym był projekt

mygit comment "Prosta gierka RTS z widokiem Top Down. Na silniku Pythona."

---

Instalacja

Wymagania:

• Python 3.7 lub nowszy
• Terminal / wiersz poleceń

Instalacja:

1. Pobierz plik mygit.py z repozytorium
2. Umieść go w folderze dostępnym w PATH lub folderze projektu
3. (Opcjonalnie) Dodaj alias:

alias mygit='python3 /ścieżka/do/mygit.py'

---

Podstawowe komendy

Komenda	Opis	Przykład
mygit init	Utwórz repozytorium	mygit init
mygit comment "opis"	Zmień opis repo	mygit comment "Projekt Node.js"
mygit save "opis"	Snapshot projektu	mygit save "Dodano nowy endpoint"
mygit get [repo[@snapshot]]	Pobierz snapshot	mygit get moje-repo
mygit log	Historia snapshotów	mygit log
mygit status	Status repo	mygit status
mygit list	Wszystkie repozytoria	mygit list
mygit info	Informacje o systemie	mygit info
mygit help	Pomoc	mygit help

---

Przykłady użycia

🔧 Nowy projekt:

cd /ścieżka/do/projektu
mygit init
mygit comment "Mój projekt Node.js - API serwer"

🔄 Regularne backupy:

mygit save "Dodano endpoint /api/users"
mygit save "Naprawiono bug z walidacją email"
mygit log
mygit status

📥 Przywracanie snapshotów:

mygit get
mygit get moje-repo
mygit get moje-repo@2025-12-04_15-30-00.zip

---

Opcje komendy GET

Flaga	Pełna nazwa	Opis	Domyślnie
-f	--force	Nadpisz istniejące pliki	❌
-b	--backup	Backup istniejących plików	✔️
-d	--dry-run	Symulacja bez działania	❌
-o DIR	--output DIR	Folder wyjściowy	.
-s	--skip-conflicts	Pomijanie konfliktów	❌
-t SEC	--timeout SEC	Timeout	60

Przykłady:

mygit get --backup --skip-conflicts
mygit get --force
mygit get --output ./backup
mygit get --dry-run

---

Web Panel

🌐 Dostęp:

http://localhost:9614

✨ Funkcje panelu:

⭐ Ulubione repozytoria

• Oznaczanie gwiazdką
• Lista ulubionych
• Filtr tylko ulubione

🔍 Zaawansowane sortowanie

• Ulubione
• Najnowsze / Najstarsze
• A–Z / Z–A
• Rozmiar rosnąco/malejąco
• Tylko puste repo

📊 Statystyki

• Liczba repozytoriów
• Liczba snapshotów
• Całkowity rozmiar danych
• Ilość ulubionych

🔎 Wyszukiwanie

• Po nazwie
• Po opisie
• Po ID repo

---

Plik .mygitignore

📄 Tworzenie:

Utwórz plik .mygitignore w katalogu projektu.

📝 Przykład:

node_modules/
.env
*.log
.DS_Store
dist/
build/
coverage/
*.tmp
*.swp
npm-debug.log*
yarn-debug.log*
yarn-error.log*

✅ Korzyści:

• Mniejsze snapshoty
• Szybsze zapisy
• Pomija niepotrzebne pliki

---

Rozwiązywanie problemów

❌ Błędy połączenia z web panelem:

• React DevTools blokuje połączenie → Wyłącz DevTools
• Port 9614 zajęty → Użyj innego portu
• Brak uprawnień → Uruchom jako administrator

⚠️ Błędy przy snapshotach:

• Projekt za duży → Użyj .mygitignore
• Brak miejsca → Zwolnij dysk lub zmień lokalizację snapshotów

🔧 Inne:

• Używaj najnowszej wersji
• Sprawdź uprawnienia
• Upewnij się, że Python 3 jest zainstalowany

---

Pomoc i wsparcie

• Wpisz mygit help
• Odwiedź web panel → „Pomoc”
• Sprawdź logi błędów

---

mygit v1.2.0 | Lokalny system wersjonowania | MIT License