Module refinery.units.formats.archive.xtdmg

Expand source code Browse git 
from __future__ import annotations


from refinery.lib.dmg.arc import DiskImage, is_dmg
from refinery.units.formats.archive import ArchiveUnit


class xtdmg(ArchiveUnit, docs='{0}{s}{PathExtractorUnit}'):
    """
    Extract files from an Apple Disk Image (DMG) files with an HFS+ file system.
    """
    def unpack(self, data: bytearray):
        dmg = DiskImage(data)
        for result in dmg.files():
            for w in result.warnings:
                self.log_warn(w)
            if result.partition:
                continue
            yield self._pack(result.path, result.date, result.data)

    @classmethod
    def handles(cls, data) -> bool | None:
        return is_dmg(data)

Classes

class xtdmg (*paths, list=False, join_path=False, drop_path=False, fuzzy=0, exact=False, regex=False, path=b'path', date=b'date', pwd=b'')

Extract files from an Apple Disk Image (DMG) files with an HFS+ file system. This unit is a path extractor which extracts data from a hierarchical structure. Each extracted item is emitted as a separate chunk and has attached to it a meta variable that contains its path within the source structure. The positional arguments to the command are patterns that can be used to filter the extracted items by their path. To view only the paths of all chunks, use the listing switch:

emit something | xtdmg --list

Otherwise, extracted items are written to the standard output port and usually require a frame to properly process. In order to dump all extracted data to disk, the following pipeline can be used:

emit something | xtdmg [| d2p ]

If you using xtdmg to unpack a file on disk, the following pattern can be useful:

ef pack.foo [| xtdmg -j | d2p ]

The unit ef is also a path extractor. By specifying -j (or --join), the paths of extracted items are combined. The d2p unit will deconflict these with the local file system. For example, if pack.foo contains items one.txt and two.txt, the following local file tree would be the result:

pack.foo
pack/one.txt
pack/two.txt

Finally, the -d (or --drop) switch can be used to not create (or alter) the path metadata at all, which is useful in cases where path metadata from a previous unit should be preserved.

Expand source code Browse git 
class xtdmg(ArchiveUnit, docs='{0}{s}{PathExtractorUnit}'):
    """
    Extract files from an Apple Disk Image (DMG) files with an HFS+ file system.
    """
    def unpack(self, data: bytearray):
        dmg = DiskImage(data)
        for result in dmg.files():
            for w in result.warnings:
                self.log_warn(w)
            if result.partition:
                continue
            yield self._pack(result.path, result.date, result.data)

    @classmethod
    def handles(cls, data) -> bool | None:
        return is_dmg(data)

Ancestors

Subclasses

Class variables

var reverse

The type of the None singleton.

Methods

def unpack(self, data)
Expand source code Browse git 
def unpack(self, data: bytearray):
    dmg = DiskImage(data)
    for result in dmg.files():
        for w in result.warnings:
            self.log_warn(w)
        if result.partition:
            continue
        yield self._pack(result.path, result.date, result.data)

Inherited members