{"id":31322820,"url":"https://github.com/danielsen/transientcontext","last_synced_at":"2025-09-25T19:16:37.184Z","repository":{"id":53347339,"uuid":"163526309","full_name":"danielsen/TransientContext","owner":"danielsen","description":"Transient database contexts for integration testing","archived":false,"fork":false,"pushed_at":"2024-05-09T15:27:21.000Z","size":25,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-08-24T23:55:22.575Z","etag":null,"topics":["database","disposable-databases","entityframeworkcore","nunit","nunit-tests","postgresql","postgresql-database","sqlite","sqlite-database","xunit","xunit-tests"],"latest_commit_sha":null,"homepage":null,"language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/danielsen.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":["danielsen"]}},"created_at":"2018-12-29T16:49:15.000Z","updated_at":"2022-08-04T18:10:51.000Z","dependencies_parsed_at":"2022-09-19T23:52:10.929Z","dependency_job_id":null,"html_url":"https://github.com/danielsen/TransientContext","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/danielsen/TransientContext","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielsen%2FTransientContext","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielsen%2FTransientContext/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielsen%2FTransientContext/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielsen%2FTransientContext/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/danielsen","download_url":"https://codeload.github.com/danielsen/TransientContext/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielsen%2FTransientContext/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":276966958,"owners_count":25736900,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-25T02:00:09.612Z","response_time":80,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["database","disposable-databases","entityframeworkcore","nunit","nunit-tests","postgresql","postgresql-database","sqlite","sqlite-database","xunit","xunit-tests"],"created_at":"2025-09-25T19:16:35.980Z","updated_at":"2025-09-25T19:16:37.178Z","avatar_url":"https://github.com/danielsen.png","language":"C#","readme":"# TransientContext\n\n`TransientContext` is a simple tool for creating transient or disposable databases for integration\ntesting. During integration testing `TransientContext` can be used to create a disposable database\nfrom an existing schema and drop the database after tests are complete. `TransientContext` supports\nPostgreSQL and SQLite databases.\n\n### Packages\n\n- Current Version: `1.2.0`\n- Target Framework: `.NET Standard 2.0`\n\n### Dependencies\n\n- [Npgsql](https://www.nuget.org/packages/Npgsql)\n- [System.Data.SQLite](https://www.nuget.org/packages/System.Data.SQLite/)\n- [Microsoft.Extensions.Configuration](https://www.nuget.org/packages/Microsoft.Extensions.Configuration/2.2.0)\n\n### Development Dependencies\n\n- [Microsoft.EntityFrameworkCore](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore/2.2.0)\n- [Microsoft.EntityFrameworkCore.Sqlite](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore.Sqlite/2.2.6)\n- [Microsoft.Extensions.Configuration.Json](https://www.nuget.org/packages/Microsoft.Extensions.Configuration.Json/2.2.0)\n- [Microsoft.Extensions.Configuration.UserSecrets](https://www.nuget.org/packages/Microsoft.Extensions.Configuration.UserSecrets/2.2.0)\n- [Microsoft.NET.Test.Sdk](https://www.nuget.org/packages/Microsoft.NET.Test.Sdk/15.9.0)\n- [Npgsql.EntityFrameworkCore.PostgreSQL](https://www.nuget.org/packages/Npgsql.EntityFrameworkCore.PostgreSQL/2.2.0)\n- [Xunit](https://www.nuget.org/packages/xunit/)\n- [Xunit.runner.visualstudio](https://www.nuget.org/packages/xunit.runner.visualstudio/)\n- [NUnit](https://www.nuget.org/packages/NUnit/)\n- [NUnit3TestAdapter](https://www.nuget.org/packages/NUnit3TestAdapter/)\n\n### Examples and Usage\n\nThe examples below are taken directly from `TransientContext.Tests.NUnit` and `TransientContext.Tests.Xunit`. In\nthe PostgreSQL examples connection strings are stored in user secrets files as described in the [Microsoft documentation](https://docs.microsoft.com/en-us/aspnet/core/security/app-secrets?view=aspnetcore-2.2\u0026tabs=linux).\n\n### NUnit Usage\n\n1. Begin by creating a database fixture. In the example below, `DomainContext` represents\nthe `EntityFramework` `DBContext` that is being created. For reference, see `TransientContext.Tests.NUnit/Common/Data/DomainContext.cs`.\n\n\t    public class DatabaseFixture : IDisposable\n\t    {\n\t        public DatabaseFixture()\n\t        {\n\t            var configuration = new ConfigurationBuilder()\n\t                .AddUserSecrets(\"your-secret-guid\")\n\t                .Build();\n\t\n\t            TestDatabase = new TestDatabaseBuilder()\n\t                .WithConfiguration(configuration)\n\t                .Build();\n\t\t\t\t\n\t\t\t\t/* Or for SQLite \n\t\t\t\t * \n            \t * TestDatabase = new TestDatabaseBuilder()\n                 *     .WithConnectionString(\"Data Source=domain.db\")\n                 *      .Build();\n                 */\n\n\t            TestDatabase.Create();\n\n\t            var builder = new DbContextOptionsBuilder\u003cDomainContext\u003e()\n\t                .UseNpgsql(TestDatabase.ConnectionString);\n\t            DbContext = new DomainContext(builder.Options);\n\t            DbContext.Database.EnsureCreated();\n\t        }\n        \n\t        public ITestDatabase TestDatabase { get; }\n\t        public DomainContext DbContext { get;  }\n        \n\t        public void Dispose()\n\t        {\n\t            TestDatabase.Drop();\n\t        }\n\t    }\n\n2. Add the `DatabaseFixture` as part of the `SetUp` and `TearDown` methods in your test fixtures.\n\n\t    [TestFixture]\n\t    public class DomainContextTests\n\t    {\n\t        private DatabaseFixture _fixture;\n\t        private DomainContext _domainContext;\n\n\t        [SetUp]\n\t        public void Setup()\n\t        {\n\t            _fixture = new DatabaseFixture();\n\t            _domainContext = _fixture.DbContext;\n\t        }\n\n\t        [TearDown]\n\t        public void Teardown()\n\t        {\n\t            _fixture.Dispose();\n\t        }\n\n\t        private async Task\u003cUser\u003e AddEntity()\n\t        {\n\t            var entity = await _domainContext.Users.AddAsync(new User\n\t            {\n\t                Username = \"Alice\"\n\t            });\n\t            await _domainContext.SaveChangesAsync();\n\t            return entity.Entity;\n\t        }\n\n\t        [Test]\n\t        public async Task should_add_entity()\n\t        {\n\t            var user = await AddEntity();\n\n\t            var count = await _domainContext.Users.CountAsync();\n\t            Assert.NotNull(user.Id);\n\t            Assert.AreEqual(1, count);\n\t        }\n\t\t}\n\n### XUnit Usage\n\nThe examples below assume XUnit as the testing framework. These examples are taken directly\nfrom `TransientContext.Tests.Xunit`.\n\n1. Begin by creating a database fixture. In the example below, `DomainContext` represents\nthe `EntityFramework` DBContext that is being created. For reference, see `TransientContext.Tests.NUnit/Common/Data/DomainContext.cs`.\n\n\t    public class DatabaseFixture : IDisposable\n\t    {\n\t        public DatabaseFixture()\n\t        {\n\t            var configuration = new ConfigurationBuilder()\n\t               .AddUserSecrets(\"your-secret-guid\")\n\t                .Build();\n\t            TestDatabase = new TestDatabaseBuilder()\n\t                .WithConfiguration(configuration)\n\t                .Build();\n\t            TestDatabase.Create();\n\n\t            var builder = new DbContextOptionsBuilder\u003cDomainContext\u003e();\n\t            builder.UseNpgsql(TestDatabase.ConnectionString);\n\t            DbContext = new DomainContext(builder.Options);\n\t            DbContext.Database.EnsureCreated();\n\t        }\n\n\n\t        public ITestDatabase TestDatabase { get; }\n\n\t        public DomainContext DbContext { get; }\n\n\t        public void Dispose()\n\t        {\n\t            TestDatabase.Drop();\n\t        }\n\t    }\n\n\t    [CollectionDefinition(\"Database\")]\n\t    public class DatabaseCollectionFixture : ICollectionFixture\u003cDatabaseFixture\u003e\n\t    {\n\t    }\n\n2. Add the `DatabaseFixture` as part of a test class constructor.\n\n\t    [Collection(\"Database\")]\n\t\tpublic class UserTests\n\t\t{\n\t\t\tprivate readonly TestDbContext _testDbContext;\n\n\t\t\tpublic UserTests(DatabaseFixture databaseFixture)\n\t\t\t{\n\t\t\t\t_testDbContext = databaseFixture.DbContext;\n\t\t\t}\n\n\t\t\t[Fact]\n\t\t\tpublic async Task InsertUsers()\n\t\t\t{\n\t\t\t\tawait _testDbContext.Users.AddAsync(new User {Username = \"Alice\"});\n\t\t\t\tawait _testDbContext.Users.AddAsync(new User {Username = \"Jane\"});\n\t\t\t\tawait _testDbContext.SaveChangesAsync();\n\n\t\t\t\tvar count = await _testDbContext.Users.CountAsync();\n\t\t\t\tAssert.Equal(2, count);\n\t\t\t}\n\t\t}\n","funding_links":["https://github.com/sponsors/danielsen"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanielsen%2Ftransientcontext","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdanielsen%2Ftransientcontext","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanielsen%2Ftransientcontext/lists"}