[feature] "run" + "commit" a container takes at least a few lines of codes

Not sure if this is a reasonable thing to add to docker and/or docker-py. So asking here. I haven't come across with similar suggestions/discussions on this repo.

Problem to be aimed at

The workflow like below for an already-built Docker image is a popular need for me.
There's no way AFAIK with the docker-py API to do this with a single command/method call.

docker run --> do stuff in the container --> docker commit (with the same tag of the Docker image running a container of.)

Lack of such a functionality leads me to make a util method that calls run and commit. On multiple different projects/repos, this would result in duplicating the same/similar codes.

Background

• Where single threaded environment, achieving run + commit with fewer commands/methods call is advantageous.
  • I'm on Gitlab CI. docker run, do stuff in the container, then docker commit on CI configuration cannot be done from a single threaded CLI (or at least I don't know how to achieve that in a reasonaly simple way).
• Whether this functionality should be added to docker-py or somewhere else is a question. I'm mainly concerned with Python API, so posting here.

Potential solution

• A new method to execute run + commit altogether.

Env

At the time of writing:

• docker-py-1.10.6

The issue names docker-py's run and commit calls as entry points; start by reviewing those APIs and the linked commit documentation. The proposal leaves the API boundary and lifecycle semantics open, so establish the intended behavior with maintainers first; done would be an agreed single-call design with validation for the requested workflow.