v1.0.20240525

Fixes:

• Support for major app version updates when using the --discover-plists argument

v1.0.20240102

Fixes:

• Includes the packaging package to resolve #7

v1.0.20230726

Fixes:

• Issue with -i/--install argument failing with -m/--mandatory and/or -o/--optional specified

Full Changelog: 2410bbd

v1.0.20230706

Fixes:

• Issues with various arguments that have a default value being incorrectly validated
• Optionally filter the output of --discover-plists by providing the -a/--apps [app] argument

Commit log: c394099

v1.0.20230621

Fixes:

• Fixes an issue with --pkg-server not actually being set to the correct value
• Provides a warning when half or more of the content being fetched has an error of some sort (i.e. HTTP 404)
• Tweaks to output in dry-runs/actual runs when the content being fetched has an error
• Provides a default retry value and a maximum of one minute for each retry to fail rather than the default curl timeout handling
• Help for previously hidden command line arguments can now be displayed with the --advanced-help argument; not all of these hidden arguments should be modified though, use these at your own risk
• Provide a means of discovering the values to use with the -p/--plist argument; use --discover-plists to print out a list of property list files that can be parsed

Full Changelog: v1.0.20230531...v1.0.20230621

loopdown v1.0.20230531

loopdown (and install)

Requirements

This should run on any version of Python 3 after/including 3.9; packaging will need to be installed (a requirements.txt file is included in this repo) as distutils is deprecated.

Build

Run ./build.sh with no additional arguments to create a compressed zipapp version of this utility; please note the default Python interpreter and shebang used is /usr/bin/env python3, if a more specific shebang needs to be used, run ./build.sh /new/shebang/path, for example: ./build.sh /usr/local/bin/python3. This will generate a new "build" in ./dist/zipapp/usr/local/bin/custom/.

Support

This is provided as is. No support provided.

License

Licensed under the Apache License Version 2.0. See LICENSE for the full license.

Usage

usage: loopdown [-h] [-n] [-a [app] [[app] ...] | -p [path|url] [[path|url] ...]] [-m] [-o] [--cache-server [server] | --pkg-server [server]] [--create-mirror [path] | -i]
                [--force] [-s] [--log-level [level]] [--version]

options:
  -h, --help            show this help message and exit
  -n, --dry-run         perform a dry run; no action taken
  -a [app] [[app] ...], --apps [app] [[app] ...]
                        application/s to process package content from; valid values are 'all', 'garageband', 'logicpro', 'mainstage', selecting 'all' will process packages for
                        any/all of the three apps if found on the target device; note that the -p/--plist argument cannot be used with this argument
  -p [path|url] [[path|url] ...], --plist [path|url] [[path|url] ...]
                        property list/s to process package content from in the absence of an installed application; note that the -a/--apps argument cannot be used with this
                        argument
  -m, --mandatory       select all mandatory packages for processing; this and/or the -o/--optional argument is required
  -o, --optional        select all optional packages for processing; this and/or the -m/--mandatory argument is required
  --cache-server [server]
                        the url representing an Apple caching server instance; for example: 'http://example.org:51492'; note that the --pkg-server argument cannot be used with
                        this argument
  --pkg-server [server]
                        the url representing a local mirror of package content; for example: 'https://example.org/' (the mirror must have the same folder structure as the Apple
                        package server; note that the --cache-server argument cannot be used with this argument
  --create-mirror [path]
                        create a local mirror of the content following the same directory structure as the Apple audio content download structure
  -i, --install         install the content on this device; note, this does not override the Apple package install check scripts, installs will still fail if the Apple install
                        checks fail, for example, an unsupported OS version, or no supported application is installed
  --force               forcibly performs the selected options regardless of pre-existing installations/downloads, etc
  -s, --silent          suppresses all output
  --log-level [level]   set the logging level; valid options are 'info', 'debug'
  --version             show program's version number and exit