{"id":31096607,"url":"https://github.com/bjbr-dev/peregrinedb","last_synced_at":"2025-09-16T18:46:36.753Z","repository":{"id":55519942,"uuid":"77636311","full_name":"bjbr-dev/PeregrineDb","owner":"bjbr-dev","description":"CRUD Extensions for Dapper.Net","archived":false,"fork":false,"pushed_at":"2020-12-24T06:19:18.000Z","size":948,"stargazers_count":23,"open_issues_count":13,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-08-16T01:15:32.737Z","etag":null,"topics":["dapper"],"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/bjbr-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-12-29T19:51:35.000Z","updated_at":"2024-07-24T09:33:49.000Z","dependencies_parsed_at":"2022-08-15T02:20:20.252Z","dependency_job_id":null,"html_url":"https://github.com/bjbr-dev/PeregrineDb","commit_stats":null,"previous_names":["berkeleybross/dapper.microcrud","berkeleybross/peregrinedb"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bjbr-dev/PeregrineDb","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bjbr-dev%2FPeregrineDb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bjbr-dev%2FPeregrineDb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bjbr-dev%2FPeregrineDb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bjbr-dev%2FPeregrineDb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bjbr-dev","download_url":"https://codeload.github.com/bjbr-dev/PeregrineDb/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bjbr-dev%2FPeregrineDb/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275465714,"owners_count":25469885,"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-16T02:00:10.229Z","response_time":65,"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":["dapper"],"created_at":"2025-09-16T18:46:34.181Z","updated_at":"2025-09-16T18:46:36.748Z","avatar_url":"https://github.com/bjbr-dev.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PeregrineDb - Lightweight CRUD Extensions for Dapper.Net\n\n\u003ca href=\"https://www.rspb.org.uk/birds-and-wildlife/wildlife-guides/bird-a-z/peregrine\" target=\"_blank\"\u003e\n\u003cimg src=\"https://github.com//berkeleybross/PeregrineDb/raw/master/Peregrine.png\" alt=\"Image of a Peregrine, from the RSPB\"/\u003e\n\u003c/a\u003e\n\nPeregrineDb is a small and fast [Dapper.Net](https://github.com/StackExchange/dapper-dot-net) extension library to perform CRUD statement with POCO models. \n\n[![Build status](https://ci.appveyor.com/api/projects/status/kcepamp69b45xkjj/branch/master?svg=true)](https://ci.appveyor.com/project/berkeleybross/peregrinedb/branch/master)\n\n## Project aims\n\n1. Provide fast and lightweight CRUD extensions for Dapper\n2. Should be able to run against multiple different databases in the same project\n3. Thread safety should be guarenteed\n\nI was using the fantastic [Dapper.SimpleCRUD](https://github.com/ericdc1/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.\n\n## DBMS Support\nCurrently, the following DBMS are supported. More will be added (e.g. SQLite) when there is demand for them:\n\n- Microsoft SqlServer 2012 and above\n- PostgreSQL\n\n## Features\n* Getting Started\n    * [Installing and using](https://github.com/berkeleybross/PeregrineDb/wiki)\n    * [Manual SQL methods](https://github.com/berkeleybross/PeregrineDb/wiki/Manual-SQL-Methods)\n* CRUD Methods\n    * [Creating](https://github.com/berkeleybross/PeregrineDb/wiki/CRUD-Creating): Insert one or many entities, with or without generating a primary key.\n    * [Counting](https://github.com/berkeleybross/PeregrineDb/wiki/CRUD-Counting): Count how many entities match some conditions\n    * [Reading an Entity](https://github.com/berkeleybross/PeregrineDb/wiki/CRUD-Reading-One-Entity): Many overloads for searching for a single entity.\n    * [Reading many Entities](https://github.com/berkeleybross/PeregrineDb/wiki/CRUD-Reading-Many-Entities): Search for any number of entities matching arbitrary conditions. Includes pagination.\n    * [Updating](https://github.com/berkeleybross/PeregrineDb/wiki/CRUD-Updating): Update one or many entities, matched on primary key\n    * [Deleting](https://github.com/berkeleybross/PeregrineDb/wiki/CRUD-Deleting): Delete one, many or all entities\n* [Testing your code](Test-helpers)\n    * DataWiper\n* Contributing\n\nDon't forget, for practical examples of usage, you can also browse our extensive [unit tests suite](tests/PeregrineDb.Tests).\n\n## Comparison\n*NB: These may not be correct nor up-to-date. I made this comparison very quickly*\n\n| Library | Operations | Composite Keys | Async | .Net Core | Notes |\n|---|---|---|---|---|---|\n| [PeregrineDb](https://github.com/berkeleybross/PeregrineDb) | Count\u003cbr\u003eFind/Get\u003cbr\u003eGet(Range/All)\u003cbr\u003eGetPage\u003cbr\u003eInsert(Range)\u003cbr\u003eUpdate(Range)\u003cbr\u003eDelete(Range/All) | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | \u003cul\u003e\u003cli\u003eCan work across multiple DBMS in same project\u003c/li\u003e\u003cli\u003eThrows exceptions for inconsistencies (E.g. Update not affected anything)\u003c/li\u003e\u003c/ul\u003e |\n| [Dapper.Contrib](https://github.com/StackExchange/dapper-dot-net/tree/master/Dapper.Contrib) | Get\u003cbr\u003eGetAll\u003cbr\u003eInsert\u003cbr\u003eUpdate\u003cbr\u003eDelete(All)\u003cbr\u003e| :heavy_check_mark: | :heavy_check_mark: | | \u003cul\u003e\u003cli\u003eCan use interfaces to track changes\u003c/li\u003e\u003c/ul\u003e |\n| [Dapper.Extensions](https://github.com/tmsmith/Dapper-Extensions) | Get\u003cbr\u003eInsert\u003cbr\u003eUpdate\u003cbr\u003eDelete\u003cbr\u003eGetList\u003cbr\u003eGetPage/GetSet\u003cbr\u003eCount | :heavy_check_mark: | | | \u003cul\u003e\u003cli\u003eCan use simple lambdas and predicates\u003c/li\u003e\u003cli\u003eGenerates GUID keys\u003c/li\u003e\u003cli\u003eCan be configured without attributes\u003c/li\u003e\u003c/ul\u003e |\n| [Dapper.FastCRUD](https://github.com/MoonStorm/Dapper.FastCRUD/tree/master/Dapper.FastCrud.Tests) | Insert\u003cbr\u003eGet\u003cbr\u003eFind(Equivalent to GetRange)\u003cbr\u003e(Bulk)Update\u003cbr\u003e(Bulk)Delete\u003cbr\u003eCount | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | \u003cul\u003e\u003cli\u003eHas a nice fluent syntax for complex WHERE operations\u003c/li\u003e\u003cli\u003eCan be configured without attributes\u003c/li\u003e\u003c/ul\u003e |\n| [Dapper.SimpleCRUD](https://github.com/ericdc1/Dapper.SimpleCRUD) | Get\u003cbr\u003eGetList\u003cbr\u003eGetListPaged\u003cbr\u003eInsert\u003cbr\u003eUpdate\u003cbr\u003eDelete(List)\u003cbr\u003eRecordCount | | :heavy_check_mark: | | \u003cul\u003e\u003cli\u003eCan create WHERE clauses from objects\u003c/li\u003e\u003cli\u003eGenerates GUID keys\u003c/li\u003e\u003c/ul\u003e |\n\n## Installation\nSimply add the nuget package [PeregrineDb](https://www.nuget.org/packages/PeregrineDb/) to your project.\n\n## Licensing and Attribution\nThis project can be used and distributed under the [MIT License](LICENSE).\n\nPlease read [Notice](NOTICE.md) for licenses of other projects used by or inspirations of this projects.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbjbr-dev%2Fperegrinedb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbjbr-dev%2Fperegrinedb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbjbr-dev%2Fperegrinedb/lists"}