Skip to content
Merged
Show file tree
Hide file tree
Changes from 5 commits
Commits
Show all changes
24 commits
Select commit Hold shift + click to select a range
d96cfd7
Initial plan
Copilot Jan 2, 2026
ae0336e
Add testcontainers-dotnet skill with examples
Copilot Jan 2, 2026
05c451d
Update repository configuration for testcontainers-dotnet skill
Copilot Jan 2, 2026
0dda689
Fix .NET examples compilation errors
Copilot Jan 2, 2026
e436358
Add .gitignore and remove build artifacts from .NET examples
Copilot Jan 2, 2026
4c4f07f
Add testcontainers.com modules link for .NET skill
Copilot Jan 2, 2026
50e4817
Add conditional job execution based on changed paths
Copilot Jan 2, 2026
9badce3
Add Testcontainers for .NET to Related Projects section
Copilot Jan 2, 2026
2080256
Update CODEOWNERS to use @mdelapenya as owner
Copilot Jan 2, 2026
9857801
Update package versions and builder API for Testcontainers 4.10.0
Copilot Jan 5, 2026
e0644ff
Complete migration to Testcontainers 4.10.0 API
Copilot Jan 5, 2026
b8c10a6
Make best practices section framework-agnostic
Copilot Jan 5, 2026
709581a
Co-authored-by: mdelapenya <951580+mdelapenya@users.noreply.github.com>
Copilot Jan 5, 2026
cf10606
Re-add wait strategies with correct Testcontainers 4.10.0 API
Copilot Jan 5, 2026
a2b5575
fix: update incorrect and wrong information
HofmeisterAn Jan 16, 2026
96436c4
feat: add more examples
HofmeisterAn Jan 16, 2026
bc70825
fix: remove minor inconsistencies
HofmeisterAn Jan 16, 2026
70dfee8
fix: remove obsolete WithImage(string) usage
HofmeisterAn Jan 16, 2026
53e032d
Reorganize to match new plugins/testcontainers layout structure
Copilot Feb 11, 2026
fd2e8e6
Re-add detect-changes job for conditional test execution
Copilot Feb 11, 2026
fc5d01e
Merge branch 'main' into copilot/add-testcontainers-dotnet-skill
Copilot Feb 11, 2026
aaff97d
Resolve merge conflicts with main branch
Copilot Feb 11, 2026
c322506
Merge branch 'main' into copilot/add-testcontainers-dotnet-skill
mdelapenya Feb 11, 2026
bb43f6e
Remove .NET examples directory, keep only SKILL.md
Copilot Feb 28, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,19 @@
"keywords": ["testcontainers", "go", "docker", "integration-testing", "testing", "containers", "databases", "postgres", "redis", "kafka", "mysql", "mongodb"],
"category": "development",
"strict": false
},
{
"name": "testcontainers-dotnet",
"source": "./testcontainers-dotnet",
"description": "A comprehensive guide for using Testcontainers for .NET to write reliable integration tests with Docker containers in .NET projects. Supports 40+ pre-configured modules for databases, message queues, cloud services, and more.",
"version": "1.0.0",
"author": {
"name": "Testcontainers",
"email": "info@testcontainers.org"
},
"keywords": ["testcontainers", "dotnet", "csharp", "docker", "integration-testing", "testing", "containers", "databases", "postgres", "sqlserver", "redis", "kafka", "mongodb", "entityframework"],
Comment thread
mdelapenya marked this conversation as resolved.
Outdated
"category": "development",
"strict": false
}
]
}
16 changes: 16 additions & 0 deletions .github/CODEOWNERS
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
# CODEOWNERS file for testcontainers/claude-skills repository
#
# This file defines code ownership for the repository.
# Reviewers will be automatically requested for pull requests that modify the specified paths.
#
# For more information, see:
# https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners

# Default owners for everything in the repo
* @testcontainers/maintainers

# testcontainers-go skill
/testcontainers-go/ @testcontainers/maintainers
Comment thread
mdelapenya marked this conversation as resolved.
Outdated

# testcontainers-dotnet skill
/testcontainers-dotnet/ @HofmeisterAn @testcontainers/maintainers
45 changes: 45 additions & 0 deletions .github/workflows/test-skills.yml
Original file line number Diff line number Diff line change
Expand Up @@ -5,11 +5,13 @@ on:
branches: [ main, copilot/** ]
paths:
- 'testcontainers-go/**'
- 'testcontainers-dotnet/**'
- '.github/workflows/test-skills.yml'
pull_request:
branches: [ main ]
paths:
- 'testcontainers-go/**'
- 'testcontainers-dotnet/**'
- '.github/workflows/test-skills.yml'

jobs:
Expand Down Expand Up @@ -75,3 +77,46 @@ jobs:
# Tests will automatically pull required Docker images
go test -v -timeout 10m ./...
echo "✅ All tests passed!"

test-testcontainers-dotnet:
Comment thread
mdelapenya marked this conversation as resolved.
Outdated
name: Test testcontainers-dotnet examples
runs-on: ubuntu-latest
permissions:
contents: read

steps:
- name: Checkout code
uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2

- name: Set up .NET
uses: actions/setup-dotnet@3e891b0cb619bf60e2c25674b222b8940e2c1c25 # v4.1.0
with:
dotnet-version: '8.0.x'

- name: Restore dependencies
working-directory: testcontainers-dotnet/examples
run: |
echo "Restoring .NET dependencies..."
dotnet restore
echo "✅ Dependencies restored!"

- name: Build examples
working-directory: testcontainers-dotnet/examples
run: |
echo "Building .NET test project..."
dotnet build --no-restore --configuration Release
echo "✅ Build successful!"

- name: Set up Docker
run: |
echo "Docker is available in GitHub Actions runners by default"
docker --version

- name: Run tests
working-directory: testcontainers-dotnet/examples
run: |
echo "Running .NET tests..."
# Run tests with verbose output and a timeout since they involve container operations
# Tests will automatically pull required Docker images
dotnet test --no-build --configuration Release --logger "console;verbosity=detailed" --blame-hang-timeout 10m
echo "✅ All tests passed!"
18 changes: 18 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,24 @@ A comprehensive guide for using Testcontainers for Go to write reliable integrat

See the [testcontainers-go skill documentation](./testcontainers-go/SKILL.md) for detailed usage instructions and examples.

### testcontainers-dotnet
Comment thread
mdelapenya marked this conversation as resolved.
A comprehensive guide for using Testcontainers for .NET to write reliable integration tests with Docker containers in .NET projects. This skill provides:

- Support for 40+ pre-configured modules for databases, message queues, cloud services, and more
- Best practices for setting up and managing Docker containers in .NET tests (xUnit, NUnit, MSTest)
- Configuration guidance for networking, volumes, and environment variables
- Proper cleanup and resource management patterns with IAsyncLifetime
- Debugging and troubleshooting techniques

**Key capabilities:**
- Use pre-configured modules (PostgreSQL, SQL Server, Redis, MongoDB, Kafka, and more)
- Write integration tests with real services instead of mocks
- Test against multiple versions or configurations of dependencies
- Create reproducible test environments with Entity Framework Core
- Set up ephemeral test infrastructure

See the [testcontainers-dotnet skill documentation](./testcontainers-dotnet/SKILL.md) for detailed usage instructions and examples.

## Try in Claude Code, Claude.ai, and the API

### Claude Code
Expand Down
21 changes: 21 additions & 0 deletions testcontainers-dotnet/LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
MIT License

Copyright (c) 2025 Testcontainers

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
Loading