Project

The Project object holds all of the project settings from the project configuration file including the project directory it was loaded from.

BST_FORMAT_VERSION = 0

The base BuildStream format version

This version is bumped whenever enhancements are made to the project.conf format or the format in general.

BST_ARTIFACT_VERSION = 0

The base BuildStream artifact version

The artifact version changes whenever the cache key calculation algorithm changes in an incompatible way or if buildstream was changed in a way which can cause the same cache key to produce something that is no longer the same.

class Project(directory, host_arch, target_arch=None)

Bases: object

Project Configuration

Parameters:

• directory (str) – The project directory
• host_arch (str) – Symbolic host machine architecture name
• target_arch (str) – Symbolic target machine architecture name

Raises:

LoadError

name = None

str – The project name

directory = None

str – The project directory

element_path = None

str – Absolute path to where elements are loaded from within the project

translate_url(url)

Translates the given url which may be specified with an alias into a fully qualified url.

Parameters:url (str) – A url, which may be using an alias Returns:The fully qualified url, with aliases resolved Return type:str

This method is provided for Source objects to resolve fully qualified urls based on the shorthand which is allowed to be specified in the YAML