KaneAI - World’s First E2E Software Testing Agent.Book a Demo Join TestMu Conference

How to use ThrowIfContainerHasNotBeenCreated method of DotNet.Testcontainers.Containers.TestcontainersContainer class

Best Testcontainers-dotnet code snippet using DotNet.Testcontainers.Containers.TestcontainersContainer.ThrowIfContainerHasNotBeenCreated

TestcontainersContainer.cs

Source:TestcontainersContainer.cs

...38    public string Id39    {40      get41      {42        this.ThrowIfContainerHasNotBeenCreated();43        return this.container.ID;44      }45    }46    /// <inheritdoc />47    public string Name48    {49      get50      {51        this.ThrowIfContainerHasNotBeenCreated();52        return this.container.Name;53      }54    }55    /// <inheritdoc />56    public string IpAddress57    {58      get59      {60        this.ThrowIfContainerHasNotBeenCreated();61        return this.container.NetworkSettings.Networks.First().Value.IPAddress;62      }63    }64    /// <inheritdoc />65    public string MacAddress66    {67      get68      {69        this.ThrowIfContainerHasNotBeenCreated();70        return this.container.NetworkSettings.Networks.First().Value.MacAddress;71      }72    }73    /// <inheritdoc />74    public string Hostname75    {76      get77      {78        var dockerHostUri = this.configuration.DockerEndpointAuthConfig.Endpoint;79        switch (dockerHostUri.Scheme)80        {81          case "http":82          case "https":83          case "tcp":84            return dockerHostUri.Host;85          case "npipe":86          case "unix":87            return this.GetContainerGateway();88          default:89            throw new InvalidOperationException($"Docker endpoint {dockerHostUri} is not supported.");90        }91      }92    }93    /// <inheritdoc />94    public IDockerImage Image95    {96      get97      {98        return this.configuration.Image;99      }100    }101    /// <inheritdoc />102    public TestcontainersStates State103    {104      get105      {106        if (this.container.State == null)107        {108          return TestcontainersStates.Undefined;109        }110        try111        {112          return (TestcontainersStates)Enum.Parse(typeof(TestcontainersStates), this.container.State.Status, true);113        }114        catch (Exception)115        {116          return TestcontainersStates.Undefined;117        }118      }119    }120    /// <summary>121    /// Gets the logger.122    /// </summary>123    [NotNull]124    internal ILogger Logger { get; }125    /// <inheritdoc />126    public ushort GetMappedPublicPort(int privatePort)127    {128      return this.GetMappedPublicPort(Convert.ToString(privatePort, CultureInfo.InvariantCulture));129    }130    /// <inheritdoc />131    public ushort GetMappedPublicPort(string privatePort)132    {133      this.ThrowIfContainerHasNotBeenCreated();134      if (this.container.NetworkSettings.Ports.TryGetValue($"{privatePort}/tcp", out var portMap) && ushort.TryParse(portMap.First().HostPort, out var publicPort))135      {136        return publicPort;137      }138      else139      {140        throw new InvalidOperationException($"Exposed port {privatePort} is not mapped.");141      }142    }143    /// <inheritdoc />144    public Task<long> GetExitCode(CancellationToken ct = default)145    {146      return this.client.GetContainerExitCode(this.Id, ct);147    }148    /// <inheritdoc />149    public Task<(string Stdout, string Stderr)> GetLogs(DateTime since = default, DateTime until = default, CancellationToken ct = default)150    {151      return this.client.GetContainerLogs(this.Id, since, until, ct);152    }153    /// <inheritdoc />154    public virtual async Task StartAsync(CancellationToken ct = default)155    {156      await this.semaphoreSlim.WaitAsync(ct)157        .ConfigureAwait(false);158      try159      {160        this.container = await this.Create(ct)161          .ConfigureAwait(false);162        this.container = await this.Start(this.Id, ct)163          .ConfigureAwait(false);164      }165      finally166      {167        this.semaphoreSlim.Release();168      }169    }170    /// <inheritdoc />171    public virtual async Task StopAsync(CancellationToken ct = default)172    {173      await this.semaphoreSlim.WaitAsync(ct)174        .ConfigureAwait(false);175      try176      {177        this.container = await this.Stop(this.Id, ct)178          .ConfigureAwait(false);179      }180      catch (DockerContainerNotFoundException)181      {182        this.container = new ContainerInspectResponse();183      }184      finally185      {186        this.semaphoreSlim.Release();187      }188    }189    /// <inheritdoc />190    public Task CopyFileAsync(string filePath, byte[] fileContent, int accessMode = 384, int userId = 0, int groupId = 0, CancellationToken ct = default)191    {192      return this.client.CopyFileAsync(this.Id, filePath, fileContent, accessMode, userId, groupId, ct);193    }194    /// <inheritdoc />195    public Task<byte[]> ReadFileAsync(string filePath, CancellationToken ct = default)196    {197      return this.client.ReadFileAsync(this.Id, filePath, ct);198    }199    /// <inheritdoc />200    public Task<ExecResult> ExecAsync(IList<string> command, CancellationToken ct = default)201    {202      return this.client.ExecAsync(this.Id, command, ct);203    }204    /// <summary>205    /// Removes the Testcontainers.206    /// </summary>207    /// <param name="ct">Cancellation token.</param>208    /// <returns>A task that represents the asynchronous clean up operation of a Testcontainers.</returns>209    public async Task CleanUpAsync(CancellationToken ct = default)210    {211      await this.semaphoreSlim.WaitAsync(ct)212        .ConfigureAwait(false);213      try214      {215        this.container = await this.CleanUp(this.Id, ct)216          .ConfigureAwait(false);217      }218      finally219      {220        this.semaphoreSlim.Release();221      }222    }223    /// <inheritdoc />224    public async ValueTask DisposeAsync()225    {226      await this.DisposeAsyncCore()227        .ConfigureAwait(false);228      GC.SuppressFinalize(this);229    }230    /// <summary>231    /// Releases any resources associated with the instance of <see cref="TestcontainersContainer" />.232    /// </summary>233    /// <returns>Value task that completes when any resources associated with the instance have been released.</returns>234    protected virtual async ValueTask DisposeAsyncCore()235    {236      if (1.Equals(Interlocked.CompareExchange(ref this.disposed, 1, 0)))237      {238        return;239      }240      if (!ContainerHasBeenCreatedStates.HasFlag(this.State))241      {242        return;243      }244      // If someone calls `DisposeAsync`, we can immediately remove the container. We do not need to wait for the Resource Reaper.245      if (Guid.Empty.Equals(this.configuration.SessionId))246      {247        await this.StopAsync()248          .ConfigureAwait(false);249      }250      else251      {252        await this.CleanUpAsync()253          .ConfigureAwait(false);254      }255      this.semaphoreSlim.Dispose();256    }257    private async Task<ContainerInspectResponse> Create(CancellationToken ct = default)258    {259      if (ContainerHasBeenCreatedStates.HasFlag(this.State))260      {261        return this.container;262      }263      var id = await this.client.RunAsync(this.configuration, ct)264        .ConfigureAwait(false);265      return await this.client.InspectContainer(id, ct)266        .ConfigureAwait(false);267    }268    private async Task<ContainerInspectResponse> Start(string id, CancellationToken ct = default)269    {270      await this.client.AttachAsync(id, this.configuration.OutputConsumer, ct)271        .ConfigureAwait(false);272      await this.client.StartAsync(id, ct)273        .ConfigureAwait(false);274      this.container = await this.client.InspectContainer(id, ct)275        .ConfigureAwait(false);276      await this.configuration.StartupCallback(this, ct)277        .ConfigureAwait(false);278      // Do not use a too small frequency. Especially with a lot of containers,279      // we send many operations to the Docker endpoint. The endpoint may cancel operations.280      var frequency = (int)TimeSpan.FromSeconds(1).TotalMilliseconds;281      const int timeout = -1;282      foreach (var waitStrategy in this.configuration.WaitStrategies)283      {284        await WaitStrategy.WaitUntil(285            async () =>286            {287              this.container = await this.client.InspectContainer(id, ct)288                .ConfigureAwait(false);289              return await waitStrategy.Until(this, this.Logger)290                .ConfigureAwait(false);291            },292            frequency,293            timeout,294            ct)295          .ConfigureAwait(false);296      }297      return this.container;298    }299    private async Task<ContainerInspectResponse> Stop(string id, CancellationToken ct = default)300    {301      await this.client.StopAsync(id, ct)302        .ConfigureAwait(false);303      return await this.client.InspectContainer(id, ct)304        .ConfigureAwait(false);305    }306    private async Task<ContainerInspectResponse> CleanUp(string id, CancellationToken ct = default)307    {308      await this.client.RemoveAsync(id, ct)309        .ConfigureAwait(false);310      return new ContainerInspectResponse();311    }312    private void ThrowIfContainerHasNotBeenCreated()313    {314      if (ContainerHasBeenCreatedStates.HasFlag(this.State))315      {316        return;317      }318      throw new InvalidOperationException("Testcontainers has not been created.");319    }320    private string GetContainerGateway()321    {322      const string localhost = "localhost";323      if (!ContainerHasBeenCreatedStates.HasFlag(this.State))324      {325        return localhost;326      }...

ThrowIfContainerHasNotBeenCreated

Using AI Code Generation

1using System;2using System.Threading.Tasks;3using DotNet.Testcontainers.Containers.Builders;4using DotNet.Testcontainers.Containers.Configurations;5using DotNet.Testcontainers.Containers.Modules;6using DotNet.Testcontainers.Containers.WaitStrategies;7using DotNet.Testcontainers.Images;8{9    {10        static async Task Main(string[] args)11        {12            TestcontainersContainer container = null;13            {14                var image = new TestcontainersImage("mcr.microsoft.com/dotnet/core/sdk:3.1", "dotnet:3.1");15                container = new TestcontainersBuilder<TestcontainersContainer>()16                .WithImage(image)17                .WithWaitStrategy(Wait.ForUnixContainer().UntilCommandIsCompleted("dotnet --version"))18                .Build();19                await container.StartAsync();20                container.ThrowIfContainerHasNotBeenCreated();21            }22            catch (Exception ex)23            {24                Console.WriteLine(ex.Message);25            }26            {27                if (container != null)28                {29                    await container.StopAsync();30                }31            }32        }33    }34}

ThrowIfContainerHasNotBeenCreated

Using AI Code Generation

1using System;2using System.Threading.Tasks;3using DotNet.Testcontainers.Containers.Builders;4using DotNet.Testcontainers.Containers.Configurations;5using DotNet.Testcontainers.Containers.Modules;6using DotNet.Testcontainers.Containers.WaitStrategies;7{8    {9        static async Task Main(string[] args)10        {11            var testcontainersBuilder = new TestcontainersBuilder<TestcontainersContainer>()12                .WithImage("alpine:3.12")13                .WithCommand("sleep 30")14                .WithWaitStrategy(Wait.ForUnixContainer().UntilCommandIsCompleted("echo hello"));15            var testcontainersContainer = testcontainersBuilder.Build();16            await testcontainersContainer.StartAsync();17            Console.WriteLine("Container has been created");18            testcontainersContainer.ThrowIfContainerHasNotBeenCreated();19            Console.WriteLine("Container has not been created");20            await testcontainersContainer.StopAsync();21        }22    }23}24using System;25using System.Threading.Tasks;26using DotNet.Testcontainers.Containers.Builders;27using DotNet.Testcontainers.Containers.Configurations;28using DotNet.Testcontainers.Containers.Modules;29using DotNet.Testcontainers.Containers.WaitStrategies;30{31    {32        static async Task Main(string[] args)33        {34            var testcontainersBuilder = new TestcontainersBuilder<TestcontainersContainer>()35                .WithImage("alpine:3.12")36                .WithCommand("sleep 30")37                .WithWaitStrategy(Wait.ForUnixContainer().UntilCommandIsCompleted("echo hello"));38            var testcontainersContainer = testcontainersBuilder.Build();39            await testcontainersContainer.StartAsync();40            Console.WriteLine("Container has been created");41            await testcontainersContainer.StopAsync();42            testcontainersContainer.ThrowIfContainerHasNotBeenCreated();43            Console.WriteLine("Container has not been created");44        }45    }46}47using System;48using System.Threading.Tasks;49using DotNet.Testcontainers.Containers.Builders;50using DotNet.Testcontainers.Containers.Configurations;

