Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Script tagCollector.py has been committed to CVS (grits-tools/python/tagCollector.py). This page has been updated for version 1.20  in which a new option, --branch, was added. 22  for which the bulk of the work is done in batch under certain circumstances and which has new options, --submit_batch and --log.

The most recent version of the tagCollector.py script should be used. On SLAC linux, the most recent version is maintained at

/afs/slac.stanford.edu/g/glast/ground/scripts/tagCollector.py

Warning
titleWarning

Tag Since tag collecting is unfortunately not an atomic process. Under certain circumstances, especially when the internet connection is not great, the process can get hung up or crash part-way through. We strongly recommend that remote users, especially those with any history of problems with tag collecting, submit a batch job ., a poor internet connection can cause failure. As of version 1.22, in order to avoid such problems and to preserve output from actual tagging (--real option supplied), commands including the --real option submit a batch job. Therefore, such commands must be issued from a SLAC machine for which batch submission is enabled. There is no such restriction for --fake.

Note
titleInterface changes from previous versions

Version 1.22 adds new options --log and --submit_batch. Also, the --real option now implies --verbose. See details below.
Version 1.19 adds a new option, --branch, making it possible to create new tags along a branch. 
Version 1.13 accepts the value NONE for the --parent option.  In this case, --new

Note
titleInterface changes from previous versions

Version 1.19 adds a new option, --branch, making it possible to create new tags along a branch. 

Version 1.13 accepts the value NONE for the --parent option.  In this case, --new=HEAD is not allowed, but you can specify a positive integer, e.g. --new=123 in order to create a tag for HEAD 123.
Version 1.11 has the additional flag --fake. The options --real and --verbose are now also true flags, taking no argument.

...

CVS Version: $Id: tagCollector.py,v 1.20 22 2011/0809/01 1716:4214:02  36  jrb Exp $
See also https://confluence.slac.stanford.edu/x/GgFyBQ  

Wiki Markup
Options:
  \-h, \--help
  \-h, \--help                show this help message and exit
    \-p PARENT, \--parent=PARENT
                                                      HEAD or NONE. Someday also (branched) release tag to
                               act as base \[default: HEAD\]
    \-n NEWTAG, \--new=NEWTAG
                                                       Specify tag to be created: HEAD (interpreted as next
                                                      available HEAD), positive integer (number of HEAD), or
                show this help message and exit
    \-p PARENT, \--parent=PARENT
                                              HEADliteral ortag NONEname. Someday also (branched) release tag toRequired option

Wiki Markup
  \-b BRANCH, \--branch=BRANCH
                      act as base \[default: HEAD\]
    \-n NEWTAG, \--new=NEWTAG
          Bracnh along with to make tag. packageList.txt,
                                             Specify tag to be created: HEAD (interpreted as next
             containerNotes.txt and ChangeLog will come from this
                                 available HEAD), positive integer (number of HEAD), or
                     branch. \[default: MAIN\]
  \-u UPGRADEFILE, \--upgrade_list=UPGRADEFILE
                              literal tag name. Required option
Wiki Markup
  \-b BRANCH, \--branch=BRANCH
                          BracnhFile alonglisting withpackages to make tag. packageList.txt,upgrade, add or remove; used
                       containerNotes.txt and ChangeLog will come from this;         only when creating a new HEAD \[default: upgrade.txt\]
  \-r, \--real                         branch. Really do it \[default: not MAINset\]
  \-u UPGRADEFILEf, \--upgrade_list=UPGRADEFILE
fake                 Just print what we \*would\* do \[default: yes\]
  \-v, \--verbose           If Fileset listingshow packagesall tocvs upgrade,command add or remove; usedoutput \[default: not set\]
  \-s, \--submit_batch            Forces submit to batch even if \--fake
  \-l LOGFILE, \--log=LOGFILE
           only when creating a new HEAD \[default: upgrade.txt\]
  \-r, \--real           Really do it \[default: not set\]
  \-f, \--fake          Just print what we \*would\* do \[default: yes\]
  \-v, \--verbose     If set show allBatch cvslog commandfile outputpath \[default: not set$HOME/tagCollector.log\]
 --internal

In this version PARENT can only be HEAD on NONE.

...