+
+ SysprepParam = namedtuple('SysprepParam',
+ ['type', 'default', 'description', 'validate'])
+
+ def __init__(self, image, **kargs):
+ self.image = image
+
+ self.root = image.root
+ self.out = image.out
+
+ self.needed_sysprep_params = {}
+ self.sysprep_params = \
+ kargs['sysprep_params'] if 'sysprep_params' in kargs else {}
+
+ self.meta = {}
+ self.mounted = False
+
+ # Many guestfs compilations don't support scrub
+ self._scrub_support = True
+ try:
+ self.image.g.available(['scrub'])
+ except RuntimeError:
+ self._scrub_support = False
+
+ def inspect(self):
+ """Inspect the media to if it is supported"""
+
+ if self.image.is_unsupported():
+ return
+
+ self.out.output('Running OS inspection:')
+ try:
+ if not self.mount(readonly=True):
+ raise FatalError("Unable to mount the media read-only")
+ self._do_inspect()
+ finally:
+ self.umount()
+
+ self.out.output()
+
+ def collect_metadata(self):
+ """Collect metadata about the OS"""
+ try:
+ if not self.mount(readonly=True):
+ raise FatalError("Unable to mount the media read-only")
+
+ self.out.output('Collecting image metadata ...', False)
+ self._do_collect_metadata()
+ self.out.success('done')
+ finally:
+ self.umount()
+
+ self.out.output()
+
+ def list_syspreps(self):
+ """Returns a list of sysprep objects"""
+ objs = [getattr(self, name) for name in dir(self)
+ if not name.startswith('_')]
+
+ return [x for x in objs if self._is_sysprep(x) and x.executed is False]
+
+ def sysprep_info(self, obj):
+ """Returns information about a sysprep object"""
+ assert self._is_sysprep(obj), "Object is not a sysprep"
+
+ SysprepInfo = namedtuple("SysprepInfo", "name description")
+
+ return SysprepInfo(obj.__name__.replace('_', '-'),
+ textwrap.dedent(obj.__doc__))
+
+ def get_sysprep_by_name(self, name):
+ """Returns the sysprep object with the given name"""
+ error_msg = "Syprep operation %s does not exist for %s" % \
+ (name, self.__class__.__name__)
+
+ method_name = name.replace('-', '_')
+ method = None
+ try:
+ method = getattr(self, method_name)
+ except AttributeError:
+ raise FatalError(error_msg)
+
+ if not self._is_sysprep(method):
+ raise FatalError(error_msg)
+
+ return method
+
+ def enable_sysprep(self, obj):
+ """Enable a system preparation operation"""
+ setattr(obj.im_func, 'enabled', True)
+
+ def disable_sysprep(self, obj):
+ """Disable a system preparation operation"""
+ setattr(obj.im_func, 'enabled', False)
+
+ def print_syspreps(self):
+ """Print enabled and disabled system preparation operations."""
+
+ syspreps = self.list_syspreps()
+ enabled = [sysprep for sysprep in syspreps if sysprep.enabled]
+ disabled = [sysprep for sysprep in syspreps if not sysprep.enabled]
+
+ wrapper = textwrap.TextWrapper()
+ wrapper.subsequent_indent = '\t'
+ wrapper.initial_indent = '\t'
+ wrapper.width = 72
+
+ self.out.output("Enabled system preparation operations:")
+ if len(enabled) == 0:
+ self.out.output("(none)")
+ else:
+ for sysprep in enabled:
+ name = sysprep.__name__.replace('_', '-')
+ descr = wrapper.fill(textwrap.dedent(sysprep.__doc__))
+ self.out.output(' %s:\n%s\n' % (name, descr))
+
+ self.out.output("Disabled system preparation operations:")
+ if len(disabled) == 0:
+ self.out.output("(none)")
+ else:
+ for sysprep in disabled:
+ name = sysprep.__name__.replace('_', '-')
+ descr = wrapper.fill(textwrap.dedent(sysprep.__doc__))
+ self.out.output(' %s:\n%s\n' % (name, descr))
+
+ def print_sysprep_params(self):
+ """Print the system preparation parameter the user may use"""
+
+ self.out.output("Needed system preparation parameters:")
+
+ if len(self.needed_sysprep_params) == 0:
+ self.out.output("(none)")
+ return
+
+ for name, param in self.needed_sysprep_params.items():
+ self.out.output("\t%s (%s): %s" %
+ (param.description, name,
+ self.sysprep_params[name] if name in
+ self.sysprep_params else "(none)"))
+
+ def do_sysprep(self):
+ """Prepare system for image creation."""
+
+ self.out.output('Preparing system for image creation:')
+
+ if self.image.is_unsupported():
+ self.out.warn(
+ "System preparation is disabled for unsupported media")
+ return
+
+ try:
+ if not self.mount(readonly=False):
+ raise FatalError("Unable to mount the media read-write")
+
+ enabled = [task for task in self.list_syspreps() if task.enabled]
+
+ size = len(enabled)
+ cnt = 0
+ for task in enabled:
+ cnt += 1
+ self.out.output(('(%d/%d)' % (cnt, size)).ljust(7), False)
+ task()
+ setattr(task.im_func, 'executed', True)
+ finally:
+ self.umount()
+
+ self.out.output()
+
+ def mount(self, readonly=False):
+ """Mount image."""
+
+ if getattr(self, "mounted", False):
+ return True
+
+ mount_type = 'read-only' if readonly else 'read-write'
+ self.out.output("Mounting the media %s ..." % mount_type, False)
+
+ if not self._do_mount(readonly):
+ return False
+
+ self.mounted = True
+ self.out.success('done')
+ return True
+
+ def umount(self):
+ """Umount all mounted filesystems."""
+
+ self.out.output("Umounting the media ...", False)
+ self.image.g.umount_all()
+ self.mounted = False
+ self.out.success('done')
+
+ def _is_sysprep(self, obj):
+ """Checks if an object is a sysprep"""
+ return getattr(obj, 'sysprep', False) and callable(obj)