🚀 Fitur Utama

• 🗣️ Sintaksis Akrab: Menggunakan kata kerja dan instruksi dalam Bahasa Sunda (Lemes & Loma).
• 🛠️ Full Featured: Mendukung variabel, fungsi, pengkondisian, perulangan, hingga OOP (Class).
• 🛡️ Error Handling: Mekanisme coba-cekel (try-catch) yang intuitif.
• 🎨 Tooling: Tersedia ekstensi VS Code untuk syntax highlighting.

📥 Instalasi (ᮄᮔ᮪ᮞ᮪ᮒᮜᮞᮤ)

Basa pemrograman ieu parantos mimiti aya dina PyPI.

Cara 1: Install via pip (Direkomendasikan)

pip install sunda-language

Lajeng jalankeun:

sunda examples/hello_world.sunda

Cara 2: Jalankan manual via Python

Pastikan Anda berada di direktori root proyek:

python -m sunda_language examples/program_simpel.sunda

Cara 3: Google Colab (Notebook)

Sunda Language ogé dilengkepan fitur khusus (IPython Magic) sangkan tiasa koding langsung tanpa nyieun file di sel Jupyter/Colab.

Dina sel kode, jalankeun pamasangan paket sarta load extension-na:

!pip install sunda-language
%load_ext sunda_language.ipython_magic

Saatosna éta, anjeun kantun nganggo magic %%sunda dina luhureun sel:

%%sunda
nyieun nami = "Colab";
tampilkeun "Halo ti " + nami + "!";

💻 Panduan Sintaksis (ᮞᮤᮔ᮪ᮒᮊ᮪ᮞ᮪)

1. Tipe Data & Variabel

Sunda Language mendukung tipe data Dinamis:

nyieun nami = "Asep";         # String
nyieun umur = 25;              # Angka
nyieun mahasiswa = leres;      # Boolean (leres/lepat)
nyieun data = kosong;          # Null (kosong)

2. Struktur Kontrol (Upami & Perulangan)

Pengkondisian:

upami umur >= 17:
    tampilkeun "Atos tiasa gaduh KTP";
lainna:
    tampilkeun "Teu acan tiasa";
anggeus

Perulangan (Pikeun):

pikeun i = 1 ti 5 ngajalankeun
    tampilkeun "Iterasi ka: " + i;
anggeus

3. Pungsi (Fungsi)

pungsi sapa(nami):
    balikkeun "Wilujeng sumping, " + nami;
anggeus

tampilkeun sapa("Baraya");

4. OOP (Kelas)

kelas Jalma:
    pungsi __mimitian__(nami):
        ieu.nami = nami;
    anggeus

    pungsi sebatNami():
        tampilkeun "Nami simkuring nyaeta " + ieu.nami;
    anggeus
anggeus

nyieun asep = anyar Jalma("Asep");
asep.sebatNami();

5. Input User (Tanya)

Gunakeun perintah tanya atanapi mangga_eusian pikeun ménta input ti pamaké:

tanya nami;
tampilkeun "Halo " + nami;

6. Ngolah Kasalahan (Try-Catch)

Tangkap error (kasalahan) nuju runtime sangkan program moal crash:

coba:
    nyieun hasil = 10 / 0;
cekel e:
    tampilkeun "Aya kasalahan: " + e;
tungtungna:
    tampilkeun "Beres diolah.";
anggeus

📜 Koding Nganggo Aksara Sunda (ᮊᮧᮓᮤᮀ ᮍᮀᮌᮧ ᮃᮊ᮪ᮞᮛ ᮞᮥᮔ᮪ᮓ)

Sunda Language nampi pisan ngetik langsung nganggo naskah Aksara Sunda. Ieu conto-conto kode anu tiasa dijalankeun di Aksara Playground:

1. Hello World (ᮠᮜᮧ ᮞᮥᮔ᮪ᮓ)

