ReflectionFactory 1.0.1

CommunityToolkit.ReflectionFactory

Overview

CommunityToolkit.ReflectionFactory is a C# library that provides a reflection-based factory for creating instances of classes marked with a custom attribute. This library is useful for scenarios where you need to dynamically create instances of classes at runtime based on certain criteria.

Features

• Dynamic Instance Creation: Create instances of classes dynamically using reflection.
• Custom Attributes: Use custom attributes to mark classes that can be instantiated by the factory.
• Flexible Configuration: Configure the factory with module paths, assembly names, and type names.

Installation

To install the library, you can use NuGet Package Manager:

dotnet add package ReflectionFactory

Usage

Defining Classes with FactoryAttribute

First, define your classes and mark them with the FactoryAttribute:

using CommunityToolkit.ReflectionFactory;

[FactoryAttribute("Dog")]
public class Dog
{
    // Class implementation
}

[FactoryAttribute("Cat")]
public class Cat
{
    // Class implementation
}

Creating Instances with ReflectionFactory

Use the ReflectionFactory to create instances of your classes:

using CommunityToolkit.ReflectionFactory;

var dogFactory = new ReflectionFactory<Dog>();
var catFactory = new ReflectionFactory<Cat>();

var dog = dogFactory.GetInstance();
var cat = catFactory.GetInstance();

Unit Testing

You can write unit tests to verify the functionality of your factory:

using NUnit.Framework;
using CommunityToolkit.ReflectionFactory;

namespace TestProject
{
    public class ReflectionFactoryTests
    {
        [Test]
        public void GetInstance_ShouldReturnInstance()
        {
            // Arrange
            var dogFactory = new ReflectionFactory<Dog>();
            var catFactory = new ReflectionFactory<Cat>();

            // Act
            var dog = dogFactory.GetInstance();
            var cat = catFactory.GetInstance();

            // Assert
            Assert.IsNotNull(dog);
            Assert.IsInstanceOf<Dog>(dog);
            Assert.IsNotNull(cat);
            Assert.IsInstanceOf<Cat>(cat);
        }
    }
}

Contributing

Contributions are welcome! Please open an issue or submit a pull request on GitHub.

License

This project is licensed under the MIT License. See the LICENSE file for details.