autopkg.py 12 KB
Newer Older
1
# Copyright 2012, 2013 GRNET S.A. All rights reserved.
Vangelis Koukis's avatar
Vangelis Koukis committed
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
#
# Redistribution and use in source and binary forms, with or
# without modification, are permitted provided that the following
# conditions are met:
#
#   1. Redistributions of source code must retain the above
#      copyright notice, this list of conditions and the following
#      disclaimer.
#
#   2. Redistributions in binary form must reproduce the above
#      copyright notice, this list of conditions and the following
#      disclaimer in the documentation and/or other materials
#      provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY GRNET S.A. ``AS IS'' AND ANY EXPRESS
# OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
# WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL GRNET S.A OR
# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
# USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
# AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
# ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.
#
# The views and conclusions contained in the software and
# documentation are those of the authors and should not be
# interpreted as representing official policies, either expressed
# or implied, of GRNET S.A.

Christos Stavrakakis's avatar
Christos Stavrakakis committed
34
35
"""Helper script for automatic build of debian packages."""

Vangelis Koukis's avatar
Vangelis Koukis committed
36
37
38
39
import git
import os
import sys
from optparse import OptionParser
40
from collections import namedtuple
Christos Stavrakakis's avatar
Christos Stavrakakis committed
41
from sh import mktemp, cd, rm, git_dch  # pylint: disable=E0611
42
from configobj import ConfigObj
Vangelis Koukis's avatar
Vangelis Koukis committed
43

44
from devflow import versioning
Christos Stavrakakis's avatar
Christos Stavrakakis committed
45

Vangelis Koukis's avatar
Vangelis Koukis committed
46
47
48
49
50
51
52
53
54
55
56
try:
    from colors import red, green
except ImportError:
    red = lambda x: x
    green = lambda x: x

print_red = lambda x: sys.stdout.write(red(x) + "\n")
print_green = lambda x: sys.stdout.write(green(x) + "\n")

AVAILABLE_MODES = ["release", "snapshot"]

57
58
59
60
61
62
63
64
branch_type = namedtuple("branch_type", ["default_debian_branch"])
BRANCH_TYPES = {
    "feature": branch_type("debian-develop"),
    "develop": branch_type("debian-develop"),
    "release": branch_type("debian-develop"),
    "master": branch_type("debian"),
    "hotfix": branch_type("debian")}

Christos Stavrakakis's avatar
Christos Stavrakakis committed
65

Christos Stavrakakis's avatar
Christos Stavrakakis committed
66
67
68
69
70
71
DESCRIPTION = """Tool for automatical build of debian packages.

%(prog)s is a helper script for automatic build of debian packages from
repositories that follow the `git flow` development model
<http://nvie.com/posts/a-successful-git-branching-model/>.

72
73
This script must run from inside a clean git repository and will perform the
following steps:
Christos Stavrakakis's avatar
Christos Stavrakakis committed
74
75
76
77
78
79
80
81
    * Clone your repository to a temporary directory
    * Merge the current branch with the corresponding debian branch
    * Compute the version of the new package and update the python
      version files
    * Create a new entry in debian/changelog, using `git-dch`
    * Create the debian packages, using `git-buildpackage`
    * Tag the appropriate branches if in `release` mode

82
83
84
%(prog)s will work with the packages that are declared in `autopkg.conf`
file, which must exist in the toplevel directory of the git repository.

Christos Stavrakakis's avatar
Christos Stavrakakis committed
85
86
87
88
89
90
"""


def print_help(prog):
    print DESCRIPTION % {"prog": prog}

Vangelis Koukis's avatar
Vangelis Koukis committed
91
92
93
94

def main():
    from devflow.version import __version__
    parser = OptionParser(usage="usage: %prog [options] mode",
Christos Stavrakakis's avatar
Christos Stavrakakis committed
95
96
97
98
99
100
                          version="devflow %s" % __version__,
                          add_help_option=False)
    parser.add_option("-h", "--help",
                      action="store_true",
                      default=False,
                      help="show this help message")
