ultraiso

UltraISO wrapper.

exception deltona.ultraiso.InvalidExec

Bases: Exception

Raised when the UltraISO executable does not contain the expected font string.

deltona.ultraiso.patch_ultraiso_font(exe: PathLike[str], font_name: str = 'Noto Sans') → None

Patch the default font in the UltraISO executable.

Replaces MS Sans Serif with the specified font name. A backup of the original file is created with a .exebak extension.

Parameters:
exe : os.PathLike[str]

Path to the UltraISO executable.

font_name : str

Replacement font name. Maximum 13 characters.

Raises:
deltona.ultraiso.run_ultraiso(*, add_dirs: Iterable[StrPathMustExist] | None = None, add_files: Iterable[StrPathMustExist] | None = None, cmd: StrPathMustExist | None = None, input: StrPathMustExist | None = None, output: StrPath | None = None, appid: str | None = None, preparer: str | None = None, publisher: str | None = None, sysid: str | None = None, volset: int | None = None, volume: str | None = None, ilong: bool = False, imax: bool = False, lowercase: bool = False, vernum: bool = False, hfs: bool = False, jlong: bool = False, joliet: bool = False, rockridge: bool = False, udf: bool = False, udfdvd: bool = False, bootfile: StrPathMustExist | None = None, bootinfotable: bool = False, optimize: bool = False, chdir: str | None = None, newdir: str | None = None, rmdir: str | None = None, ahide: str | None = None, hide: str | None = None, pn: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | None = None, bin2iso: StrPathMustExist | None = None, dmg2iso: StrPathMustExist | None = None, bin2isz: StrPathMustExist | None = None, compress: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | None = None, encrypt: 1 | 2 | 3 | None = None, password: str | None = None, split: int | None = None, extract: StrPath | None = None, get: str | None = None, list_: StrPath | None = None, prefix: StrPathMustExist = PosixPath('/home/docs/.local/share/wineprefixes/ultraiso')) → None

Run UltraISO in a convenient way.

Despite always passing -silent to the application, windows including ones requiring interaction may still appear.

On non-Windows, for any option taking a file path, only pass UNIX file paths. They will be converted as needed.

Parameters:
input : StrPathMustExist | None

Input image.

output : StrPath | None

Output image.

add_dirs : Iterable[StrPath] | None

Directories to add.

add_files : Iterable[StrPath] | None

Files to add.

cmd : StrPathMustExist | None

File to read command line arguments from. If this argument is present and not None, all other arguments are ignored.

appid : str | None

Application ID.

preparer : str | None

Preparer name.

publisher : str | None

Publisher name.

sysid : str | None

System ID.

volset : int | None

Volume set ID.

volume : str | None

Volume label.

ilong : bool

Long filename for ISO 9660 volume, up to 31 characters.

imax : bool

Max filename for ISO 9660 volume, up to 207 characters.

lowercase : bool

Allow lowercase letters.

vernum : bool

Include file version number.

hfs : bool

Create Apple HFS volume.

jlong : bool

Long filenames for joliet volume, up to 103 characters.

joliet : bool

Create a Joliet volume.

rockridge : bool

Create RockRidge volume.

udf : bool

Create UDF volume.

udfdvd : bool

Create UDF DVD image (this option will overwrite all other volume settings).

bootfile : StrPathMustExist | None

Boot file.

bootinfotable : bool

Generate boot information table in boot file.

optimize : bool

Optimise file systems by coding same files only once.

chdir : str | None

Change current directory in ISO image.

newdir : str | None

Create a new directory.

rmdir : str | None

Remove a file or folder from ISO image (full path should be specified).

ahide : str | None

Set advanced hidden attribute of a file or folder (full path should be specified).

hide : str | None

Set hidden attribute of a file or folder (full path should be specified).

pn : Literal[1, 2, 3, 4, 5, 6, 7, 8, 9] | None

Set priority of a file or folder (full path should be specified).

bin2iso : StrPathMustExist | None

Convert input CD/DVD image to ISO format.

dmg2iso : StrPathMustExist | None

Convert input DMG image to ISO format.

bin2isz : StrPathMustExist | None

Convert image to ISZ.

compress : Literal[1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16] | None

Set compression level.

encrypt : Literal[1, 2, 3] | None

Set encryption method.

password : str | None

Set password.

split : int | None

Set segment size in bytes.

extract : StrPath | None

Extract ISO image to specified directory.

get : str | None

Set a file or directory (full path) to be extracted.

list_ : StrPath | None

Create a list of files and directories in an ISO image.

prefix : StrPathMustExist

Wine prefix path.

Raises:

  • InsufficientArguments – If not enough arguments are passed.

  • FileNotFoundError – If the UltraISO executable cannot be found.