TwoFiveThree.Repository 2.0.3

TwoFiveThree.Repository

Core abstractions for the TwoFiveThree repository library. This package provides the base interfaces, classes, and DI registration hooks that provider packages build upon.

Packages

Requirements

• .NET Standard 2.0+ (.NET Framework 4.6.1, .NET Core, .NET 5+)

Installation

dotnet add package TwoFiveThree.Repository

Install a provider alongside it:

dotnet add package TwoFiveThree.Repository.Psql
# or
dotnet add package TwoFiveThree.Repository.MySql

Getting Started

1. Register in DI

using TwoFiveThree.Repository;
using TwoFiveThree.Repository.Psql;

builder.Services.AddRepository(options =>
    options.UsePsql(connectionString));

2. Define your entities

Implement IEntity and decorate with [Table] and [PrimaryKey]:

[Table("products")]
[PrimaryKey("id")]
public class Product : IEntity
{
    public Guid Id { get; set; }
    public string Name { get; set; } = default!;
    public decimal Price { get; set; }
}

3. Inject and use

public class ProductService(IRepository repository)
{
    public async Task<Product?> GetProductAsync(Guid id) =>
        await repository.SelectByIdAsync<Product>([id]);
}

Multiple Connections

If your project requires more than one database connection, use named registrations (.NET 8+):

builder.Services.AddRepository("primary", options =>
    options.UsePsql(primaryConnectionString));

builder.Services.AddRepository("replica", options =>
    options.UsePsql(replicaConnectionString));

builder.Services.AddRepository("migration", options =>
    options.UseMySql(migrationConnectionString));

Inject by name:

public class ProductService(
    [FromKeyedServices("primary")] IRepository primary,
    [FromKeyedServices("replica")] IRepository replica)
{ }

Key Abstractions

IEntity

Marker interface that all entity classes must implement. Enforced at compile time by TwoFiveThree.Repository.Analysers (to be implemented).

IRepository

The main interface for data access. Inject this in your application code — never depend on a concrete provider type.

RepositoryOptions

Used during DI registration to configure which provider to use. Extended by provider packages via extension methods (e.g. UsePsql(), UseMySql()).

Attributes