def __init__(self,
board,
device='',
dryrun=False,
interactive=True,
enable_colors=True):
"""
:param board: :class:`Board` instance.
:param device: Device name (i.e. '/dev/sdb').
:param dryrun: Enable dryrun mode. Systems commands will be logged,
but not executed.
:type dryrun: boolean
:param interactive: Enable interactive mode. The user will
be prompted before executing dangerous commands.
:type interactive: boolean
"""
self._l = utils.logger.get_global_logger()
self._e = utils.executer.get_global_executer()
self._e.enable_colors = enable_colors
self._board = board
self._sd = SDCard(device)
self._dryrun = dryrun
self._e.dryrun = dryrun
self._sd.dryrun = dryrun
self._board.dryrun = dryrun
self._interactive = interactive
self._partitions = []
self._loopdevice_partitions = {}
def __init__(self, board, device='', dryrun=False,
interactive=True, enable_colors=True):
"""
:param board: :class:`Board` instance.
:param device: Device name (i.e. '/dev/sdb').
:param dryrun: Enable dryrun mode. Systems commands will be logged,
but not executed.
:type dryrun: boolean
:param interactive: Enable interactive mode. The user will
be prompted before executing dangerous commands.
:type interactive: boolean
"""
self._l = utils.logger.get_global_logger()
self._e = utils.executer.get_global_executer()
self._e.enable_colors = enable_colors
self._board = board
self._sd = SDCard(device)
self._dryrun = dryrun
self._e.dryrun = dryrun
self._sd.dryrun = dryrun
self._board.dryrun = dryrun
self._interactive = interactive
self._partitions = []
self._loopdevice_partitions = {}
def __set_device(self, device):
self._sd = SDCard(device)
self._sd.dryrun = self._dryrun
class SDCardInstaller(object):
"""
Class to handle SD-card operations to support the installer.
Typical flow:
::
1. read_partitions()
2. format()
3. mount_partitions()
4. install_components()
5. release()
"""
def __init__(self, board, device='', dryrun=False,
interactive=True, enable_colors=True):
"""
:param board: :class:`Board` instance.
:param device: Device name (i.e. '/dev/sdb').
:param dryrun: Enable dryrun mode. Systems commands will be logged,
but not executed.
:type dryrun: boolean
:param interactive: Enable interactive mode. The user will
be prompted before executing dangerous commands.
:type interactive: boolean
"""
self._l = utils.logger.get_global_logger()
self._e = utils.executer.get_global_executer()
self._e.enable_colors = enable_colors
self._board = board
self._sd = SDCard(device)
self._dryrun = dryrun
self._e.dryrun = dryrun
self._sd.dryrun = dryrun
self._board.dryrun = dryrun
self._interactive = interactive
self._partitions = []
self._loopdevice_partitions = {}
def __set_device(self, device):
self._sd = SDCard(device)
self._sd.dryrun = self._dryrun
def __get_device(self):
return self._sd.name
device = property(__get_device, __set_device,
doc="""Device name (i.e. '/dev/sdb').""")
def __set_dryrun(self, dryrun):
self._dryrun = dryrun
self._board.dryrun = dryrun
self._e.dryrun = dryrun
self._sd.dryrun = dryrun
def __get_dryrun(self):
return self._dryrun
dryrun = property(__get_dryrun, __set_dryrun,
doc="""Enable dryrun mode. Systems commands will be
logged, but not executed.""")
def __set_interactive(self, interactive):
self._interactive = interactive
def __get_interactive(self):
return self._interactive
interactive = property(__get_interactive, __set_interactive,
doc="""Enable interactive mode. The user will
be prompted before executing dangerous commands.""")
def __set_enable_colors(self, enable):
self._e.enable_colors = enable
def __get_enable_colors(self):
return self._e.enable_colors
enable_colors = property(__get_enable_colors, __set_enable_colors,
doc="""Enable colored messages.""")
def mount_partitions(self, directory):
"""
Mounts the partitions in the specified directory.
:exception DeviceException: When unable to mount.
"""
self._sd.mount(directory)
def _format_checks(self):
if self._sd.exists is False:
raise SDCardInstallerError('No disk on %s' % self._sd.name)
if self._sd.is_mounted:
if self._interactive:
ret = self._sd.confirmed_unmount()
if ret is False:
raise SDCardInstallerError('User canceled')
else:
self._sd.unmount()
if self._sd.size_cyl == 0:
raise SDCardInstallerError('%s size is 0' % self._sd.name)
if self._sd.size_cyl < self._sd.min_cyl_size():
raise SDCardInstallerError('Size of partitions is too large to '
'fit in %s' % self._sd.name)
def _format_confirms(self):
if self._sd.confirm_size_gb(WARN_DEVICE_SIZE_GB) is False:
raise SDCardInstallerError('User canceled')
msg = ('You are about to repartition %s (all your data will be lost)'
% self._sd.name)
confirmed = self._e.prompt_user(msg, WARN_COLOR)
if not confirmed:
raise SDCardInstallerError('User canceled')
def format(self):
"""
Creates and formats the partitions in the SD card.
:returns: Returns true on success; false otherwise.
:exception DeviceException: On failure formatting the device.
:exception SDCardInstallerError: On failure executing this action.
"""
if not self.dryrun:
self._format_checks()
if self._interactive:
self._format_confirms()
self._l.info('Formatting %s (this may take a while)' % self._sd.name)
self._sd.wipe_bootloader_env()
self._sd.create_partitions()
self._sd.format_partitions()
def release(self):
"""
Unmounts all partitions and release the given device.
:exception DeviceException: On failure releasing the device.
"""
self._sd.unmount()
self._sd.optimize_filesystems()
self._sd.check_filesystems()
def read_partitions(self, filename):
"""
Reads the partitions information from the given file.
:param filename: Path to the file with the partitions information.
:returns: Returns true on success; false otherwise.
"""
self._sd.read_partitions(filename)
def install_components(self):
"""
Installs the specified components for each partition.
:exception SDCardInstallerError: On failure installing the components.
"""
try:
self._board.sd_install_components(self._sd)
except BoardError as e:
raise SDCardInstallerError(e)
def __set_device(self, device):
self._sd = SDCard(device)
self._sd.dryrun = self._dryrun
class SDCardInstaller(object):
"""
Class to handle SD-card operations to support the installer.
Typical flow:
::
1. read_partitions()
2. format()
3. mount_partitions()
4. install_components()
5. release()
"""
def __init__(self,
board,
device='',
dryrun=False,
interactive=True,
enable_colors=True):
"""
:param board: :class:`Board` instance.
:param device: Device name (i.e. '/dev/sdb').
:param dryrun: Enable dryrun mode. Systems commands will be logged,
but not executed.
:type dryrun: boolean
:param interactive: Enable interactive mode. The user will
be prompted before executing dangerous commands.
:type interactive: boolean
"""
self._l = utils.logger.get_global_logger()
self._e = utils.executer.get_global_executer()
self._e.enable_colors = enable_colors
self._board = board
self._sd = SDCard(device)
self._dryrun = dryrun
self._e.dryrun = dryrun
self._sd.dryrun = dryrun
self._board.dryrun = dryrun
self._interactive = interactive
self._partitions = []
self._loopdevice_partitions = {}
def __set_device(self, device):
self._sd = SDCard(device)
self._sd.dryrun = self._dryrun
def __get_device(self):
return self._sd.name
device = property(__get_device,
__set_device,
doc="""Device name (i.e. '/dev/sdb').""")
def __set_dryrun(self, dryrun):
self._dryrun = dryrun
self._board.dryrun = dryrun
self._e.dryrun = dryrun
self._sd.dryrun = dryrun
def __get_dryrun(self):
return self._dryrun
dryrun = property(__get_dryrun,
__set_dryrun,
doc="""Enable dryrun mode. Systems commands will be
logged, but not executed.""")
def __set_interactive(self, interactive):
self._interactive = interactive
def __get_interactive(self):
return self._interactive
interactive = property(__get_interactive,
__set_interactive,
doc="""Enable interactive mode. The user will
be prompted before executing dangerous commands.""")
def __set_enable_colors(self, enable):
self._e.enable_colors = enable
def __get_enable_colors(self):
return self._e.enable_colors
enable_colors = property(__get_enable_colors,
__set_enable_colors,
doc="""Enable colored messages.""")
def mount_partitions(self, directory):
"""
Mounts the partitions in the specified directory.
:exception DeviceException: When unable to mount.
"""
self._sd.mount(directory)
def _format_checks(self):
if self._sd.exists is False:
raise SDCardInstallerError('No disk on %s' % self._sd.name)
if self._sd.is_mounted:
if self._interactive:
ret = self._sd.confirmed_unmount()
if ret is False:
raise SDCardInstallerError('User canceled')
else:
self._sd.unmount()
if self._sd.size_cyl == 0:
raise SDCardInstallerError('%s size is 0' % self._sd.name)
if self._sd.size_cyl < self._sd.min_cyl_size():
raise SDCardInstallerError('Size of partitions is too large to '
'fit in %s' % self._sd.name)
def _format_confirms(self):
if self._sd.confirm_size_gb(WARN_DEVICE_SIZE_GB) is False:
raise SDCardInstallerError('User canceled')
msg = ('You are about to repartition %s (all your data will be lost)' %
self._sd.name)
confirmed = self._e.prompt_user(msg, WARN_COLOR)
if not confirmed:
raise SDCardInstallerError('User canceled')
def format(self):
"""
Creates and formats the partitions in the SD card.
:returns: Returns true on success; false otherwise.
:exception DeviceException: On failure formatting the device.
:exception SDCardInstallerError: On failure executing this action.
"""
if not self.dryrun:
self._format_checks()
if self._interactive:
self._format_confirms()
self._l.info('Formatting %s (this may take a while)' % self._sd.name)
self._sd.wipe_bootloader_env()
self._sd.create_partitions()
self._sd.format_partitions()
def release(self):
"""
Unmounts all partitions and release the given device.
:exception DeviceException: On failure releasing the device.
"""
self._sd.unmount()
self._sd.optimize_filesystems()
self._sd.check_filesystems()
def read_partitions(self, filename):
"""
Reads the partitions information from the given file.
:param filename: Path to the file with the partitions information.
:returns: Returns true on success; false otherwise.
"""
self._sd.read_partitions(filename)
def install_components(self):
"""
Installs the specified components for each partition.
:exception SDCardInstallerError: On failure installing the components.
"""
try:
self._board.sd_install_components(self._sd)
except BoardError as e:
raise SDCardInstallerError(e)
