1dg(1)                       General Commands Manual                      dg(1)
2
3
4

NAME

6       dg - templating system/generator for distributions
7

SYNOPSIS

9       dg [-h] [--version] [--projectdir PROJECTDIR] [--distro DIST] [--multi‐
10       spec MULTISPEC] [--multispec-selector MULTISPEC_SELECTOR] [--spec SPEC]
11       [--output   OUTPUT]   [--macros-from   PROJECTDIR]   [--container  CON‐
12       TAINER_TYPE] [--macro MACRO] [--max-passes PASSES] [--keep-block-white‐
13       spaces] (--template TEMPLATE | --multispec-combinations)
14

DESCRIPTION

16       Generate script using predefined metadata about distribution and
17       templates.
18
19       As an example of 'dg' usage, to generate _Dockerfile_ for Fedora
20       21 64-bit system, you may use command(s):
21
22        $ cd project/directory
23        $ dg --spec      docker-data.yaml      \
24             --template  docker.tpl
25

OPTIONS

27       --version
28              show program's version number and exit
29
30
31       --projectdir PROJECTDIR
32              Directory with project (defaults to CWD)
33
34
35       --distro DIST
36              Use  DIST  distribution  configuration.   Either  that DIST.yaml
37              needs to exist in the distgen installation, or  it  can  be  any
38              file within PROJECTDIR (relative or absolute file name).
39
40
41       --multispec MULTISPEC
42              Use MULTISPEC yaml file to fill the TEMPLATE file
43
44
45       --multispec-selector MULTISPEC_SELECTOR
46              Selectors for the multispec file
47
48
49       --spec SPEC
50              Use SPEC yaml file to fill the TEMPLATE file
51
52
53       --output OUTPUT
54              Write result to OUTPUT file instead of stdout
55
56
57       --macros-from PROJECTDIR
58              Load variables from PROJECTDIR
59
60
61       --container CONTAINER_TYPE
62              Container type, e.g. 'docker'
63
64
65       --macro MACRO
66              Define distgen's macro
67
68
69       --max-passes PASSES
70              Maximum number of rendering passes, defaults to 32
71
72
73       --keep-block-whitespaces
74              Disable the jinja2 trim_blocks and lstrip_blocks options
75
76
77       --template TEMPLATE
78              Use  TEMPLATE  file,  e.g. docker.tpl or a template string, e.g.
79              "{{ config.docker.from }}"
80
81
82       --multispec-combinations
83              Print available multispec combinations
84
85

AUTHORS

87       distgen was written  by  Pavel  Raiskup  (see  AUTHORS)  <praiskup@red‐
88       hat.com>.
89

DISTRIBUTION

91       The    latest    version    of   distgen   may   be   downloaded   from
92       ⟨https://github.com/devexp-db/distgen⟩
93
94
95
96                                    Manual                               dg(1)
Impressum