ᮒᮙ᮪ᮕᮤᮜ᮪ᮊᮩᮔ᮪ "ᮠᮜᮧ ᮞᮥᮔ᮪ᮓ! 🌺";

2. Variabel & Angka Sunda (᮱-᮹)

ᮑᮤᮉᮔ᮪ ᮃ = ᮱᮰;
ᮑᮤᮉᮔ᮪ ᮘ = ᮵;
ᮒᮙ᮪ᮕᮤᮜ᮪ᮊᮩᮔ᮪ ᮃ + ᮘ;

3. Kondisi (ᮅᮕᮙᮤ)

ᮑᮤᮉᮔ᮪ ᮃ = ᮱᮰;
ᮅᮕᮙᮤ ᮃ > ᮵:
    ᮒᮙ᮪ᮕᮤᮜ᮪ᮊᮩᮔ᮪ "ᮜᮨᮥᮙ᮪ᮕᮒ᮪ ᮃ ";
ᮃᮀᮌᮩᮞ᮪

4. Perulangan (ᮕᮤᮊᮩᮔ᮪)

ᮕᮤᮊᮩᮔ᮪ ᮄ = ᮱ ᮒᮤ ᮳ ᮍᮏᮜᮔ᮪ᮊᮩᮔ᮪
    ᮒᮙ᮪ᮕᮤᮜ᮪ᮊᮩᮔ᮪ ᮄ;
ᮃᮀᮌᮩᮞ᮪

5. Pungsi (ᮕᮥᮀᮞᮤ)

ᮕᮥᮀᮞᮤ ᮒᮙ᮪ᮘᮠ᮪(ᮃ, ᮘ):
    ᮘᮜᮤᮊ᮪ᮊᮩᮔ᮪ ᮃ + ᮘ;
ᮃᮀᮌᮩᮞ᮪

ᮒᮙ᮪ᮕᮤᮜ᮪ᮊᮩᮔ᮪ ᮒᮙ᮪ᮘᮠ᮪(᮱᮰, ᮵);

6. Input (ᮒᮑ)

ᮒᮙ᮪ᮕᮤᮜ᮪ᮊᮩᮔ᮪ "ᮞᮠ ᮔᮙᮤ ᮃᮔ᮪ᮏᮩᮔ᮪?";
ᮒᮑ ᮔᮙᮤ;
ᮒᮙ᮪ᮕᮤᮜ᮪ᮊᮩᮔ᮪ "ᮠᮜᮧ, " + ᮔᮙᮤ;

📖 Kamus Keyword (ᮊᮤᮝᮧᮁᮓ᮪)

📖 Kamus Sunda - Indonesia (Terjemahan)

Kamus leutik kanggo daptar kosa kata nu digunakeun dina struktur basa pamrograman ieu. Sumber rujukan utama: SundaDigi Kamus sareng padanan umum Aksara.

🛠️ Operator & Konstanta

📂 Struktur Proyek

.
├── sunda_language/     # Kode sumber Interpreter
│   ├── __init__.py     # Metadata proyek
│   ├── lexer.py        # Analisis leksikal
│   ├── sunda_parser.py # Analisis sintaksis
│   ├── interpreter.py  # Eksekusi kode
│   └── __main__.py     # Titik masuk eksekusi (CLI)
├── examples/           # Contoh program (.sunda)
├── sunda-vscode/       # Plugin VS Code
├── pyproject.toml      # Konfigurasi instalasi PIP modern
├── MANIFEST.in         # Konfigurasi pengepakan distribusi
└── README.md           # Dokumentasi

🤝 Kontribusi (ᮊᮧᮔ᮪ᮒᮢᮤᮘᮥᮞᮤ)

Kami nampi pisan kontribusi ti sadayana pikeun ngembangkeun basa ieu!

1. Fork repositori ieu.
2. Buat cabang (git checkout -b fitur-anyar).
3. Commit parobahan (git commit -m 'Nambahkeun fitur anyar').
4. Push (git push origin fitur-anyar).
5. Pull Request.