Dapper.MicroCRUD

CRUD Extensions for Dapper.Net

Description

Dapper.MicroCRUD is a small and fast Dapper.Net extension library to perform CRUD statement with POCO models.

Programming language: C#

License: MIT License

Tags: ORM     SQL     PostgreSQL     Micro-orm     Dapper     POCO     Crud    

README

PeregrineDb - Lightweight CRUD Extensions for Dapper.Net

PeregrineDb is a small and fast Dapper.Net extension library to perform CRUD statement with POCO models.

Project aims

1. Provide fast and lightweight CRUD extensions for Dapper
2. Should be able to run against multiple different databases in the same project
3. Thread safety should be guarenteed

I was using the fantastic Dapper.SimpleCRUD library and found it incredibly easy to use. However, two things drove me to write this library - I have a project which uses SqlServer and Postgres databases side-by-side, and unfortunately Dapper.SimpleCRUD does not support this. Second, I found it was missing a few crucial optimizations which was doubling the time taken to easily insert many rows.

DBMS Support

Currently, the following DBMS are supported. More will be added (e.g. SQLite) when there is demand for them:

• Microsoft SqlServer 2012 and above
• PostgreSQL

Features

• Getting Started
  • Installing and using
  • Manual SQL methods
• CRUD Methods
  • Creating: Insert one or many entities, with or without generating a primary key.
  • Counting: Count how many entities match some conditions
  • Reading an Entity: Many overloads for searching for a single entity.
  • Reading many Entities: Search for any number of entities matching arbitrary conditions. Includes pagination.
  • Updating: Update one or many entities, matched on primary key
  • Deleting: Delete one, many or all entities
• [Testing your code](Test-helpers)
  • DataWiper
• Contributing

Don't forget, for practical examples of usage, you can also browse our extensive [unit tests suite](tests/PeregrineDb.Tests).

Comparison

NB: These may not be correct nor up-to-date. I made this comparison very quickly

Library	Operations	Composite Keys	Async	.Net Core	Notes
PeregrineDb	CountFind/GetGet(Range/All)GetPageInsert(Range)Update(Range)Delete(Range/All)	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	Can work across multiple DBMS in same projectThrows exceptions for inconsistencies (E.g. Update not affected anything)
Dapper.Contrib	GetGetAllInsertUpdateDelete(All)	:heavy_check_mark:	:heavy_check_mark:		Can use interfaces to track changes
Dapper.Extensions	GetInsertUpdateDeleteGetListGetPage/GetSetCount	:heavy_check_mark:			Can use simple lambdas and predicatesGenerates GUID keysCan be configured without attributes
Dapper.FastCRUD	InsertGetFind(Equivalent to GetRange)(Bulk)Update(Bulk)DeleteCount	:heavy_check_mark:	:heavy_check_mark:	:heavy_check_mark:	Has a nice fluent syntax for complex WHERE operationsCan be configured without attributes
Dapper.SimpleCRUD	GetGetListGetListPagedInsertUpdateDelete(List)RecordCount		:heavy_check_mark:		Can create WHERE clauses from objectsGenerates GUID keys

Installation

Simply add the nuget package PeregrineDb to your project.

Licensing and Attribution

This project can be used and distributed under the [MIT License](LICENSE).

Please read [Notice](NOTICE.md) for licenses of other projects used by or inspirations of this projects.