52 lines
2.0 KiB
Markdown
52 lines
2.0 KiB
Markdown
# Blender Asset Tracer BAT🦇
|
|
|
|
Script to manage assets with Blender.
|
|
|
|
Blender Asset Tracer, a.k.a. BAT🦇, is the replacement of
|
|
[BAM](https://developer.blender.org/diffusion/BAM/) and
|
|
[blender-file](https://developer.blender.org/source/blender-file/)
|
|
|
|
Development is driven by choices explained in [T54125](https://developer.blender.org/T54125).
|
|
|
|
|
|
## Uploading to S3-compatible storage
|
|
|
|
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.qarnot.com/jobs/awesome_work
|
|
|
|
This will upload the blend file and its dependencies to `awesome_work/my_blendfile.blend` in
|
|
the `jobs` bucket.
|
|
|
|
|
|
## Paths
|
|
|
|
There are two object types used to represent file paths. Those are strictly separated.
|
|
|
|
1. `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.
|
|
2. `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.
|
|
|
|
|
|
## Type checking
|
|
|
|
The code statically type-checked with [mypy](http://mypy-lang.org/).
|
|
|
|
Mypy likes to see the return type of `__init__` methods explicitly declared as `None`. Until issue
|
|
[#604](https://github.com/python/mypy/issues/604) is resolved, we just do this in our code too.
|