Vangelis Koukis's avatar
Vangelis Koukis committed
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
    parser.add_option("-k", "--keep-repo",
                      action="store_true",
                      dest="keep_repo",
                      default=False,
                      help="Do not delete the cloned repository")
    parser.add_option("-b", "--build-dir",
                      dest="build_dir",
                      default=None,
                      help="Directory to store created pacakges")
    parser.add_option("-r", "--repo-dir",
                      dest="repo_dir",
                      default=None,
                      help="Directory to clone repository")
    parser.add_option("-d", "--dirty",
                      dest="force_dirty",
                      default=False,
                      action="store_true",
                      help="Do not check if working directory is dirty")
119
120
121
    parser.add_option("-c", "--config-file",
                      dest="config_file",
                      help="Override default configuration file")
Christos Stavrakakis's avatar
Christos Stavrakakis committed
122
123
124
125
126
    parser.add_option("--no-sign",
                      dest="sign",
                      action="store_false",
                      default=True,
                      help="Do not sign the packages")
127
128
129
    parser.add_option("--key-id",
                      dest="keyid",
                      help="Use this keyid for gpg signing")
130
131
132
133
    parser.add_option("--dist",
                      dest="dist",
                      default="unstable",
                      help="If running in snapshot mode, automatically set"
Christos Stavrakakis's avatar
Christos Stavrakakis committed
134
135
                           " the changelog distribution to this value"
                           " (default=unstable).")
Vangelis Koukis's avatar
Vangelis Koukis committed
136
137
138

    (options, args) = parser.parse_args()

Christos Stavrakakis's avatar
Christos Stavrakakis committed
139
140
141
142
143
    if options.help:
        print_help(parser.get_prog_name())
        parser.print_help()
        return

144
    # Get build mode
Christos Stavrakakis's avatar
Christos Stavrakakis committed
145
146
147
148
149
    try:
        mode = args[0]
    except IndexError:
        raise ValueError("Mode argument is mandatory. Usage: %s"
                         % parser.usage)
Vangelis Koukis's avatar
Vangelis Koukis committed
150
151
152
153
    if mode not in AVAILABLE_MODES:
        raise ValueError(red("Invalid argument! Mode must be one: %s"
                         % ", ".join(AVAILABLE_MODES)))

154
    os.environ["DEVFLOW_BUILD_MODE"] = mode
Vangelis Koukis's avatar
Vangelis Koukis committed
155

156
    # Load the repository
Vangelis Koukis's avatar
Vangelis Koukis committed
157
158
    try:
        original_repo = git.Repo(".")
Christos Stavrakakis's avatar
Christos Stavrakakis committed
159
    except git.InvalidGitRepositoryError:
Vangelis Koukis's avatar
Vangelis Koukis committed
160
161
        raise RuntimeError(red("Current directory is not git repository."))

162
    # Check that repository is clean
Christos Stavrakakis's avatar
Christos Stavrakakis committed
163
    toplevel = original_repo.working_dir
Vangelis Koukis's avatar
Vangelis Koukis committed
164
165
166
    if original_repo.is_dirty() and not options.force_dirty:
        raise RuntimeError(red("Repository %s is dirty." % toplevel))

167
    # Get packages from configuration file
168
169
170
    config_file = options.config_file or os.path.join(toplevel, "devflow.conf")
    config = ConfigObj(config_file)
    packages = config['packages'].keys()
Christos Stavrakakis's avatar
Christos Stavrakakis committed
171
    print_green("Will build the following packages:\n" + "\n".join(packages))
Vangelis Koukis's avatar
Vangelis Koukis committed
172

Christos Stavrakakis's avatar
Christos Stavrakakis committed
173
    # Get current branch name and type and check if it is a valid one
174
    branch = original_repo.head.reference.name
Christos Stavrakakis's avatar
Christos Stavrakakis committed
175
    branch_type_str = versioning.get_branch_type(branch)
Vangelis Koukis's avatar
Vangelis Koukis committed
176

Christos Stavrakakis's avatar
Christos Stavrakakis committed
177
    if branch_type_str not in BRANCH_TYPES.keys():
Christos Stavrakakis's avatar
Christos Stavrakakis committed
178
        allowed_branches = ", ".join(BRANCH_TYPES.keys())
179
180
181
        raise ValueError("Malformed branch name '%s', cannot classify as"
                         " one of %s" % (branch, allowed_branches))

182
    # Check that original repo has the correct debian branch
Christos Stavrakakis's avatar
Christos Stavrakakis committed
183
    debian_branch = "debian-" + branch
184
    origin_debian = "origin/" + debian_branch
185
    if not debian_branch in original_repo.branches:
