xcp.net.ifrename.dynamic

Object for manipulating dynamic rules.

The dynamic rules file on disk is a JSON file with optional line comments beginning with a # character.

class xcp.net.ifrename.dynamic.DynamicRules(path=None, fd=None)

Bases: object

Object for parsing the dynamic rules configuration.

There are two distinct usecases; the installer needs to write the dynamic rules from scratch, whereas interface-rename.py in dom0 needs to read and write them.

generate(state)

Make rules from the formulae based on global state.

load_and_parse()

Parse the dynamic rules file. Returns boolean indicating success or failure.

save(header=True)

Save the dynamic rules to a file/path. Returns boolean indicating success or failure.

write(header=True)

Write the dynamic rules to a string