Download qooxdoo Documentation

qooxdoo Documentation, Release 1.3.1
• Further optimization includes support for auto-merging small packages. The relevant size to decide if a package
is too small, is the minimum compiled size which is defined by the author of the job. The system calculates the
size of each package and tries to merge packages automatically.
• The parts can be used in combination with the include/exclude system. Includes can be used to select the classes
to use.
• By default all classes mentioned in the parts are added to the include list. It is possible to override this list.
• All global excludes listed are also respected for the parts.
8.1.2 Generator Usage
The generator is a command-line utility which serves as the single entry point front-end for all qooxdoo tool chain
functions (nearly; there are a few functions that are available through other programs, but these really serve specialcase purposes).
The generator is started to execute various jobs. Those jobs represent the feature set of the tool chain. This page is
about how to invoke the generator.
Files and Folder Structure
The qooxdoo SDK has a dedicated tool folder that contains all elements that make up the tool chain. The general
structure is like this:
tool
||||-
app
-- helper apps
bin
-- stand-alone programs and scripts
data -- various data files
pylib -- Python modules
The generator is actually the program under tool/bin/generator.py.
generate.py
To make it easier to invoke the generator, each library in the SDK (framework, applications, components) contains a
generate.py script that is really just a proxy for the generator itself. It is also part of each project structure created
by the create-application.py wizard. The aim is to hide the actual path to the generator program.
Command-line Options
Since the generator is nearly complete driven by its config files, there are very few command-line options:
shell> generator.py -h
Usage: generator.py [options] job,...
Arguments:
job,...
x
a list of jobs (like ’source’ or ’copy-files’,
without the quotes) to run
use ’x’ (or some undefined job name) to get a
list of all available jobs from the configuration file
Options:
-h, --help
show this help message and exit
-c CFGFILE, --config=CFGFILE
8.1. Generator Introduction
255