autopkg-wrapper 2026.2.2__py3-none-any.whl → 2026.2.5__py3-none-any.whl

autopkg_wrapper/autopkg_wrapper.py

@@ -13,6 +13,7 @@ import autopkg_wrapper.utils.git_functions as git
 from autopkg_wrapper.notifier import slack
 from autopkg_wrapper.utils.args import setup_args
 from autopkg_wrapper.utils.logging import setup_logger
+from autopkg_wrapper.utils.recipe_ordering import order_recipe_list
 from autopkg_wrapper.utils.report_processor import process_reports
 
 
@@ -36,43 +37,39 @@ class Recipe(object):
         return name
 
     def verify_trust_info(self, args):
-        verbose_output = ["-vvvv"] if args.debug else None
+        verbose_output = ["-vvvv"] if args.debug else []
         prefs_file = (
-            ["--prefs", args.autopkg_prefs.as_posix()] if args.autopkg_prefs else None
+            ["--prefs", args.autopkg_prefs.as_posix()] if args.autopkg_prefs else []
         )
-        cmd = ["/usr/local/bin/autopkg", "verify-trust-info", self.filename]
-        cmd = cmd + verbose_output if verbose_output else cmd
-        cmd = cmd + prefs_file if prefs_file else cmd
-        cmd = " ".join(cmd)
-        logging.debug(f"cmd: {str(cmd)}")
-
-        p = subprocess.Popen(
-            cmd, stdout=subprocess.PIPE, stderr=subprocess.PIPE, shell=True
+        autopkg_bin = getattr(args, "autopkg_bin", "/usr/local/bin/autopkg")
+        cmd = (
+            [autopkg_bin, "verify-trust-info", self.filename]
+            + verbose_output
+            + prefs_file
         )
-        (output, err) = p.communicate()
-        p_status = p.wait()
-        if p_status == 0:
+        logging.debug(f"cmd: {cmd}")
+
+        result = subprocess.run(cmd, capture_output=True, text=True)
+        if result.returncode == 0:
             self.verified = True
         else:
-            err = err.decode()
-            self.results["message"] = err
+            self.results["message"] = (result.stderr or "").strip()
             self.verified = False
         return self.verified
 
     def update_trust_info(self, args):
         prefs_file = (
-            ["--prefs", args.autopkg_prefs.as_posix()] if args.autopkg_prefs else None
+            ["--prefs", args.autopkg_prefs.as_posix()] if args.autopkg_prefs else []
         )
-        cmd = ["/usr/local/bin/autopkg", "update-trust-info", self.filename]
-        cmd = cmd + prefs_file if prefs_file else cmd
-        cmd = " ".join(cmd)
-        logging.debug(f"cmd: {str(cmd)}")
+        autopkg_bin = getattr(args, "autopkg_bin", "/usr/local/bin/autopkg")
+        cmd = [autopkg_bin, "update-trust-info", self.filename] + prefs_file
+        logging.debug(f"cmd: {cmd}")
 
         # Fail loudly if this exits 0
         try:
-            subprocess.check_call(cmd, shell=True)
+            subprocess.check_call(cmd)
         except subprocess.CalledProcessError as e:
-            logging.error(e.stderr)
+            logging.error(str(e))
             raise e
 
     def _parse_report(self, report):
@@ -108,9 +105,9 @@ class Recipe(object):
                 prefs_file = (
                     ["--prefs", args.autopkg_prefs.as_posix()]
                     if args.autopkg_prefs
-                    else None
+                    else []
                 )
-                verbose_output = ["-vvvv"] if args.debug else None
+                verbose_output = ["-vvvv"] if args.debug else []
                 post_processor_cmd = (
                     list(
                         chain.from_iterable(
@@ -121,25 +118,25 @@ class Recipe(object):
                         )
                     )
                     if self.post_processors
-                    else None
+                    else []
                 )
+                autopkg_bin = getattr(args, "autopkg_bin", "/usr/local/bin/autopkg")
                 cmd = [
-                    "/usr/local/bin/autopkg",
+                    autopkg_bin,
                     "run",
                     self.filename,
                     "--report-plist",
                     str(report),
                 ]
-                cmd = cmd + post_processor_cmd if post_processor_cmd else cmd
-                cmd = cmd + verbose_output if verbose_output else cmd
-                cmd = cmd + prefs_file if prefs_file else cmd
-                cmd = " ".join(cmd)
+                cmd = cmd + post_processor_cmd + verbose_output + prefs_file
 
-                logging.debug(f"cmd: {str(cmd)}")
+                logging.debug(f"cmd: {cmd}")
 
-                subprocess.check_call(cmd, shell=True)
+                result = subprocess.run(cmd, capture_output=True, text=True)
+                if result.returncode != 0:
+                    self.error = True
 
-            except subprocess.CalledProcessError:
+            except Exception:
                 self.error = True
 
             self._has_run = True
@@ -246,7 +243,12 @@ def update_recipe_repo(recipe, git_info, disable_recipe_trust_check, args):
 
 
 def parse_recipe_list(recipes, recipe_file, post_processors, args):
-    """Parsing list of recipes into a common format"""
+    """Parse recipe inputs into a common list of recipe names.
+
+    The arguments assume that `recipes` and `recipe_file` are mutually exclusive.
+    If `args.recipe_processing_order` is provided, the list is re-ordered before
+    creating `Recipe` objects.
+    """
     recipe_list = None
 
     logging.info(f"Recipes: {recipes}") if recipes else None
@@ -256,6 +258,12 @@ def parse_recipe_list(recipes, recipe_file, post_processors, args):
         if recipe_file.suffix == ".json":
             with open(recipe_file, "r") as f:
                 recipe_list = json.load(f)
+        elif recipe_file.suffix in {".yaml", ".yml"}:
+            from ruamel.yaml import YAML
+
+            yaml = YAML(typ="safe")
+            with open(recipe_file, "r", encoding="utf-8") as f:
+                recipe_list = yaml.load(f)
         elif recipe_file.suffix == ".txt":
             with open(recipe_file, "r") as f:
                 recipe_list = f.read().splitlines()
@@ -279,11 +287,16 @@ def parse_recipe_list(recipes, recipe_file, post_processors, args):
             """Please provide recipes to run via the following methods:
     --recipes recipe_one.download recipe_two.download
     --recipe-file path/to/recipe_list.json
-    Comma separated list in the AUTOPKG_RECIPES env variable"""
+    Comma separated list in the AW_RECIPES env variable"""
         )
         sys.exit(1)
 
-    logging.info(f"Processing the following recipes: {recipe_list}")
+    if args.recipe_processing_order:
+        recipe_list = order_recipe_list(
+            recipe_list=recipe_list, order=args.recipe_processing_order
+        )
+
+    logging.info(f"Processing {len(recipe_list)} recipes.")
     recipe_map = [Recipe(name, post_processors=post_processors) for name in recipe_list]
 
     return recipe_map

autopkg_wrapper/notifier/slack.py

@@ -5,7 +5,7 @@ import requests
 
 
 def send_notification(recipe, token):
-    logging.debug("Skipping Slack notification as DEBUG is enabled!")
+    logging.debug("Preparing Slack notification")
 
     if token is None:
         logging.error("Skipping Slack Notification as no SLACK_WEBHOOK_TOKEN defined!")

autopkg_wrapper/utils/args.py

@@ -68,6 +68,33 @@ def setup_args():
                 `autopkg-wrapper`
             """,
     )
