P4 Shelve

Notes

To use these scripts with current versions of P4Python, you will need to remove the p4c.parse_forms() calls, as this function is no longer present in the GA version of the API.

See also p4tar, which can be used to "shelve" a changelist by packaging it on the client rather than by checking it into the depot.

Usage

Usage: p4_shelve [options]

Shelves a changelist for later editing.

Shelving a changelist will create a branch of the files in the
current changelist and move all the changes to that branch. It
will then revert the files in the current changelist while preserving
any changes in the branch.

Use 'p4_unshelve' to restore a shelved changelist.

Options:
  -h, --help         Prints this help message
  -v, --verbose      Prints verbose messages while shelving
  -p, --port         Perforce Port depot is on
  -c, --client       Perforce Client that maps the depot files
  -u, --user         Perforce User that owns the client
  -P, --password     Perforce Password for the user
  -e, --changelist   Perforce Change List ID to shelve
  -s, --shelfroot    Depot path where the shelved files should go. 

Note: Uses the default P4 settings for Perforce options not supplied.

Usage: p4_unshelve [options] <shelve branchspec>

Restores a shelved changelist into the default changelist for editing. 

  <shelve branchspec>  Perforce branchspec created by p4_shelve.

Options:
  -h, --help         Prints this help message
  -p, --port         Perforce Port depot is on
  -c, --client       Perforce Client that maps the depot files
  -u, --user         Perforce User that owns the client
  -P, --password     Perforce Password for the user

Note: Uses the default P4 settings for Perforce options not supplied.

License

#   Copyright 2005, Chris Stoy.  All Rights Reserved.
#
#   License:
#   This file and any derivatives or translations of it may be freely
#   copied and redistributed so long as:
#       1) This license and copyright notice are not changed.
#       2) Any fixes or enhancements are reported back to either the
#           author (cstoy@nc.rr.com).
#   and any of:
#       a) The source is redistributed with it.
#       b) The source is compiled unmodified, and instructions for finding
#           the original source are included.
#       c) The source is made available by some other means.

Recent Changes

• Change 5228 on 2005/12/06 by chris_stoy@chris_stoy_client
  - Fixed bug where the integration for the branch was using the latest revision instead of the revision of the file being edited in the workspace. This could cause problems if reintegrating back into the mainline after the files have been modified (which is likely.) Fix was to specify the client in the file spec for the integrate command.
  
• Change 5213 on 2005/11/26 by chris_stoy@chris_stoy_client
  finished the readme.txt file
  
• Change 5209 on 2005/11/22 by chris_stoy@chris_stoy_client
  - updated default depot for shelves to //depot/shelves
  - added first readme file
  
• Change 5208 on 2005/11/22 by chris_stoy@chris_stoy_client
  First version of these files. Provides the shelve, unshelve, and setup script for making stand-alone Exes.
  Requires P4Python to run.
  

Variants