Pierwsze wydanie 0.1.2

🌲 Plot FS Tree v0.1.2

Narzędzie CLI do wizualizacji struktury plików w terminalu. Skanuje katalogi na podstawie zaawansowanych wzorców (włączeń/wykluczeń) i generuje kolorowe drzewo ASCII.

Repozytorium: https://github.com/mod-by-cis/plot-path-tree-by-pattern
Wydania: https://github.com/mod-by-cis/plot-path-tree-by-pattern/releases

---

📥 1. Pobieranie (Gotowe pliki)

Nie musisz nic instalować. Pobierz archiwum dla swojego systemu z sekcji Assets na dole strony, rozpakuj je i uruchom.

System	Architektura	Plik do pobrania	Opis
Windows	64-bit (Standard)	cargo-plot-fs-tree-x86_64-windows.zip	Windows 10/11 (Intel/AMD)
Windows	32-bit (Legacy)	cargo-plot-fs-tree-i686-windows.zip	Starsze systemy Windows
Linux	64-bit (MUSL)	cargo-plot-fs-tree-x86_64-linux.tar.gz	Uniwersalna. Ubuntu, Debian, Fedora, Alpine
Linux	32-bit (GNU)	cargo-plot-fs-tree-i686-linux.tar.gz	Starsze systemy Linux 32-bit
macOS	Apple Silicon	cargo-plot-fs-tree-aarch64-macos.tar.gz	Procesory M1/M2/M3
macOS	Intel	cargo-plot-fs-tree-x86_64-macos.tar.gz	Starsze Maki z Intelem

---

⚠️ 2. Pierwsze uruchomienie (Ważne!)

Ponieważ pliki binarne nie są podpisane cyfrowo (brak certyfikatu developera), systemy mogą je blokować. Wykonaj te kroki jednorazowo po rozpakowaniu.

🪟 Windows

# Windows
cargo-plot-fs-tree.exe --help

🪟 Windows (Wersja PowerShell)

Jeśli chcesz używać skryptu .ps1 zamiast .exe, musisz zezwolić na wykonywanie skryptów w bieżącej sesji:

Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
.\ps1\plot-fs-tree.ps1

🐧 Linux

Należy nadać plikowi uprawnienia do wykonywania:

# Linux
./cargo-plot-fs-tree --help

# Jeśli zainstalowano przez Cargo
cargo plot-fs-tree --help

Należy nadać plikowi uprawnienia do wykonywania:

# Linux
chmod +x cargo-plot-fs-tree
./cargo-plot-fs-tree --help

🍎 macOS (Apple)

System zablokuje plik z komunikatem o "Nieznanym deweloperze". Należy zdjąć flagę kwarantanny i nadać uprawnienia:

# macOS (Apple)

# 1. Zdejmij blokadę kwarantanny
xattr -d com.apple.quarantine cargo-plot-fs-tree

# 2. Nadaj uprawnienia wykonywania
chmod +x cargo-plot-fs-tree

# 3. Uruchom
./cargo-plot-fs-tree --help

🦀 3. Instalacja przez Cargo (Alternatywa)

Jeśli masz Rust, zainstaluj narzędzie jako wtyczkę globalną:

# Instalacja
cargo install --git https://github.com/mod-by-cis/plot-path-tree-by-pattern

# Aktualizacja
cargo install --git https://github.com/mod-by-cis/plot-path-tree-by-pattern --force

# Z kodu źródłowego (Lokalnie)
cargo install --path .
cargo install --path .  --force

---

🚀 Jak używać?

A. Wersja Rust (CLI)

Pomoc:

# Windows
cargo-plot-fs-tree.exe --help

# Linux / macOS
./cargo-plot-fs-tree --help

# Jeśli zainstalowano przez Cargo
cargo plot-fs-tree --help

Dostępne opcje:

Usage: cargo-plot-fs-tree [OPTIONS]

Options:
  -l, --location <LOCATION>    Ścieżka początkowa (domyślnie .)
  -p, --patterns <PATTERNS>    Wzorce oddzielone przecinkami (np. "**/*, !target/")
  -s, --strategy <STRATEGY>    Strategia sortowania: name, ext-name, deep-ext
      --dir-first              Czy wyświetlać foldery jako pierwsze?
      --ext-depth <EXT_DEPTH>  Głębokość sortowania rozszerzeń (dla strategii deep-ext) [default: 4]
  -h, --help                   Print help
  -V, --version                Print version

Przykłady:

# Tryb interaktywny (Menu TUI)
cargo plot-fs-tree

# Szybkie skanowanie z parametrami
cargo plot-fs-tree -l "." -p "**/*.rs, !target/" --dir-first

---

B. Wersja PowerShell (Skrypt)

Dla użytkowników Windows dostępny jest natywny skrypt (w folderze ps1 w kodzie źródłowym), który nie wymaga kompilacji.

Uruchomienie:

.\ps1\plot-fs-tree.ps1 -pathLocation "<ŚCIEŻKA>" `
                       -pathPatterns "<WZORCE>" `
                       -sortPriority "<PRIORYTETY>" `
                       -sortStrategy "<STRATEGIA>" `
                       -sortExtDepth <GŁĘBOKOŚĆ> `
                       -sortDirFirst

Przykład:

.\ps1\plot-fs-tree.ps1 -pathLocation "." -pathPatterns "**/*.rs", "!git/" -sortDirFirst

---

---

Full Changelog: v.0.1.1...v0.1.2