How gorkemguler/metacls works
MetaCLS is a bulk metadata-scrubbing application for documents and media. Users submit files through the CLI, local web UI, REST API, or desktop drop app; the runtime selects format engines, writes cleaned copies or overwrites in place, rescans for residual metadata, and produces per-file evidence reports. Archive recursion and audio/video handling extend the same engine workflow. The graph reflects documented capabilities, but several subsystem connections rely on README statements or SOURCE INDEX references rather than complete source excerpts.
Main entry points: cli.py CLI · cleaner.py Scrub coordinator · __init__.py Engine selection · web.py Local web UI
Components 25
User entry points
- CLI
src/metacls/cli.py - Local web UI
src/metacls/web.py - REST API
src/metacls/api/app.py - API job queue
src/metacls/api/jobs.py - Mac drop app
platform/macos/desktop_runtime.py
Scrub workflow
- Run configuration
src/metacls/config.py - File discovery
src/metacls/scanner.py - Scrub coordinator
src/metacls/cleaner.py - FTP source
src/metacls/ftp_source.py - Folder watcher
src/metacls/watch.py
Format engines
- Engine selection
src/metacls/engines/__init__.py - Engine contract
src/metacls/engines/base.py - PDF scrubber
src/metacls/engines/pdf.py - Office scrubber
src/metacls/engines/office.py - Legacy Office
src/metacls/engines/legacy_office.py - Image scrubber
src/metacls/engines/image.py - ExifTool adapter
src/metacls/engines/exiftool.py - Audio/video scrubber
src/metacls/engines/media.py - EBML/Riff scrubber
src/metacls/engines/ebml_riff.py - SVG scrubber
src/metacls/engines/svg.py - Archive scrubber
src/metacls/engines/container.py
Results and state
- Result model
src/metacls/models.py - JSON/HTML reports
src/metacls/report/__init__.py - Report comparison
src/metacls/diff.py
Other components
- User
Connections 41
- User → CLI: runs command
README.md - User → Local web UI: uploads files
README.md - User → REST API: posts files
README.md - User → Mac drop app: drops files
README.md - Mac drop app → CLI: invokes scrub
platform/macos/desktop_runtime.py - CLI → Run configuration: sets options
src/metacls/cli.py - CLI → File discovery: discovers files
src/metacls/cli.py - CLI → Scrub coordinator: starts cleaning
src/metacls/cli.py - CLI → Folder watcher: starts watching
src/metacls/cli.py - CLI → Local web UI: starts UI
src/metacls/cli.py - CLI → REST API: starts service
src/metacls/cli.py - CLI → JSON/HTML reports: renders report
src/metacls/cli.py - CLI → Report comparison: compares reports
src/metacls/cli.py - Local web UI → Scrub coordinator: cleans uploads
src/metacls/web.py - Local web UI → Run configuration: sets options
src/metacls/web.py - Local web UI → FTP source: loads FTP files
src/metacls/web.py - Local web UI → JSON/HTML reports: renders results
src/metacls/web.py - REST API → API job queue: submits jobs
src/metacls/api/app.py - REST API → Scrub coordinator: cleans uploads
src/metacls/api/app.py - REST API → Run configuration: sets options
src/metacls/api/app.py - API job queue → JSON/HTML reports: packages results
src/metacls/api/jobs.py - Folder watcher → File discovery: discovers changes
src/metacls/watch.py - Folder watcher → Scrub coordinator: cleans files
src/metacls/watch.py - Scrub coordinator → Engine selection: selects engine
src/metacls/cleaner.py - Scrub coordinator → File discovery: enumerates paths
src/metacls/cleaner.py - Scrub coordinator → Run configuration: uses options
src/metacls/cleaner.py - Scrub coordinator → Result model: builds results
src/metacls/cleaner.py - Engine selection → PDF scrubber: dispatches PDFs
src/metacls/engines/__init__.py - Engine selection → Office scrubber: dispatches Office
src/metacls/engines/__init__.py - Engine selection → Legacy Office: dispatches legacy
src/metacls/engines/__init__.py - Engine selection → Image scrubber: dispatches images
src/metacls/engines/__init__.py - Engine selection → Audio/video scrubber: dispatches media
src/metacls/engines/__init__.py - Engine selection → SVG scrubber: dispatches SVG
src/metacls/engines/__init__.py - Engine selection → Archive scrubber: dispatches archives
src/metacls/engines/__init__.py - PDF scrubber → Engine contract: implements contract
src/metacls/engines/base.py - Office scrubber → Engine contract: implements contract
src/metacls/engines/base.py - Image scrubber → ExifTool adapter: uses adapter
src/metacls/engines/image.py - Audio/video scrubber → ExifTool adapter: uses adapter
src/metacls/engines/media.py - Audio/video scrubber → EBML/Riff scrubber: uses parser
src/metacls/engines/media.py - Scrub coordinator → Result model: records outcome
src/metacls/cleaner.py - JSON/HTML reports → Result model: serializes results
src/metacls/report/__init__.py