Patch Title#

class PatchTitle(*, title: str, title_id: str, released: str, hosts_patched: int, missing_patch: int, latest_version: str, completion_percent: float = 0.0, total_hosts: int = 0, install_label: List[Label] | None = [])[source]#

Represents patch software title information retrieved via API calls.

Variables:
  • title – The name of the patch title.

  • title_id – The softwareTitleId of the patch title from Jamf API response.

  • released – The release date of the patch title.

  • hosts_patched – The number of hosts that have applied the patch.

  • missing_patch – The number of hosts missing the patch.

  • latest_version – The latest version available for the software title.

  • completion_percent – The percentage of hosts that have applied the patch.

  • total_hosts – The total number of hosts.

  • install_label – The corresponding Installomator label(s) if available.

Parameters:
  • title (str)

  • title_id (str)

  • released (str)

  • hosts_patched (int)

  • missing_patch (int)

  • latest_version (str)

  • completion_percent (float)

  • total_hosts (int)

  • install_label (List[Label] | None)

validator cast_as_string  »  title_id[source]#

Ensures the title_id property is always a string, regardless of type in API response payload.

Parameters:

value (Union [int | str]) – The value of the title_id field.

Returns:

The value cast as a string.

Return type:

str

validator calculate_completion_percent  »  all fields[source]#

Calculates the completion percentage and total hosts of a PatchTitle object based on hosts patched and missing patch.

See get_summaries()