Nasıl Çalışır
Docufy'nin iş akış modeli ve komut aileleri
İş akışı modeli
Docufy, tüm komutlarda benzer bir çalışma modeli kullanır: girdi seçimi, dönüşüm stratejisi, yerel işlem ve çıktı/rapor.
1) Girdi belirleme
- Tek dosya: `convert`, `video`, `audio`, `info`
- Klasör / glob: `batch`
- Sürekli klasör izleme: `watch`
- JSON tabanlı çok adımlı akış: `pipeline run`
2) Strateji ve parametreler
Komutların çoğu ortak kontrol parametreleri paylaşır: kalite, metadata modu, çakışma politikası, tekrar deneme, rapor üretimi ve profil kullanımı.
docufy convert input.jpg --to webp --quality 85 --strip-metadata
docufy batch ./media --from jpg --to png --on-conflict versioned --retry 2 3) Yerel işleme katmanı
Tüm dönüşümler yerel makinede çalışır. FFmpeg / LibreOffice / Pandoc gerektiren dönüşümlerde ilgili aracın sistemdeki kurulumu kullanılır; dosyalar dış servislere gönderilmez.
4) Çıktı, rapor ve devam
Özellikle batch ve pipeline modlarında JSON raporla gözlemlenebilirlik sağlanır. Yarıda kalan operasyonlarda `--resume-from-report` ile başarılı adımlar atlanarak devam edilir.
docufy batch ./assets --from png --to jpg --report json --report-file ./reports/batch.json
docufy batch ./assets --from png --to jpg --resume-from-report ./reports/batch.json Konfigürasyon önceliği
Genel öncelik sırası: CLI flag > ENV > proje config > default.
Komut aileleri özeti
| Komut | Kullanım amacı |
|---|---|
convert | Tek dosya dönüşümü ve temel medya format işlemleri |
batch | Toplu klasör/glob işleme, raporlama, resume |
watch | Klasör izleyip yeni dosyaları otomatik dönüştürme |
pipeline run | Çok adımlı JSON akışlarıyla otomasyon |
video, audio, info | Medya araçları ve metadata/teknik bilgi analizi |