Installation PL

Instalacja

🌍 English · Polski · Français · Deutsch · 中文

ECLI dostarcza natywne pakiety dla Linux, FreeBSD, macOS i Windows, plus wieloplatformową dystrybucję PyPI. Wybierz ścieżkę odpowiednią dla swojego środowiska.

Wybierz metodę instalacji

Metoda	Najlepsze dla	Uwagi
Natywny pakiet (.deb/.rpm/.pkg/.dmg/.exe)	Produkcja, instalacja systemowa	Pojedynczy binary, bez Pythona
PyPI (pip install ecli-editor)	Pythonowcy, virtualenvs, CI	Wymaga Python 3.11+ i zależności systemowych
Ze źródeł	Contributors, custom builds	Patrz build-from-source.md

Wszystkie artefakty są na stronie Releases. Każdy binary ma plik .sha256 do weryfikacji.

---

Linux

Debian / Ubuntu

# Pobierz
wget https://github.com/SSobol77/ecli/releases/download/v0.1.3/ecli_0.1.3_linux_x86_64.deb
wget https://github.com/SSobol77/ecli/releases/download/v0.1.3/ecli_0.1.3_linux_x86_64.deb.sha256

# Sprawdź integralność
sha256sum -c ecli_0.1.3_linux_x86_64.deb.sha256

# Zainstaluj
sudo apt install ./ecli_0.1.3_linux_x86_64.deb

Fedora / RHEL / Rocky / CentOS Stream

wget https://github.com/SSobol77/ecli/releases/download/v0.1.3/ecli_0.1.3_linux_x86_64.rpm
sudo dnf install ./ecli_0.1.3_linux_x86_64.rpm

Arch Linux / Manjaro

Brak pakietu AUR (na razie). Użyj tarballa:

wget https://github.com/SSobol77/ecli/releases/download/v0.1.3/ecli_0.1.3_linux_x86_64.tar.gz
tar -xzf ecli_0.1.3_linux_x86_64.tar.gz
sudo mv ecli /usr/local/bin/

Generic Linux (każda dystrybucja)

Użyj tarballa powyżej, lub zainstaluj z PyPI (patrz niżej).

Wymagane biblioteki systemowe

Binarki ECLI są samowystarczalne, ale kilka bibliotek systemowych musi być obecnych:

# Debian / Ubuntu
sudo apt install libncursesw6 libtinfo6

# Fedora / RHEL
sudo dnf install ncurses

# Arch
sudo pacman -S ncurses

---

FreeBSD

fetch https://github.com/SSobol77/ecli/releases/download/v0.1.3/ecli_0.1.3_freebsd_x86_64.pkg
sudo pkg add ./ecli_0.1.3_freebsd_x86_64.pkg

ECLI na FreeBSD wymaga ncurses i libyaml (instalowane automatycznie przez zależności pakietu).

---

macOS

ECLI dostarczany jest jako Universal2 DMG, ad-hoc signed (bez notaryzacji). Pierwsze uruchomienie wymaga ręcznego zatwierdzenia.

# Pobierz
curl -LO https://github.com/SSobol77/ecli/releases/download/v0.1.3/ecli_0.1.3_macos_universal2.dmg

# Zamontuj i skopiuj
open ecli_0.1.3_macos_universal2.dmg
# Przeciągnij ECLI do /Applications, lub skopiuj binarkę:
cp /Volumes/ECLI/ecli /usr/local/bin/

Pierwsze uruchomienie zostanie zablokowane przez Gatekeeper. Dwie opcje:

Opcja A (GUI):

• Otwórz System Settings → Privacy & Security
• Przewiń na dół — zobaczysz "ecli was blocked"
• Kliknij "Open Anyway"

Opcja B (CLI):

xattr -d com.apple.quarantine /usr/local/bin/ecli

Pełne uwagi: docs/install/macos.md.

---

Windows

Dostępne dwa artefakty:

Installer (rekomendowany)

curl.exe -LO https://github.com/SSobol77/ecli/releases/download/v0.1.3/ecli_0.1.3_win_x86_64_setup.exe
.\ecli_0.1.3_win_x86_64_setup.exe

Installer rejestruje ECLI w Programs and Features, dodaje do PATH i tworzy skróty w menu Start.

Portable

curl.exe -LO https://github.com/SSobol77/ecli/releases/download/v0.1.3/ecli_0.1.3_win_x86_64.exe
.\ecli_0.1.3_win_x86_64.exe README.md

Bez instalacji — uruchamia się z dowolnego katalogu.

Windows SmartScreen ostrzeże przy pierwszym uruchomieniu (niepodpisany executable). Kliknij "More info" → "Run anyway".

Pełne uwagi: docs/install/windows.md.

---

PyPI (każda platforma)

Wymaga Python 3.11 lub nowszy.

# Systemowo (niezalecane na zarządzanych systemach)
pip install ecli-editor

# User install
pip install --user ecli-editor

# W virtualenv (rekomendowane)
python3 -m venv ~/.venv/ecli
source ~/.venv/ecli/bin/activate
pip install ecli-editor

Weryfikacja:

ecli --version

Zależności systemowe (biblioteki terminala) nadal muszą być obecne — patrz komendy per dystrybucja powyżej.

---

Weryfikacja sum kontrolnych

Każdy artefakt release ma sidecar .sha256. Zweryfikuj przed instalacją:

# Linux / macOS / FreeBSD
sha256sum -c ecli_0.1.3_linux_x86_64.deb.sha256

# Windows PowerShell
Get-FileHash -Algorithm SHA256 ecli_0.1.3_win_x86_64_setup.exe
# Porównaj ręcznie z zawartością pliku .sha256

---

Deinstalacja

Platforma	Polecenie
Debian / Ubuntu	sudo apt remove ecli
Fedora / RHEL	sudo dnf remove ecli
FreeBSD	sudo pkg remove ecli
macOS	Usuń /usr/local/bin/ecli lub przeciągnij z /Applications do Kosza
Windows	Programs and Features → ECLI → Uninstall
PyPI	pip uninstall ecli-editor

Konfiguracja zostaje pod ~/.config/ecli/ (Linux/FreeBSD), ~/Library/Application Support/ecli/ (macOS), lub %APPDATA%\ecli\ (Windows). Usuń ręcznie jeśli chcesz.

---

Rozwiązywanie problemów

Patrz Rozwiązywanie problemów:

• "ecli: command not found"
• "Library not loaded" (macOS)
• "VCRUNTIME140.dll missing" (Windows)
• Permission denied
• Locale i UTF-8