gecko/python/mozbuild
Gregory Szorc f299c1f5e8 Bug 899792 - Establish precompile tier and move IPDL and WebIDL build rules; r=glandium
A new build tier is introduced: precompile. The intention is to replace
the export subtier with something better and nonrecursive. IPDL and
WebIDL code generation have been moved into this new tier and are
performed concurrently. This appears to reduce build times due to fewer
"single threaded" build actions.

The subtier tracking UI has been updated to reflect operations that can
occur in parallel. As subtiers are started, they turn yellow. They can
then complete in any order.

Nonrecursive targets have been added to preserve the IPDL and WebIDL
build targets such that developers can type |make| from leaf directories
like they have always done.
2013-07-30 17:00:24 -07:00
..
dumbmake Bug 677452 - Add smartmake-like functionality to |mach build DIR|. r=gps 2013-05-01 15:36:05 -07:00
mozbuild Bug 899792 - Establish precompile tier and move IPDL and WebIDL build rules; r=glandium 2013-07-30 17:00:24 -07:00
mozpack Bug 893976 - Avoid importing buildconfig globally from mozpack.executables. r=gps 2013-07-30 08:57:28 +09:00
README.rst Bug 784841 - Part 7: Implement recursive make backend; r=ted 2013-01-29 06:24:24 -08:00
setup.py Bug 780561 - Import new packager code. r=gps 2013-01-23 11:23:14 +01: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.backend -- Functionality for producing and interacting with build
  backends. A build backend is an entity that consumes build system metadata
  (from mozbuild.frontend) and does something useful with it (typically writing
  out files that can be used by a build tool to build the tree).
* 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.
* mozpack -- Functionality related to packaging builds.

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.

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.