• 1.23 Stable

    joseph.henry released this 2026-04-28 15:29:02 +02:00 | 0 commits to main since this release

    What's new

    Every .zip produced by blender_asset_tracer.pack.zipped.ZipPacker now contains a top-level bat-debug.log capturing the full DEBUG-level trace of the pack run. Archives are self-describing — you no longer need terminal output to debug what BAT found, where it rewrote paths to, which files were missing, or which references resolved to where.

    What's captured

    • Banner: BAT version, UTC timestamp, blend file(s), project root, target, noop / relative_only / keep_hierarchy flags, sys.argv, Python version, platform.
    • Trace phase: every block expansion, every Resolved / Resolving line, every Missing file warning, library load failures.
    • Pack phase: every ZIP src → dst line for files copied (compressed and stored), every path-rewrite update inside blend files.
    • Closing: a BAT Pack closing; flushing debug log to bat-debug.log line confirming the buffer was flushed cleanly.

    Usage

    # After producing a pack
    unzip -p mypack.zip bat-debug.log | less
    
    # Or extract just the log
    unzip -p mypack.zip bat-debug.log > pack.log
    

    Notes

    • The capture is independent of CLI verbosity-q still keeps the terminal quiet while the in-zip log stays at DEBUG. No flag needed; it's always on for zip targets.
    • noop mode skips the log embedding (no zip is written).
    • KeyboardInterrupt and FileTransferError paths still flush whatever was logged up to the abort point.
    • Adds ~10–15 MB to a typical production pack; negligible vs. the multi-GB asset payload.
    • Only ZipPacker is affected — filesystem, S3, and Shaman packers are unchanged.
    Downloads
  • 1.22 Stable

    joseph.henry released this 2026-03-24 18:07:50 +01:00 | 1 commits to main since this release

    BAT v1.22 — Sequence Packing

    Highlights

    Pack entire shot sequences in one go. Select a sequence folder, BAT finds the latest published blend files across all shots, traces and deduplicates shared dependencies, and packs everything into a single ZIP.

    New features

    Blender addon

    • Pack Sequence operator (File > External Data > BAT > BAT - Pack Sequence) — browse to a sequence folder, scan for latest published blend files, review and toggle individual shots, export to ZIP
    • Studio template system — dropdown to select folder conventions per studio (Autour de Minuit, La Cabane Productions). Templates define where to look for published files and which task types are available
    • Progress indicator — cursor progress bar during tracing and file transfer on all pack operators
    • Auto-named output — ZIP filename inferred from the scanned folder name

    CLI

    • New bat pack-sequence -t output.zip file1.blend file2.blend ... subcommand for packing multiple blend files with unambiguous argument parsing
    • Old bat pack --sequence still works but is deprecated

    Improvements

    • Blender 5.0 compatibility fixes (DNA struct changes for nodes, modifiers, sequencer)
    • Console logging for all pack operations (trace progress, asset counts, transfer status)
    • ZIP write start/finish logging
    • pack-info.txt now lists all blend files when packing a sequence

    Bug fixes

    • Fixed folder matching using prefix instead of exact match (e.g. Publish_old could be picked over Publish)
    • Fixed Windows UNC and drive letter path normalization in bpathlib.make_absolute()
    • Fixed os.path.commonpath crash when blend files span multiple drives
    • Fixed progress bar getting stuck on pack failure (missing progress_end() cleanup)
    • Fixed ZIP error handler swallowing tracebacks
    • Added per-shot error isolation in sequence scan (one broken folder no longer aborts the entire scan)
    • Deduplicate blend file paths when same file appears in both positional arg and --sequence

    Testing

    • 28 new tests for sequence packing (tests/test_sequence_pack.py)
    • 0 regressions on existing test suite
    image.png image.png
    Downloads
  • 1.21 Stable

    joseph.henry released this 2026-02-20 11:01:20 +01:00 | 5 commits to main since this release

    What's new

    Pack operators in Blender

    Two pack operators are now available under File > External Data:

    • BAT - Zip pack (flat) — Pack all assets into a flat ZIP archive
    • BAT - Zip pack (keep hierarchy) — Pack preserving the project directory structure, with configurable project root and optional directory copy mode

    Keep hierarchy packing

    New --keep-hierarchy CLI option that preserves the full project directory structure in the pack. Paths in blend files are rewritten to relative paths within the hierarchy.

    Addon preferences

    Added a preferences panel (Edit > Preferences > Add-ons) to configure:

    • A default project root directory
    • Reading the root from ZIP_ROOT or PROJECT_ROOT environment variables

    Improvements

    • Refactored addon structure: operators and preferences moved to dedicated modules (operators.py, preferences.py)
    • Fixed cyclic package import with the preferences module
    Downloads