RegisterFile

class RegisterFile(data=<cfinterface.data.registerdata.RegisterData object>)

Class that models a file divided by registers, where the reading and writing are given by a series of registers.

property data: RegisterData

Exposes the RegisterData object, which gives access to the methods:

• preppend()

• append()

• add_before()

• add_after()

• get_blocks_of_type()

Returns:

The data internal object

Return type:

RegisterData

classmethod read(content: str | bytes, *args, **kwargs)

Reads the registerfile data from a given file in disk.

Parameters:

content (str | bytes) – The file name in disk or the file contents themselves

classmethod set_version(v: str)

Sets the file’s version to be read. Different file versions may contain different registers. The version to be set is considered is forced to the latest version with a new register set available.

If a RegisterFile has VERSIONS with keys {“v0”: …, “v1”: …}, calling set_version("v2") will set the version to v1.

Parameters:

v (str) – The file version to be read.

write(to: str | IO, *args, **kwargs)

Write the registerfile data to a given file or buffer.

Parameters:

to (str | IO) – The writing destination, being a string for writing to a file or the IO buffer