STADATA-X

Membuka Data Statistik Indonesia, Satu Perintah Sekaligus.

stadata-x adalah sebuah aplikasi terminal (TUI) modern yang dirancang untuk menjelajahi, melihat, dan mengunduh data dari Badan Pusat Statistik (BPS) Indonesia secara interaktif. Dibangun dengan Python dan Textual, aplikasi ini menyediakan antarmuka yang cepat dan efisien untuk mengakses kekayaan data publik BPS langsung dari command line Anda.

Lupakan mengunduh file secara manual. Dengan stadata-x, Anda dapat dengan mudah menavigasi data berdasarkan wilayah, mencari tabel statistik, melihat pratinjau, dan mengunduhnya dalam berbagai format (CSV, Excel, JSON).

📸 Screenshots

Layar Selamat Datang

Pemilihan Wilayah

✨ Fitur Utama

🎯 Navigasi Interaktif: Jelajahi data BPS berdasarkan wilayah (Provinsi/Kabupaten/Kota) melalui antarmuka yang responsif.
📊 Pratinjau Tabel: Lihat isi tabel statistik langsung di terminal sebelum mengunduh, dengan pewarnaan dan perataan kolom otomatis untuk keterbacaan maksimal.
📥 Unduhan Multi-Format: Unduh data yang Anda butuhkan dalam format CSV, Excel (.xlsx), atau JSON.
⚙️ Manajemen Konfigurasi: Simpan Token API BPS dan atur folder unduhan default dengan mudah.
🔄 Penanganan Error Cerdas: Dilengkapi dengan mekanisme retry otomatis untuk mengatasi rate limiting API dan penanganan error koneksi yang tangguh.
🚀 Caching: Permintaan data yang sering diakses (seperti daftar wilayah) disimpan dalam cache untuk mempercepat waktu muat.
🎨 Antarmuka Modern: Pengalaman pengguna yang mulus dan modern di dalam terminal Anda.

📋 Persyaratan Sistem

Python: 3.9 atau yang lebih baru
Terminal: Terminal modern yang mendukung ANSI colors (Windows Terminal, iTerm2, GNOME Terminal, dll.)
Token API BPS: Diperlukan untuk mengakses data (gratis dari portal developer BPS)

📈 Status & Coverage

✅ 113 Tests Passed - Test suite lengkap dengan coverage tinggi
✅ Cross-platform - Kompatibel Windows, Linux, dan macOS (Python 3.9-3.13)
✅ CI/CD Active - GitHub Actions dengan testing multi-platform
✅ PyPI Published - Tersedia untuk instalasi global via pip install stadata-x

🚀 Instalasi

Pastikan Anda memiliki Python 3.9 atau yang lebih baru. stadata-x dapat diinstal dengan mudah menggunakan pip, pipx, atau uv.

Menggunakan `pipx` (Direkomendasikan)

pipx menginstal paket Python dalam lingkungan terisolasi, yang merupakan cara terbaik untuk menginstal aplikasi command-line.

pipx install stadata-x

Menggunakan `pip`

pip install stadata-x

Menggunakan `uv`

uv pip install stadata-x

Verifikasi Instalasi

Setelah instalasi, verifikasi bahwa aplikasi terinstal dengan benar:

stadata-x --version

🔧 Troubleshooting

Masalah Instalasi Umum

1. Build Error dengan `lxml`

Error: fatal error C1083: Cannot open include file: 'libxml/xmlversion.h'

Solusi:

# Gunakan wheel-only installation
pip install stadata-x --only-binary=all

# Atau gunakan uv
uv pip install stadata-x --only-binary=all

Penjelasan: stadata-x menggunakan lxml>=6.0.0 yang sudah include libxml2 binaries.

2. Python Version Compatibility

Error: TypeError: unsupported operand type(s) for |: 'type' and 'NoneType'

Solusi:

Pastikan menggunakan Python 3.9 atau yang lebih baru
stadata-x mendukung Python 3.9-3.13

3. Permission Error (Windows)

Error: PermissionError: [Errno 13] Permission denied

Solusi:

