https://github.com/sdrapkin/securitydriven.tinyorm

.NET micro ORM done right.
https://github.com/sdrapkin/securitydriven.tinyorm

micro-orm mssql orm sql sql-server

Last synced: 6 days ago
JSON representation

.NET micro ORM done right.

• Host: GitHub
• URL: https://github.com/sdrapkin/securitydriven.tinyorm
• Owner: sdrapkin
• License: ms-pl
• Created: 2017-01-04T21:54:47.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2024-05-15T22:22:24.000Z (7 months ago)
• Last Synced: 2024-12-05T02:22:13.575Z (17 days ago)
• Topics: micro-orm, mssql, orm, sql, sql-server
• Language: C#
• Size: 306 KB
• Stars: 305
• Watchers: 23
• Forks: 20
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md
  • Codeowners: .github/CODEOWNERS
  • Security: SecurityDriven.TinyORM.Tests/App.config

Awesome Lists containing this project

README

        
![TinyORM](TinyORM-Logo.png "TinyORM")

# Simple, fast, and secure micro ORM for .NET [![NuGet](https://img.shields.io/nuget/v/TinyORM.svg)](https://www.nuget.org/packages/TinyORM/)

**TinyORM** by [Stan Drapkin](https://github.com/sdrapkin "Stan Drapkin") [sdrapkin at sdprime dot com]

## [Documentation](https://github.com/sdrapkin/SecurityDriven.TinyORM/wiki): [wiki](https://github.com/sdrapkin/SecurityDriven.TinyORM/wiki) ##

## Features: ##

1.  Focused on **SQL Server** (any `SqlClient`-based db engine). [Azure SQL](https://docs.microsoft.com/en-us/azure/sql-database/sql-database-technical-overview) is supported as well.

2.  **Intuitive, tiny, simple API**. This is usually the hardest part for libraries to get right.

3.  **Does not obscure or reinvent `T-SQL`**. If you prefer APIs that hide `T-SQL` incompetence, look [elsewhere](https://en.wikipedia.org/wiki/Entity_Framework).

4.  **Very fast.** As fast as competition (`Dapper`, `OrmLite`, `LLBLGen`, `EF Core`, etc. [benchmarks](https://gist.github.com/sdrapkin/c2d310e0f42b18d8f2beae789294faa8)). 

5.  **Seamlessly transactional** and **safe**. Transactions are not merely supported - they are the default.

	* [`XACT_ABORT=ON`](https://docs.microsoft.com/en-us/sql/t-sql/statements/set-xact-abort-transact-sql) (automatic transaction rollback on runtime T-SQL errors).

	* Custom transaction scopes are declared via standard `TransactionScope` instance (created via `TinyORM`.`DbContext`.`CreateTransactionScope()` factory).

6.  **Transparent connection management**. One less thing to worry about and screw up. Never think about connections again.

7.  `Task`-based `async` API (ie. *the* API). All calls are buffered (focus on safety and fast connection release).

8.  **POCOs** or `anonymous` objects are fine. No inheritance, interface, or attribute requirements.

9.  Returns `dynamic` entities which can be consumed directly, or projected to statically-typed objects (*fast!*).

	* Either strict (perfect-match) or relaxed (best-effort) projection of `dynamic` to statically-typed objects.

10. Full **parameterization**, with parameter list expansion (ex. `WHERE Id IN (@IdList)`). This also helps prevent SQL injection.

	* `CHAR`, `VARCHAR`, `NCHAR`, `NVARCHAR` support for `string` parameters. 

11. Single or multiple Result Sets.

12. **Snapshots** provide change-tracking, with `UPDATE` `T-SQL` generation for partial updates.

13. Intelligent **batched \*bulk\* command sequences** via `QueryBatch` (not just for `INSERT` - for all `CREATE/UPDATE/DELETE/MERGE` commands).

14. **Streaming data-out** support (ex. streaming out `BLOBs`/files).

15. **Auditing**

	* Caller identity tracking (*which user made the call?*).

	* Callsite tracking (*which source code filename, method, and line# made the call?*).

16. Helpers for `CREATE`, `UPDATE`, `DELETE`, and `UPSERT` `T-SQL` generation.

17. `SequentialGuid` generator for **fragmentation-free**, **unique**, **unguessable**, **code-generated** clustered `uniqueidentifier` indexes.

18. c# 10.0 in `safe` mode. Compiled `any cpu` for .NET 4.5.2+ and NetStandard 2.0/.NET Core 2.0+.

19. Tiny codebase. Tiny ~45k `.dll`.

20. `TinyORM` on [NuGet](https://www.nuget.org/packages/tinyorm) (`Install-Package TinyORM`).

21. **MS-PL** ([Microsoft Public](LICENSE.md)) license. If MS-PL does not suit you, contact me.

If you are serious about SQL Server, give **TinyORM** a try (even if you're a `Dapper` fan).

## Simple TinyORM query ##

```csharp

var db = DbContext.Create(connString);

var query = await db.QueryAsync("select [Answer] = @a + @b", new { @a = 123, @b = 2 });

Console.WriteLine(query.First().Answer); // prints "125"

static string connString = "Data Source=.\\SQL2012; Initial Catalog=tempdb; Integrated Security=True;";

```

## ##

Nature graphic by [Freepik](http://www.flaticon.com/authors/freepik) is licensed under [CC BY 3.0](http://creativecommons.org/licenses/by/3.0/).