How vulpfin/vfa works
VFA is a cross-platform archive toolchain. Users create or append VFA1/VFA2 archives, then browse or extract them; VFA2 adds chunking, deduplication, filters, and specialized codecs. The repository also includes Windows self-extracting archives and a self-finishing installer flow. The excerpts show selected writer, reader, codec, and GUI internals; several documented features are represented at their owning module without guessing unshown call paths.
Main entry points: vfa.py VFA CLI · vfa_extract.py Archive extraction · vulp.h Codec API · vfa2.py VFA2 writer
Components 19
Archive workflows
- VFA CLI
vfa.py - VFA1 archives
vfa.py - VFA2 writer
vfa2.py - Archive extraction
vfa_extract.py - VFA2 reading
vfa2.py - File metadata
vfa.py - Archive security
vfa.py
VFA2 codecs
- Filters and chunking
vfa2.py - Python reference codec
vulp_ref.py
Browse and install
- Archive viewer
vfa_viewer.py - SFX launcher
sfx_stub.py - Installer stub
sfi_stub.py - Installer wizard
sfi_gui.py - Version reporting
vfa_version.py
Native codec
- tANS codec
vulp/vulp.c - Vulp LZ codec
vulp/vulp_lz.c - Context mixer
vulp/vulp_cm.c - Codec API
vulp/vulp.h
Other components
- Archive user
Connections 20
- Archive user → VFA CLI: invokes
README.md - VFA CLI → VFA1 archives: creates or appends
README.md - VFA CLI → VFA2 writer: selects VFA2
README.md - VFA CLI → Archive extraction: extracts via
vfa.py - VFA CLI → VFA2 reading: dispatches VFA2
vfa.py - VFA2 writer → Filters and chunking: chunks and filters
vfa2.py - VFA2 reading → Filters and chunking: reverses filters
vfa2.py - VFA2 writer → Python reference codec: uses fallback codec
vfa2.py - VFA2 reading → Python reference codec: uses fallback codec
vfa2.py - Codec API → tANS codec: declares API
vulp/vulp.h - Codec API → Vulp LZ codec: declares API
vulp/vulp.h - Codec API → Context mixer: declares API
vulp/vulp.h - Archive user → Archive viewer: browses archives
README.md - Archive viewer → Archive extraction: uses extraction
vfa_viewer.py - SFX launcher → Archive extraction: extracts payload
sfx_stub.py - Installer stub → Archive extraction: extracts payload
sfi_stub.py - Installer stub → Installer wizard: opens GUI
sfi_stub.py - VFA CLI → File metadata: preserves metadata
README.md - VFA CLI → Archive security: supports encryption
README.md - VFA CLI → Version reporting: reports version
vfa.py