🇮🇩 NUSADATA

Bahasa Pemrograman Data Nusantara

"Bicara soal Data, Pakai Bahasa Kita Sendiri"

Apa itu NUSADATA?

NUSADATA adalah bahasa pemrograman data berbasis Python yang ditulis sepenuhnya dalam Bahasa Indonesia dengan gaya komunikasi Generasi Z — kasual, langsung, mudah dipahami, tetapi tetap profesional dan powerful.

Perbandingan

Quick Start

Install

pip install nusadata

Hello World

Buat file halo.nds:

tampilin "Halo, Dunia! 🇮🇩"

Jalankan:

nusadata jalankan halo.nds

Analisis Data

// Baca data penjualan
masukin data dari "penjualan.csv"

// Lihat info
tampilin data.lima_baris_pertama()

// Statistik
tampilin "Rata-rata: " + teks(data.kolom("harga").rata_rata())
tampilin "Total: " + teks(data.kolom("total").jumlah())

// Filter
punya teknologi = data[data["kategori"] == "Teknologi"]
tampilin "Teknologi: " + teks(teknologi.jumlah_baris()) + " produk"

// Visualisasi
gambarrin data pakai "batang" dari kolom "kategori" dan "total"

CLI Commands

# Jalankan program
nusadata jalankan program.nds
nusadata jalankan program.nds --debug    # Lihat kode Python
nusadata jalankan program.nds --show-ast # Lihat AST tree

# Mode interaktif (REPL)
nusadata mulai

# Buat project baru
nusadata buat my_project

# Compile ke Python
nusadata kompile program.nds

# Package manager
nusadata install nusadata.stats
nusadata packages

# Info
nusadata versi
nusadata dokumentasi
nusadata test

REPL Commands

nusadata> bantuan     # Tampilkan bantuan
nusadata> variabel    # Lihat semua variabel
nusadata> riwayat     # Lihat riwayat perintah
nusadata> bersihkan   # Bersihkan layar
nusadata> keluar      # Keluar

Fitur Utama

📊 Data Operations

masukin data dari "penjualan.csv"

// Filter
punya filtered = data[data["harga"] > 100000]

// Sort
punya sorted = data.urutin("total", "menurun")

// GroupBy
punya grouped = data.kelompokin("kategori").agg({"total": "sum"})

// Clean
punya bersih = data.bersihin().buang_duplikat()

📈 Statistik

tampilin data.kolom("harga").rata_rata()
tampilin data.kolom("harga").tengah()
tampilin data.kolom("harga").terkecil()
tampilin data.kolom("harga").terbesar()
tampilin data.kolom("total").jumlah()
tampilin data.ringkasan()

📊 Visualisasi

gambarrin data pakai "batang" dari kolom "kategori" dan "total"
gambarrin data pakai "garis" dari kolom "tanggal" dan "penjualan"
gambarrin data pakai "lingkaran" dari kolom "total" dan "kategori"
gambarrin data pakai "titik" dari kolom "umur" dan "pendapatan"

🤖 Machine Learning

model.latih(data_latih, y_latih)
punya prediksi = model.tebak(data_uji)
tampilin model.akurasi()

📦 Package Manager

nusadata install nusadata.stats    # Install package
nusadata packages                  # Lihat semua packages

🇮🇩 Error Handling Ramah

┌─────────────────────────────────────────────────────┐
│  ❌  Kolom atau key "hrga" ga ditemukan.            │
│                                                     │
│  💡 Cek ejaan nama kolomnya.                        │
│     Ketik data.kolom_semua() untuk lihat semua.     │
│                                                     │
│  📝 Tipe error: KeyError                            │
└─────────────────────────────────────────────────────┘

Keyword Lengkap

Lihat Cheat Sheet Lengkap untuk daftar lengkap.

Struktur Direktori

nusadata/
├── src/
│   └── nusadata/
│       ├── __init__.py          # Package init
│       ├── lexer.py             # Tokenizer (60+ keywords)
│       ├── parser.py            # Parser (AST generator)
│       ├── codegen.py           # Python code generator
│       ├── runtime/             # Runtime engines
│       │   ├── handler.py       # Error handler (friendly messages)
│       │   ├── dataframe.py     # DataFrame operations
│       │   ├── stats.py         # Statistics engine
│       │   ├── chart.py         # Visualization engine
│       │   ├── ml.py            # Machine Learning engine
│       │   ├── clean.py         # Data cleaning engine
│       │   └── db.py            # Database connector
│       ├── packages/            # Package manager
│       │   ├── __init__.py      # PackageRegistry class
│       │   └── registry.json    # Package registry
│       └── cli/                 # Command line tools
│           └── main.py          # Main CLI entry
├── tests/                       # 475+ tests
│   ├── test_lexer.py           # 76 tests
│   ├── test_parser.py          # 81 tests
│   ├── test_codegen.py         # 115 tests
│   ├── test_integration.py     # 23 tests
│   ├── test_runtime.py         # 76 tests
│   ├── test_cli.py             # 40 tests
│   ├── test_cli_enhancements.py # 23 tests
│   └── test_e2e.py             # 41 tests
├── examples/
│   └── data/                   # Sample datasets
│       ├── penjualan.csv       # 20 records
│       ├── siswa.csv           # 15 records
│       └── produk.csv          # 10 records
├── docs/                       # Documentation
│   ├── architecture.md         # Arsitektur teknis
│   ├── cheat-sheet.md          # Cheat sheet lengkap
│   ├── cli-reference.md        # CLI reference
│   └── examples.md             # Contoh program
├── pyproject.toml              # Project configuration
└── README.md                   # This file

Arsitektur

Source Code (.nds)
       ↓
   [Lexer] → Tokens (60+ keywords)
       ↓
   [Parser] → AST (Abstract Syntax Tree)
       ↓
   [Code Generator] → Python Code (auto-import tracking)
       ↓
   [Runtime Engine] → Output
       ├── DataFrame Engine (Pandas/Polars)
       ├── Statistics Engine (SciPy/Statsmodels)
       ├── Visualization Engine (Matplotlib/Plotly)
       ├── ML Engine (Scikit-learn/XGBoost)
       ├── Cleaning Engine (Pandas)
       └── Database Connector (SQLAlchemy)

Test Coverage

Target Performance

Kontribusi

Kami sangat terbuka untuk kontribusi! Silakan:

1. Fork repository ini
2. Buat branch baru (git checkout -b fitur/nama-fitur)
3. Commit perubahanmu (git commit -m 'Tambah fitur baru')
4. Push ke branch (git push origin fitur/nama-fitur)
5. Buka Pull Request

Lisensi

MIT License — Silakan gunakan untuk keperluan apapun.

Kontak

• 🌐 Website: nusadata.dev
• 📚 Dokumentasi: docs.nusadata.dev
• 💬 Discord: discord.gg/nusadata
• 📧 Email: hello@nusadata.dev
• 🐙 GitHub: github.com/nusadata

NUSADATA — Data Kita, Bahasa Kita, Masa Depan Kita 🇮🇩