Fix "borgmatic list --successful" with a slightly better heuristic for listing successful (non-checkpoint) archives.

NEWS

@@ -1,3 +1,7 @@
+1.3.26
+ * #224: Fix "borgmatic list --successful" with a slightly better heuristic for listing successful
+   (non-checkpoint) archives.
+
 1.3.25
  * #223: Dead man's switch to detect when backups start failing silently, implemented via
    healthchecks.io hook integration. See the documentation for more information:

borgmatic/borg/list.py

@@ -6,8 +6,9 @@ from borgmatic.execute import execute_command
 logger = logging.getLogger(__name__)
 
 
-# A hack to convince Borg to exclude archives ending in ".checkpoint".
-BORG_EXCLUDE_CHECKPOINTS_GLOB = '*[!.][!c][!h][!e][!c][!k][!p][!o][!i][!n][!t]'
+# A hack to convince Borg to exclude archives ending in ".checkpoint". This assumes that a
+# non-checkpoint archive name ends in a digit (e.g. from a timestamp).
+BORG_EXCLUDE_CHECKPOINTS_GLOB = '*[0123456789]'
 
 
 def list_archives(repository, storage_config, list_arguments, local_path='borg', remote_path=None):

docs/how-to/monitor-your-backups.md

@@ -29,10 +29,10 @@ below for how to configure this.
 4. **borgmatic Healthchecks hook**: This feature integrates with the
 [Healthchecks](https://healthchecks.io/) service, and pings Healthchecks
 whenever borgmatic runs. That way, Healthchecks can alert you when something
-goes wrong or it doesn't hear from borgmatic for a configured interval. (See
+goes wrong or it doesn't hear from borgmatic for a configured interval. See
 [Healthchecks
 hook](https://torsion.org/borgmatic/docs/how-to/monitor-your-backups/#healthchecks-hook)
-below for how to configure this.)
+below for how to configure this.
 3. **Third-party monitoring software**: You can use traditional monitoring
 software to consume borgmatic JSON output and track when the last
 successful backup occurred. See [scripting
@@ -129,9 +129,15 @@ output only shows up at the console, and not in syslog.
 ### Successful backups
 
 `borgmatic list` includes support for a `--successful` flag that only lists
-successful (non-checkpoint) backups. Combined with a built-in Borg flag like
-`--last`, you can list the last successful backup for use in your monitoring
-scripts. Here's an example combined with `--json`:
+successful (non-checkpoint) backups. This flag works via a basic heuristic: It
+assumes that non-checkpoint archive names end with a digit (e.g. from a
+timestamp), while checkpoint archive names do not. This means that if you're
+using custom archive names that do not end in a digit, the `--successful` flag
+will not work as expected.
+
+Combined with a built-in Borg flag like `--last`, you can list the last
+successful backup for use in your monitoring scripts. Here's an example
+combined with `--json`:
 
 ```bash
 borgmatic list --successful --last 1 --json

setup.py

@@ -1,6 +1,6 @@
 from setuptools import find_packages, setup
 
-VERSION = '1.3.25'
+VERSION = '1.3.26'
 
 
 setup(