Skip to content

marcin-brzozowski/RepoDb

 
 

Repository files navigation


SolutionBuilds Version Releases UnitTests IntegrationTests GitterChat

RepoDB - a hybrid ORM Library for .NET.

RepoDB is an open-source .NET ORM library that bridges the gaps of micro-ORMs and full-ORMs. It helps you simplify the switch-over of when to use the BASIC and ADVANCE operations during the development.

It is your best alternative ORM to both Dapper and EntityFramework.

👋 Hey Scott, thank you for endorsing RepoDB into the community of .NET.

Benefits/Advantages

Like with any other ORMs, RepoDB does provide the preliminary methods needed for your basic operations (i.e.: CRUD). The good thing is, RepoDB also does provide the operations that is needed to cater your edge-cases like 2nd-Layer Cache, Tracing, Repositories, Property Handlers and Batch/Bulk Operations.

If you are to use RepoDB, your development experience is as simple as Dapper when opening a connection and is as simple as Entity Framework when executing an operation. It is the reason that makes this library the simpliest ORM to use.

When you do the bulk operations, the generated value of the identity columns will be set back to the data models, just right after your execution. It is an important use-case that is/may needed by you and/or most developers, and both the BulkInsert and BulkMerge operations addressed this need.

RepoDB also does support the different way-of-executions (the atomic, the batch and the bulk). Through this, it is easy for you to establish your repository that can process the smallest-to-the-largest datasets without even affecting the efficiency and the performance of your application.

Important Attributes

Easy-to-use - the operations were all implemented as extension methods of your IDbConnection object. For as long your connection is open, any operations can then be called against your database.

High performant - it caches the already-generated compiled expressions for future reusabilities and executions. It understands your schema to create the most optimal compiled expression AOT.

Memory efficient - it extracts and caches your object properties, execution contexts, object mappings and SQL statements. It is reusing them all throughout the process of transformations and executions.

High quality - it is a high-quality micro-ORM supported by 10K+ real-life Unit and Integration Tests. It is highly tested and is used by various critical systems that are running in the Production environment.

Get Started

Please click any of the link below to fast-track your learnings.

Or, learn a specific feature.

Otherwise, please visit our documentation page to learn more.

Supported Databases

The execute methods below support all the RDBMS data providers.

Whereas the fluent methods below only support the SQL Server, SQLite, MySQL and PostgreSQL RDBMS data providers.

Click here to see all the operations.

.NET Type Coercion

By default, RepoDB does not do the automatic .NET CLR Type conversion during the serialization and deserialization process. The coercion support is completely dependent to the ADO.NET coercion capability.

It is in purpose to strictly notify you (as a library user) the design and/or the implementation problem of the Model if being compared to its corresponding database Table.

If you wish to have an automatic conversion, simply set the Converter.ConversionProperty property to Automatic.

RepoDb.Converter.ConversionType = ConversionType.Automatic;

Note: The exception that is being thrown is dependent to what the underlying ADO.NET coercion exception. If the Automatic conversion is used, the extracted value will always be evaluated and an additional conversion logic will be used (if needed). The conversion logic is through the AOT compilation of System.Linq.Expressions.Expression.Convert and/or System.Convert.

Library Limitations

It is very important for you and to the community of .NET to learn the things the library is capable and is-not capable of doing, so please spend time reading the limitation page before using the library.

Benchmark

The benchmark result shown on this section is the result of the community-approved ORM bencher tool, the RawDataAccessBencher tool.

Below is the actual recent official execution result.

Contributions

We would like to make RepoDB the mainstream hybrid-ORM library for .NET technology. Please help us build and realize the solution.

To contribute, please find a for-grabs item and issue a PR. Or, you may otherwise create a new issue for us to look-at and discuss.

If you wish to contribute to the documentation site, it is hosted in the RepoDb.NET repository. Your expertise is needed to correct the forms, if needed.

Your biggest contribution is to utilize and share this library to the other developers.

  • Blog it
  • Discuss it
  • Document it
  • Share it
  • Use it

Or, show your support by simply giving a ⭐ on this project.

Engagements

Please get in touch with us via:

Hints

Credits

Thanks to all the contributors of this project, and to Scott Hanselman for Exploring the .NET open source hybrid ORM library RepoDB.

And also, thanks to these awesome OSS projects.

License

Apache-2.0 - Copyright © 2019 - Michael Camara Pendon

About

A hybrid ORM library for .NET.

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 100.0%