The BasicAssetLibrary provides a basic "librarian" asset management system.
It serves to provide a minimum level of functionality to allow simple, repeatable demonstrations and end-to-end tests to be realized with as little supporting infrastructure as possible.
It is not intended to be any kind of comprehensive example of the breadth of functionality exposed though the OpenAssetIO API. See the SampleAssetManager for a more concrete example of canonical manager behavior.
Note: This code is a sketch to facilitate testing and sample workflows. It should never be considered in any way a "good example of how to write an asset management system". Consequently, it omits a plethora of "good engineering practice".
Resolves references with the bal:///
prefix to data from a
pre-configured library of assets stored in a .json
file.
Environment variables are expanded in string-type trait property
values (using the $var
or ${var}
syntax, escape $
using $$
). A
library can also define arbitrary variables of its own under the
top-level variables
key. In addition, BAL provides the built-in
$bal_library_path
, $bal_library_dir
and $bal_library_dir_url
variables, which can be used to anchor to the current library
location.
Any string undergoing expansion will also be normalized, removing relative paths, if that string presents as a file URL.
The library file to be used is controlled by the library_path
setting, and this should point to a library file with valid content.
If no library_path
has been specified, the BAL_LIBRARY_PATH
env
var will be checked to see if it points to a valid library file.
Persists newly registered data in-memory (the original library JSON is not updated).
Simulate network delay with the simulated_query_latency_ms
setting.
Note
Pythons time.sleep is the mechanism by which the delay is triggered. Simulated query latency defaults to 10ms.
The entity reference URL scheme consumed by BAL can be adjusted from the
default of bal
using the entity_reference_url_scheme
setting.
This must be set to a simple alphanumeric string.
Specific versions of BAL entities are accessed using the v=X
query
parameter, where X
is an integer version number starting at 1
or
the string latest
. BAL also supports OpenAssetIO-MediaCreation
*EntityVersionsRelationship
relationship
queries, including filtering by stableTag
.
To use the plugin in an OpenAssetIO host, install via pip
, or set (or append) the
OPENASSETIO_PLUGIN_PATH
env var to include the plugin
directory in
a checkout of the source repository.
The plugin provides a manager with the identifier
org.openassetio.examples.manager.bal
.
python -m pip install openassetio-manager-bal
A JSON Schema is provided here that validates a BAL library file.
The test fixtures take care of providing a suitable host environment and configuring the OpenAssetIO plugin search paths for you. Assuming your working directory is set to a checkout of the source repository:
python -m venv .venv
. .venv/bin/activate
python -m pip install -r tests/requirements.txt
python -m pip install .
python -m pytest ./tests