BAT parses Blend files and produces dependency information. After installation run `bat --help`
pip install blender-asset-tracer==1.12
Script to manage assets with Blender.
Blender Asset Tracer, a.k.a. BAT🦇, is the replacement of BAM and blender-file
Development is driven by choices explained in T54125.
BAT Pack supports uploading to S3-compatible storage. This requires a credentials file in
~/.aws/credentials
. Replace the all-capital words to suit your situation.
[ENDPOINT]
aws_access_key_id = YOUR_ACCESS_KEY_ID
aws_secret_access_key = YOUR_SECRET
You can then send a BAT Pack to the storage using a target s3:/ENDPOINT/bucketname/path-in-bucket
,
for example:
bat pack my_blendfile.blend s3:/storage.service.cloud/jobs/awesome_work
This will upload the blend file and its dependencies to awesome_work/my_blendfile.blend
in
the jobs
bucket.
There are two object types used to represent file paths. Those are strictly separated.
bpathlib.BlendPath
represents a path as stored in a blend file. It consists of bytes, and is
blendfile-relative when it starts with //
. It can represent any path from any OS Blender
supports, and as such should be used carefully.pathlib.Path
represents an actual path, possibly on the local filesystem of the computer
running BAT. Any filesystem operation (such as checking whether it exists) must be done using a
pathlib.Path
.When it is necessary to interpret a bpathlib.BlendPath
as a real path instead of a sequence of
bytes, BAT first attempts to decode it as UTF-8. If that fails, the local filesystem encoding is
used. The latter is also no guarantee of correctness, though.
The code statically type-checked with mypy.
Mypy likes to see the return type of __init__
methods explicitly declared as None
. Until issue
#604 is resolved, we just do this in our code too.