ControllerGenerator.Abstraction 1.1.0

ControllerGenerator

Automatic Controller Generator with Source Generator This project is an automatic controller generator for .NET projects. It uses Source Generator to automatically create controllers from specified services in a project containing the services.

Installation

To use this generator, you need to install the ControllerGenerator.Abstractions library in the project that contains the services you want to use for generating controllers.

Install-Package ControllerGenerator.Abstractions

##Usage To have your services recognized by the generator, each service or its interface must inherit the IAutoGenerateController interface.

public interface IMyService : IAutoGenerateController
{
    // Service methods
}

Request Generation based on Method Prefixes

Requests in the generated controllers are determined based on the method prefixes:

• If the service method starts with "Get", "Post", "Patch", "Update", "Create", or "Delete", the generated request will correspond to the respective HTTP methods.
• If there is no prefix, the generated request will be of type HTTP POST.

Requirements

The Source Generator library must be installed in the target project. The target project should be a .NET 7.0 web application or a higher version.

Example

Here's an example of using this generator:

// In the project containing the services

public interface IMyService : IAutoGenerateController
{
    void GetUserAsync(int id);
    void PostUser(UserData data);
    void UpdateUser(int id, UserData data);
    // Other service methods
}

// In the .NET 7.0 or higher web project

// The generator will automatically create a controller for IMyService with corresponding HTTP methods for each method in the service.
public class MyController : ControllerBase
{
    private readonly IMyService _myService;

    public MyController(IMyService myService)
    {
        _myService = myService;
    }

    // GET endpoint generated for GetUserAsync
    [HttpGet("{id}")]
    public IActionResult GetUser(int id)
    {
        // Implementation
    }

    // POST endpoint generated for PostUser
    [HttpPost]
    public IActionResult PostUser([FromBody] UserData data)
    {
        // Implementation
    }

    // Other endpoints for UpdateUser and other service methods
}

Disclaimer

This generator uses Source Generator to automatically generate controllers. Make sure you understand how it works before using it in your project. Please perform thorough testing to ensure that the generated controllers meet your requirements.

Contributing

Contributions are welcome! Please see the CONTRIBUTING.md file for information on how to contribute to this project.

License

This project is licensed under the MIT License.