/Patcher

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

Primary LanguagePythonApache License 2.0Apache-2.0

Patcher

Patch reporting simplified

    

Patcher leverages the Jamf Pro API to fetch patch management data and generate comprehensive reports in both Excel and PDF formats. It simplifies tracking and reporting on software update compliance across macOS devices managed through Jamf Pro.

Documentation

Project documentation can now be found on our project homepage. All content from our project wiki has been migrated to the new homepage. We are continuously updating references to the new homepage and regularly improving the documentation.

Sample PDF

Assuming 'AnyOrg' is the name of your organization, an exported PDF could look like this:

Installation

Install via pip:

pip install patcherctl

Note

Please note that while Patcher is installed as a package, it is meant to be used as a command line tool and not as an imported library.

Why patcherctl? The pip package is called patcherctl because the name patcher was already taken on PyPI. Despite this, the project itself is referred to as Patcher

Usage

After installation, you can generate reports by running the main script. You can specify the output directory for the reports and choose to generate PDF reports alongside Excel files.

patcherctl --path '/path/to/output/directory' [--pdf]

For a list of all available command options, visit the usage page of our documentation.

Authors & Contributions

Patcher is co-authored by Andrew Speciale - @liquidz00 and Chris Ball - @ball42. 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.