# Jalankan sebagai administrator atau gunakan virtual environment
python -m venv venv
venv\Scripts\activate
pip install stadata-x

4. SSL/Connection Error

Error: ssl.SSLCertVerificationError atau connection timeout

Solusi:

# Update pip dan certificates
pip install --upgrade pip certifi

# Atau gunakan HTTP instead HTTPS
pip install stadata-x --trusted-host pypi.org --trusted-host files.pythonhosted.org

5. Dependency Conflict

Error: ERROR: Cannot install stadata-x because these package versions have conflicting dependencies

Solusi:

# Gunakan virtual environment terisolasi
python -m venv isolated_env
isolated_env\Scripts\activate
pip install stadata-x

# Atau gunakan pip-tools untuk resolve dependencies
pip install pip-tools
pip-compile --output-file=requirements.txt pyproject.toml
pip-sync

Alternative Installation Methods

Menggunakan Conda (Windows Recommended)

# Install Miniconda atau Anaconda
# Buat environment baru
conda create -n stadata-env python=3.11
conda activate stadata-env

# Install package
pip install stadata-x

Menggunakan pipx (Isolated Environment)

pipx install stadata-x

Manual Installation dari Source

# Clone repository
git clone https://github.com/dzakwanalifi/stadata-x.git
cd stadata-x

# Install dengan uv
uv sync --dev
uv run stadata-x --version

Debug dan Logging

Enable Verbose Output

# Untuk pip
pip install stadata-x -v

# Untuk uv
uv pip install stadata-x --verbose

Check System Information

# Python version
python --version

# pip version
pip --version

# OS information
python -c "import platform; print(platform.platform())"

# Check installed packages
pip list | grep -E "(stadata|lxml|textual)"

Masalah Runtime

API Token Error

ApiTokenError: Token API tidak diatur

Solusi:

Jalankan stadata-x
Tekan s untuk Settings
Masukkan Token API BPS Anda
Test koneksi dengan tombol "Tes Koneksi"

Network/Connection Error

NoInternetError: Tidak ada koneksi internet

Solusi:

Check koneksi internet
Coba lagi dalam beberapa saat (rate limiting)
Gunakan VPN jika diperlukan

Cache Issues

# Clear cache
# Windows
rmdir /s %USERPROFILE%\.stadata-x

# Linux/Mac
rm -rf ~/.stadata-x

Getting Help

Jika masalah berlanjut:

Check GitHub Issues: https://github.com/dzakwanalifi/stadata-x/issues
Create New Issue: Sertakan:
- Python version (python --version)
- OS information
- Full error traceback
- Installation method used
Contact: [email protected]

⚡ Quick Start

Konfigurasi Token API BPS:

stadata-x
# Tekan 's' untuk masuk ke pengaturan
# Tempel token API BPS Anda

Jelajahi Data:

stadata-x
# Pilih wilayah → Pilih tabel → Lihat pratinjau → Unduh

Konfigurasi Awal: API Key BPS

Untuk menggunakan aplikasi ini, Anda memerlukan Token API dari BPS. Token ini gratis dan berfungsi sebagai kunci untuk mengakses data.

Cara Mendapatkan Token API

Kunjungi Portal WebAPI BPS: Buka webapi.bps.go.id/developer/.
Daftar/Masuk: Buat akun baru atau masuk jika Anda sudah memilikinya.
Salin Token: Setelah masuk, salin Token API yang ditampilkan di dashboard Anda.
Konfigurasi di stadata-x:
- Jalankan aplikasi: stadata-x
- Tekan s untuk masuk ke menu Pengaturan.
- Tempel Token API Anda, lalu simpan.
- Gunakan tombol "Tes Koneksi" untuk memvalidasi token Anda.

Penggunaan

Jalankan aplikasi dari terminal Anda:

stadata-x

⌨️ Navigasi Dasar

Tombol	Fungsi
`↑/↓` atau `j/k`	Bergerak di dalam daftar
`Enter`	Pilih item (wilayah atau tabel)
`Escape`	Kembali ke level sebelumnya
`s`	Buka halaman Pengaturan
`d`	Buka dialog unduhan (saat di pratinjau tabel)
`q`	Keluar dari aplikasi

