pyinfra.api.inventory module

class pyinfra.api.inventory.Inventory(names_data, override_data=None, ssh_user=None, ssh_port=None, ssh_key=None, ssh_key_password=None, ssh_password=None, winrm_username=None, winrm_password=None, winrm_port=None, winrm_transport=None, **groups)

Bases: object

Represents a collection of target hosts. Stores and provides access to group data, host data and default data for these hosts.

Parameters

• names_data – tuple of (names, data)
• override_data – dictionary of data overrides
• ssh_* – deprecated, use override_data.ssh_*
• winrm_* – deprecated, use override_data.winrm_*
• **groups – map of group name -> (names, data)

get_data()

Get the base/all data attached to this inventory.

get_deploy_data()

Gets any default data attached to the current deploy, if any.

get_group(name, default=<class 'pyinfra.api.exceptions.NoGroupError'>)

Get a list of hosts belonging to a group.

get_group_data(group)

Get data for a single group in this inventory.

get_groups_data(groups)

Gets aggregated data from a list of groups. Vars are collected in order so, for any groups which define the same var twice, the last group’s value will hold.

get_host(name, default=<class 'pyinfra.api.exceptions.NoHostError'>)

Get a single host by name.

get_host_data(hostname)

Get data for a single host in this inventory.

get_override_data()

Get override data for this inventory.

iter_activated_hosts()

Iterates over activated inventory hosts.

iter_active_hosts()

Iterates over active inventory hosts.

iter_all_hosts()

len_activated_hosts()

Returns the number of activated inventory hosts.

len_active_hosts()

Returns the number of active inventory hosts.

len_all_hosts()

make_hosts_and_groups(names, groups)

state = None

pyinfra.api.inventory.extract_name_data(names)