text: # Copyright 2014 Eucalyptus Systems, Inc.
  #
  # Redistribution and use of this software in source and binary forms,
  # with or without modification, are permitted provided that the following
  # conditions are met:
  #
  #   Redistributions of source code must retain the above copyright notice,
  #   this list of conditions and the following disclaimer.
  #
  #   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 THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  # "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 THE COPYRIGHT
  # OWNER 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.
  
  from requestbuilder import Arg
  from requestbuilder.exceptions import ArgumentError
  
  from euca2ools.commands.s3 import S3Request
  
  
  class HeadObject(S3Request):
      DESCRIPTION = 'Retrieve info about an object from the server'
      ARGS = [Arg('path', metavar='BUCKET/KEY', route_to=None,
                  help='the object to retrieve info for (required)')]
      METHOD = 'HEAD'
  
      def configure(self):
          S3Request.configure(self)
  
          bucket, _, key = self.args['path'].partition('/')
          if not bucket:
              raise ArgumentError('path must contain a bucket name')
          if not key:
              raise ArgumentError('path must contain a key name')
  
      def preprocess(self):
          self.path = self.args['path']
  