Added support for copy file to container

.gitignore

@@ -7,3 +7,4 @@ site/
 .direnv/
 src/mkdocs-codeinclude-plugin
 src/pip-delete-this-directory.txt
+.idea/

container.go

@@ -49,6 +49,7 @@ type Container interface {
  NetworkAliases(context.Context) (map[string][]string, error) // get container network aliases for a network
  Exec(ctx context.Context, cmd []string) (int, error)
  ContainerIP(context.Context) (string, error) // get container ip
+ CopyFileToContainer(ctx context.Context, containerPath string, fileName string, fileContent []byte, fileMode int64) error
 }
 
 // ImageBuildInfo defines what is needed to build an image

docker.go

@@ -1,6 +1,7 @@
 package testcontainers
 
 import (
+ "archive/tar"
  "bytes"
  "context"
  "encoding/binary"
@@ -306,6 +307,27 @@ func (c *DockerContainer) Exec(ctx context.Context, cmd []string) (int, error) {
  return exitCode, nil
 }
 
+func (c *DockerContainer) CopyFileToContainer(ctx context.Context, containerPath string, fileName string, fileContent []byte, fileMode int64) error {
+ buffer := &bytes.Buffer{}
+
+ tw := tar.NewWriter(buffer)
+ defer tw.Close()
+
+ hdr := &tar.Header{
+ Name: fileName,
+ Mode: fileMode,
+ Size: int64(len(fileContent)),
+ }
+ if err := tw.WriteHeader(hdr); err != nil {
+ return err
+ }
+ if _, err := tw.Write(fileContent); err != nil {
+ return err
+ }
+
+ return c.provider.client.CopyToContainer(ctx, c.ID, containerPath, buffer, types.CopyToContainerOptions{})
+}
+
 // StartLogProducer will start a concurrent process that will continuously read logs
 // from the container and will send them to each added LogConsumer
 func (c *DockerContainer) StartLogProducer(ctx context.Context) error {

docker_test.go

@@ -4,6 +4,7 @@ import (
  "context"
  "errors"
  "fmt"
+ "io/ioutil"
  "net/http"
  "path/filepath"
  "testing"
@@ -1267,3 +1268,31 @@ func TestContainerNonExistentImage(t *testing.T) {
  })
 
 }
+
+func TestDockerContainerCopyFileToContainer(t *testing.T) {
+ ctx := context.Background()
+
+ nginxC, err := GenericContainer(ctx, GenericContainerRequest{
+ ContainerRequest: ContainerRequest{
+ Image: "nginx:1.17.6",
+ ExposedPorts: []string{"80/tcp"},
+ WaitingFor: wait.ForListeningPort("80/tcp"),
+ },
+ Started: true,
+ })
+ defer nginxC.Terminate(ctx)
+
+ fileContent, err := ioutil.ReadFile("./testresources/hello.sh")
+ if err != nil {
+ t.Fatal(err)
+ }
+ copiedFilePath := "hello_copy.sh"
+ nginxC.CopyFileToContainer(ctx, "/", copiedFilePath, fileContent, 700)
+ c, err := nginxC.Exec(ctx, []string{"bash", copiedFilePath})
+ if err != nil {
+ t.Fatal(err)
+ }
+ if c != 0 {
+ t.Fatalf("File %s should exist, expected return code 0, got %v", copiedFilePath, c)
+ }
+}

docs/features/copy_file.md

@@ -0,0 +1,23 @@
+# Copy Files To Container
+
+If you would like to copy a file to a container, you can do it using the `CopyFileToContainer` method...
+
+```go
+ctx := context.Background()
+
+nginxC, err := GenericContainer(ctx, GenericContainerRequest{
+ ContainerRequest: ContainerRequest{
+ Image: "nginx:1.17.6",
+ ExposedPorts: []string{"80/tcp"},
+ WaitingFor: wait.ForListeningPort("80/tcp"),
+ },
+ Started: true,
+ })
+
+fileContent, err := ioutil.ReadFile("./testresources/hello.sh")
+ if err != nil {
+ t.Fatal(err)
+ }
+nginxC.CopyFileToContainer(ctx, "/", "hello_copy.sh", fileContent, 700)
+```
+