Commit 265f364
0
plików
+0
dodanych
-0
usuniętych
@@ -0,0 +1,66 @@
1
+# pag - PaganOS Package Manager
2
+
3
+Prosty, szybki menedżer pakietów dla [PaganOS](https://paganlinux.eu). Instaluje, aktualizuje i usuwa pakiety z podpisem GPG, atomową instalacją i wsparciem rollbacku.
4
+
5
+## Instalacja
6
+
7
+```bash
8
+pag install pag
9
+pag sync
10
+```
11
+
12
+## Użycie
13
+
14
+| Komenda | Opis |
15
+|---------|------|
16
+| `pag sync` | Synchronizuj indeks repozytorium |
17
+| `pag install <pakiet>` | Zainstaluj pakiet |
18
+| `pag remove <pakiet>` | Usuń pakiet |
19
+| `pag upgrade` | Aktualizuj wszystkie pakiety |
20
+| `pag search <fraza>` | Szukaj pakietu |
21
+| `pag info <pakiet>` | Pokaż szczegóły pakietu |
22
+| `pag list` | Lista zainstalowanych pakietów |
23
+| `pag rollback <pakiet>` | Przywróć poprzednią wersję |
24
+| `pag key add <plik>` | Zaimportuj klucz GPG |
25
+| `pag key list` | Lista zaufanych kluczy |
26
+| `pag self-update` | Aktualizuj samego siebie |
27
+| `pag clean` | Wyczyść cache |
28
+
29
+## Przykłady
30
+
31
+```bash
32
+pag install neovim ripgrep fd bat
33
+pag sync && pag upgrade
34
+pag search python
35
+pag rollback neovim
36
+```
37
+
38
+## Architektura
39
+
40
+```
41
+/etc/pag/repos/ # pliki .conf z URL-ami repozytoriów
42
+/etc/pag/trusted-keys.gpg # klucze GPG
43
+/var/cache/pag/repos/ # zsynchronizowane indeksy
44
+/var/cache/pag/pkgs/ # pobrane pakiety
45
+/var/lib/pag/installed.db # baza SQLite
46
+```
47
+
48
+## Format .pkg.tar.xz
49
+
50
+```
51
+pakiet-1.0-1.pkg.tar.xz
52
+├── metadata.json # nazwa, wersja, zależności, SHA256, GPG
53
+└── data.tar.xz # właściwe pliki
54
+```
55
+
56
+## Bezpieczeństwo
57
+
58
+- Podpisy GPG (klucz: `A14CBE52BE0D63F5`)
59
+- Atomowa instalacja (tmpdir → rename)
60
+- Rollback
61
+- Weryfikacja SHA256
62
+- Izolowane buildy w chroot
63
+
64
+## Licencja
65
+
66
+GPL-3.0-or-later