patcherctl 3.0.0

Fetch patch management data from Jamf Pro to generate comprehensive reports in both Excel and PDF formats

Find us in the #patcher channel in the MacAdmins Slack

---

A python library and CLI for turning patch reports into something other than a spreadsheet you'll never open again. Read the full project documentation on our project homepage.

_{An exported PDF report for "AnyOrg". See Customization in the project docs for more.}

Installation

$ python3 -m pip install --upgrade patcherctl

Usage

Full library and CLI references plus assembled recipes live in the Guides section of the docs. The two quick examples below cover the common case of fetching Jamf's patch-management view and exporting reports.

Library

import asyncio
from patcher import PatcherClient

async def main():
    async with PatcherClient(
        client_id="...",
        client_secret="...",
        server="https://yourorg.jamfcloud.com",
    ) as patcher:
        titles = await patcher.fetch_patches()
        await patcher.export(titles, output_dir="./reports", formats={"pdf"})

asyncio.run(main())

CLI

$ patcherctl --client-id="..." --client-secret="..." --url="https://yourorg.jamfcloud.com" export --path="./reports" --format=pdf

Patcher API

Patcher's API is a community catalog of macOS app patching metadata stitched from Installomator, Homebrew Cask, AutoPkg (and more) into a single queryable surface.

Read endpoints are public, there is no authentication required. See project docs for curl and PatcherClient examples.

Contributing

Contributions to Patcher are welcome! We have set up templates for submitting issues, feature requests, and feedback. Please be sure to utilize these templates when contributing to the project.