Skip to content

About

Ratusan Excel, Satu Rekap

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Rekapin dong - Excel Value Extractor

Ratusan Excel, Satu Rekap.

Ambil nilai dari sheet, cell, atau rentang tertentu dalam banyak file Excel bertemplate sama, lalu gabungkan ke satu workbook. Cocok untuk rekap kiriman tim lapangan tanpa menyalin nilai satu per satu. File sumber tidak diubah.

Fitur

  • Membaca .xlsx dan .xlsm, termasuk sel gabungan.
  • Mengubah pilihan Sheet + Cell menjadi kolom dengan header sendiri.
  • Menggabungkan rentang ke satu nilai, beberapa kolom, atau beberapa baris.
  • Preset Niltan, RPKH, dan demo; wizard visual untuk membuat pemetaan baru.
  • exclude_blank dan filter baris untuk melewati data kosong.
  • GUI PySide6, CLI, serta log proses untuk memeriksa file bermasalah.

Instalasi

Gunakan Python 3.12+ untuk GUI; CLI saja mendukung Python 3.10+.

macOS / Linux:

python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r gui/requirements.txt

Windows PowerShell:

py -3.12 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r gui/requirements.txt

Untuk CLI saja, ganti gui/requirements.txt dengan requirements.txt.

Cara pakai

GUI

Jalankan python rekapin_dong.py pada venv aktif. Di Windows:

.\.venv\Scripts\python.exe rekapin_dong.py
  1. Pilih preset, folder Excel, dan lokasi hasil .xlsx.
  2. Klik Jalankan Rekap, lalu periksa ringkasan dan log.
  3. Untuk pemetaan baru, buka wizard: pilih file contoh dan sheet, pilih cell/rentang, beri nama header, periksa preview, lalu simpan preset.

CLI dan contoh sintetis

Di Windows, gunakan .\.venv\Scripts\python.exe sebagai pengganti python. Demo menghasilkan empat baris di output/rekap.xlsx dan log di output/rekap.log.csv. Untuk GUI, pilih preset Demo sintetis — Data, folder examples/, dan lokasi hasil di luar folder sample.

Opsi tambahan: --recursive untuk subfolder, --strict untuk membatalkan penulisan rekap jika ada masalah, dan --overwrite untuk mengganti hasil lama. Lihat seluruh opsi dengan python excel_value_extractor.py --help.

Konfigurasi dan preset

Contoh konfigurasi YAML berikut cocok dengan sample; simpan di akar proyek:

input_folder: examples
output: output/rekap.xlsx
targets:
  - sheet: Data
    cell: B2
    header: Unit
  - sheet: Data
    range: B5:C7
    header: Rincian
    headers: [Jumlah, Status]
    mode: long
row_filter:
  sheet: Data
  field: Petak
  header_range: A4:C4
  exclude_blank: true

Path relatif dihitung dari lokasi file konfigurasi. JSON juga didukung. lihat config.example.json. Untuk preset GUI, tambahkan name dan gunakan Kelola Preset untuk mengimpor YAML. Contoh ada di examples/presets/generic.yaml.

Mode rentang Hasil
concat Gabungkan nilai menjadi satu kolom.
columns Setiap sel menjadi kolom tersendiri.
long Setiap baris rentang menjadi baris hasil.

exclude_blank: true pada target rentang melewati nilai kosong dan merapatkan nilai; 0 dan False tetap dipertahankan. Gunakan row_filter seperti contoh untuk melewati seluruh baris tanpa menggeser posisi kolom.

Catatan penggunaan

  • Rumus tidak dihitung oleh aplikasi. Hitung dan simpan file di Excel atau LibreOffice terlebih dahulu agar hasil rumus dapat dibaca.
  • Format .xls lama tidak didukung; simpan ulang sebagai .xlsx.
  • Hasil dan log memuat path sumber absolut. Periksa informasi pribadi sebelum dibagikan.
  • Toolkit Buka Proteksi Sheet membuat salinan file yang boleh Anda ubah; fitur ini tidak membuka enkripsi/password untuk membuka file.

Struktur dan kontribusi

core/          Engine dan CLI
extractor/     Layer kompatibilitas
gui/          GUI dan wizard
presets/       Preset bawaan
examples/      Workbook sintetis, config, dan preset demo
tests/         Pengujian dengan data dummy
docs/         Panduan ignore dan placeholder screenshot
packaging/     Dependency build dan installer

Placeholder screenshot tersedia di docs/screenshots/. Untuk kontribusi, buat branch, gunakan data dummy, jalankan test, lalu ajukan pull request dengan penjelasan perubahan. Jangan sertakan data lapangan atau kredensial.

python -m unittest discover -s tests -v

Untuk pengujian tanpa jendela, set QT_QPA_PLATFORM=offscreen.

Lisensi

MIT. Dependency memiliki lisensi masing-masing.

English summary

Extract selected sheets, cells, and ranges from many Excel files into one workbook. Includes a CLI, PySide6 desktop app, reusable presets, and a visual mapping wizard. Original field data is excluded; try the synthetic samples in examples/. Licensed under MIT.

About

Ratusan Excel, Satu Rekap

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages