feat: container pause/unpause

Signed-off-by: thediveo <thediveo@gmx.eu>

Author: thediveo

README.md

@@ -7,7 +7,7 @@
 ![build and test](https://github.com/thediveo/morbyd/actions/workflows/buildandtest.yaml/badge.svg?branch=master)
 ![goroutines](https://img.shields.io/badge/go%20routines-not%20leaking-success)
 [![Go Report Card](https://goreportcard.com/badge/github.com/thediveo/morbyd)](https://goreportcard.com/report/github.com/thediveo/morbyd)
-![Coverage](https://img.shields.io/badge/Coverage-98.7%25-brightgreen)
+![Coverage](https://img.shields.io/badge/Coverage-98.6%25-brightgreen)
 
 `morbyd` is a thin layer on top of the standard Docker Go client to easily build
 and run throw-away test Docker images and containers. And to easily run commands

container.go

@@ -135,6 +135,16 @@ func (c *Container) PID(ctx context.Context) (int, error) {
 	}
 }
 
+// Pause the container.
+func (c *Container) Pause(ctx context.Context) error {
+	return c.Session.moby.ContainerPause(ctx, c.ID)
+}
+
+// Unpause the container.
+func (c *Container) Unpause(ctx context.Context) error {
+	return c.Session.moby.ContainerUnpause(ctx, c.ID)
+}
+
 // Stop the container by sending it a termination signal. Default is SIGTERM,
 // unless changed using [run.WithStopSignal].
 func (c *Container) Stop(ctx context.Context) {

container_test.go

@@ -57,6 +57,23 @@ var _ = Describe("containers", Ordered, func() {
 		Expect(time.Since(start)).To(BeNumerically(">=", 4*time.Second))
 	})
 
+	It("pauses and unpauses a container", func(ctx context.Context) {
+		cntr := Successful(sess.Run(ctx, "busybox",
+			run.WithCommand("/bin/sh", "-c", "while true; do sleep 1; done"),
+			run.WithAutoRemove(),
+			run.WithCombinedOutput(timestamper.New(GinkgoWriter)),
+		))
+		Expect(cntr.PID(ctx)).Error().NotTo(HaveOccurred())
+
+		Expect(cntr.Pause(ctx)).To(Succeed())
+		Expect(cntr.Refresh(ctx)).To(Succeed())
+		Expect(cntr.Details.State.Paused).To(BeTrue())
+
+		Expect(cntr.Unpause(ctx)).To(Succeed())
+		Expect(cntr.Refresh(ctx)).To(Succeed())
+		Expect(cntr.Details.State.Paused).To(BeFalse())
+	})
+
 	It("stops a container cooperatively", func(ctx context.Context) {
 		var buff safe.Buffer