ngapakin 1.0.0__tar.gz

ngapakin-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ilham Hatta Manggala
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ngapakin-1.0.0/PKG-INFO

@@ -0,0 +1,230 @@
+Metadata-Version: 2.4
+Name: ngapakin
+Version: 1.0.0
+Summary: Bahasa pemrograman berekstensi .ngpk dengan dialek Ngapak/Banyumasan & Larapak MVC Web Framework.
+Home-page: https://github.com/IlhamHattaManggala/ngapakin
+Author: Ilham Hatta Manggala
+Author-email: ilham.hatta@example.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+Dynamic: summary
+
+# NgapakIn & Larapak MVC 🚀
+
+[![NgapakLang CI Pipeline](https://github.com/IlhamHattaManggala/ngapakin/actions/workflows/python.yml/badge.svg)](https://github.com/IlhamHattaManggala/ngapakin/actions/workflows/python.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python Version](https://img.shields.io/badge/python-3.8%20%7C%203.9%20%7C%203.10%20%7C%203.11-blue)](https://www.python.org/)
+
+NgapakIn adalah bahasa pemrograman open-source dengan ekstensi `.ngpk`, dirancang dengan sintaksis berbasis bahasa Ngapak / Banyumasan / Indonesia. 
+Larapak adalah MVC Web Framework lengkap yang berjalan di atas VM NgapakIn, dirancang meniru arsitektur elegan Laravel dengan fungsionalitas modern seperti ORM, Migrasi, Job Queues, Session/Cookies, Validasi, Caching, Event Dispatcher, Package Manager, hingga Language Server Protocol (LSP).
+
+---
+
+## 🌟 Fitur Utama Ekosistem (Phase 1 - Phase 5)
+
+1. **Inti Bahasa NgapakIn (Phase 1 & 2)**:
+   - Sintaksis berbasis dialek Banyumasan (`gawe`, `rampung`, `nek - ya - liyane`, `balekna`).
+   - Tipe data lengkap: Angka, Teks, Boolean (`bener`/`salah`), dan Null (`kosong`).
+   - Stack-based Virtual Machine (VM) yang efisien dengan eksekusi bytecode cepat.
+2. **Larapak MVC Framework (Phase 3)**:
+   - Web Server berbasis standard library HTTP.
+   - Routing dinamis (`routes/web.ngpk`, `routes/api.ngpk`).
+   - Blade-like Template Engine dengan layouting (`@layout`, `@sekat`, `@mlebui`).
+3. **Database & ORM System (Phase 4)**:
+   - Kelas berorientasi objek (`kelas ... extends Model`).
+   - Fluent SQL Query Builder berbasis SQLite.
+   - Skema Migrasi (`schema.gawe`, `schema.buang`) dan CLI migration engine.
+4. **Ecosystem & Advanced Features (Phase 5)**:
+   - **Autentikasi**: Fitur `auth` bawaan (`mlebu`, `metu`, `user`, `cek`).
+   - **Sesi & Cookies**: Penyimpanan sesi berbasis database SQLite, helper cookies.
+   - **Validasi**: Validator input dengan aturan `required`, `email`, `numeric`, `min`, `max`.
+   - **Cache**: Penyimpanan data sementara berbasis SQLite dengan waktu kedaluwarsa (TTL).
+   - **Event/Listener**: Dispatcher event bawaan untuk pemrograman reaktif.
+   - **Job Queues**: Pemrosesan latar belakang (background queue workers) dengan `queue:work`.
+   - **Package Manager**: Pemasangan paket otomatis beserta auto-discovery Service Provider.
+   - **REPL Terminal**: Interactive terminal interaktif via `repl`.
+   - **Step Debugger**: Breakpoint debugger interaktif (`s` step, `c` continue, `l` locals, `g` globals).
+   - **VSCode Support & LSP**: Syntax highlighting TextMate & diagnostik LSP syntax errors.
+
+---
+
+## 📁 Struktur Folder Proyek
+
+```text
+ngapakin/
+├── .github/workflows/   # CI/CD Pipeline
+├── app/
+│   ├── Controllers/     # Controller Kelas Larapak
+│   ├── Jobs/            # Background Jobs
+│   ├── Middleware/      # Request Middlewares
+│   └── Models/          # Model Database (Autoloaded)
+├── database/
+│   ├── migrations/      # Berkas Migrasi Database
+│   └── seeders/         # Berkas Database Seeder
+├── editors/vscode/      # Ekstensi VSCode & LSP Server
+├── framework/           # Modul Internal Larapak Core
+├── ngapak/              # Compiler, Lexer, Parser & VM NgapakLang
+├── packages/            # Lokasi Paket yang Diinstal
+├── routes/              # Rute web & API (.ngpk)
+├── tests/               # Berkas Unit Testing
+├── ngapakin.py          # Entrypoint CLI
+└── README.md
+```
+
+---
+
+## 🛠️ Instalasi & Penggunaan
+
+### Prasyarat
+- Python 3.8 ke atas (tanpa ketergantungan pustaka pihak ketiga).
+
+### Cara Kloning & Memulai Proyek
+```bash
+git clone https://github.com/IlhamHattaManggala/ngapakin.git
+cd ngapakin
+```
+
+---
+
+## 💻 Panduan CLI Command
+
+Larapak menyediakan CLI helper komprehensif melalui `ngapakin.py`:
+
+```bash
+# Menjalankan berkas kode biasa
+python ngapakin.py run berkas.ngpk
+
+# Menjalankan server web Larapak (port default: 8000)
+python ngapakin.py serve 8000
+
+# Melihat daftar rute terdaftar
+python ngapakin.py route:list
+
+# Membuat komponen baru (Scaffolding)
+python ngapakin.py make:controller UserController
+python ngapakin.py make:model Member
+python ngapakin.py make:middleware AuthMiddleware
+python ngapakin.py make:migration create_users_table
+python ngapakin.py make:job SendEmailJob
+
+# Migrasi Database
+python ngapakin.py migrate       # Jalankan migrasi
+python ngapakin.py rollback      # Kembalikan migrasi terakhir
+python ngapakin.py db:seed       # Jalankan seeder database
+
+# Layanan Ekosistem
+python ngapakin.py cache:clear                    # Hapus data cache
+python ngapakin.py queue:work                     # Jalankan pemroses job queue
+python ngapakin.py package:install auth-helper    # Pasang paket baru
+python ngapakin.py repl                           # Masuk ke REPL interaktif
+python ngapakin.py debug berkas.ngpk              # Debug bytecode berkas
+python ngapakin.py test                           # Jalankan seluruh unit test suite
+```
+
+---
+
+## 📖 Cara Menggunakan Fitur Ekosistem
+
+### 1. Validasi & Autentikasi
+```ngapak
+# Validasi data request
+data = ["email": "ilham@example.com", "umur": 20]
+aturan = ["email": "required|email", "umur": "required|numeric|min:18"]
+
+val = validator.gawe(data, aturan)
+nek val.gagal() ya
+    tulis "Validasi Gagal!"
+    tulis val.errors()
+liyane
+    tulis "Validasi Sukses!"
+rampung
+
+# Login user
+nek auth.mlebu("ilham@example.com", "password123") ya
+    tulis "Berhasil Login!"
+    tulis auth.user().name
+liyane
+    tulis "Login Gagal!"
+rampung
+```
+
+### 2. Caching & Sesi
+```ngapak
+# Sesi
+sesi.pasang("cart_total", 150000)
+total = sesi.entuk("cart_total")
+
+# Cache (Simpan data 60 detik)
+cache.pasang("weather_jakarta", "Hujan", 60)
+cuaca = cache.entuk("weather_jakarta")
+```
+
+### 3. Event & Queue
+```ngapak
+# Event
+gawe kirimNotif(data)
+    tulis "Mengirim notifikasi ke user ID: " + data
+rampung
+event.listen("user.registered", kirimNotif)
+event.dispatch("user.registered", 99)
+
+# Queue Job
+queue.push("SendEmailJob", ["pesan": "Halo Selamat Datang!"])
+```
+
+---
+
+## 🔍 Interactive Breakpoint Debugger
+
+Jalankan debug program menggunakan perintah `python ngapakin.py debug <file.ngpk>`. Ketika VM menyala di mode tracing debugger, Anda dapat memasukkan perintah berikut di shell `dbg>`:
+- `s` atau [Enter]: Melangkah 1 instruksi bytecode (Step Over/Into).
+- `c`: Lanjutkan eksekusi normal tanpa jeda (Continue).
+- `l` atau `locals`: Cetak semua variabel lokal di call frame aktif.
+- `g` atau `globals`: Cetak semua variabel global yang terdaftar.
+- `st` or `stack`: Cetak kondisi VM stack saat ini.
+- `q` atau `quit`: Hentikan program seketika.
+
+---
+
+## 🎨 VSCode Extension & LSP Setup
+
+1. Salin seluruh isi direktori `editors/vscode` ke dalam folder ekstensi VSCode lokal Anda:
+   - Windows: `%USERPROFILE%\.vscode\extensions\ngapaklang-vscode`
+   - Linux/macOS: `~/.vscode/extensions/ngapaklang-vscode`
+2. Jalankan ulang VSCode. Berkas berekstensi `.ngpk` kini mendapatkan pewarnaan sintaksis.
+3. Language Server otomatis memindai sintaksis dan menampilkan tanda garis bawah merah jika terjadi error penulisan (LSP Diagnostics).
+
+---
+
+## 🧪 Pengujian Pipeline
+
+Kami menjaga kualitas ekosistem dengan unit testing komprehensif. Jalankan perintah berikut untuk memvalidasi:
+```bash
+$env:PYTHONPATH="."; pytest
+```
+
+---
+
+## 🗺️ Roadmap Masa Depan
+
+- **v1.1.0**: Dukungan HTTP Client terintegrasi untuk komunikasi API eksternal.
+- **v1.2.0**: Relasi ORM Polimorfik (Many-to-Many dinamis).
+- **v1.3.0**: Enkripsi berkas bytecode `.ngpkc` terkompresi tingkat lanjut.
+- **v2.0.0**: Compiler NgapakIn JIT (Just-In-Time) untuk kecepatan setara kode mesin.
+
+---
+
+## 📄 Lisensi
+Dilindungi oleh Lisensi **MIT** - Lihat berkas [LICENSE](file:///d:/Ilham%20Hatta%20Manggala/Joki%20Project/NgapakLang/LICENSE) untuk detail.

ngapakin-1.0.0/README.md

@@ -0,0 +1,207 @@
+# NgapakIn & Larapak MVC 🚀
+
+[![NgapakLang CI Pipeline](https://github.com/IlhamHattaManggala/ngapakin/actions/workflows/python.yml/badge.svg)](https://github.com/IlhamHattaManggala/ngapakin/actions/workflows/python.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python Version](https://img.shields.io/badge/python-3.8%20%7C%203.9%20%7C%203.10%20%7C%203.11-blue)](https://www.python.org/)
+
+NgapakIn adalah bahasa pemrograman open-source dengan ekstensi `.ngpk`, dirancang dengan sintaksis berbasis bahasa Ngapak / Banyumasan / Indonesia. 
+Larapak adalah MVC Web Framework lengkap yang berjalan di atas VM NgapakIn, dirancang meniru arsitektur elegan Laravel dengan fungsionalitas modern seperti ORM, Migrasi, Job Queues, Session/Cookies, Validasi, Caching, Event Dispatcher, Package Manager, hingga Language Server Protocol (LSP).
+
+---
+
+## 🌟 Fitur Utama Ekosistem (Phase 1 - Phase 5)
+
+1. **Inti Bahasa NgapakIn (Phase 1 & 2)**:
+   - Sintaksis berbasis dialek Banyumasan (`gawe`, `rampung`, `nek - ya - liyane`, `balekna`).
+   - Tipe data lengkap: Angka, Teks, Boolean (`bener`/`salah`), dan Null (`kosong`).
+   - Stack-based Virtual Machine (VM) yang efisien dengan eksekusi bytecode cepat.
+2. **Larapak MVC Framework (Phase 3)**:
+   - Web Server berbasis standard library HTTP.
+   - Routing dinamis (`routes/web.ngpk`, `routes/api.ngpk`).
+   - Blade-like Template Engine dengan layouting (`@layout`, `@sekat`, `@mlebui`).
+3. **Database & ORM System (Phase 4)**:
+   - Kelas berorientasi objek (`kelas ... extends Model`).
+   - Fluent SQL Query Builder berbasis SQLite.
+   - Skema Migrasi (`schema.gawe`, `schema.buang`) dan CLI migration engine.
+4. **Ecosystem & Advanced Features (Phase 5)**:
+   - **Autentikasi**: Fitur `auth` bawaan (`mlebu`, `metu`, `user`, `cek`).
+   - **Sesi & Cookies**: Penyimpanan sesi berbasis database SQLite, helper cookies.
+   - **Validasi**: Validator input dengan aturan `required`, `email`, `numeric`, `min`, `max`.
+   - **Cache**: Penyimpanan data sementara berbasis SQLite dengan waktu kedaluwarsa (TTL).
+   - **Event/Listener**: Dispatcher event bawaan untuk pemrograman reaktif.
+   - **Job Queues**: Pemrosesan latar belakang (background queue workers) dengan `queue:work`.
+   - **Package Manager**: Pemasangan paket otomatis beserta auto-discovery Service Provider.
+   - **REPL Terminal**: Interactive terminal interaktif via `repl`.
+   - **Step Debugger**: Breakpoint debugger interaktif (`s` step, `c` continue, `l` locals, `g` globals).
+   - **VSCode Support & LSP**: Syntax highlighting TextMate & diagnostik LSP syntax errors.
+
+---
+
+## 📁 Struktur Folder Proyek
+
+```text
+ngapakin/
+├── .github/workflows/   # CI/CD Pipeline
+├── app/
+│   ├── Controllers/     # Controller Kelas Larapak
+│   ├── Jobs/            # Background Jobs
+│   ├── Middleware/      # Request Middlewares
+│   └── Models/          # Model Database (Autoloaded)
+├── database/
+│   ├── migrations/      # Berkas Migrasi Database
+│   └── seeders/         # Berkas Database Seeder
+├── editors/vscode/      # Ekstensi VSCode & LSP Server
+├── framework/           # Modul Internal Larapak Core
+├── ngapak/              # Compiler, Lexer, Parser & VM NgapakLang
+├── packages/            # Lokasi Paket yang Diinstal
+├── routes/              # Rute web & API (.ngpk)
+├── tests/               # Berkas Unit Testing
+├── ngapakin.py          # Entrypoint CLI
+└── README.md
+```
+
+---
+
+## 🛠️ Instalasi & Penggunaan
+
+### Prasyarat
+- Python 3.8 ke atas (tanpa ketergantungan pustaka pihak ketiga).
+
+### Cara Kloning & Memulai Proyek
+```bash
+git clone https://github.com/IlhamHattaManggala/ngapakin.git
+cd ngapakin
+```
+
+---
+
+## 💻 Panduan CLI Command
+
+Larapak menyediakan CLI helper komprehensif melalui `ngapakin.py`:
+
+```bash
+# Menjalankan berkas kode biasa
+python ngapakin.py run berkas.ngpk
+
+# Menjalankan server web Larapak (port default: 8000)
+python ngapakin.py serve 8000
+
+# Melihat daftar rute terdaftar
+python ngapakin.py route:list
+
+# Membuat komponen baru (Scaffolding)
+python ngapakin.py make:controller UserController
+python ngapakin.py make:model Member
+python ngapakin.py make:middleware AuthMiddleware
+python ngapakin.py make:migration create_users_table
+python ngapakin.py make:job SendEmailJob
+
+# Migrasi Database
+python ngapakin.py migrate       # Jalankan migrasi
+python ngapakin.py rollback      # Kembalikan migrasi terakhir
+python ngapakin.py db:seed       # Jalankan seeder database
+
+# Layanan Ekosistem
+python ngapakin.py cache:clear                    # Hapus data cache
+python ngapakin.py queue:work                     # Jalankan pemroses job queue
+python ngapakin.py package:install auth-helper    # Pasang paket baru
+python ngapakin.py repl                           # Masuk ke REPL interaktif
+python ngapakin.py debug berkas.ngpk              # Debug bytecode berkas
+python ngapakin.py test                           # Jalankan seluruh unit test suite
+```
+
+---
+
+## 📖 Cara Menggunakan Fitur Ekosistem
+
+### 1. Validasi & Autentikasi
+```ngapak
+# Validasi data request
+data = ["email": "ilham@example.com", "umur": 20]
+aturan = ["email": "required|email", "umur": "required|numeric|min:18"]
+
+val = validator.gawe(data, aturan)
+nek val.gagal() ya
+    tulis "Validasi Gagal!"
+    tulis val.errors()
+liyane
+    tulis "Validasi Sukses!"
+rampung
+
+# Login user
+nek auth.mlebu("ilham@example.com", "password123") ya
+    tulis "Berhasil Login!"
+    tulis auth.user().name
+liyane
+    tulis "Login Gagal!"
+rampung
+```
+
+### 2. Caching & Sesi
+```ngapak
+# Sesi
+sesi.pasang("cart_total", 150000)
+total = sesi.entuk("cart_total")
+
+# Cache (Simpan data 60 detik)
+cache.pasang("weather_jakarta", "Hujan", 60)
+cuaca = cache.entuk("weather_jakarta")
+```
+
+### 3. Event & Queue
+```ngapak
+# Event
+gawe kirimNotif(data)
+    tulis "Mengirim notifikasi ke user ID: " + data
+rampung
+event.listen("user.registered", kirimNotif)
+event.dispatch("user.registered", 99)
+
+# Queue Job
+queue.push("SendEmailJob", ["pesan": "Halo Selamat Datang!"])
+```
+
+---
+
+## 🔍 Interactive Breakpoint Debugger
+
+Jalankan debug program menggunakan perintah `python ngapakin.py debug <file.ngpk>`. Ketika VM menyala di mode tracing debugger, Anda dapat memasukkan perintah berikut di shell `dbg>`:
+- `s` atau [Enter]: Melangkah 1 instruksi bytecode (Step Over/Into).
+- `c`: Lanjutkan eksekusi normal tanpa jeda (Continue).
+- `l` atau `locals`: Cetak semua variabel lokal di call frame aktif.
+- `g` atau `globals`: Cetak semua variabel global yang terdaftar.
+- `st` or `stack`: Cetak kondisi VM stack saat ini.
+- `q` atau `quit`: Hentikan program seketika.
+
+---
+
+## 🎨 VSCode Extension & LSP Setup
+
+1. Salin seluruh isi direktori `editors/vscode` ke dalam folder ekstensi VSCode lokal Anda:
+   - Windows: `%USERPROFILE%\.vscode\extensions\ngapaklang-vscode`
+   - Linux/macOS: `~/.vscode/extensions/ngapaklang-vscode`
+2. Jalankan ulang VSCode. Berkas berekstensi `.ngpk` kini mendapatkan pewarnaan sintaksis.
+3. Language Server otomatis memindai sintaksis dan menampilkan tanda garis bawah merah jika terjadi error penulisan (LSP Diagnostics).
+
+---
+
+## 🧪 Pengujian Pipeline
+
+Kami menjaga kualitas ekosistem dengan unit testing komprehensif. Jalankan perintah berikut untuk memvalidasi:
+```bash
+$env:PYTHONPATH="."; pytest
+```
+
+---
+
+## 🗺️ Roadmap Masa Depan
+
+- **v1.1.0**: Dukungan HTTP Client terintegrasi untuk komunikasi API eksternal.
+- **v1.2.0**: Relasi ORM Polimorfik (Many-to-Many dinamis).
+- **v1.3.0**: Enkripsi berkas bytecode `.ngpkc` terkompresi tingkat lanjut.
+- **v2.0.0**: Compiler NgapakIn JIT (Just-In-Time) untuk kecepatan setara kode mesin.
+
+---
+
+## 📄 Lisensi
+Dilindungi oleh Lisensi **MIT** - Lihat berkas [LICENSE](file:///d:/Ilham%20Hatta%20Manggala/Joki%20Project/NgapakLang/LICENSE) untuk detail.

ngapakin-1.0.0/framework/__init__.py

@@ -0,0 +1,5 @@
+"""
+Larapak Framework - MVC Web Framework for NgapakIn Language.
+"""
+
+__version__ = "1.0.0"

ngapakin-1.0.0/framework/auth.py

@@ -0,0 +1,75 @@
+# Authentication System for Larapak
+
+from framework.database import db_manager
+
+class Auth:
+    def __init__(self, vm=None):
+        self.vm = vm
+
+    @property
+    def sesi(self):
+        if self.vm and "sesi" in self.vm.globals:
+            return self.vm.globals["sesi"]
+        return None
+
+    def user(self):
+        ses = self.sesi
+        if not ses:
+            return None
+        user_id = ses.get("auth_user_id")
+        if not user_id:
+            return None
+        
+        if self.vm and "User" in self.vm.globals:
+            User = self.vm.globals["User"]
+            # Call User.golek(user_id)
+            # golek is a classmethod on Model, which wraps it.
+            # In Python, we can call it using __func__ since Model.golek is a classmethod
+            from framework.model import Model
+            return Model.golek.__func__(User, user_id)
+        return None
+
+    def cek(self):
+        return self.user() is not None
+
+    def check(self):
+        return self.cek()
+
+    def mlebu(self, email, password):
+        """Login user with email and password."""
+        if self.vm and "User" in self.vm.globals:
+            User = self.vm.globals["User"]
+            from framework.model import Model
+            # Query user using ModelQueryBuilder
+            # We will make sure Model.nek works and returns a user.
+            # Or we can query directly via SQL for safety inside auth:
+            table = Model.get_table_name(User)
+            row = db_manager.execute(f"SELECT * FROM {table} WHERE email = ?", [email]).fetchone()
+            if row:
+                user_dict = dict(row)
+                if user_dict.get("password") == password:
+                    ses = self.sesi
+                    if ses:
+                        ses.set("auth_user_id", user_dict.get("id"))
+                    
+                    # Instantiate user object
+                    from ngapak.vm import NgapakInstance
+                    instance = User() if hasattr(User, 'attributes') else User.__new__(User)
+                    if isinstance(instance, NgapakInstance):
+                        instance.fields.update(user_dict)
+                    else:
+                        instance.__dict__.update(user_dict)
+                    return True
+        return False
+
+    def login(self, email, password):
+        return self.mlebu(email, password)
+
+    def metu(self):
+        """Logout current user."""
+        ses = self.sesi
+        if ses:
+            ses.forget("auth_user_id")
+
+    def logout(self):
+        self.metu()

ngapakin-1.0.0/framework/cache.py

@@ -0,0 +1,72 @@
+# Cache Manager for Larapak
+
+import time
+import json
+from framework.database import db_manager
+
+class Cache:
+    def __init__(self):
+        self._ensure_table()
+
+    def _ensure_table(self):
+        db_manager.execute_write(
+            "CREATE TABLE IF NOT EXISTS cache (key VARCHAR(255) PRIMARY KEY, value TEXT, expiration INTEGER)"
+        )
+
+    def pasang(self, key, value, seconds=None):
+        expiration = None
+        if seconds is not None:
+            expiration = int(time.time() + seconds)
+        
+        serialized = json.dumps(value)
+        db_manager.execute_write(
+            "INSERT OR REPLACE INTO cache (key, value, expiration) VALUES (?, ?, ?)",
+            [key, serialized, expiration]
+        )
+        return True
+
+    def set(self, key, value, seconds=None):
+        return self.pasang(key, value, seconds)
+
+    def entuk(self, key, default=None):
+        row = db_manager.execute("SELECT value, expiration FROM cache WHERE key = ?", [key]).fetchone()
+        if not row:
+            return default
+            
+        expiration = row["expiration"]
+        if expiration is not None and expiration <= time.time():
+            # Expired, remove it
+            self.lalekna(key)
+            return default
+            
+        try:
+            return json.loads(row["value"])
+        except Exception:
+            return default
+
+    def get(self, key, default=None):
+        return self.entuk(key, default)
+
+    def lalekna(self, key):
+        db_manager.execute_write("DELETE FROM cache WHERE key = ?", [key])
+        return True
+
+    def forget(self, key):
+        return self.lalekna(key)
+
+    def remove(self, key):
+        return self.lalekna(key)
+
+    def resiki(self):
+        db_manager.execute_write("DELETE FROM cache")
+        return True
+
+    def clear(self):
+        return self.resiki()
+
+    def nduwe(self, key):
+        val = self.entuk(key, None)
+        return val is not None
+
+    def has(self, key):
+        return self.nduwe(key)

ngapakin-1.0.0/framework/container.py

@@ -0,0 +1,42 @@
+# Service Container for Larapak Web Framework
+
+class Container:
+    def __init__(self):
+        self.bindings = {}
+        self.instances = {}
+        self.vm = None  # Injected by VM
+
+    def bind(self, name, factory):
+        """Bind a dependency resolver function to a name."""
+        self.bindings[name] = factory
+
+    def singleton(self, name, factory):
+        """Bind a singleton dependency resolver."""
+        def singleton_factory():
+            if name not in self.instances:
+                if self.vm and callable(factory):
+                    # If it's a VM function, invoke it
+                    self.instances[name] = self.vm.execute_callable(factory, [])
+                else:
+                    self.instances[name] = factory()
+            return self.instances[name]
+        self.bindings[name] = singleton_factory
+
+    def make(self, name):
+        """Resolve dependency by name."""
+        if name in self.instances:
+            return self.instances[name]
+            
+        if name in self.bindings:
+            factory = self.bindings[name]
+            # Check if it is a VM function
+            if self.vm and hasattr(factory, 'chunk'):
+                res = self.vm.execute_callable(factory, [])
+                return res
+            elif callable(factory):
+                res = factory()
+                return res
+            else:
+                return factory
+                
+        raise KeyError(f"Dependency '{name}' tidak ditemukan di Service Container.")