Patcher 2.1.3

Patcher Release Notes

This release has been automatically generated by a GitHub Action.
For detailed installation instructions, please refer to the Docs or the README

Changelog for this release

This amended changelog is specific to this release. View the full changelog for all details.

Changed

• Warnings about skipped Installomator labels are logged instead of being shown directly to stdout

Fixed

• An issue causing the HTML template directory to not be included in built distribution

Changes

• d16331d - fix: ensure templates directory is included in build
• 607b47a - chore: bump version
• a066af5 - perf(installomator): log warnings about skipped labels instead of showing to stdout
• 48bdabb - chore(relese): v2.1.3

Contributors

Patcher 2.1.2

Patcher Release Notes

This release has been automatically generated by a GitHub Action.
For detailed installation instructions, please refer to the Docs or the README

Changelog for this release

This amended changelog is specific to this release. View the full changelog for all details.

Changed

• Problematic Installomator labels are now handled gracefully instead of raising exceptions (#28)
• PDF classes have been refactored to resolve FPDF Deprecation warnings around ln=True usage

Fixed

• An issue with HTML template path reference (#27)
• CLI entry point references the correct property list value for HTML report titles

Changes

• 7587fb8 - fix(datamanager): properly reference html template path (#27)
• 44afcac - chore: bump version
• 8c4b869 - perf(pdf): resolve fpdf deprecation warnings around ln=True usage
• 48ee2a1 - docs(label): remove classmethod decorators
• 5e365bf - perf(installomator): gracefully handle problematic labels (#28)
• 66df2b2 - chore(release): bump to v2.1.2

Contributors

Patcher 2.1.1

Patcher Release Notes

This release has been automatically generated by a GitHub Action.
For detailed installation instructions, please refer to the Docs or the README

Changelog for this release

This amended changelog is specific to this release. View the full changelog for all details.

Added

• Installomator support can be disabled should it not align with the security standards of your environment (Docs)

Changed

• Property list structure has been reformatted for simplicity and efficiency. (Docs)
• All property list methods refactored into own PropertyListManager class for separation of concerns

Fixed

• An issue with bold fonts not be adding properly, leading to unhandled FPDF exceptions
• 404 status responses are properly handled during app matching process instead of raising an APIResponseError (#26)
• Prevent inaccurate setup runs by checking property list migration before setup completion

Changes

• 02b6e16 - chore: Remove deprecated argument
• 6792949 - ci: merge version switcher changes from develop to main
• 39c625f - ci: Ensure runner copies docs into versioned directories as expected
• 5afee56 - ci: merge Makefile changes to ensure switcher.json is generated
• 3279bb7 - ci: copy switcher to directory
• 49260df - docs: fix branch or tag conditional statement
• df973d5 - docs: remove version switcher from built docs.
• 0e52d0a - chore(release): bump to v2.1.1
• f686f1b - fix(cli): retrieve proper key from plist for report title
• 032fe0f - chore(release): v2.1.1

Contributors

Patcher 2.1.0

Patcher Release Notes

This release has been automatically generated by a GitHub Action.
For detailed installation instructions, please refer to the Docs or the README

Changelog for this release

This amended changelog is specific to this release. View the full changelog for all details.

Added

• Export command defaults to exporting to all file formats (Excel, PDF, and HTML), with the --format option allowing for export of specific formats if desired
• Installomator matching. PatchTitle objects are matched with Installomator labels upon export
• Installomator FilterCriteria to show which labels are supported by Installomator

Changed

• Added hour and minute information to cached data timestamp, allowing for caching of multiple reports in same day

Fixed

• An issue where date_format was not being properly formatted as a datetime object in exported HTML reports
• OSError and PermissionError types are properly handled when trying to create directories
• app_names key returns a list of appName strings instead of first entry only
• An issue where ReportManager objects were not properly awaiting async functions

Changes

• 65a46c9 - chore: bump to 2.1.0
• 0e29cc8 - chore(merge): develop → main
• c996bdc - chore(changelog): Add v2.1.0 information
• 00f1c97 - docs: Remove redundant CLI reference page in favor of Usage docs

Contributors

Patcher 2.0.3

Patcher Release Notes

This release has been automatically generated by a GitHub Action.
For detailed installation instructions, please refer to the Docs or the README

Changelog for this release

This amended changelog is specific to this release. View the full changelog for all details.

Fixed

• Data sets are cached before dropping ignored columns so that analysis can complete as expected

Changes

• 190737d - fix: cache dataset before dropping columns to prevent validation errors

Contributors

Patcher 2.0.2

Patcher Release Notes

This release has been automatically generated by a GitHub Action.
For detailed installation instructions, please refer to the Docs or the README

Changelog for this release

This amended changelog is specific to this release. View the full changelog for all details.

Added

• Support for tracking softwareTitleId from Jamf API Response
• macOS badge to README.md

Changed

• Ignored columns are formatted properly before being dropped from export
• title_id attribute is set to "iOS" when calculating amount of devices on latest version

Fixed

• HTML template path references #25

Changes

• d344a3a - Format unicode characters properly.
• 6fc7aca - Add support for tracking softwareTitleId from API response.
• ab1a9d5 - Update unit tests and fixtures with title_id attribute.
• 955fadb - Properly mock property list during unit tests.
• 1872348 - Bump to v2.0.2
• 7239eaa - Fix HTML template path reference (#25); Moved ignored column dropping to export methods; Format warning log messages as expected.
• 9cb8144 - Set title_id attribute to 'iOS' when calculating amount of devices on latest version.
• 5c49077 - Ensures ignored columns are formatted correctly before attempting drop.
• b372e71 - Add macOS badge.
• 75450dc - Add CHANGELOG.md
• 0eb9ee6 - Update CHANGELOG.md for versions 2.0.1 and 2.0.2
• f9f76b3 - Add CHANGELOG.md link to Docs
• d6590b8 - chore(CHANGELOG): Fix formatting.
• bf9810b - ci(release-runner): Add step for parsing changelog for release notes.

Contributors

Patcher 2.0.1

This release has been automatically generated by a GitHub Action.

Installation Instructions

For detailed installation instructions, please refer to the Docs or the README

Release notes

• e2d9501 - Bump to 2.0.1
• 371a6c6 - Correct entry point.
• a460173 - Merge from develop; update animation messages at runtime.

Contributors

Patcher 2.0

This release has been automatically generated by a GitHub Action.

Installation Instructions

For detailed installation instructions, please refer to the Docs or the README

Release notes

• 200b51f - Bump to v2.0
• 3a12273 - Fix verbiage with InstallomatorErrors, refactor DatabaseError to DataframeError
• 27d0628 - Add mvp Analyzer class
• 9324ef7 - Fix f-string typo
• d39fd78 - Add mvp Installomator class
• ac62778 - Add mvp Label model, add optional label property to PatchTitle models
• c1d4592 - Exclude installomator label property in exported Excel file
• 236da9c - Formatting/linting
• 351764f - Add functionality to reset credentials
• 386fd30 - Pull recent changes from develop branch
• 4b17dce - Refactor exceptions, deprecate usage of asyncclick in exception classes
• edc0610 - Refactor logger into class, include exc_info on error logs
• 4efea95 - Remove redundant logging and error handling. Update class and method DocStrings.
• d26b714 - Add header reference for DocString
• 6b67d16 - Create temp file for property list mocking
• e0b933a - Fix SSO handling ref syntax
• 3b9a025 - Refactor first_run and launch methods into single private method. Update unit tests accordingly.
• 8e00bef - Fix class reference in DocString
• 46b0370 - Ignore E722
• 81a14fb - Move debug flag to root logger instead of child loggers, add UnifiedLogHandler class and format traceback functionality.
• 7ba7b9e - Update DocString
• 5c0695a - Resolve issue with tracebacks not being suppressed to stdout/stderr as expected
• e2f82dd - Refactor reset method to reset_setup, which resets Setup elements (property list file).
• 50bb08b - Add INFO, DEBUG, WARNING log level messages with consistent format.
• 17e1475 - Add varying log level statements where appropriate, format exceptions to follow consistent pattern.
• fa22bc4 - Remove debug parameter from LogMe class, refactor debug detection into property.
• 6e69808 - ✅
• b706db4 - ✅
• 7ef1ab0 - Explicitly set INFO levels to only show in console if debug is enabled at a child logger level.
• 16e95d1 - Add data analysis functionality to Analyzer class ensuring errors are handled appropriately.
• e39eb18 - Refactor into three separate commands; reset, export, and analyze.
• d0bcddf - Refactor into three separate commands; reset, export, and analyze.
• 2a71fbe - Update unit tests with proper error verbiage.
• f37535d - Add unit tests for Analyzer class.
• be99897 - Remove backslash from f-string in BaseAPIClient.
• 2b489f0 - Update README with new example_pdf.jpeg
• 6c9fb48 - Remove dropdown directive.
• 3e5a187 - Add meta variables for command options and arguments.
• e89bb59 - Update DocStrings and Project documentation to follow consistent formatting scheme.
• e1f680e - Revert to pydantic.Field; update DocString
• 6e08ff8 - Add page for Analyzer class; update CSS to ignore hover when using sd-table
• 2bc2a3b - Update DocStrings and data types.
• 8b29694 - Update docs based on recent implementations.
• 5a72cf2 - Propagate error logs to callers.
• 0eec982 - Deprecate headers property and AccessToken management.
• 2f2c266 - Refactor AccessToken object management to TokenManager class as single source of 'truth'.
• cb6b5ae - Fix typo.
• 36d1261 - Fix an issue with stale tokens being retrieved.
• 546138e - logging.DEBUG default level for RotatingFileHandler. Console handler only configured if debug is enabled.
• b046897 - Pass separate token object when saving client information.
• 081d0ab - Ensure API headers retrieve latest AccessToken from TokenManager.
• 6988f7e - Fix DocString formatting and short help strings.
• cc9f3ad - Update unit tests based on refactoring of classes.
• 61dce6e - Update DocString type hints.
• 08c4a90 - Deprecate requirement of passing ConfigManager, TokenManager and UIConfigManager instances.
• c1dfbee - Add API error exit code; format errors consistently
• 159edf4 - Update project docs with subcommands
• 25b04ef - Add LaunchAgent docs
• 138d1bc - Add .patcher-title class
• 0991999 - Add FAQ page to docs
• 2762a8f - Add optional admonition class
• d279e43 - Add troubleshooting docs
• d69ca3c - Add updated help page and instructions on confirming python is on PATH
• a2005e9 - Fix TokenManager class ref
• [2c2ebef](http://github.com/liquidz00/Patcher/commit/2c2ebeff9aaeeb6b2ba5dd0...

Patcher 1.4.2

Installation Instructions

For detailed installation instructions, please refer to the Docs or the [README (https://github.com/liquidz00/Patcher/blob/main/README.md)

Release notes

For this specific release, see the latest merged PR notes.

• v1.4.2 by @liquidz00 in #23

Additional Info

Testing for version 2.0 is close to being complete. Working on implementing a version switcher for our Docs page to see differences between versions. Stay tuned!

What's Changed

Full Changelog: v1.4.1...1.4.2

Patcher 1.4.1

This release has been automatically generated by a GitHub Action.

Installation Instructions

For detailed installation instructions, please refer to the Docs or the README

Release notes

• 3d2baef - bump download artifact action to v4
• c93e146 - Bump to 1.4.2 beta 1
• 2a688ed - Add BaseAPIClient class, move to async curl calls as potential workaround for SSL issues.
• 9a5d4b5 - Inherit from BaseAPIClient
• 79c9719 - Move max concurrency handling to BaseAPIClient
• 731d0c3 - Refactor AnyStr -> str
• 12498ba - Support GET and POST requests
• 6177ce8 - Linting and formatting
• 1c7ad7c - Fix async handling during init
• a738ffb - Remove redundant code, refactor with existing methods from TokenManager class
• 9266fd3 - Utilize BaseAPIClient class methods
• faaf954 - Narrow scope of Setup class, refactor out of scope methods to proper classes
• 52a39f4 - Create separate methods for sort options
• 3606b29 - Update dependencies
• 8fcaadb - Initialize child logger with at class level
• 57ba65e - Add exceptions for Database errors and Installomator errors, move to str data types instead of AnyStr
• f1191d4 - Refactor AnyStr -> str
• 5ef054c - Pass correct arguments to classes after refactor
• f8e6a01 - Formatting/linting
• da32553 - Add SSLContextManager class
• ef9d093 - Refactor unit tests based upon class changes
• 4a1a365 - 🧺
• d81ecad - Make SOFA feed call asynchronous
• e60f8fc - Remove SSLContextManager and associated imports
• abe3442 - Utilize ui_config.plist_path in favor of redundancy, change verbiage around token errors
• 688df5b - Formatting, remove dead code
• f4af485 - Remove unused fixtures
• c956e89 - Move example_pdf.jpeg to static docs directory
• 8e8640b - Add comment for sanity check
• 9036476 - Add asyncio options for pytest
• d1a773e - Rename to accurately reflect test
• a59c05a - Update unit tests based on recent refactoring of ApiClient and BaseAPIClient classes
• 35f5c75 - Formatting and linting, as always
• 24548c2 - Fix issue where plist file was not properly being mocked
• fae6e31 - Bump action versions
• 46d8dc0 - Bump to beta 2
• e27b0ba - Add Exceptions for API responses and non-zero exit stats
• c1dc6bb - Raise appropriate exceptions instead of returning None
• 40e8261 - Move setup API calls to BaseAPIClient, add HTTP Status to end of each API call to evaluate success
• 36574e3 - Use BaseAPIClient for setup calls
• cac47a7 - Update test with recent Setup class refactors
• f46f48c - Remove await from synchronous function
• 1d48fda - Fix unit tests based on API client refactors
• c012946 - Formatting
• 44ed620 - Add SetupError exception to raise instead of returning None
• 191925a - Fix call for setting concurrency level
• 664c3a9 - Raise exceptions instead of returning None, improve error messages
• 84e01cb - Raise exceptions instead of returning None, improve error messages
• b924cd7 - Remove APIPrivilegeError
• 44812b9 - Fix unit tests to anticipate Exception
• 1eac658 - Reparse response as JSON
• 583c006 - Reparse response as JSON
• 3965b0a - Add BaseAPIClient, create unit tests
• 8a17b9d - Linting/formatting
• b7bb4f6 - Create unit test for async cURL calls
• 9d1f711 - Change argument verbiage
• 7ecf610 - Refactor role and client creation workflow to use fetch_json method for HTTP error handling
• 5636926 - Move image to docs directory
• 3232417 - Change verbiage of welcome message
• 200d2a1 - Format headers properly, add flexibility to fetch_json method to properly handle attaching data to POST requests when URL encoded content type is detected.
• 0f178a8 - Remove code blocks in DocStrings, update code formatting.
• 4d9af62 - Rename module
• f22e5ef - Refactor private methods to be asynchronous, fix an issue with PDF exports
• 11a3e02 - Create instances of TokenManager and ApiClient objects when needed instead of during init
• 73b9d6d - TokenManager object is needed in ApiClient for token verification checks
• cffe7d5 - Lazy load credentials when needed instead of during init to prevent premature validation errors. Fix issue with token fetching calls
• f14647f - Insta...