quay/formats/tarimageformatter.py

import tarfile
from util.registry.gzipwrap import GzipWrap

class TarImageFormatter(object):
  """ Base class for classes which produce a TAR containing image and layer data. """

  def build_stream(self, namespace, repository, tag, synthetic_image_id, layer_json,
                   get_image_iterator, get_layer_iterator):
    """ Builds and streams a synthetic .tar.gz that represents the formatted TAR created by this
        class's implementation.
    """
    return GzipWrap(self.stream_generator(namespace, repository, tag,
                                             synthetic_image_id, layer_json,
                                             get_image_iterator, get_layer_iterator))

  def stream_generator(self, namespace, repository, tag, synthetic_image_id,
                       layer_json, get_image_iterator, get_layer_iterator):
    raise NotImplementedError

  def tar_file(self, name, contents):
    """ Returns the TAR binary representation for a file with the given name and file contents. """
    length = len(contents)
    tar_data = self.tar_file_header(name, length)
    tar_data += contents
    tar_data += self.tar_file_padding(length)
    return tar_data

  def tar_file_padding(self, length):
    """ Returns TAR file padding for file data of the given length. """
    if length % 512 != 0:
      return '\0' * (512 - (length % 512))

    return ''

  def tar_file_header(self, name, file_size):
    """ Returns TAR file header data for a file with the given name and size. """
    info = tarfile.TarInfo(name=name)
    info.type = tarfile.REGTYPE
    info.size = file_size
    return info.tobuf()

  def tar_folder(self, name):
    """ Returns TAR file header data for a folder with the given name. """
    info = tarfile.TarInfo(name=name)
    info.type = tarfile.DIRTYPE
    # allow the directory to be readable by non-root users
    info.mode = 0755
    return info.tobuf()