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.
- Membaca
.xlsxdan.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_blankdan filter baris untuk melewati data kosong.- GUI PySide6, CLI, serta log proses untuk memeriksa file bermasalah.
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.txtWindows PowerShell:
py -3.12 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r gui/requirements.txtUntuk CLI saja, ganti gui/requirements.txt dengan requirements.txt.
Jalankan python rekapin_dong.py pada venv aktif. Di Windows:
.\.venv\Scripts\python.exe rekapin_dong.py- Pilih preset, folder Excel, dan lokasi hasil
.xlsx. - Klik Jalankan Rekap, lalu periksa ringkasan dan log.
- Untuk pemetaan baru, buka wizard: pilih file contoh dan sheet, pilih cell/rentang, beri nama header, periksa preview, lalu simpan preset.
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.
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: truePath 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.
- Rumus tidak dihitung oleh aplikasi. Hitung dan simpan file di Excel atau LibreOffice terlebih dahulu agar hasil rumus dapat dibaca.
- Format
.xlslama 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.
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 -vUntuk pengujian tanpa jendela, set QT_QPA_PLATFORM=offscreen.
MIT. Dependency memiliki lisensi masing-masing.
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.