FakeStore.Database 1.0.0

FakeStoreDatabase Project

The FakeStoreDatabase project provides a static database of fake data for use in other projects. This fake database includes simulated information for users, products, and categories, which can be useful for testing and development without the need to access a real database.

Installation via NuGet

To install the FakeStoreDatabase package via NuGet, you can use the Package Manager Console in Visual Studio or the .NET CLI. Here's how to do it:

Package Manager Console

Install-Package FakeStore.Database

.NET CLI

dotnet add package FakeStore.Database

Configuration

To use the fake database in your project, follow these steps:

1. Installation: Add a reference to the FakeStoreDatabase project in your solution or project.
2. Dependency Injection: In your startup configuration file (Startup.cs or similar), add the following code to configure and use the fake database:

csharpCopy code
builder.Services.UseFakeStoreDatabase(new FakeDatabaseConfigurator()
{
    UsersConfiguration = new UsersConfigurator()
    {
        MaxDefaultUsers = 10,
        NullProbability = 0.1f
    },
    ProductsConfiguration = new ProductsConfigurator()
    {
        MaxProducts = 100,
        MaxPrice = 1000,
        MinPrice = 100,
        NullProbability = 0.3f
    },
    CategoriesConfiguration = new CategoriesConfigurator()
    {
        MaxCategories = 10,
        NullProbability = 0.2f
    }
});

1. Public Methods: To access the fake database, use the following methods provided by the IFakeStoreDatabase interface:

List<FakeUser> GetUsers()

This method returns a list of fake users, generating them if they do not already exist. If the users have already been generated previously, the function will return the existing list. Each fake user is represented by a FakeUser object.

List<FakeProduct> GetProducts()

This method returns a list of fake products, retrieving them from the database generator if they have not been retrieved before. If the products have already been generated previously, the function will return the existing list. Each fake product is represented by a FakeProduct object.

List<FakeCategory> GetCategories()

This method returns a list of fake categories, generating them if they do not already exist. If the categories have already been generated previously, the function will return the existing list. Each fake category is represented by a FakeCategory object.

Working with Relationships between Collections

The FakeStoreDatabase project is currently under development to provide more advanced functionality for handling relationships between different collections, such as users, products, and categories. The goal is to improve the way fake data can interact with each other to simulate more realistic scenarios.

While this functionality is still in development, you can use LINQ (Language Integrated Query) to work with relationships between existing collections. LINQ is a powerful tool in C# that allows you to perform queries and operations on collections in an elegant and expressive way.

Below is an example of how to perform a join based on the CategoryId between the categories and products collections:

csharpCopy code
List<FakeCategory> categories = _FakeStoredDb.GetCategories();
List<FakeProduct> products = _FakeStoredDb.GetProducts();

// Perform the join based on CategoryId
var joinedData = categories
    .Join(products,
        category => category.CategoryId,
        product => product.CategoryId,
        (category, product) => new
        {
            Category = category,
            Product = product
        })
    .ToList();

In this example, we are joining the categories and products collections using the Join clause of LINQ, where we specify how to compare the elements of both collections based on the CategoryId. We then project the results into a new collection that contains both the category and the related product.

Example: Getting Product Names for a Specific CategoryId

Let's say we want to get the product names for a specific CategoryId (e.g., categoryIdToFilter = 1):

csharpCopy code
int categoryIdToFilter = 1;
var productsWithCategoryId = joinedData
    .Where(data => data.Category.CategoryId == categoryIdToFilter)
    .Select(data => data.Product.Name)
    .ToList();

In this example, we use the Where clause to filter the elements in joinedData where the CategoryId of the category matches the categoryIdToFilter. We then use Select to project only the names of the products related to the filtered category.

Note: As the functionality for handling relationships is developed in the project, specific methods and utilities are expected to be added to work with relationships more easily and efficiently.

License

This project is distributed under the MIT license. See the LICENSE file for more details.

If you find it useful, consider supporting the project by making a donation via PayPal:

Support in Paypal ♥️

Enjoy using FakeStoreDatabase in your project! If you have any questions or need assistance, do not hesitate to contact the development team.