app/soc/release.py
author Todd Larsen <tlarsen@google.com>
Sun, 23 Nov 2008 18:45:04 +0000
changeset 581 f7634fd0274c
parent 580 9fefe7895f38
child 582 c1900a929885
permissions -rw-r--r--
Attempt number two at a release process, with correct usage of /tags/ this time around. Patch by: Todd Larsen
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
578
0f34318f5693 Add release tag string, Melange "badge" image, and Google App Engine version
Todd Larsen <tlarsen@google.com>
parents:
diff changeset
     1
# Copyright 2008 the Melange authors.
0f34318f5693 Add release tag string, Melange "badge" image, and Google App Engine version
Todd Larsen <tlarsen@google.com>
parents:
diff changeset
     2
#
0f34318f5693 Add release tag string, Melange "badge" image, and Google App Engine version
Todd Larsen <tlarsen@google.com>
parents:
diff changeset
     3
# Licensed under the Apache License, Version 2.0 (the "License");
0f34318f5693 Add release tag string, Melange "badge" image, and Google App Engine version
Todd Larsen <tlarsen@google.com>
parents:
diff changeset
     4
# you may not use this file except in compliance with the License.
0f34318f5693 Add release tag string, Melange "badge" image, and Google App Engine version
Todd Larsen <tlarsen@google.com>
parents:
diff changeset
     5
# You may obtain a copy of the License at
0f34318f5693 Add release tag string, Melange "badge" image, and Google App Engine version
Todd Larsen <tlarsen@google.com>
parents:
diff changeset
     6
#
0f34318f5693 Add release tag string, Melange "badge" image, and Google App Engine version
Todd Larsen <tlarsen@google.com>
parents:
diff changeset
     7
#     http://www.apache.org/licenses/LICENSE-2.0
0f34318f5693 Add release tag string, Melange "badge" image, and Google App Engine version
Todd Larsen <tlarsen@google.com>
parents:
diff changeset
     8
#
0f34318f5693 Add release tag string, Melange "badge" image, and Google App Engine version
Todd Larsen <tlarsen@google.com>
parents:
diff changeset
     9
# Unless required by applicable law or agreed to in writing, software
0f34318f5693 Add release tag string, Melange "badge" image, and Google App Engine version
Todd Larsen <tlarsen@google.com>
parents:
diff changeset
    10
# distributed under the License is distributed on an "AS IS" BASIS,
0f34318f5693 Add release tag string, Melange "badge" image, and Google App Engine version
Todd Larsen <tlarsen@google.com>
parents:
diff changeset
    11
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
0f34318f5693 Add release tag string, Melange "badge" image, and Google App Engine version
Todd Larsen <tlarsen@google.com>
parents:
diff changeset
    12
# See the License for the specific language governing permissions and
0f34318f5693 Add release tag string, Melange "badge" image, and Google App Engine version
Todd Larsen <tlarsen@google.com>
parents:
diff changeset
    13
# limitations under the License.
0f34318f5693 Add release tag string, Melange "badge" image, and Google App Engine version
Todd Larsen <tlarsen@google.com>
parents:
diff changeset
    14
580
9fefe7895f38 Reset the RELEASE_TAG to None (unreleased) now that the 0.0a20081123 release
Todd Larsen <tlarsen@google.com>
parents: 578
diff changeset
    15
"""Release tag string for display in templates (and possibly other uses).
9fefe7895f38 Reset the RELEASE_TAG to None (unreleased) now that the 0.0a20081123 release
Todd Larsen <tlarsen@google.com>
parents: 578
diff changeset
    16
581
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    17
Steps (currently done by hand, but too be scripted in the future) to make
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    18
a release:
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    19
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    20
1) set RELEASE_TAG in this file to a "release candidate" release string that
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    21
   ends in "rc"
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    22
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    23
2) commit this file *by itself* in its own commit
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    24
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    25
3) use 'svn cp' to create a release branch in /branches/ with exactly the
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    26
   same name as the contents of the RELEASE_TAG string
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    27
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    28
4) set RELEASE_TAG back to None in /trunk/
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    29
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    30
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    31
To finalize a release candidate in a release branch for a push to the live
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    32
web site:
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    33
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    34
1) in the release branch, change RELEASE_TAG to remove the trailing "rc"
580
9fefe7895f38 Reset the RELEASE_TAG to None (unreleased) now that the 0.0a20081123 release
Todd Larsen <tlarsen@google.com>
parents: 578
diff changeset
    35
581
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    36
2) commit this file in the release branch *by itself* in its own commit
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    37
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    38
3) use 'svn cp' to create a tag in /tags/ with exactly the same name as the
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    39
   contents of the RELEASE_TAG string
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    40
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    41
4) put the release branch in a state where it is ready for additional patches
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    42
   after the tag by setting the end of the RELEASE_TAG string to "p0"
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    43
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    44
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    45
To re-release a previously-tagged release branch after a patch for a push to
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    46
the live web site:
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    47
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    48
1) increment the "patch suffix" of the RELEASE_TAG string to the next integer
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    49
   (for example, "p0" becomes "p1", so the first tagged patch release will
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    50
   always be "p1", not "p0", which is just a placeholder)
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    51
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    52
2) (same as #2 for a release candidate)
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    53
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    54
3) (same as #3 for a release candidate)
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    55
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    56
4) (there is no step 4)
580
9fefe7895f38 Reset the RELEASE_TAG to None (unreleased) now that the 0.0a20081123 release
Todd Larsen <tlarsen@google.com>
parents: 578
diff changeset
    57
"""
9fefe7895f38 Reset the RELEASE_TAG to None (unreleased) now that the 0.0a20081123 release
Todd Larsen <tlarsen@google.com>
parents: 578
diff changeset
    58
578
0f34318f5693 Add release tag string, Melange "badge" image, and Google App Engine version
Todd Larsen <tlarsen@google.com>
parents:
diff changeset
    59
__authors__ = [
0f34318f5693 Add release tag string, Melange "badge" image, and Google App Engine version
Todd Larsen <tlarsen@google.com>
parents:
diff changeset
    60
  '"Todd Larsen" <tlarsen@google.com>',
0f34318f5693 Add release tag string, Melange "badge" image, and Google App Engine version
Todd Larsen <tlarsen@google.com>
parents:
diff changeset
    61
  ]
0f34318f5693 Add release tag string, Melange "badge" image, and Google App Engine version
Todd Larsen <tlarsen@google.com>
parents:
diff changeset
    62
0f34318f5693 Add release tag string, Melange "badge" image, and Google App Engine version
Todd Larsen <tlarsen@google.com>
parents:
diff changeset
    63
581
f7634fd0274c Attempt number two at a release process, with correct usage of /tags/ this
Todd Larsen <tlarsen@google.com>
parents: 580
diff changeset
    64
RELEASE_TAG = '0.0a20081123rc'
580
9fefe7895f38 Reset the RELEASE_TAG to None (unreleased) now that the 0.0a20081123 release
Todd Larsen <tlarsen@google.com>
parents: 578
diff changeset
    65