Fetch patch management data from Jamf Pro to generate comprehensive reports in both Excel and PDF formats
Project description
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.
Features
- Fetches patch management data from a specified Jamf Pro instance.
- Generates reports in Excel format for detailed analysis.
- Creates PDF reports for easy sharing and presentation.
- Customizable report headers and footers through a simple configuration.
Sample PDF
The following image can be found in the images
directory.
Getting Started
Prerequisites
[!IMPORTANT] Patcher requires an API client for authentication. For instructions on creating an API Role & Client in Jamf Pro, refer to the Jamf Pro Deployment Guide in the wiki.
- Python 3.10+ (with pip).
- Git installed (via Homebrew or Developer Tools)
- Access to a Jamf Pro instance with administrator privileges (for API client creation).
- A Jamf Pro API Client with the following:
- Read Patch Management Software Titles, Read Patch Policies, Read Mobile Devices, Read Mobile Device Inventory Collection, Read Mobile Device Applications, Read API Integrations, Read API Roles, and Read Patch Management Settings
- Client ID
- Client Secret
Installation
[!NOTE] Patcher can now be conveniently installed via
pip
. 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.
[!TIP] About the package name: The pip package is called
patcherctl
because the namepatcher
was already taken on PyPI. Despite this, the project itself is referred to as Patcher.
Run the Installer
pip install patcherctl
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]
- The
--path
option specifies the directory where the reports will be saved. - The optional
--pdf
flag indicates if PDF reports should be generated in addition to Excel files.
For additional command options to use, visit the Command Options in the Wiki.
Upcoming Features
We are developing functionality to have Patcher automatically create the necessary API Client and API Roles to simplify the prerequisites needed before use. Any assistance and contributions in this area would be greatly welcomed!
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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for patcherctl-1.3.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | dcf402e38f37d29bc8e98192f26fff733ef2f103a15b4bde7bd3f3e67fba9a88 |
|
MD5 | 82006c825db65fdff79b872055df68da |
|
BLAKE2b-256 | 76c7ee6e448a661c5e19a59ce149297a69e84c6dc5664d050096a68d09ba2b23 |