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 — narzedzie cli do uruchamaia i kompilacji samych plików .hacker (służy do drobnych skryptów, programów, projektów).
hli — skrót od hacker lang interface narzędzie ma większe zastosowanie niz hackerc wymaga pliku bytes.yaml (służy do dużych projektów, programów, skryptów).
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 hackerc, hli, hlh i bytes

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

hackerc run {plik.hacker} Uruchamia plik .hacker bez kompilacji.
hackerc compile {plik.hacker} Kompiluje plik .hacker do binarki.
hackerc check {plik.hacker} Szuka błedów w .hacker.
hackerc repl Uruchamia interaktywny REPL Hacker Lang.
hackerc version Wyświetla wersję hackerc.
hli run Uruchamia bytes.yaml.
hli compile Kompiluje kod na podstawie bytes.yaml.
hli check Sprawdza poprawność kodu na podstawie bytes.yaml.
hli init Tworzy przykładowy projekt z bytes.yaml, .hacker w bieżącym katalogu.
hli clean Czyści cache oraz pliki tymczasowe.
hli version Wyświetla wersję hli.
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.
hlh Informacje o narzędziach hli, hackerc, bytes.

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