evil 1.0.0

The EVIL! Web Framework

EVIL! (or Evil, or even evil) is a C# web framework inspired by Python modules like Flask and Tornado. It aims to provide a simple way to write web applications with no external dependencies, to avoid bloating your project with code you aren't using.

Evil depends on the standard library and can be summarized as a 'wrapper'. It handles routing requests to methods, and provides a thin wrapper for HttpListener classes. It does not provide an authentication library, or templating, or anything above handling and routing requests. It is, however, trivial to implement these things yourself using the tools Evil provides.

To write an Evil application, you have to options. You can subclass Evil.WebApplication, or simply create an instance of it. You can define a function like this:

public static void HellorldRoute(string method, string[] groups, Request req, Response res) {
   req.ContentType = "text/html";
   req.SetBody("<h1>Hello, world!</h1>");
}

and then define the application like so:

public static async Task Main(string[] args) {
   // Verbose = true enables logging for each request
   WebApplication app = new WebApplication() { Verbose = true };
   // The second argument is regex for matching the request path
   app.RegisterRoute("get", "(.*)", HellorldRoute);
   // If you subclass WebApplication, you SHOULD NOT define prefixes from your
   // class's initializer!
   app.Prefixes.Add("http://localhost:60080/");
   await app.Run();
}

Now, if you point your browser to localhost:60080, you should see a big header that says "Hello, world!". Cool!

Bugs

If you find a bug:

Patch it!

Evil welcomes contributors at codeberg.org. However, if you aren't comfortable writing server code (understandably)...

Report it!

You can visit the issues tab to report any issues you're not aware of the solution for. If you don't have an account on Codeberg and don't feel like creating one, you can email me at tobskep@aol.com.