Roozie.AutoInterface 0.1.1-beta

Roozie.AutoInterface

What is it?

Roozie.AutoInterface is a C# source generator that generates an interface for a class. The generated interface contains the XML-doc comments, public properties, and public methods.

Why?

Interfaces are great for keeping your code loosely coupled and unit testable. But, they add some maintenance overhead. This source generator will keep your interfaces up to date.

How to use it?

1. Add the NuGet package to your project.

   dotnet add package Roozie.AutoInterface --prerelease

2. Create a class where you want to generate an interface.

public class MyClass
{
    public string MyProperty { get; set; }

    public void MyMethod()
    {
        // Do something
    }
}

3. Add the [AutoInterface] attribute to the class.
4. An interface will be generated in the same namespace as the class.

You can now use the generated interface in your code. If the class is partial, the interface will be automatically implemented.

Check out the tests (1, 2) for examples.

Configuration

You can configure the generator in the [AutoInterface] attribute. The following options are available:

Contributing

Please open an issue if you find a bug or have a feature request. If you'd like to contribute, please open a pull request.

Kudos

Andrew Lock's Source Generator series is an excellent resource for learning all aspects of source generators.