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.
hl — uruchamiaj kompiluj skrypty .hacker.
hli — interaktywna wersja narzędzia hl.
bytes — narzędzie do instalacji bibliotek, pluginów dla hacker lang.
hlh — skrót od hacker lang help - narzedzie pokazuje szczegółowe informacje o narzędziach hackerc, bytes, hli.

== Komendy dla narzedzi hacker lang

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

hl run {plik.hacker} Uruchamia plik .hacker bez kompilacji.
hl compile {plik.hacker} Kompiluje plik .hacker do binarki.
hl check {plik.hacker} Szuka błedów w .hacker.
hl repl Uruchamia interaktywny REPL Hacker Lang.
hl version Wyświetla wersję hl.
hli Aktywuje interaktywny interfejs.
hlh Wyświetla informacje o wszystkich narzędziach cli od hacker lang.
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). Możesz również używać bibliotek z innych języków programowania | # obsidian, # bytes:obsidian, # rust:serde, # python:rich

| @ | Zmienna środowiskowa | @USER=admin

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

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

| >>> | Każda komenda jest wykonywana osobno | >>> 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

|===

== 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]