Metadata-Version: 2.1
Name: vosha
Version: 1.0
Summary: A simple Python web framework for building web applications
Home-page: https://github.com/vosha/vosha-framework
Author: VOSHA Framework Team
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: fastapi >=0.100.0
Requires-Dist: jinja2 >=3.1.0
Requires-Dist: requests >=2.31.0
Requires-Dist: uvicorn >=0.23.0

# VOSHA Framework

VOSHA adalah framework Python modern yang dirancang untuk mempercepat pembuatan aplikasi fullstack dengan otomasi sinkronisasi antara Frontend (HTML/CSS) dan Backend (FastAPI).

Framework ini mengusung filosofi "Plug and Play" dengan tampilan dashboard yang elegan secara default menggunakan efek Glassmorphism dan desain premium.

## Fitur Utama

- Fullstack Automation: Generate struktur Backend (FastAPI) dan Frontend secara otomatis.
- Premium UI Default: Dilengkapi dengan dashboard modern berbasis Poppins font dan Glassmorphism yang estetik.
- Multi-language CLI: Mendukung perintah dalam bahasa Indonesia (buat, jalankan) dan Inggris (create, run).
- Hot-Reloading: Perubahan pada backend otomatis terdeteksi.
- Simple Orchestration: Cukup jalankan python run.py di dalam project untuk memulai seluruh layanan.

## Instalasi "Plug and Play" (v1.0)

Ada 3 cara mudah untuk memasang VOSHA di komputer kamu:

### A. Metode Klik-Klik (Windows/Linux GUI)

Ini adalah cara yang paling direkomendasikan untuk pengalaman premium:

1. Klik kanan file installer_gui.py lalu pilih Run with Python, atau
2. Jalankan di terminal: python3 install.py
3. Klik tombol "Pasang VOSHA Sekarang" dan tunggu hingga selesai.

### B. Metode Terminal (Standard)

Jika kamu lebih suka menggunakan pip:

```bash
pip install .
```

### C. Metode Cepat (Cukup satu baris)

```bash
python3 pasang.py
```

> [!TIP]
> Windows User: Kamu bisa mengubah installer_gui.py menjadi file .exe menggunakan aplikasi seperti PyInstaller agar benar-benar menjadi aplikasi installer mandiri.

Setelah terpasang, kamu tidak perlu lagi mengetik .py. Cukup gunakan perintah vosha langsung dari terminal mana pun!

## Cara Menghapus (Uninstall)

VOSHA juga menyediakan cara hapus yang bersih:

- GUI: Jalankan python3 uninstaller_gui.py
- Shortcut CLI: Jalankan python3 uninstall.py atau python3 hapus.py / python3 copot.py
- Terminal: pip uninstall vosha

## Cara Penggunaan

### 1. Membuat Project Baru

```bash
# Versi Indonesia
vosha buat nama_project_kamu 1

# Versi Inggris (jika bahasa CLI diubah)
vosha create my_project 1
```

### 2. Menjalankan Project

Masuk ke folder project, lalu jalankan orchestrator:

```bash
cd nama_project_kamu
python3 run.py
```

Akses website kamu di http://localhost:9871/.

### 3. Mengubah Bahasa CLI

```bash
vosha bahasa en  # Mengubah ke mode English
vosha language id  # Mengubah kembali ke mode Indonesia
```

## Rencana Pengembangan

- v1.0: Premium UI, Multi-language support, Root-URL simplification.
- v1.1: Database migration tool otomatis.
- v1.2: Template engine yang lebih bervariasi.

## Kontribusi

Kami sangat terbuka bagi siapa saja yang ingin berkontribusi untuk membuat VOSHA menjadi lebih baik.

## Lisensi

Distributed under the MIT License. See LICENSE for more information.

---

Dibuat untuk developer Indonesia.