📁 Struktur Proyek

stadata-x/
├── stadata_x/          # Kode aplikasi utama
│   ├── assets/         # CSS dan asset statis
│   ├── screens/        # Layar-layar aplikasi
│   ├── widgets/        # Komponen UI kustom
│   └── *.py            # Modul utama
├── assets/             # Screenshot dan gambar dokumentasi
├── .gitignore          # File yang diabaikan Git
├── LICENSE             # Lisensi MIT
├── pyproject.toml      # Konfigurasi proyek Python
└── README.md           # Dokumentasi ini

🤝 Kontribusi

Kontribusi, laporan bug, dan permintaan fitur sangat kami hargai! 🎉

Cara Berkontribusi

Fork repositori ini
Buat branch untuk fitur Anda (git checkout -b feature/AmazingFeature)
Commit perubahan Anda (git commit -m 'Add some AmazingFeature')
Push ke branch (git push origin feature/AmazingFeature)
Buka Pull Request

Pengembangan Lokal

Untuk pengembangan lokal, kloning repositori dan instal dependensi:

git clone https://github.com/dzakwanalifi/stadata-x.git
cd stadata-x
pip install -e ".[dev]"

Jalankan aplikasi dalam mode pengembangan dengan hot-reloading:

textual run --dev stadata_x/main.py

Panduan Pengembangan

Gunakan ruff untuk linting dan formatting
Ikuti konvensi penamaan PEP 8
Tambahkan docstring untuk fungsi baru
Update dokumentasi jika diperlukan

🙏 Acknowledgments

Badan Pusat Statistik (BPS) - Untuk menyediakan data publik yang berharga
Textual - Framework TUI yang powerful
stadata - Library Python resmi untuk API BPS

📞 Dukungan

Jika Anda mengalami masalah atau memiliki pertanyaan:

📧 Email: [email protected]
🐛 Issues: GitHub Issues
📖 Dokumentasi: README ini

📄 Lisensi

Proyek ini dilisensikan di bawah Lisensi MIT - lihat file LICENSE untuk detail lebih lanjut.

Dibuat dengan ❤️ untuk komunitas data Indonesia

⭐ Jika Anda menyukai proyek ini, berikan bintang di GitHub!

Name		Name	Last commit message	Last commit date
Latest commit History 16 Commits
.github/workflows		.github/workflows
assets		assets
stadata_x		stadata_x
tests		tests
.coveragerc		.coveragerc
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
pyproject.toml		pyproject.toml
requirements-dev.txt		requirements-dev.txt
uv.lock		uv.lock

License

dzakwanalifi/stadata-x

Folders and files

Latest commit

History

Repository files navigation

STADATA-X

📸 Screenshots

Layar Selamat Datang

Pemilihan Wilayah

✨ Fitur Utama

📋 Persyaratan Sistem

📈 Status & Coverage

🚀 Instalasi

Menggunakan pipx (Direkomendasikan)

Menggunakan pip

Menggunakan uv

Verifikasi Instalasi

🔧 Troubleshooting

Masalah Instalasi Umum

1. Build Error dengan lxml

2. Python Version Compatibility

3. Permission Error (Windows)

4. SSL/Connection Error

5. Dependency Conflict

Alternative Installation Methods

Menggunakan Conda (Windows Recommended)

Menggunakan pipx (Isolated Environment)

Manual Installation dari Source

Debug dan Logging

Enable Verbose Output

Check System Information

Masalah Runtime

API Token Error

Network/Connection Error

Cache Issues

Getting Help

⚡ Quick Start

Konfigurasi Awal: API Key BPS

Cara Mendapatkan Token API

Penggunaan

⌨️ Navigasi Dasar

📁 Struktur Proyek

🤝 Kontribusi

Cara Berkontribusi

Pengembangan Lokal

Panduan Pengembangan

🙏 Acknowledgments

📞 Dukungan

📄 Lisensi

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 2

Packages 0

Languages

Menggunakan `pipx` (Direkomendasikan)

Menggunakan `pip`

Menggunakan `uv`

1. Build Error dengan `lxml`

Packages