This directory contains shared Python utility/helper modules for use by scripts and other modules in //tools/android
.
chromium_git/src/tools/android
to your Python module search path, e.g.:_TOOLS_ANDROID_PATH = pathlib.Path(__file__).resolve().parents[2] if str(_TOOLS_ANDROID_PATH) not in sys.path: sys.path.append(str(_TOOLS_ANDROID_PATH))
from python_utils import some_util_module
Although the module search path can be modified in many ways, the example code above ensures that some_util_module
is specifically the one from //tools/android/python_utils
.
Note: A Python file‘s directory gets added to the search path automatically, therefore another module named some_util_module
in the same directory could inadvertently be imported if using a plain import some_util_module
statement. The above code adds tools/android
to the end of the module search path in case you intentionally need to import some_util_module
from the file’s directory. However, the local module should ideally be renamed in this case to avoid confusion.
The git_metadata_utils
module provides helper functions for retrieving Git repository metadata, including the SHA1 hash and timestamp of the HEAD
commit. Additionally, it provides a simple function to retrieve the absolute path of the Chromium src
directory.
The subprocess_utils
module provides helper functions for running commands as subprocesses and returning the output as a string, as well as emitting debug logs to the console on failure.