Daftar Isi
- Tentang AHAN
- Fitur Utama
- Arsitektur
- Instalasi
- Penggunaan Cepat
- Contoh Kode
- Dokumentasi
- Teknologi yang Digunakan
- Status Proyek
- Berkontribusi
- Lisensi
Tentang AHAN
AHAN adalah bahasa pemrograman imperatif sumber terbuka yang menggabungkan kesederhanaan sintaks bergaya Python dengan kekayaan kosakata bahasa Devayan — bahasa asli masyarakat Pulau Simeulue, Aceh, Indonesia.
Nama AHAN diambil dari kata kunci utamanya, ahan, yang berarti "mengucapkan" atau "berkata". Filosofinya sederhana: menulis program adalah cara berkata kepada komputer, dan ahan adalah perintah untuk menyampaikan sesuatu.
Proyek ini bertujuan untuk:
- Edukasi — menjadi media pembelajaran konsep lexer, parser, evaluator, dan desain bahasa pemrograman.
- Pelestarian Budaya — memperkenalkan bahasa Devayan ke ranah teknologi modern.
- Eksperimen — menjadi playground untuk ide-ide bahasa pemrograman yang unik.
Catatan: AHAN saat ini berada dalam tahap prototipe. API dan sintaks dapat berubah sewaktu-waktu.
Fitur Utama
| Kategori | Fitur |
|---|---|
| Paradigma | Imperatif, dengan dukungan closure |
| Sintaks | Indentasi (seperti Python), kata kunci Devayan |
| Tipe Data | Integer, Float, String, Boolean, Null, List, Dictionary |
| Kontrol Alur | anga/laenne, salamo, mek/bak, kajab, lanjar |
| Fungsi | fungsi, balekken/muba, closure, rekursi |
| Modularitas | Import file dengan pakek |
| Error Handling | cubo/adorapek, error dengan posisi baris/kolom |
| List & Dict | Indexing, slicing, modifikasi elemen |
| I/O | ahan/kaluarken, baco/mitidao, antoroman |
| Operator | Aritmetika, perbandingan, logika, assignment gabungan |
Arsitektur
AHAN diimplementasikan sebagai tree-walking interpreter dengan tiga tahap klasik:
┌─────────────┐ ┌──────────┐ ┌─────────┐ ┌───────────┐
│ Source Code │───▶│ Lexer │───▶│ Parser │───▶│ Evaluator │
│ (.ahan) │ │ (Tokens) │ │ (AST) │ │ (Hasil) │
└─────────────┘ └──────────┘ └─────────┘ └───────────┘
| File | Peran |
|---|---|
token_types.py |
Konstanta jenis token |
lexer.py |
Tokenisasi kode sumber (indentasi, bracket, string, angka) |
ast_nodes.py |
Definisi node AST |
parser.py |
Pembangunan AST dari token (recursive descent) |
evaluator.py |
Eksekusi AST dengan environment chain |
main.py |
Entry point (REPL dan file runner) |
Detail lengkap ada di docs/ARCHITECTURE.md.
Instalasi
Prasyarat
- Python 3.8 atau lebih baru
Langkah Instalasi
# 1. Clone repositori
git clone https://github.com/AlfinGnw/ahanlang.git
cd ahanlang
# 2. (Opsional) Buat virtual environment
python -m venv venv
source venv/bin/activate # Linux/macOS
venv\Scripts\activate # Windows
# 3. Jalankan program pertama
python main.py examples/halo.ahan
Tidak ada dependensi eksternal — AHAN hanya menggunakan Python Standard Library.
Penggunaan Cepat
Menjalankan File
python main.py namafile.ahan
Mode Interaktif (REPL)
python main.py
Contoh sesi REPL:
AHAN REPL v1.1
Ketik 'kaluar' atau Ctrl+D untuk keluar.
Untuk blok multi-baris, akhiri dengan baris kosong.
ahan> fungsi halo(nama):
... ahan("Halo, " + nama)
...
ahan> halo("Alfin")
Halo, Alfin
ahan> kaluar
Contoh Kode
1. Program Hello World
nama = "Dunia"
ahan("Halo, " + nama + "!")
2. Fungsi Rekursif
fungsi faktorial(n):
anga n <= 1:
balekken 1
laenne:
balekken n * faktorial(n - 1)
ahan(faktorial(5)) # 120
3. Closure
fungsi pembuat_kali(faktor):
fungsi kali(x):
balekken x * faktor
balekken kali
kali_dua = pembuat_kali(2)
ahan(kali_dua(10)) # 20
4. List dan Dictionary
daftar = [10, 20, 30]
daftar[0] = 100
ahan(daftar[1:3]) # [20, 30]
orang = {"nama": "Alfin", "umur": 25}
orang["umur"] += 1
ahan(orang["umur"]) # 26
5. Try/Except
cubo:
hasil = 10 / 0
adorapek pesan:
ahan("Error: " + pesan)
Dokumentasi
| Dokumen | Deskripsi |
|---|---|
| docs/SYNTAX.md | Panduan sintaks lengkap |
| docs/KEYWORDS.md | Daftar lengkap kata kunci Devayan |
| docs/STANDARD_LIBRARY.md | Built-in function dan utilitas |
| docs/ARCHITECTURE.md | Detail arsitektur interpreter |
| docs/ROADMAP.md | Rencana pengembangan |
Teknologi yang Digunakan
Bahasa Implementasi
| Teknologi | Versi | Peran |
|---|---|---|
| Python | 3.8+ | Bahasa utama implementasi interpreter |
Konsep Ilmu Komputer
- Lexical Analysis — tokenisasi dengan hand-written lexer.
- Recursive Descent Parsing — parsing top-down untuk membangun AST.
- Tree-Walking Interpreter — evaluasi AST secara langsung.
- Environment Chain — scope variabel dengan linked environment untuk closure.
- Exception-Based Control Flow — exception Python untuk sinyal
return,break,continue,exit.
Standar Library Python
sys— argumen command-line dan I/O.os— resolusi path untuk import modul.copy— penyalinan node untuk closure.
Tidak Menggunakan
- Parser generator (ANTLR, Yacc, PLY) — agar konsep parsing dipahami sepenuhnya.
- LLVM atau backend kompilasi — fokus pada kesederhanaan.
- Framework web atau ORM — proyek ini murni interpreter.
Status Proyek
| Aspek | Status |
|---|---|
| Versi | 0.1.0 (prototipe) |
| Stabilitas API | ❌ Belum stabil |
| Cakupan Test | ⚠️ Manual testing |
| Dokumentasi | ✅ Lengkap |
| Distribusi PyPI | ⏳ Direncanakan |
| Web Playground | ⏳ Direncanakan |
Berkontribusi
Kontribusi sangat diterima — baik laporan bug, usulan fitur, perbaikan dokumentasi, maupun pull request.
Lihat CONTRIBUTING.md untuk panduan lengkap.
Alur Cepat
- Fork repositori.
- Buat branch fitur:
git checkout -b fitur-keren. - Commit:
git commit -m "feat: tambah fitur keren". - Push:
git push origin fitur-keren. - Buka Pull Request.
Lisensi
MIT License — lihat file LICENSE.
Ucapan Terima Kasih
- Masyarakat Simeulue atas warisan bahasa Devayan.
- Robert Nystrom atas buku Crafting Interpreters.
- Komunitas Python Indonesia atas inspirasi.
Dibuat dengan ❤️ untuk pelestarian bahasa dan edukasi teknologi.
Metadata
Release files for ahanlang 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| ahanlang-0.1.1.tar.gz | 34.7 kB | Without provenance | Details for ahanlang-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| ahanlang-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for ahanlang-0.1.1-py3-none-any.whl |
Total release size: 53.6 kB
Release files / ahanlang-0.1.1.tar.gz
| Download URL | ahanlang-0.1.1.tar.gz |
|---|---|
| Size | 34.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d69ddba89c8d7fd5c859b99e44c6a91186e3b21ebf0e4f0e69550e146f8eada6
|
|
BLAKE2b-256 checksum How to use checksums |
940ab419c3164c94728940e318e69290eb92baa38fd3b459ed1af843d8374648
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.0
|
Release files / ahanlang-0.1.1-py3-none-any.whl
| Download URL | ahanlang-0.1.1-py3-none-any.whl |
|---|---|
| Size | 18.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
59e55027dea41402b131694c8581a42205361efee8338ba42e1dbe58e04ffa62
|
|
BLAKE2b-256 checksum How to use checksums |
206e697888f91cdcdffa274766e6d8f0bf66ea2ff102ad023df1c5efc5f33bea
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.0
|
Security for ahanlang 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.