gecko/python/mozbuild
Gregory Szorc f92f1b79dc Bug 808280 - Remove unused imports from mozconfig.py; r=ted
By preventing the import of pymake, multiprocessing is no longer
imported and BSDs should no longer choke when trying to import it.

DONTBUILD
2013-01-17 11:02:16 -08:00
..
mozbuild Bug 808280 - Remove unused imports from mozconfig.py; r=ted 2013-01-17 11:02:16 -08:00
README.rst Bug 784841 - Part 2: Implement sandboxing for Python build files; r=ted,glandium 2013-01-15 22:21:21 -08:00
setup.py Bug 794509 - Part 2: Move mach command modules into a mach.commands sub-module; r=jhammel 2012-10-05 12:13:18 -07:00
TODO Bug 784841 - Part 2: Implement sandboxing for Python build files; r=ted,glandium 2013-01-15 22:21:21 -08:00

========
mozbuild
========

mozbuild is a Python package providing functionality used by Mozilla's
build system.

Modules Overview
================

* mozbuild.compilation -- Functionality related to compiling. This
  includes managing compiler warnings.
* mozbuild.frontend -- Functionality for reading build frontend files
  (what defines the build system) and converting them to data structures
  which are fed into build backends to produce backend configurations.

Overview
========

The build system consists of frontend files that define what to do. They
say things like "compile X" "copy Y."

The mozbuild.frontend package contains code for reading these frontend
files and converting them to static data structures. The set of produced
static data structures for the tree constitute the current build
configuration.

There exist entities called build backends. From a high level, build
backends consume the build configuration and do something with it. They
typically produce tool-specific files such as make files which can be used
to build the tree.

Builders are entities that build the tree. They typically have high
cohesion with a specific build backend.

Piecing it all together, we have frontend files that are parsed into data
structures. These data structures are fed into a build backend. The output
from build backends is used by builders to build the tree.