feat(options): add WithProvider

The generic container allows to set a provider for a container but this
is not exposed via the options. This commit adds this capability so that
it is possible to set the provider to Podman on MacOS when the auto
detection fails

Author: dfioravanti

docs/features/common_functional_options.md

@@ -437,6 +437,13 @@ ctr, err := mymodule.Run(ctx, "docker.io/myservice:1.2.3",
 
 If you need to prevent the container from being started after creation, you can use the `testcontainers.WithNoStart` option.
 
+##### WithProvider
+
+- Since <a href="https://github.com/testcontainers/testcontainers-go/releases/tag/v0.39.0"><span class="tc-version">:material-tag: v0.39.0</span></a>
+
+If you need specify which provider to use to run the container,  you can use the `testcontainers.WithProvider` option.
+Currently only `docker` or `podman` are supported. 
+
 #### Experimental Options
 
 ##### WithReuseByName

docs/features/common_functional_options_list.md

@@ -60,6 +60,8 @@ The following options are exposed by the `testcontainers` package.
 - [`CustomizeRequest`](/features/creating_container/#customizerequest) Since <a href="https://github.com/testcontainers/testcontainers-go/releases/tag/v0.20.0"><span class="tc-version">:material-tag: v0.20.0</span></a>
 - [`WithName`](/features/creating_container/#withname) Since <a href="https://github.com/testcontainers/testcontainers-go/releases/tag/v0.38.0"><span class="tc-version">:material-tag: v0.38.0</span></a>
 - [`WithNoStart`](/features/creating_container/#withnostart) Since <a href="https://github.com/testcontainers/testcontainers-go/releases/tag/v0.38.0"><span class="tc-version">:material-tag: v0.38.0</span></a>
+- [`WithProvider`](/features/creating_container/#withprovider) Since <a href="https://github.com/testcontainers/testcontainers-go/releases/tag/v0.39.0"><span class="tc-version">:material-tag: v0.39.0</span></a>
+
 
 ### Experimental Options
 

docs/system_requirements/using_podman.md

@@ -44,6 +44,44 @@ The reaper container needs to connect to the docker daemon to reap containers, s
 > systemctl --user start podman.socket
 ```
 
+## MacOS
+
+Currently, in MacOS the autodetection of podman does not work as intended, which leads to Ryku failing at boot-up.
+In order to use testcontainer then either
+1. Disable Ryku (not recommended): see [here](../features/garbage_collector.md#ryuk)
+2. If you want to use Ryku then you need
+   1. Run podman in rootful mode by running the following commands
+      ```bash
+        podman machine stop
+        podman machine set --rootful
+        podman machine start 
+      ```
+   2. Add 
+         ```
+         ryuk.container.privileged=true
+         ``` 
+      to `~/.testcontainers.properties`
+   3. Use the `WithProvider` option when running your containers
+        ```go
+        package some_test
+        
+        import (
+            "testing"
+        
+            tc "github.com/testcontainers/testcontainers-go"
+        )
+        
+        func TestSomething(t *testing.T) {
+            ctx := t.Context()
+            ctr, err := tc.Run(ctx,
+                "docker.io/myservice:1.2.3",
+                tc.WithProvider(tc.ProviderPodman),
+            )
+        
+            // ...
+        }
+        ```
+
 ## Fedora
 
 `DOCKER_HOST` environment variable must be set

options.go

@@ -537,3 +537,12 @@ func WithFiles(files ...ContainerFile) CustomizeRequestOption {
 		return nil
 	}
 }
+
+// WithProvider sets the provider type for a container
+func WithProvider(provider ProviderType) CustomizeRequestOption {
+	return func(req *GenericContainerRequest) error {
+		req.ProviderType = provider
+
+		return nil
+	}
+}

options_test.go

@@ -906,3 +906,30 @@ func TestWithWaitStrategy(t *testing.T) {
 		})
 	})
 }
+
+func TestWithProvider(t *testing.T) {
+	t.Parallel()
+	req := testcontainers.GenericContainerRequest{
+		ContainerRequest: testcontainers.ContainerRequest{
+			Image: "alpine",
+		},
+	}
+
+	t.Run("default", func(t *testing.T) {
+		opt := testcontainers.WithProvider(testcontainers.ProviderDefault)
+		require.NoError(t, opt.Customize(&req))
+		require.Equal(t, testcontainers.ProviderDefault, req.ProviderType)
+	})
+
+	t.Run("docker", func(t *testing.T) {
+		opt := testcontainers.WithProvider(testcontainers.ProviderDocker)
+		require.NoError(t, opt.Customize(&req))
+		require.Equal(t, testcontainers.ProviderDocker, req.ProviderType)
+	})
+
+	t.Run("podman", func(t *testing.T) {
+		opt := testcontainers.WithProvider(testcontainers.ProviderPodman)
+		require.NoError(t, opt.Customize(&req))
+		require.Equal(t, testcontainers.ProviderPodman, req.ProviderType)
+	})
+}