docs: add RunContainer example for mongo

docs/modules/mongodb.md

@@ -17,7 +17,7 @@ go get github.com/testcontainers/testcontainers-go/modules/mongodb
 ## Usage example
 
 <!--codeinclude-->
-[Creating a MongoDB container](../../modules/mongodb/mongodb_test.go) inside_block:createMongoDBContainer
+[Creating a MongoDB container](../../modules/mongodb/examples_test.go) inside_block:runMongoDBContainer
 <!--/codeinclude-->
 
 ## Module reference
@@ -66,9 +66,11 @@ The MongoDB container exposes the following methods:
 
 #### ConnectionString
 
-This method returns the connection string to connect to the MongoDB container.
+The `ConnectionString` method returns the connection string to connect to the MongoDB container.
 It returns a string with the format `mongodb://<host>:<port>`.
 
+It can be use to configure a MongoDB client (`go.mongodb.org/mongo-driver/mongo`), e.g.:
+
 <!--codeinclude-->
-[Get connection string](../../modules/mongodb/mongodb_test.go) inside_block:connectionString
-<!--/codeinclude-->
+[Using ConnectionString with the MongoDB client](../../modules/mongodb/examples_test.go) inside_block:connectToMongo
+<!--/codeinclude-->

modules/mongodb/examples_test.go

@@ -0,0 +1,78 @@
+package mongodb_test
+
+import (
+	"context"
+	"fmt"
+
+	"go.mongodb.org/mongo-driver/mongo"
+	"go.mongodb.org/mongo-driver/mongo/options"
+
+	"github.com/testcontainers/testcontainers-go"
+	"github.com/testcontainers/testcontainers-go/modules/mongodb"
+)
+
+func ExampleRunContainer() {
+	// runMongoDBContainer {
+	ctx := context.Background()
+
+	mongodbContainer, err := mongodb.RunContainer(ctx, testcontainers.WithImage("mongo:6"))
+	if err != nil {
+		panic(err)
+	}
+
+	// Clean up the container
+	defer func() {
+		if err := mongodbContainer.Terminate(ctx); err != nil {
+			panic(err)
+		}
+	}()
+	// }
+
+	state, err := mongodbContainer.State(ctx)
+	if err != nil {
+		panic(err)
+	}
+
+	fmt.Println(state.Running)
+
+	// Output:
+	// true
+}
+
+func ExampleRunContainer_connect() {
+	// connectToMongo {
+	ctx := context.Background()
+
+	mongodbContainer, err := mongodb.RunContainer(ctx, testcontainers.WithImage("mongo:6"))
+	if err != nil {
+		panic(err)
+	}
+
+	// Clean up the container
+	defer func() {
+		if err := mongodbContainer.Terminate(ctx); err != nil {
+			panic(err)
+		}
+	}()
+
+	endpoint, err := mongodbContainer.ConnectionString(ctx)
+	if err != nil {
+		panic(err)
+	}
+
+	mongoClient, err := mongo.Connect(ctx, options.Client().ApplyURI(endpoint))
+	if err != nil {
+		panic(err)
+	}
+	// }
+
+	err = mongoClient.Ping(ctx, nil)
+	if err != nil {
+		panic(err)
+	}
+
+	fmt.Println(mongoClient.Database("test").Name())
+
+	// Output:
+	// test
+}

modules/mongodb/mongodb_test.go

@@ -12,12 +12,10 @@ import (
 func TestMongoDB(t *testing.T) {
 	ctx := context.Background()
 
-	// createMongoDBContainer {
 	container, err := RunContainer(ctx)
 	if err != nil {
 		t.Fatal(err)
 	}
-	// }
 
 	// Clean up the container after the test is complete
 	t.Cleanup(func() {
@@ -30,10 +28,10 @@ func TestMongoDB(t *testing.T) {
 
 	// connectionString {
 	endpoint, err := container.ConnectionString(ctx)
+	// }
 	if err != nil {
 		t.Error(fmt.Errorf("failed to get connection string: %w", err))
 	}
-	// }
 
 	mongoClient, err := mongo.Connect(ctx, options.Client().ApplyURI(endpoint))
 	if err != nil {