Spectacle

Spectacle is the toolset for packaging maintenance of MeeGo, including the tool to generate spec files from metadata file in YAML format, and tools to convert spec files or spec-builder's ini files to YAML format.

For spectacle managed packages, all generic packaging information will be stored in the YAML file, and it also allows maintaining customizations in the spec file directly with special enclosure tags.

Three separated tools will be installed:

• specify: the tool to generate or to update spec file, based on YAML
• ini2spectacle: the tool to convert spec-builder .ini to YAML and new spec file
• spec2spectacle: the tool to convert original spec to YAML and new spec file

Requirements:

• python 2.x, above 2.5
• PyYAML, the python module for YAML parsing
• cheetah, one popular templating system for python

Usage;

specify [options] [yaml-path]

Options:
  --version             show program's version number and exit
  -h, --help            show this help message and exit
  -o OUTFILE_PATH, --output=OUTFILE_PATH
                        Path of output spec file
  -s, --skip-scm        Skip to check upstream SCM when specified in YAML
  -N, --not-download    Do not try to download newer source files
  -n, --non-interactive
                    Non interactive running, to use default answers

ini2spectacle [options] [ini-path]

Options:
  --version             show program's version number and exit
  -h, --help            show this help message and exit
  -o OUTFILE_PATH, --output=OUTFILE_PATH
                        Path of output yaml file
  -f, --include-files   To store files list in YAML file

spec2spectacle [options] [spec-path]

Options:
  --version             show program's version number and exit
  -h, --help            show this help message and exit
  -o OUTFILE_PATH, --output=OUTFILE_PATH
                        Path of output yaml file
  -r, --replace-macros  To replace self-defined macros in spec file
  --no-builder-parsing  Do NOT try to parse build/install scripts
  -f, --include-files   To store files list in YAML file