feat(options): add WithProvider (#3241)

* 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

* docs: use release placeholder

---------

Co-authored-by: Manuel de la Peña <[email protected]>

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
+
+- Not available until the next release <a href="https://github.com/testcontainers/testcontainers-go"><span class="tc-version">:material-tag: main</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) Not available until the next release <a href="https://github.com/testcontainers/testcontainers-go"><span class="tc-version">:material-tag: main</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 Ryuk failing at boot-up.
+In order to use Testcontainers then either
+1. Disable Ryuk (not recommended): see [here](../features/garbage_collector.md#ryuk)
+2. If you want to use Ryuk 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)
+	})
+}