Dalang (Data Analytics LANGuage)

Dalang adalah bahasa analisis data yang mudah dibaca, dirancang untuk pengguna DAX/Power BI dan analis data, dari pemula awam sampai mahir. Konteks perhitungan selalu tertulis eksplisit di kode, dan pesan error berbahasa Indonesia.

LET sales = LOAD CSV "penjualan.csv"

MODEL Store
    TABLES sales
    CALENDAR sales.tanggal
    MEASURE Omzet = SUM(sales.nilai)
    MEASURE Growth = (Omzet - Omzet PREVIOUS YEAR) / Omzet PREVIOUS YEAR
END MODEL

SHOW Omzet, Growth BY kota WHERE YEAR = 2025
EXPLAIN Omzet AT kota = "Jakarta", YEAR = 2025

Status versi 0.1.0

Versi 0.1.0 adalah versi pertama yang bisa menjalankan program. Program .dal diperiksa, diterjemahkan ke Python, lalu dijalankan di atas DuckDB.

• dal run: menjalankan file .dal.
  • --set nama=nilai mengganti nilai PARAMETER (boleh berulang).
  • --show-python menampilkan kode Python hasil terjemahan.
• dal check: memeriksa file .dal tanpa menjalankannya (lihat daftar di bawah).
• dal parse: menampilkan cara Dalang membaca program, dengan setiap ekspresi berkurung lengkap.

Yang sudah bisa dijalankan:

• LOAD CSV (pemisah ;, ,, tab, atau | dikenali otomatis), SAVE ... AS CSV;
• tabel: WHERE, SELECT, SORT BY ... DESCENDING, kolom baru LET sales.pajak = nilai * 0.11, RENAME, REMOVE, FILL, APPEND;
• SHOW nilai, tabel, dan ringkasan SUM/MEAN/MEDIAN/MIN/MAX/COUNT/COUNTDISTINCT/STDEV/VARIANCE dengan BY dan WHERE, serta opsi rows, totals (dihitung ulang, bukan dijumlahkan), dan show_empty;
• PLOT ... BY ...: grafik teks di layar, dan file PNG bila matplotlib terpasang;
• LET, SET, PARAMETER, IF, FOR, FOR EACH (daftar atau baris tabel), WHILE, EXIT, CONTINUE, FUNCTION, RETURN, TRY/CATCH, FAIL;
• USE PYTHON "paket" AS alias;
• aturan MISSING: operasi dengan MISSING menghasilkan MISSING, dan pembagian dengan nol menghasilkan MISSING disertai peringatan;
• angka ditampilkan dalam format Indonesia: 1.250.000, 42,9.

Keamanan: nilai dari program tidak pernah disambung ke teks SQL. Semua nilai dikirim sebagai parameter kueri.

Belum didukung di 0.1.0 (pesan jelas, program tidak dijalankan sebagian): MODEL/MEASURE/RELATE/CALENDAR, pengubah waktu (PREVIOUS, LAST, TO DATE), AT, IGNORE FILTER, AS SHARE OF, TOP, RANK, JOIN, TEST, EXPLAIN, EXPORT, ASK, FORECAST, REGRESS, USE R, modul .dal, LOAD EXCEL/PARQUET. MODEL menjadi sasaran versi 0.2.0.

Yang diperiksa dal check:

• seluruh susunan kalimat menurut Tata Bahasa v0.1 (misalnya IF tanpa THEN, WHERE tanpa kurung di dalam syarat IF/EXPECT, MEASURE di luar MODEL, kata kunci dipakai sebagai nama);
• teks yang belum ditutup, karakter tak dikenal, kurung tak berpasangan, != (gunakan <>);
• bentuk lama yang tidak berlaku (PRINT, REM, ELSEIF, NEXT sebagai penutup FOR, DESC, satuan jamak seperti MONTHS);
• nama dan kolom yang tidak ada, dengan saran nama yang mirip (dibaca dari header CSV);
• aturan MODEL: TABLES wajib, kunci RELATE unik, CALENDAR bertipe tanggal, nama measure tidak sama dengan nama kolom;
• PREVIOUS, LAST, dan ... TO DATE tanpa konteks waktu, termasuk lewat measure lain;
• operasi aritmetika pada teks, termasuk WHERE tanpa kurung yang menelan pembagian;
• FOR EACH ROW OF hanya untuk ekspresi berisi measure;
• LET/SET/PARAMETER (parameter hanya-baca), fungsi bawaan dan jumlah argumennya, nama fungsi lama seperti AVERAGE;
• keseimbangan blok IF/FOR/WHILE/FUNCTION/MODEL/TEST/TRY dengan END pasangannya;
• USE dan PARAMETER wajib di bagian atas file, dan USE wajib memakai AS;
• koma di dalam WHERE (syarat digabung dengan AND/OR);
• TOP tanpa BY.

Pemasangan dan pemakaian

pip install dalang
dal --version
dal check analisis.dal
dal run analisis.dal
dal run analisis.dal --set tahun=2024

Untuk grafik PNG: pip install "dalang[grafik]".

Contoh dal run (Program 2 di examples/):

610
kota     SUM(sales.nilai)  COUNT(sales)
-------  ----------------  ------------
Bandung               150             3
Jakarta               460             5

Contoh keluaran dal check:

Kesalahan di analisis.dal baris 1:
    PRINT Omzet
    ^^^^^
PRINT tidak ada di Dalang. Gunakan SHOW.

[GAGAL] analisis.dal: 1 kesalahan

Pengembangan

pip install -e ".[dev]"
pytest

Folder examples/ berisi Program Target 1–9 dan kasus error E1–E6 yang menjadi golden test. Program 1–4 dijalankan penuh oleh tests/test_run.py.

Lisensi

Dalang dirilis di bawah Apache License 2.0.