https://github.com/TortugaResearch/DotNet-ORM-Cookbook

This repository is meant to show how to perform common tasks using C# with variety of ORMs.
https://github.com/TortugaResearch/DotNet-ORM-Cookbook

Last synced: about 2 months ago
JSON representation

This repository is meant to show how to perform common tasks using C# with variety of ORMs.

• Host: GitHub
• URL: https://github.com/TortugaResearch/DotNet-ORM-Cookbook
• Owner: TortugaResearch
• License: unlicense
• Created: 2016-10-27T00:43:53.000Z (about 8 years ago)
• Default Branch: main
• Last Pushed: 2024-07-08T14:25:30.000Z (6 months ago)
• Last Synced: 2024-07-31T09:08:58.071Z (5 months ago)
• Language: C#
• Homepage: https://tortugaresearch.github.io/DotNet-ORM-Cookbook/
• Size: 6.9 MB
• Stars: 337
• Watchers: 17
• Forks: 28
• Open Issues: 101
• Metadata Files:
  • Readme: README.md
  • Changelog: Changelog.md
  • Contributing: CONTRIBUTING.md
  • License: License.txt

Awesome Lists containing this project

• awesome - TortugaResearch/DotNet-ORM-Cookbook - This repository is meant to show how to perform common tasks using C# with variety of ORMs. (C\#)

README

        
# The .NET ORM Cookbook

In October of 2016, InfoQ published a series of articles on the repository pattern in .NET. To illustrate the concepts, three ORMs were demonstrated:  Entity Framework, Dapper, and Chain. 

A criticism of the articles was that it didn't include many people's favorite ORM. So as a follow up, this GitHub repository was created to expand on that idea and create a shared "cookbook" of design patterns for any or all of the .NET ORMs. Contributions are welcome.

With this in mind, we'd like to present [The ORM Cookbook](https://tortugaresearch.github.io/DotNet-ORM-Cookbook/)

## History

In December of 2019, the ORM Cookbook project was revived with an emphasis on modern, production grade programming. This means that each example must take into consideration these factors:

* Exception handling

* .NET Core Support

* C# 8 Nullable Reference Types

* Static Code Analysis (e.g. FxCopAnalyzers)

### Original InfoQ Articles

* [Implementation Strategies for the Repository Pattern with Entity Framework, Dapper, and Chain](https://www.infoq.com/articles/repository-implementation-strategies)

* [Advanced Use Cases for the Repository Pattern in .NET]( https://www.infoq.com/articles/repository-advanced)

## Presentation

Each ORM is presented as its own test project. The actual recipes are in the Models and Repositories folder. 

To ensure each ORM is "playing by the rules", a shared set of tests will be used. The tests are arranged into "scenario" classes. Each ORM can opt in for a given scenario by inheriting from the appropriate class. This can be done multiple times if the ORM wishes to demonstrate alternate patterns.

Each scenario has a matching markdown file in which the code samples can be added along with any relevant explanations. When possible, use [Projbook]( http://defrancea.github.io/Projbook/) notation to inline code samples. This will prevent the code samples from getting out of sync with the documentation.

If you build the "Documentation" project, the cookbook will be compiled as a website file. 

## Supporting Documents

* [Change Log](Changelog.md)

* [Contributing](CONTRIBUTING.md)

* [License](License.txt)