app/soc/release.py
author Sverre Rabbelier <srabbelier@gmail.com>
Tue, 24 Feb 2009 12:52:19 +0000
changeset 1479 bc738f92a4d8
parent 1393 142b2d97ec13
child 1493 2f6a607390df
permissions -rw-r--r--
Fix the user editing Noticed by: Lennard de Rijk Patch by: Sverre Rabbelier
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1308
35b75ffcbb37 Partially reverted "Update the copyright notice for 2009."
Sverre Rabbelier <srabbelier@gmail.com>
parents: 1307
diff changeset
     1
# Copyright 2008 the Melange authors.
578
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
1393
142b2d97ec13 Reset the RELEASE_TAG to None (unreleased) now that the 0.3-20090219 release
Pawel Solyga <Pawel.Solyga@gmail.com>
parents: 1392
diff changeset
    64
RELEASE_TAG = None
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