ThrowIfContainerHasNotBeenCreated

Using AI Code Generation

1using System;2using System.Threading.Tasks;3using DotNet.Testcontainers.Containers.Builders;4using DotNet.Testcontainers.Containers.Modules;5using DotNet.Testcontainers.Containers.WaitStrategies;6using DotNet.Testcontainers.Images;7using DotNet.Testcontainers.Images.Archives;8using DotNet.Testcontainers.Images.Builders;9using DotNet.Testcontainers.Images.Configurations;10{11    {12        static async Task Main(string[] args)13        {14            var postgresImage = new TestcontainersImageBuilder<TestcontainersImage>()15                .WithImageConfiguration(16                    new ImageFromDockerfileConfiguration()17                        .WithDockerfile(Path.Combine(Environment.CurrentDirectory, "Dockerfile"))18                .WithBuildTimeout(TimeSpan.FromMinutes(1))19                .Build();20            var postgres = new TestcontainersContainerBuilder<PostgreSqlTestcontainer>()21                .WithImage(postgresImage)22                .WithDatabase(new PostgreSqlTestcontainerConfiguration())23                .WithWaitStrategy(Wait.ForUnixContainer().UntilPortIsAvailable(5432))24                .Build();25            await postgres.StartAsync();26            Console.WriteLine("Container has been created");27            postgres.ThrowIfContainerHasNotBeenCreated();28            Console.WriteLine("Container has been created");29            await postgres.StopAsync();30        }31    }32}33using System;34using System.Threading.Tasks;35using DotNet.Testcontainers.Containers.Builders;36using DotNet.Testcontainers.Containers.Modules;37using DotNet.Testcontainers.Containers.WaitStrategies;38using DotNet.Testcontainers.Images;39using DotNet.Testcontainers.Images.Archives;40using DotNet.Testcontainers.Images.Builders;41using DotNet.Testcontainers.Images.Configurations;42{43    {44        static async Task Main(string[] args)45        {46            var postgresImage = new TestcontainersImageBuilder<TestcontainersImage>()47                .WithImageConfiguration(48                    new ImageFromDockerfileConfiguration()49                        .WithDockerfile(Path.Combine(Environment.CurrentDirectory, "Dockerfile"))50                .WithBuildTimeout(TimeSpan.FromMinutes(1))51                .Build();52            var postgres = new TestcontainersContainerBuilder<PostgreSqlTestcontainer>()53                .WithImage(postgresImage)54                .WithDatabase(new PostgreSqlTestcontainerConfiguration())55                .WithWaitStrategy(Wait.ForUnix

ThrowIfContainerHasNotBeenCreated

Using AI Code Generation

1using System;2using System.Threading.Tasks;3using DotNet.Testcontainers.Containers.Builders;4using DotNet.Testcontainers.Containers.Modules.Databases;5using DotNet.Testcontainers.Containers.WaitStrategies;6{7    {8        static async Task Main(string[] args)9        {10            using var container = new PostgreSqlTestcontainerBuilder()11                .WithDatabase("test")12                .WithUsername("test")13                .WithPassword("test")14                .WithWaitStrategy(Wait.ForUnixContainer().UntilPortIsAvailable(5432))15                .Build();16            await container.StartAsync();17            container.ThrowIfContainerHasNotBeenCreated();18            Console.WriteLine("Hello World!");19        }20    }21}22using System;23using System.Threading.Tasks;24using DotNet.Testcontainers.Containers.Builders;25using DotNet.Testcontainers.Containers.Modules.Databases;26using DotNet.Testcontainers.Containers.WaitStrategies;27{28    {29        static async Task Main(string[] args)30        {31            using var container = new PostgreSqlTestcontainerBuilder()32                .WithDatabase("test")33                .WithUsername("test")34                .WithPassword("test")35                .WithWaitStrategy(Wait.ForUnixContainer().UntilPortIsAvailable(5432))36                .Build();37            await container.StartAsync();38            container.ThrowIfContainerHasNotBeenStarted();39            Console.WriteLine("Hello World!");40        }41    }42}43using System;44using System.Threading.Tasks;45using DotNet.Testcontainers.Containers.Builders;46using DotNet.Testcontainers.Containers.Modules.Databases;47using DotNet.Testcontainers.Containers.WaitStrategies;48{49    {50        static async Task Main(string[] args)51        {52            using var container = new PostgreSqlTestcontainerBuilder()53                .WithDatabase("test")54                .WithUsername("test")55                .WithPassword("test")56                .WithWaitStrategy(Wait.ForUnixContainer().UntilPortIsAvailable

ThrowIfContainerHasNotBeenCreated

Using AI Code Generation

1var container = new GenericContainer("mcr.microsoft.com/playwright:v1.13.1-focal");2container.ThrowIfContainerHasNotBeenCreated();3var container = new GenericContainer("mcr.microsoft.com/playwright:v1.13.1-focal");4container.ThrowIfContainerHasNotBeenStarted();5var container = new GenericContainer("mcr.microsoft.com/playwright:v1.13.1-focal");6container.ThrowIfContainerHasNotBeenStopped();7var container = new GenericContainer("mcr.microsoft.com/playwright:v1.13.1-focal");8container.ThrowIfContainerHasNotBeenRemoved();9var container = new GenericContainer("mcr.microsoft.com/playwright:v1.13.1-focal");10container.ThrowIfContainerHasNotBeenBuilt();11var container = new GenericContainer("mcr.microsoft.com/playwright:v1.13.1-focal");12container.ThrowIfContainerHasNotBeenCommitted();13var container = new GenericContainer("mcr.microsoft.com/playwright:v1.13.1-focal");14container.ThrowIfContainerHasNotBeenPaused();15var container = new GenericContainer("mcr.microsoft.com/playwright:v1.13.1-focal");16container.ThrowIfContainerHasNotBeenUnpaused();

ThrowIfContainerHasNotBeenCreated

Using AI Code Generation

1var container = new TestcontainersContainerBuilder<DotNetTestcontainersContainer>()2    .WithImage("hello-world")3    .WithCleanUp(false)4    .Build();5container.ThrowIfContainerHasNotBeenCreated();6var container = new TestcontainersContainerBuilder<DotNetTestcontainersContainer>()7    .WithImage("hello-world")8    .WithCleanUp(false)9    .Build();10container.Start();11container.ThrowIfContainerHasNotBeenCreated();12var container = new TestcontainersContainerBuilder<DotNetTestcontainersContainer>()13    .WithImage("hello-world")14    .WithCleanUp(false)15    .Build();16container.Start();17container.Stop();18container.ThrowIfContainerHasNotBeenCreated();19var container = new TestcontainersContainerBuilder<DotNetTestcontainersContainer>()20    .WithImage("hello-world")21    .WithCleanUp(false)22    .Build();23container.Start();24container.Stop();25container.Remove();26container.ThrowIfContainerHasNotBeenCreated();27var container = new TestcontainersContainerBuilder<DotNetTestcontainersContainer>()28    .WithImage("hello-world")29    .WithCleanUp(false)30    .Build();31container.Start();32container.Stop();33container.Remove();34container.Dispose();35container.ThrowIfContainerHasNotBeenCreated();36var container = new TestcontainersContainerBuilder<DotNetTestcontainersContainer>()37    .WithImage("hello-world")38    .WithCleanUp(false)39    .Build();40container.Start();41container.Stop();42container.Remove();43container.Dispose();44container.ThrowIfContainerHasNotBeenCreated();

Automation Testing Tutorials

Learn to execute automation testing from scratch with LambdaTest Learning Hub. Right from setting up the prerequisites to run your first automation test, to following best practices and diving deeper into advanced test scenarios. LambdaTest Learning Hubs compile a list of step-by-step guides to help you be proficient with different test automation frameworks i.e. Selenium, Cypress, TestNG etc.