autopkg-wrapper 2024.2.4__py3-none-any.whl → 2026.2.6__py3-none-any.whl

autopkg_wrapper-2026.2.6.dist-info/METADATA

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: autopkg-wrapper
+Version: 2026.2.6
+Summary: A package used to execute some autopkg functions, primarily within the context of a GitHub Actions runner.
+Project-URL: Repository, https://github.com/smithjw/autopkg-wrapper
+Author-email: James Smith <james@smithjw.me>
+License-Expression: BSD-3-Clause
+License-File: LICENSE
+Requires-Python: ~=3.14.0
+Requires-Dist: chardet
+Requires-Dist: idna
+Requires-Dist: jamf-pro-sdk
+Requires-Dist: pygithub
+Requires-Dist: requests
+Requires-Dist: ruamel-yaml
+Requires-Dist: toml
+Requires-Dist: urllib3
+Description-Content-Type: text/markdown
+
+# autopkg-wrapper
+
+`autopkg_wrapper` is a small package that can be used to run [`autopkg`](https://github.com/autopkg/autopkg) within CI/CD environments such as GitHub Actions.
+
+The easiest way to run it is by installing with pip.
+
+```shell
+pip install autopkg-wrapper
+```
+
+## Command Line Parameters
+
+```shell
+-h, --help                      Show this help message and exit
+--recipe-file RECIPE_FILE       Path to a list of recipes to run (cannot be run with --recipes)
+--recipes [RECIPES ...]         Recipes to run with autopkg (cannot be run with --recipe-file)
+--recipe-processing-order [RECIPE_PROCESSING_ORDER ...]
+                                Optional processing order for recipe "types" (suffix segments after the first '.'); supports partial tokens like upload/auto_update; env var AW_RECIPE_PROCESSING_ORDER expects comma-separated values
+--debug                         Enable debug logging when running script
+ --disable-recipe-trust-check    If this option is used, recipe trust verification will not be run prior to a recipe run.
+ --github-token GITHUB_TOKEN     A token used to publish a PR to your GitHub repo if overrides require their trust to be updated
+ --branch-name BRANCH_NAME       Branch name to be used where recipe overrides have failed their trust verification and need to be updated.
+                                 By default, this will be in the format of "fix/update_trust_information/YYYY-MM-DDTHH-MM-SS"
+ --create-pr                     If enabled, autopkg_wrapper will open a PR for updated trust information
+ --create-issues                 Create a GitHub issue for recipes that fail during processing
+ --disable-git-commands          If this option is used, git commands won't be run
+ --post-processors [POST_PROCESSORS ...]
+                                 One or more autopkg post processors to run after each recipe execution
+ --autopkg-prefs AW_AUTOPKG_PREFS_FILE
+                                 Path to the autopkg preferences you'd like to use
+ --overrides-repo-path AUTOPKG_OVERRIDES_REPO_PATH
+                                 The path on disk to the git repository containing the autopkg overrides directory. If none is provided, we will try to determine it for you.
+ --concurrency CONCURRENCY       Number of recipes to run in parallel (default: 1)
+ --process-reports               Process autopkg report directories or zip and emit markdown summaries (runs after recipes complete)
+ --reports-zip REPORTS_ZIP       Path to an autopkg_report-*.zip to extract and process
+ --reports-extract-dir REPORTS_EXTRACT_DIR
+                                 Directory to extract the zip into (default: autopkg_reports_summary/reports)
+ --reports-dir REPORTS_DIR       Directory of reports to process (if no zip provided). Defaults to /private/tmp/autopkg when processing after a run
+ --reports-out-dir REPORTS_OUT_DIR
+                                 Directory to write markdown outputs (default: autopkg_reports_summary/summary)
+ --reports-run-date REPORTS_RUN_DATE
+                                 Run date string to include in the summary
+ --reports-strict                Exit non-zero if any errors are detected in processed reports
+```
+
+## Examples
+
+Run recipes (serial):
+
+```bash
+autopkg_wrapper --recipes Foo.download Bar.download
+```
+
+Run 3 recipes concurrently and process reports afterward:
+
+```bash
+autopkg_wrapper \
+  --recipe-file /path/to/recipe_list.txt \
+  --concurrency 3 \
+  --disable-git-commands \
+  --process-reports \
+  --reports-out-dir /tmp/autopkg_reports_summary \
+  --reports-strict
+```
+
+Process a reports zip explicitly (no recipe run):
+
+```bash
+autopkg_wrapper \
+  --process-reports \
+  --reports-zip /path/to/autopkg_report-2026-02-02.zip \
+  --reports-extract-dir /tmp/autopkg_reports \
+  --reports-out-dir /tmp/autopkg_reports_summary
+```
+
+Notes:
+
+- During recipe runs, per‑recipe plist reports are written to `/private/tmp/autopkg`.
+- When `--process-reports` is supplied without `--reports-zip` or `--reports-dir`, the tool processes `/private/tmp/autopkg`.
+- If `AUTOPKG_JSS_URL`, `AUTOPKG_CLIENT_ID`, and `AUTOPKG_CLIENT_SECRET` are set, uploaded package rows are enriched with Jamf package links.
+  - No extra CLI flag is required; enrichment runs automatically when all three env vars are present.
+
+An example folder structure and GitHub Actions Workflow is available within the [`actions-demo`](actions-demo)
+
+## Credits
+
+- [`autopkg_tools` from Facebook](https://github.com/facebook/IT-CPE/tree/main/legacy/autopkg_tools)
+- [`autopkg_tools` from Facebook, modified by Gusto](https://github.com/Gusto/it-cpe-opensource/tree/main/autopkg)

autopkg_wrapper-2026.2.6.dist-info/RECORD

@@ -0,0 +1,17 @@
+autopkg_wrapper/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+autopkg_wrapper/autopkg_wrapper.py,sha256=k4V-vEoCLUsUUNRxDh3VdWvxAsDIrYH5aSMMZ0HRlTY,12307
+autopkg_wrapper/models/recipe.py,sha256=xUENrhmCIXN8U86u8HwplSsoxP-vgznJZF_OfhGD9_Y,4891
+autopkg_wrapper/notifier/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+autopkg_wrapper/notifier/slack.py,sha256=pUsjwpVfwDSn3c09O3UbdcNtfD98q2fXJ_rKPWvDw7E,1959
+autopkg_wrapper/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+autopkg_wrapper/utils/args.py,sha256=1uEdjTIuqQQcealiEqihZNAamSDLbU9qBzJ6M-tpsS4,8423
+autopkg_wrapper/utils/git_functions.py,sha256=e7wiUIW8Pu6m4oK0LlH7Vnrvp8XzknwTPYXz-Ekn40o,4893
+autopkg_wrapper/utils/logging.py,sha256=3knpMViO_zAU8WM5bSImQaz5M01vMFk_raB4lt1cbvo,324
+autopkg_wrapper/utils/recipe_batching.py,sha256=13Xw952cUryeymYMICA-ATAQiRdpv89Mn4HK17Mynoo,1051
+autopkg_wrapper/utils/recipe_ordering.py,sha256=v5yn8KAcvOnNuvAL93ZXwkCUlmNnTGo3oNIqpUAF2jk,5974
+autopkg_wrapper/utils/report_processor.py,sha256=TjSvW02Jq62JhsHNmt_JmZCuQwT_x5RfJNfVTmIePrY,22420
+autopkg_wrapper-2026.2.6.dist-info/METADATA,sha256=UlniYyeX0seVYUVeXb76mJbJaAcoICtBkKQfHNyVuoM,5223
+autopkg_wrapper-2026.2.6.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+autopkg_wrapper-2026.2.6.dist-info/entry_points.txt,sha256=TVIcOt7OozzX1c00pwMGbBysaHg_v_N3mO3juoFqPpo,73
+autopkg_wrapper-2026.2.6.dist-info/licenses/LICENSE,sha256=PpNOQjZGcsKFuA0wU16YU7PueVxqPX4OnyZ7TlLQlq4,1602
+autopkg_wrapper-2026.2.6.dist-info/RECORD,,

{autopkg_wrapper-2024.2.4.dist-info → autopkg_wrapper-2026.2.6.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 1.8.1
+Generator: hatchling 1.28.0
 Root-Is-Purelib: true
 Tag: py3-none-any

autopkg_wrapper-2026.2.6.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+autopkg_wrapper = autopkg_wrapper.autopkg_wrapper:main

autopkg_wrapper-2024.2.4.dist-info/METADATA

@@ -1,57 +0,0 @@
-Metadata-Version: 2.1
-Name: autopkg-wrapper
-Version: 2024.2.4
-Summary: A package used to execute some autopkg functions, primarily within the context of a GitHub Actions runner
-Home-page: https://github.com/smithjw/autopkg-wrapper
-License: BSD-3-Clause
-Author: James Smith
-Author-email: james@smithjw.me
-Requires-Python: >=3.12,<4.0
-Classifier: License :: OSI Approved :: BSD License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.12
-Requires-Dist: chardet (==5.2.0)
-Requires-Dist: idna (==3.6)
-Requires-Dist: pygithub (==2.2.0)
-Requires-Dist: requests (==2.31.0)
-Requires-Dist: ruamel-yaml (==0.18.6)
-Requires-Dist: toml (==0.10.2)
-Requires-Dist: urllib3 (==2.2.0)
-Project-URL: Repository, https://github.com/smithjw/autopkg-wrapper
-Description-Content-Type: text/markdown
-
-# autopkg-wrapper
-
-`autopkg_wrapper` is a small package that can be used to run [`autopkg`](https://github.com/autopkg/autopkg) within CI/CD environments such as GitHub Actions.
-
-The easiest way to run it is by installing with pip.
-
-```shell
-pip install autopkg-wrapper
-```
-
-## Command Line Parameters
-
-```shell
--h, --help                      Show this help message and exit
---recipe-file RECIPE_FILE       Path to a list of recipes to run (cannot be run with --recipes)
---recipes [RECIPES ...]         Recipes to run with autopkg (cannot be run with --recipe-file)
---debug                         Enable debug logging when running script
---override-trust                If set recipe override trust verification will be disabled. (Default: True)
---github-token GITHUB_TOKEN     A token used to publish a PR to your GitHub repo if overrides require their trust to be updated
---branch-name BRANCH_NAME       Branch name to be used where recipe overrides have failed their trust verification and need to be updated.
-                                By default, this will be in the format of "fix/update_trust_information/YYYY-MM-DDTHH-MM-SS"
---create-pr                     If enabled, autopkg_wrapper will open a PR for updated trust information
---autopkg-overrides-repo-path AUTOPKG_OVERRIDES_REPO_PATH
-                                The path on disk to the git repository containing the autopkg overrides directory. If none is provided, we will try to determine it for you.
-```
-
-## Example
-
-An example folder structure and GitHub Actions Workflow is available within the [`actions-demo`](actions-demo)
-
-## Credits
-
-- [`autopkg_tools` from Facebook](https://github.com/facebook/IT-CPE/tree/main/legacy/autopkg_tools)
-- [`autopkg_tools` from Facebook, modified by Gusto](https://github.com/Gusto/it-cpe-opensource/tree/main/autopkg)
-

autopkg_wrapper-2024.2.4.dist-info/RECORD

@@ -1,13 +0,0 @@
-autopkg_wrapper/__init__.py,sha256=MmNFucd4R7YE8vxBTgy6txaQAviKyV2UklOK2JNjiWs,25
-autopkg_wrapper/autopkg_wrapper.py,sha256=wcB-rnc6YyXGM0E4t8Dksz_Ppw85TXUn6FXEgiXLwx8,7426
-autopkg_wrapper/notifier/__init__.py,sha256=ShXQBVjyiSOHxoQJS2BvNG395W4KZfqMxZWBAR0MZrE,22
-autopkg_wrapper/notifier/slack.py,sha256=nKHeSmgDaTaSUo19ZgnjjjKzeWgg34fMHUwNj9C5FMY,1982
-autopkg_wrapper/utils/__init__.py,sha256=ShXQBVjyiSOHxoQJS2BvNG395W4KZfqMxZWBAR0MZrE,22
-autopkg_wrapper/utils/args.py,sha256=5Nms6mmymI3mOyP969kajDEa2O8CxAvl1Kk-tvNmPhk,2730
-autopkg_wrapper/utils/git_functions.py,sha256=zMMzwRG9V2VFaQk3y_o1H63_hzI1qohwBKaetNDS2mY,2975
-autopkg_wrapper/utils/logging.py,sha256=3knpMViO_zAU8WM5bSImQaz5M01vMFk_raB4lt1cbvo,324
-autopkg_wrapper-2024.2.4.dist-info/LICENSE,sha256=PpNOQjZGcsKFuA0wU16YU7PueVxqPX4OnyZ7TlLQlq4,1602
-autopkg_wrapper-2024.2.4.dist-info/METADATA,sha256=uaf7o9wl_GbuXxNK1T8dDUXeEYAUJcDLymNjJ9n2Bc0,2658
-autopkg_wrapper-2024.2.4.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
-autopkg_wrapper-2024.2.4.dist-info/entry_points.txt,sha256=w9VfrX4aY0ZzJndvzjSI5lLe_sCP2tIq0I5bRLlEKJc,125
-autopkg_wrapper-2024.2.4.dist-info/RECORD,,

autopkg_wrapper-2024.2.4.dist-info/entry_points.txt

@@ -1,4 +0,0 @@
-[console_scripts]
-autopkg-wrapper=autopkg_wrapper.autopkg_wrapper:main
-autopkg_wrapper=autopkg_wrapper.autopkg_wrapper:main
-