Homura 14.1.0

dotnet add package Homura --version 14.1.0
                    
NuGet\Install-Package Homura -Version 14.1.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Homura" Version="14.1.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Homura" Version="14.1.0" />
                    
Directory.Packages.props
<PackageReference Include="Homura" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Homura --version 14.1.0
                    
#r "nuget: Homura, 14.1.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Homura@14.1.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Homura&version=14.1.0
                    
Install as a Cake Addin
#tool nuget:?package=Homura&version=14.1.0
                    
Install as a Cake Tool

Homura - C# ORM

Product Compatible and additional computed target framework versions.
.NET net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
14.1.0 214 5/12/2026
14.0.1 181 3/12/2026
14.0.0 150 3/11/2026
13.0.0 258 12/23/2025
12.0.1 432 11/21/2025
11.1.1 459 4/7/2024
11.1.0 294 4/7/2024
11.0.1 356 1/4/2024
11.0.0 283 1/2/2024
10.0.1 322 11/17/2023
9.10.0 273 11/5/2023
9.9.0 262 11/1/2023
9.8.5 315 8/17/2023
9.8.4 276 8/17/2023
9.8.3 295 8/17/2023
9.8.2 297 8/14/2023
9.8.1 297 8/14/2023
9.8.0 279 8/14/2023
9.7.1 320 8/6/2023
9.7.0 295 8/5/2023
Loading failed

v14.1.0: Major read-path overhaul. Generated and non-generated DAOs now both reach Dapper-class throughput.

New APIs (Source Generator emits these on entities with primary keys):
- Task<E> FindByPrimaryKeyAsync(pk..., conn, timeout) — strongly-typed positional args, const SQL, no Dictionary allocation
- Task<int> DeleteByPrimaryKeyAsync(pk..., conn, timeout) — same pattern for deletes

Source Generator additions:
- SELECT fast path: const SQL template plus a ToEntityFast override using literal ordinals and typed reader.GetXxx calls (skips SafeGet wrapping)
- FindBy / Delete fast path: per-DAO ConcurrentDictionary cache of SQL keyed by the sorted key set; the Dictionary entry point routes through it before the QueryBuilder fallback
- DeleteAll const SQL

Core runtime improvements:
- Dao<E>.Table now caches the Table<E> instance; EntityVersionType setter invalidates the cache
- EntityReaderCache<E> compiles a per-(type, version) Func<IDataRecord, ITable, E> via Expression trees, replacing the per-row reflection loop (DelegateCache lookups, GetInterfaces probes, CatchThrow closures) in ToEntityInDefaultWay
- ConcurrentDictionary cache for Type.GetType(assemblyQualifiedName); SafeGetType also fixes a latent DBNull bug
- QueryBuilder switches Relay from per-step List copy to a lazily-materialized parent-pointer chain; Merge replaces builder.ToString() per iteration with HasContent + LastCharIsSpace flags and caches Represent() per call
- s_logger is a static readonly Logger field; Debug calls that build parameter strings are now guarded by IsDebugEnabled
- OverridedColumns.Count replaces null-check + LINQ Any() in every fast-path guard

Public surface:
- IColumn gains a PropertyInfo accessor (used by the compiled reader). External implementations of IColumn need to add it.
- Dao<E>.s_logger visibility changed from private to protected so generated subclasses can guard their Debug calls.

Benchmark highlights (AMD Ryzen 9 5950X, SQLite, .NET 9):
- Select 1000 rows, non-generated DAO: 11.6 ms / 5.9 MB -> 2.6 ms / 557 KB
- Select 1000 rows, generated DAO: 2.4 ms / 836 KB -> 1.8 ms / 436 KB (matches Dapper)
- FindBy 1000 PK lookups, Typed PK: 158 ms / 2316 KB (beats Dapper at 159 ms / 2495 KB on both axes)

All 197 existing tests pass plus 3 new TypeCacheTest cases.