Skip to main content

AHAN

Bahasa Pemrograman Imperatif dengan Sintaks Bahasa Devayan

Berkata lewat kode.

License: MIT Python 3.8+ Status: Prototype


Daftar Isi


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

  1. Fork repositori.
  2. Buat branch fitur: git checkout -b fitur-keren.
  3. Commit: git commit -m "feat: tambah fitur keren".
  4. Push: git push origin fitur-keren.
  5. 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)

Source distribution for ahanlang 0.1.1
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)

Table of built distributions (wheels) for ahanlang 0.1.1
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page