186
        # Get default debian branch
Christos Stavrakakis's avatar
Christos Stavrakakis committed
187
        default_debian = BRANCH_TYPES[branch_type_str].default_debian_branch
Christos Stavrakakis's avatar
Christos Stavrakakis committed
188
        origin_debian = "origin/" + default_debian
189
190
191
192
193
194
        if not default_debian in original_repo.branches:
            original_repo.git.branch(default_debian,
                                     origin_debian)

    # Clone the repo
    repo_dir = options.repo_dir or create_temp_directory("df-repo")
Christos Stavrakakis's avatar
Christos Stavrakakis committed
195
    repo_dir = os.path.abspath(repo_dir)
196
    repo = original_repo.clone(repo_dir, branch=branch)
197
    print_green("Cloned repository to '%s'." % repo_dir)
Christos Stavrakakis's avatar
Christos Stavrakakis committed
198

Christos Stavrakakis's avatar
Christos Stavrakakis committed
199
200
201
202
    build_dir = options.build_dir or create_temp_directory("df-build")
    build_dir = os.path.abspath(build_dir)
    print_green("Build directory: '%s'" % build_dir)

203
    # Create the debian branch
Christos Stavrakakis's avatar
Christos Stavrakakis committed
204
    repo.git.branch(debian_branch, origin_debian)
205
206
    print_green("Created branch '%s' to track '%s'" % (debian_branch,
                origin_debian))
Vangelis Koukis's avatar
Vangelis Koukis committed
207

208
    # Go to debian branch
Vangelis Koukis's avatar
Vangelis Koukis committed
209
210
211
    repo.git.checkout(debian_branch)
    print_green("Changed to branch '%s'" % debian_branch)

212
    # Merge with starting branch
Vangelis Koukis's avatar
Vangelis Koukis committed
213
    repo.git.merge(branch)
Christos Stavrakakis's avatar
Christos Stavrakakis committed
214
    print_green("Merged branch '%s' into '%s'" % (branch, debian_branch))
Vangelis Koukis's avatar
Vangelis Koukis committed
215

216
    # Compute python and debian version
Vangelis Koukis's avatar
Vangelis Koukis committed
217
    cd(repo_dir)
218
    python_version = versioning.get_python_version()
Christos Stavrakakis's avatar
Christos Stavrakakis committed
219
    debian_version = versioning.\
Christos Stavrakakis's avatar
Christos Stavrakakis committed
220
        debian_version_from_python_version(python_version)
Christos Stavrakakis's avatar
Christos Stavrakakis committed
221
    print_green("The new debian version will be: '%s'" % debian_version)
Vangelis Koukis's avatar
Vangelis Koukis committed
222

223
    # Update the version files
Christos Stavrakakis's avatar
Christos Stavrakakis committed
224
    versioning.update_version()
225

Christos Stavrakakis's avatar
Christos Stavrakakis committed
226
227
228
    # Tag branch with python version
    branch_tag = python_version
    repo.git.tag(branch_tag, branch)
229
230
    upstream_tag = "upstream/" + branch_tag
    repo.git.tag(upstream_tag, branch)
Christos Stavrakakis's avatar
Christos Stavrakakis committed
231

232
    # Update changelog
Vangelis Koukis's avatar
Vangelis Koukis committed
233
    dch = git_dch("--debian-branch=%s" % debian_branch,
Christos Stavrakakis's avatar
Christos Stavrakakis committed
234
235
236
237
238
                  "--git-author",
                  "--ignore-regex=\".*\"",
                  "--multimaint-merge",
                  "--since=HEAD",
                  "--new-version=%s" % debian_version)
Vangelis Koukis's avatar
Vangelis Koukis committed
239
240
241
    print_green("Successfully ran '%s'" % " ".join(dch.cmd))

    if mode == "release":
242
        call("vim debian/changelog")
243
244
245
    else:
        f = open("debian/changelog", 'r+')
        lines = f.readlines()
246
        lines[0] = lines[0].replace("UNRELEASED", options.dist)
Christos Stavrakakis's avatar
Christos Stavrakakis committed
247
        lines[2] = lines[2].replace("UNRELEASED", "Snapshot build")
248
249
250
        f.seek(0)
        f.writelines(lines)
        f.close()
