Tildom.Libraries.MongoDb 8.0.1

Prefix Reserved
.NET 6.0 This package targets .NET 6.0. The package is compatible with this framework or higher. 
dotnet add package Tildom.Libraries.MongoDb --version 8.0.1                

                    
                

            
NuGet\Install-Package Tildom.Libraries.MongoDb -Version 8.0.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Tildom.Libraries.MongoDb" Version="8.0.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
paket add Tildom.Libraries.MongoDb --version 8.0.1                

                    
                

            
#r "nuget: Tildom.Libraries.MongoDb, 8.0.1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
// Install Tildom.Libraries.MongoDb as a Cake Addin
#addin nuget:?package=Tildom.Libraries.MongoDb&version=8.0.1

// Install Tildom.Libraries.MongoDb as a Cake Tool
#tool nuget:?package=Tildom.Libraries.MongoDb&version=8.0.1

Tildom.Libraries.MongoDb is a wrapper library around the Official MongoDb Dotnet library. It utilises a unified repository approach making it simpler to consume the office library.

Please Read: But Why?

The official MongoDb library is good. That's why we wrapped around it. The decision on a layer of abstraction is purely for convenience. You should at least learn about what the office library. If you are happy with that, that should be it. Avoiding another layer of abstraction is quite often a good thing. Obviously, we have added more convenience such as easier DI, a unified repo pattern, a named factory and so on. Not trying to undersell the library, but be considerate when you introduce more dependencies and abstraction to your codebase.

Entity Framework for MongoDb

In many cases and where it is suitable, you are better off using the Entity Framework for MongoDb, especially if you already use EF Core for your data context layer. This library is not competing with EF Core, but rather provides a somewhat different approach to it.

A Note on Versioning

This and most other Tildom domain libraries are versioned following their minimum-supported .NET version as the primary version number. In the case of 6.0.0, this means the library supports .NET 6 and onwards. It is always a LTS version of the .NET, such as 6, 8 and so on. The secondary version number is the major version of the library itself (feature flag). The third version number is the minor version of the library itself (fix flag).

If you are using these libraries, you can easily tell which version to use based on the .NET version you are targeting. For example, if you are using .NET 6, you should use Tildom.Core 6.0.0. If you are on Tildom.Core 6.1.20 and 6.2.1 is available, you should be careful with updating since breaking changes could have been introduced.

When Is A Version Deprecated

A shorter cycle is applied to this process compared to Microsoft's LTS support schedule. Libraries are hopefully updated to a new .NET version when a STS version is released. For instance, currently .NET 8.0 has just been released, in which case, the libraries would support the previous LTS version = .NET 6.0. When .NET 9.0 is released in 2024, the libraries would be updated to support .NET 8.0. But when in 2025, another LTS version is released, the libraries would still support .NET 8.0.

Contribution

Feel free to contribute by submitting pull requests or creating issues.

License

This project is licensed under the MIT License.

Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
8.0.1 37 11/22/2024