HackerOS-Linux-System/Hacker-Lang: A simple programming language. The Hacker Lang programming language is a scripting language.

= Hacker Lang :doctype: book :icons: font :toc: left :toclevels: 2 :author: HackerOS Team :revnumber: 0.0.2 :revdate: 2025-10-28

== Opis

Hacker Lang to lekki i wygodny język skryptowy stworzony dla HackerOS, zaprojektowany jako bezpośrednia alternatywa dla tradycyjnych skryptów .sh — zamiast skryptów shellowych używasz binarek skompilowanych z kodu .hacker.

Hacker Lang korzysta z systemu pakietów i bibliotek hostowanych w repozytorium bytes.io.

== Dlaczego Hacker Lang?

Zastępuje złożone skrypty .sh prostymi, czytelnymi plikami .hacker.
Umożliwia kompilację do binarek, co przyśpiesza uruchamianie oraz ułatwia dystrybucję.
Integruje się z repozytorium bibliotek bytes.io — instalacja i aktualizacja bibliotek odbywa się przez hackerc.
Zaprojektowany do użytku wewnętrznego w ekosystemie HackerOS, ale nadaje się też do zastosowań zewnętrznych.

== Szybkie rozpoczęcie

=== Wymagania

Dystrybucja HackerOS.
hackerc — narzędzie CLI dla Hacker Lang (dostępne w repo projektu).

== Komendy hackerc

Poniżej lista podstawowych komend dostępnych w narzędziu hackerc:

hackerc run {plik.hacker}:: Uruchamia plik .hacker bez kompilacji.
hackerc run .:: Uruchamia hacker.bytes.
hackerc compile --bytes:: Uruchamia proces kompilacji na podstawie pliku hacker.bytes.
hackerc compiler {plik.hacker} {lokalizacja}:: Kompiluje plik .hacker do binarki i zapisuje wynik w podanej lokalizacji.
hackerc check {plik.hacker}:: Sprawdza poprawność składni i podstawowe błędy logiczne w pliku.
hackerc init:: Tworzy przykładowy plik .hacker w bieżącym katalogu.
hackerc clean:: Czyści cache oraz pliki tymczasowe hackerc.
hackerc repl:: Uruchamia interaktywny REPL Hacker Lang.
hackerc version:: Wyświetla wersję hackerc.
hackerc help:: Pokazuje listę dostępnych komend i krótkie opisy.
hackerc unpack bytes:: Sprawdza czy manager zależności bytes jeżeli nie instaluje go.
bytes install:: Instaluje wybrana biblioteke.
bytes remove:: Usuwa wybrana biblioteke wybrana biblioteke.
bytes search:: Szuka wybranej biblioteki.

== Składnia i przykład prostego skryptu .hacker

Poniżej przykład prostego pliku .hacker.

[source,hacker]

// sudo // apt

sudo apt update

= Składnia Hacker Lang

|=== | Prefiks | Znaczenie | Przykład

| ! | Komentarz (cała linia jest ignorowana) | ! To jest komentarz

| // | Zależność systemowa (pakiet z apt) | // curl → sudo apt install curl

| # | Biblioteka (lib) – biblioteka z repozytorium bytes.io (zainstaluj ją za pomocą bytes install) | # obsidian

| @ | Zmienna środowiskowa | @USER=admin

| > | Komenda do wykonania | > echo "Hello"

| = | Pętla (liczba > komenda) | =3 > echo "Hi" → 3 razy

| ? | Warunek (warunek > komenda) | ? [ -f file ] > echo OK

| & | Uruchom w tle | & sleep 10

| [ | Początek sekcji konfiguracyjnej | [

| ] | Koniec sekcji konfiguracyjnej | ]

| \\ | Plugin (pluginy przechowywane w ~/.hackeros/hacker-lang/plugins/, mogą być binarkami) | \\ moj-plugin

| $ | Zmienna lokalna | $TEMP=tmp_value

| : | Funkcja/blok (początek definicji funkcji :nazwa, koniec : , wywołanie .nazwa) | :moja_funkcja ... :

| !! | Komentarz blokowy (otwarcie i zamknięcie) | !! ... !!

| ^ | Tryb superuser (dodaj sudo do komendy) | ^ > rm file → sudo rm file

|===

== Przykładowy workflow

Napisz script.hacker.
Sprawdź składnię: hackerc check script.hacker.
Uruchom testowo bez kompilacji: hackerc run script.hacker.
Skompiluj do binarki: hackerc compiler script.hacker /usr/local/bin/myscript.
Uruchamiaj bezpośrednio jako binarkę.

== Integracja z bytes.io

Hacker Lang używa repozytorium bibliotek bytes.io. Użyj bytes install <nazwa> aby pobrać paczkę; bytes update aby ją zaktualizować. Jeżeli nie masz zainstalowanego narzędzia cli bytes użyj komendy hackerc unpack bytes.

== FAQ (krótkie)

Jak debugować?:: Użyj hackerc check oraz hackerc run z dodatkowymi flagami debug (jeśli dostępne). Logi hackerc znajdują się w domyślnym katalogu cache.
Czy .hacker może wywoływać polecenia systemowe?:: Tak — użyj > aby wykonać komendę shellową.
Gdzie znaleźć dokumentację?:: Pełna dokumentacja i wiki: link:https://github.com/HackerOS-Linux-System/Hacker-Lang/wiki[Wiki na GitHubie].
Gdzie znajde repozytorium bytes.io ?:: link:https://github.com/Bytes-Repository[Repozytorium bytes.io]
Zgłoś błąd:: link:https://github.com/HackerOS-Linux-System/Hacker-Lang/issues[Issues na GitHubie]