|author||Jay Zhuang <email@example.com>||Thu Feb 25 20:16:17 2021|
|committer||Mark Mentovai <firstname.lastname@example.org>||Thu Feb 25 22:38:40 2021|
Wrap python build script in __main__ guard This makes it safe for other scripts to import it as a module. For example another script might want to import this script, and use importlib to list all of this script's transitive dependencies. Change-Id: I295f2297787b3136283e5619ab18ccf5d18b83bf Reviewed-on: https://chromium-review.googlesource.com/c/chromium/mini_chromium/+/2720450 Reviewed-by: Mark Mentovai <email@example.com>
This is mini_chromium, a small collection of useful low-level (“base”) routines from the Chromium open-source project. Chromium is large, sprawling, full of dependencies, and a web browser. mini_chromium is small, self-contained, and a library. mini_chromium is especially useful as a dependency of other code that wishes to use Chromium’s base routines. By using mini_chromium, other projects’ code can function in a standalone environment outside of Chromium without having to treat all of Chromium as a dependency. When building as part of Chromium, those projects’ code can use Chromium’s own (non-mini_chromium) base implementation.
Code provided in mini_chromium provides the same interface as the equivalent code in Chromium.
While it’s a goal of mini_chromium to maintain interface compatibility with Chromium’s base library for the interfaces it does implement, there’s no requirement that it use the same implementations as Chromium’s base library. Many of the implementations used in mini_chromium are identical to Chromium’s, but many others have been modified to eliminate dependencies that are not desired in mini_chromium, and a few are completely distinct from Chromium’s altogether. Additionally, when mini_chromium provides an interface in the form of a file or class present in Chromium, it’s not bound to provide all functions, methods, or types that the Chromium equivalent does. The differences noted above notwithstanding, the interfaces exposed by mini_chromium’s base are and must remain a strict subset of Chromium’s.
Crashpad is the chief consumer of mini_chromium.