-:  -------- >  1:  6074460a [drop] base for recent docker adapter PRs
 -:  -------- >  2:  22118280 MV: docker adapter: Move some bits to adapters.utils
 -:  -------- >  3:  01b1a202 RF: adapters.utils: Rename _list_images to get_docker_image_ids
 -:  -------- >  4:  c52a0c0c RF: adapters: Prefer subprocess.run over check_* methods
 -:  -------- >  5:  3072f6d3 MV: adapters: Move logging configuration to utils
 -:  -------- >  6:  faf5256c ENH: adapters.utils: Avoid double logging
 -:  -------- >  7:  59ed18f7 ENH: adapters.utils: Add helper for main() handling
 -:  -------- >  8:  94363806 ENH: adapters.utils: Display captured stderr on exit
 1:  ac3db32a !  9:  cdea6a52 NF: oci: Add adapter for working with OCI images
    @@ Commit message
         via podman in the future.

         Add an initial skopeo-based OCI adapter.  At this point, it has the
    -    same functionality as the docker adapter.  Structurally it's fairly
    -    similar to the docker adapter, but it's not clear that it's worth the
    -    effort to try to share any common parts, at least until the oci
    -    interface settles and we decide to keep the docker adapter around.
    +    same functionality as the docker adapter.

      ## datalad_container/adapters/oci.py (new) ##
     @@
    @@ datalad_container/adapters/oci.py (new)
     +
     +import json
     +import logging
    -+import os
     +from pathlib import Path
     +import re
     +import subprocess as sp
     +import sys
     +
    ++from datalad_container.adapters.utils import (
    ++    docker_run,
    ++    get_docker_image_ids,
    ++    log_and_exit,
    ++    setup_logger,
    ++)
    ++
     +lgr = logging.getLogger("datalad.container.adapters.oci")
     +
     +
    @@ datalad_container/adapters/oci.py (new)
     +    return info["config"]["digest"]
     +
     +
    -+def _get_docker_image_ids():
    -+    out = sp.run(
    -+        ["docker", "images", "--all", "--quiet", "--no-trunc"],
    -+        capture_output=True, universal_newlines=True, check=True)
    -+    return out.stdout.splitlines()
    -+
    -+
     +def load(path):
     +    """Load OCI image from `path`.
     +
    @@ datalad_container/adapters/oci.py (new)
     +    An image ID (str)
     +    """
     +    image_id = get_image_id(path)
    -+    if image_id not in _get_docker_image_ids():
    ++    if image_id not in get_docker_image_ids():
     +        lgr.debug("Loading %s", image_id)
     +        # The image is copied with a datalad-container/ prefix to reduce the
     +        # chance of collisions with existing names registered with the Docker
    @@ datalad_container/adapters/oci.py (new)
     +
     +def cli_run(namespace):
     +    image_id = load(namespace.path)
    -+    prefix = ["docker", "run",
    -+              # FIXME: The -v/-w settings are convenient for testing, but they
    -+              # should be configurable. Another option would be to not specify
    -+              # any arguments to docker-run and let everything be handled by
    -+              # the caller.
    -+              "-v", "{}:/tmp".format(os.getcwd()),
    -+              "-w", "/tmp",
    -+              # Make it possible for the output files to be added to the
    -+              # dataset without the user needing to manually adjust the
    -+              # permissions.
    -+              #
    -+              # FIXME: But if the container doesn't have these IDs, some
    -+              # commands may fail.
    -+              "-u", "{}:{}".format(os.getuid(), os.getgid()),
    -+              "--rm"]
    -+    if sys.stdin.isatty():
    -+        prefix.extend(["--interactive", "--tty=true"])
    -+    prefix.append(image_id)
    -+    cmd = prefix + namespace.cmd
    -+    lgr.debug("Running %r", cmd)
    -+    sp.run(cmd, check=True)
    ++    docker_run(image_id, namespace.cmd)
     +
     +
     +def main(args):
    @@ datalad_container/adapters/oci.py (new)
     +
     +    namespace = parser.parse_args(args[1:])
     +
    -+    lgr.setLevel(logging.DEBUG if namespace.verbose else logging.INFO)
    ++    setup_logger(lgr, logging.DEBUG if namespace.verbose else logging.INFO)
     +
     +    namespace.func(namespace)
     +
     +
     +if __name__ == "__main__":
    -+    try:
    ++    with log_and_exit(lgr):
     +        main(sys.argv)
    -+    except Exception as exc:
    -+        lgr.exception("Failed to execute %s", sys.argv)
    -+        if isinstance(exc, sp.CalledProcessError):
    -+            excode = exc.returncode
    -+            if exc.stderr:
    -+                sys.stderr.write(exc.stderr)
    -+        else:
    -+            excode = 1
    -+        sys.exit(excode)
 2:  62c3e97e = 10:  9013fdf6 DOC: oci: Add todo comment about image ID mismatch
 3:  5710e8f8 <  -:  -------- ENH: oci: Wire up logging handler when script called via path
 4:  1bbfac5d = 11:  27cd9417 DOC: oci: Add comment about alternative destinations
 5:  8cae9302 = 12:  02fa4922 ENH: oci: Silence 'skopeo copy' output when loading image
 6:  45a7d332 ! 13:  954b5d84 ENH: oci: Add utility for parsing Docker reference
    @@ datalad_container/adapters/oci.py
     +from collections import namedtuple
      import json
      import logging
    - import os
    + from pathlib import Path
     @@
      lgr = logging.getLogger("datalad.container.adapters.oci")

 7:  a51391b9 = 14:  47a2054e ENH: oci: Copy over tag when saving OCI directory
 8:  cb262015 = 15:  aa7653a3 ENH: oci: Add utilities for storing and reading annotation field
 9:  c398c789 = 16:  a04e6a5f ENH: oci: Record source for skopeo-copy in image's annotation
10:  fa6b5388 = 17:  d2f33fd4 ENH: oci: Register a more informative name with docker-daemon
11:  3d670b99 ! 18:  ee1a33af ENH: containers-add: Wire up OCI adapter
    @@ datalad_container/adapters/tests/test_oci_more.py (new)
     +    WitlessRunner,
     +)
     +from datalad_container.adapters import oci
    ++from datalad_container.adapters.utils import get_docker_image_ids
     +from datalad.tests.utils import (
     +    assert_in,
     +    integration,
    @@ datalad_container/adapters/tests/test_oci_more.py (new)
     +
     +    image_path = ds.repo.pathobj / ".datalad" / "environments" / "bb" / "image"
     +    image_id = oci.get_image_id(image_path)
    -+    existed = image_id in oci._get_docker_image_ids()
    ++    existed = image_id in get_docker_image_ids()
     +
     +    try:
     +        out = WitlessRunner(cwd=ds.path).run(
12:  a5a13621 = 19:  b4d73a17 MV: Add utils module with containers-add's _ensure_datalad_remote
13:  290743a9 ! 20:  c45cef66 ENH: containers-add: Try to link layers in OCI directory
    @@ datalad_container/adapters/tests/test_oci_more.py
     +    DATALAD_SPECIAL_REMOTES_UUIDS,
     +)
      from datalad_container.adapters import oci
    + from datalad_container.adapters.utils import get_docker_image_ids
      from datalad.tests.utils import (
          assert_in,
          integration,