+    parser.add_argument(
+        "--recipe-processing-order",
+        nargs="*",
+        default=os.getenv("AW_RECIPE_PROCESSING_ORDER", None),
+        help="""
+            This option comes in handy if you include additional recipe type names in your overrides and wish them to be processed in a specific order.
+            We'll specifically look for these recipe types after the first period (.) in the recipe name.
+            Order items can be either a full type suffix (e.g. "upload.jamf") or a partial token (e.g. "upload", "auto_update").
+            Partial tokens are matched against the dot-separated segments after the first '.' so recipes like "Foo.epz.auto_update.jamf" will match "auto_update".
+            This can also be provided via the 'AW_RECIPE_PROCESSING_ORDER' environment variable as a comma-separated list (e.g. "upload,self_service,auto_update").
+            For example, if you have the following recipes to be processed:
+                ExampleApp.auto_install.jamf
+                ExampleApp.upload.jamf
+                ExampleApp.self_service.jamf
+            And you want to ensure that the .upload recipes are always processed first, followed by .auto_install, and finally .self_service, you would provide the following processing order:
+                `--recipe-processing-order upload.jamf auto_install.jamf self_service.jamf`
+            This would ensure that all .upload recipes are processed before any other recipe types.
+            Within each recipe type, the recipes will be ordered alphabetically.
+            We assume that no extensions are provided (but will strip them if needed - extensions that are stripped include .recipe or .recipe.yaml).
+            """,
+    )
+    parser.add_argument(
+        "--autopkg-bin",
+        default=os.getenv("AW_AUTOPKG_BIN", "/usr/local/bin/autopkg"),
+        help="Path to the autopkg binary (default: /usr/local/bin/autopkg). Can also be set via AW_AUTOPKG_BIN.",
+    )
+
     parser.add_argument(
         "--debug",
         default=validate_bool(os.getenv("AW_DEBUG", False)),

autopkg_wrapper/utils/git_functions.py

@@ -1,4 +1,5 @@
 import logging
+import re
 import subprocess
 from datetime import datetime
 
@@ -21,12 +22,26 @@ def git_run(*args):
 
 
 def get_repo_info(override_repo_git_git_dir):
-    repo_url = (
-        git_run(override_repo_git_git_dir, "config", "--get", "remote.origin.url")
-        .stdout.strip()
-        .split(".git")[0]
+    remote = git_run(
+        override_repo_git_git_dir, "config", "--get", "remote.origin.url"
+    ).stdout.strip()
+
+    # Supports:
+    # - https://github.com/<owner>/<repo>.git
+    # - git@github.com:<owner>/<repo>.git
+    # - ssh://git@github.com/<owner>/<repo>.git
+    m = re.search(
+        r"github\.com[:/](?P<owner>[^/]+)/(?P<repo>[^\s/]+?)(?:\.git)?$",
+        remote,
+        flags=re.IGNORECASE,
     )
-    remote_repo_ref = repo_url.split("https://github.com/")[1]
+    if not m:
+        raise ValueError(f"Unsupported Git remote URL: {remote}")
+
+    owner = m.group("owner")
+    repo = m.group("repo")
+    remote_repo_ref = f"{owner}/{repo}"
+    repo_url = f"https://github.com/{remote_repo_ref}"
 
     logging.debug(f"Repo URL: {repo_url}")
     logging.debug(f"Remote Repo Ref: {remote_repo_ref}")

autopkg_wrapper/utils/recipe_ordering.py

@@ -0,0 +1,149 @@
+import logging
+
+
+def order_recipe_list(recipe_list, order):
+    # This option comes in handy if you include additional recipe type names in your overrides and wish them to be processed in a specific order.
+    # We'll specifically look for these recipe types after the first period (.) in the recipe name.
+    # For example, if you have the following recipes to be processed:
+    #     ExampleApp.auto_install.jamf
+    #     ExampleApp.upload.jamf
+    #     ExampleApp.self_service.jamf
+    # And you want to ensure that the .upload recipes are always processed first, followed by .auto_install, and finally .self_service, you would provide the following processing order:
+    #     `--recipe-processing-order upload.jamf auto_install.jamf self_service.jamf`
+    # This would ensure that all .upload recipes are processed before any other recipe types.
+    # Within each recipe type, the recipes will be ordered alphabetically.
+    # We assume that no extensions are provided (but will strip them if needed - extensions that are stripped include .recipe or .recipe.yaml).
+
+    def strip_known_extensions(value: str) -> str:
+        value = value.strip()
+        if value.endswith(".recipe.yaml"):
+            return value[: -len(".recipe.yaml")]
+        if value.endswith(".recipe"):
+            return value[: -len(".recipe")]
+        return value
+
+    def normalise_processing_order(value):
+        if not value:
+            return []
+
+        items: list[str] = []
+        if isinstance(value, str):
+            raw = value.strip()
+            if not raw:
+                return []
+            # String values generally come from env var defaults; treat as comma-separated.
+            items = [v.strip() for v in raw.split(",")]
+        else:
+            # argparse typically provides a list here, but env var defaults can leak through.
+            for v in value:
+                if v is None:
+                    continue
+                v = str(v).strip()
+                if not v:
+                    continue
+                if "," in v:
+                    items.extend([p.strip() for p in v.split(",")])
+                else:
+                    items.append(v)
+
+        normalised: list[str] = []
+        seen: set[str] = set()
+        for item in items:
+            if not item:
+                continue
+            item = item.lstrip(".")
+            item = strip_known_extensions(item)
+            if not item or item in seen:
+                continue
+            seen.add(item)
+            normalised.append(item)
+        return normalised
+
+    def recipe_type(recipe_name: str) -> str:
+        # Type is everything after the first '.' (e.g. Example.upload.jamf -> upload.jamf)
+        parts = recipe_name.split(".", 1)
+        return parts[1] if len(parts) == 2 else ""
+
+    def recipe_segments_after_first_dot(recipe_name: str) -> list[str]:
+        after_first = recipe_type(recipe_name)
+        return [p for p in after_first.split(".") if p] if after_first else []
+
+    def pattern_matches_segments(pattern: str, segments: list[str]) -> bool:
+        # Pattern can be a single token ("auto_update") or a dot-separated sequence
+        # ("upload.jamf", "auto_update.jamf", etc.).
+        if not pattern:
+            return False
+        pattern_parts = [p for p in pattern.split(".") if p]
+        if not pattern_parts:
+            return False
+
+        # Case-insensitive matching.
+        segments_norm = [s.casefold() for s in segments]
+        pattern_parts_norm = [p.casefold() for p in pattern_parts]
+
+        if len(pattern_parts_norm) == 1:
+            return pattern_parts_norm[0] in segments_norm
+
+        # Contiguous subsequence match.
+        for start in range(0, len(segments_norm) - len(pattern_parts_norm) + 1):
+            if (
+                segments_norm[start : start + len(pattern_parts_norm)]
+                == pattern_parts_norm
+            ):
+                return True
+        return False
+
+    if not recipe_list:
+        return recipe_list
+
+    normalised_order = normalise_processing_order(order)
+
+    # If the provided order contains no usable tokens, do not re-order.
+    # (We still strip known extensions, which is order-preserving.)
+    if not normalised_order:
+        return [
+            strip_known_extensions(str(r).strip()) for r in recipe_list if r is not None
+        ]
+
+    # First, normalise recipe names by stripping known extensions.
+    normalised_recipes: list[str] = []
+    for r in recipe_list:
+        if r is None:
+            continue
+        normalised_recipes.append(strip_known_extensions(str(r).strip()))
+
+    # If a processing order is supplied, match each recipe to the *first* pattern it satisfies.
+    # This supports both direct matches ("upload.jamf") and partial matches ("upload",
+    # "auto_update") against dot-separated segments after the first '.' in the recipe name.
+    pattern_groups: dict[str, list[str]] = {p: [] for p in normalised_order}
+    unmatched: list[str] = []
+
+    for r in normalised_recipes:
+        segments = recipe_segments_after_first_dot(r)
+        matched = False
+        for p in normalised_order:
+            if pattern_matches_segments(p, segments):
+                pattern_groups[p].append(r)
+                matched = True
+                break
+        if not matched:
+            unmatched.append(r)
+
+    ordered: list[str] = []
+    for p in normalised_order:
+        ordered.extend(sorted(pattern_groups[p], key=str.casefold))
+
+    # Remaining recipes: group by their full type string and order groups alphabetically,
+    # with empty-type last.
+    groups: dict[str, list[str]] = {}
+    for r in unmatched:
+        t = recipe_type(r)
+        groups.setdefault(t, []).append(r)
+
+    for t in sorted(groups.keys(), key=lambda x: (x == "", x.casefold())):
+        ordered.extend(sorted(groups[t], key=str.casefold))
+
+    logging.debug(f"Recipe processing order: {normalised_order}")
+    logging.debug(f"Ordered recipes: {ordered}")
+
+    return ordered

autopkg_wrapper/utils/report_processor.py

@@ -53,7 +53,7 @@ def parse_text_file(path: str) -> Dict[str, List]:
 
     re_error = re.compile(r"ERROR[:\s-]+(.+)", re.IGNORECASE)
     re_upload = re.compile(
-        r"(Uploaded|Upload|Uploading)[^\n]*?(?P<name>[A-Za-z0-9 ._+\-]+)(?:[^\n]*?version[^\d]*(?P<version>\d+(?:\.\d+)+))?",
+        r"(Uploaded|Upload|Uploading)[^\n]*?(?P<name>[A-Za-z0-9 ._+\-]+?)(?=(?:\s+\bversion\b)|$)(?:[^\n]*?\bversion\b[^\d]*(?P<version>\d+(?:\.\d+)+))?",
         re.IGNORECASE,
     )
     re_policy = re.compile(r"Policy (created|updated):\s*(?P<name>.+)", re.IGNORECASE)

{autopkg_wrapper-2026.2.2.dist-info → autopkg_wrapper-2026.2.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autopkg-wrapper
-Version: 2026.2.2
+Version: 2026.2.5
 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>
@@ -33,6 +33,8 @@ pip install autopkg-wrapper
 -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

autopkg_wrapper-2026.2.5.dist-info/RECORD

@@ -0,0 +1,15 @@
+autopkg_wrapper/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+autopkg_wrapper/autopkg_wrapper.py,sha256=bfPrZQgcoBZLGKaclBwUh-J2gi8lxIqxFQdDI2AO3lU,15856
+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_ordering.py,sha256=v5yn8KAcvOnNuvAL93ZXwkCUlmNnTGo3oNIqpUAF2jk,5974
+autopkg_wrapper/utils/report_processor.py,sha256=TjSvW02Jq62JhsHNmt_JmZCuQwT_x5RfJNfVTmIePrY,22420
+autopkg_wrapper-2026.2.5.dist-info/METADATA,sha256=mzvKpevomEGeb2iPYjg424EWA3U9yhLdPpRkmR1Nu14,5223
+autopkg_wrapper-2026.2.5.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+autopkg_wrapper-2026.2.5.dist-info/entry_points.txt,sha256=TVIcOt7OozzX1c00pwMGbBysaHg_v_N3mO3juoFqPpo,73
+autopkg_wrapper-2026.2.5.dist-info/licenses/LICENSE,sha256=PpNOQjZGcsKFuA0wU16YU7PueVxqPX4OnyZ7TlLQlq4,1602
+autopkg_wrapper-2026.2.5.dist-info/RECORD,,

autopkg_wrapper-2026.2.2.dist-info/RECORD

@@ -1,14 +0,0 @@
-autopkg_wrapper/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-autopkg_wrapper/autopkg_wrapper.py,sha256=lIcsLJoaHqhQx8yWvew3_GVm3Vn3DgAp9nBAvfz2JnY,15364
-autopkg_wrapper/notifier/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-autopkg_wrapper/notifier/slack.py,sha256=aPxQDGd5zPxSsu3mEqalNOF0ly0QnYog0ieHokd5-OY,1979
-autopkg_wrapper/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-autopkg_wrapper/utils/args.py,sha256=s7QawLF_WV8nReXTLlyXzT1yGL3M03FXegeTUJ3mzNw,6463
-autopkg_wrapper/utils/git_functions.py,sha256=Ojsq-wQsw7Gezq9pYDTtXF9SxrK9b9Cfap3mbJyVgdw,4456
-autopkg_wrapper/utils/logging.py,sha256=3knpMViO_zAU8WM5bSImQaz5M01vMFk_raB4lt1cbvo,324
-autopkg_wrapper/utils/report_processor.py,sha256=kjKgumD2ERYOrPqvg6ozmIsOxDZLSabs1UTjm4bMl6o,22391
-autopkg_wrapper-2026.2.2.dist-info/METADATA,sha256=j07Aix7InD5wasrgREyTNqIEVU3kiMqqCPc3ayDOOVU,4936
-autopkg_wrapper-2026.2.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-autopkg_wrapper-2026.2.2.dist-info/entry_points.txt,sha256=TVIcOt7OozzX1c00pwMGbBysaHg_v_N3mO3juoFqPpo,73
-autopkg_wrapper-2026.2.2.dist-info/licenses/LICENSE,sha256=PpNOQjZGcsKFuA0wU16YU7PueVxqPX4OnyZ7TlLQlq4,1602
-autopkg_wrapper-2026.2.2.dist-info/RECORD,,