Christos Stavrakakis's avatar
Christos Stavrakakis committed
251
252
253
254
255
256
257
258

    # Add changelog to INDEX
    repo.git.add("debian/changelog")
    # Commit Changes
    repo.git.commit("-s", "-a", m="Bump version to %s" % debian_version)
    # Tag debian branch
    debian_branch_tag = "debian/" + branch_tag
    repo.git.tag(debian_branch_tag)
Vangelis Koukis's avatar
Vangelis Koukis committed
259
260

    # Add version.py files to repo
261
    call("grep \"__version_vcs\" -r . -l -I | xargs git add -f")
Vangelis Koukis's avatar
Vangelis Koukis committed
262

Christos Stavrakakis's avatar
Christos Stavrakakis committed
263
    # Create debian packages
Christos Stavrakakis's avatar
Christos Stavrakakis committed
264
    cd(repo_dir)
265
266
267
268
    version_files = []
    for _, pkg_info in config['packages'].items():
        version_files.append(pkg_info['version_file'])
    ignore_regexp = "|".join(["^(%s)$" % vf for vf in version_files])
Christos Stavrakakis's avatar
Christos Stavrakakis committed
269
270
271
    build_cmd = "git-buildpackage --git-export-dir=%s"\
                " --git-upstream-branch=%s --git-debian-branch=%s"\
                " --git-export=INDEX --git-ignore-new -sa"\
272
273
274
275
                " --source-option='\"--extend-diff-ignore=%s\"'"\
                " --git-upstream-tag=%s"\
                % (build_dir, branch, debian_branch, ignore_regexp,
                   upstream_tag)
Christos Stavrakakis's avatar
Christos Stavrakakis committed
276
277
    if not options.sign:
        build_cmd += " -uc -us"
278
279
    elif options.keyid:
        build_cmd += " -k\"'%s'\"" % options.keyid
Christos Stavrakakis's avatar
Christos Stavrakakis committed
280
    call(build_cmd)
Vangelis Koukis's avatar
Vangelis Koukis committed
281

282
    # Remove cloned repo
283
    if mode != 'release' and not options.keep_repo:
Vangelis Koukis's avatar
Vangelis Koukis committed
284
285
286
        print_green("Removing cloned repo '%s'." % repo_dir)
        rm("-r", repo_dir)

Christos Stavrakakis's avatar
Christos Stavrakakis committed
287
288
289
290
291
292
293
294
295
    # Print final info
    info = (("Version", debian_version),
            ("Upstream branch", branch),
            ("Upstream tag", branch_tag),
            ("Debian branch", debian_branch),
            ("Debian tag", debian_branch_tag),
            ("Repository directory", repo_dir),
            ("Packages directory", build_dir))
    print_green("\n".join(["%s: %s" % (name, val) for name, val in info]))
Christos Stavrakakis's avatar
Christos Stavrakakis committed
296

297
    # Print help message
Christos Stavrakakis's avatar
Christos Stavrakakis committed
298
    if mode == "release":
Christos Stavrakakis's avatar
Christos Stavrakakis committed
299
300
301
302
        origin = original_repo.remote().url
        repo.create_remote("original_origin", origin)
        print_green("Created remote 'original_origin' for the repository '%s'"
                    % origin)
Christos Stavrakakis's avatar
Christos Stavrakakis committed
303

Christos Stavrakakis's avatar
Christos Stavrakakis committed
304
305
306
307
308
309
        print_green("To update repositories '%s' and '%s' go to '%s' and run:"
                    % (toplevel, origin, repo_dir))
        for remote in ['origin', 'original_origin']:
            print
            for obj in [debian_branch, branch_tag, debian_branch_tag]:
                print_green("git push %s %s" % (remote, obj))
Christos Stavrakakis's avatar
Christos Stavrakakis committed
310
311


312
313
314
def create_temp_directory(suffix):
    create_dir_cmd = mktemp("-d", "/tmp/" + suffix + "-XXXXX")
    return create_dir_cmd.stdout.strip()
Vangelis Koukis's avatar
Vangelis Koukis committed
315
316


317
318
319
def call(cmd):
    rc = os.system(cmd)
    if rc:
Christos Stavrakakis's avatar
Christos Stavrakakis committed
320
        raise RuntimeError("Command '%s' failed!" % cmd)
321
322


Vangelis Koukis's avatar
Vangelis Koukis committed
323
324
if __name__ == "__main__":
    sys.exit(main())