sunda-language 1.1.0

Basa pamrograman saderhana nganggo Basa Sunda

ᮞᮥᮔ᮪ᮓ ᮜᮔ᮪ᮌᮥᮃᮌᮨ 🌺

Sampurasun! 🙏

"Ngarumat Budaya ku Teknologi"

Sunda Language adalah bahasa pemrograman interpreted yang dirancang khusus dengan sintaksis berbasis Bahasa Sunda. Proyek ini bertujuan untuk memperkenalkan logika pemrograman melalui pendekatan kearifan lokal (Nusantara).

---

🚀 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é tiasa pisan dijalankeun ngagunakeun Google Colab atawa Jupyter Notebook.

Dina sel kode, jalankeun pamasangan paket ieu:

!pip install sunda-language

Damel file kode program Sunda-na nganggo magics %%writefile:

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

Jalankeun file éta nganggo pre-fix !:

!sunda program.sunda

---

💻 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 (ᮊᮤᮝᮧᮁᮓ᮪)

Keyword	Sinonim	Padanan Inggris
nyieun	ngadeklarasikeun	var / let
tampilkeun	-	print / console.log
upami	-	if
lamun	-	else if
lainna	lain lamun	else
pikeun	-	for
bari	-	while
pungsi	-	function
balikkeun	-	return
coba	-	try
cekel	-	catch
anyar	-	new
ieu	-	this / self

---

📖 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.

Basa Sunda	Bahasa Indonesia
nyieun / ngadeklarasikeun	Membuat / Mendeklarasikan
tampilkeun	Tampilkan / Perlihatkan
tanya / mangga_eusian	Tanya / Silakan isi (Input)
upami	Jikalau / Seandainya / Jika
lamun	Kalau / Misal
lainna / lain lamun	Lainnya / Atau Kalau (Sebaliknya)
pikeun	Untuk (Bagi)
ti ... nepi	Dari ... Sampai (Rentang)
bari	Sambil / Selagi (While)
ngajalankeun	Menjalankan
anggeus	Selesai / Tamat
pungsi / fungsi	Fungsi
balikkeun	Kembalikan (Return)
leres	Benar / Lurus
lepat	Salah / Keliru
jeung	Dan
atawa	Atau
lain	Bukan
kosong	Kosong / Hampa
coba	Coba
cekel	Pegang / Tangkap (Catch)
tungtungna	Pada akhirnya / Ujungnya (Finally)
balangkeun	Lemparkan (Throw)
kelas	Kelas
anyar	Baru
ieu	Ini (Konteks merujuk pada objek/diri sendiri)
turunan	Keturunan (Extends/Inherits)
eureun	Berhenti
teraskeun	Teruskan / Lanjutkan

---

🛠️ Operator & Konstanta

Logika	jeung (AND), atawa (OR), lain (NOT)
Boolean	leres (True), lepat (False)
Aritmatika	+ - * / %

---

📂 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.

Proyek ini dilisensikan di bawah MIT License

Hatur nuhun pisan! Mugia mangpaat kanggo urang sadayana! 🙏😊

Sunda Language Team © 2025 - 2026