Release Candidate 5

State of the Rewrite

A new Release Candidate is available due to a breaking change, in a few addons only :

• Jwt : Helper & Service
• BasicAuth : Helper & Service (this is a new nuget package and is no longer part of the core)
• OpenID : Helper & Service

Why?

Last week, I was finalizing the code and documentation for the release. I wanted to create a showcase for a common real-world use case: supporting multiple authentication schemes based on criteria like (host, IP, etc.).

When I tried to implement the example, the design turned out to be… ugly. A complete failure ! And not a small one.

The upcoming v26 must have solid, bulletproof foundations and be easily extensible.

At that point, releasing was not an option. Something had to change. So I took a step back and looked at how other frameworks handle this. The result:

• Handler attributes
• Authentication middleware

Thanks to this, my scenario is now handled in a clean, elegant, and powerful way. I’ll be shipping it in the templates NuGet package.

And there’s more : UseRouter(), UseEngine()

These two configuration methods allow you to easily override the Router and the Engine. Another building block for SimpleW’s extensibility.

I'm polishing the code a bit more and running tests, so I’ve postponed the release by another week. I don’t see any other parts of the code that require that level of rewriting, so I expect things to be calm. The release is planned for next week.

Read the updated documentation

feature / comparison

Feature / Aspect	SimpleW v16 (old)	SimpleW v26 (new)
NET runtime	NET8	NET8 but should consider NET9/NET10 for better perfs and RAM usage under heavy load (e.g: NET8 400Mo, NET9 100Mo, NET10 70Mo)
Core architecture	⚠️ (tied to NetCoreServer)	✅ from scratch (custom, simple, clean)
Code readability	⚠️	✅
Overall design philosophy	⚠️ wrapper	✅ minimal, custom, fast
Long-term maintainability	⚠️ harder	✅ much easier
Performance	✅ (very high)	✅ (very high)
Middleware	❌	✅
Modules	❌	✅
Extensibility	⚠️ (callback, subclass)	✅ middleware, module, callback, subclass
Response Builder	✅(status, contentType, headers, body, cookies)	✅ (status, contentType, contentLength, headers, body, cookies, compression)
Handler (Expression Tree)	✅ sync ❌async	✅ sync ✅ async + RequestAborted
Routing	✅ (minimal, attribute, querystring, regexp, path, wildcard)	✅ (minimal, attribute, querystring, path, wildcard, host)
Minimal API	✅	✅
Controllers	✅	✅
Custom attribute	❌	✅
SSL / HTTPS	✅ (SslContext)	✅ (SslContext, mutual authentication)
WebSocket	✅ (full broadcast)	✅ (smart broadcast using "rooms")
Server-Sent Events (SSE)	✅	✅ (smart broadcast using "rooms")
Unix socket	✅	✅
Static files	✅ (Cache, FileWatcher)	✅ (Cache, FileWatcher, Last-Modified, Etag)
Cross-Origin Resource Sharing (CORS)	✅	✅
Body parsing (JSON)	✅	✅
Body parsing (form-urlencoded)	✅	✅
Body parsing (multipart/form-data)	✅	✅
Bag	❌	✅ (share data between middleware)
Auth	⚠️ custom IWebUser	✅ Principal / Identity
Custom JSON engine	✅	✅
HTTP pipelining	❌	✅
Content Range	❌	✅
Idle Timeout	❌	✅
Request Protection	❌	✅(malformed)
Observability	✅ (traces) & global to all processes	✅ (traces, metrics, enrich) per SimpleWServer instance
Logging	❌	✅
Documentation	✅	✅ simplew.net
Tests	✅	✅ (more tests)
Support	❌	✅ Discord
Addons	❌	✅ BasicAuth, Chaos, Firewall, Hosting, Jwt, Latency, Log4net, OpenID, Razor, Swagger, LetsEncrypt, Templates, Serilog, Log4net

Release Candidate 4

State of the Rewrite

A new Release Candidate is available due to a breaking change : WebSocketEnvelope has been refactored (see documentation).

Other changes :

• improved performance of the StaticFilesModule and WebSocketModules. SimpleW is now in the top 3 at Http-Arena that is AWESOME !!😁
• fixed HttpRequestParser to be more RFC compliant
• Request and Response now support Content-Range, which allows to seek video position during streaming.
• added a few Telemetry metrics

I believe this will be the last RC. Some modules originally planned for v26 will be postponed, as they need more time. The core of v26 is now very stable, so it makes sense to release it.

I’d just like to make a few changes so that the router becomes easily extensible, which isn’t the case yet.

feature / comparison

Feature / Aspect	SimpleW v16 (old)	SimpleW v26 (new)
NET runtime	NET8	NET8 but should consider NET9/NET10 for better perfs and RAM usage under heady load (e.g: NET8 400Mo, NET9 100Mo, NET10 70Mo)
Core architecture	⚠️ (tied to NetCoreServer)	✅ from scratch (custom, simple, clean)
Code readability	⚠️	✅
Overall design philosophy	⚠️ wrapper	✅ minimal, custom, fast
Long-term maintainability	⚠️ harder	✅ much easier
Performance	✅ (very high)	✅ (very high)
Middleware	❌	✅
Modules	❌	✅
Extensibility	⚠️ (callback, subclass)	✅ middleware, module, callback, subclass
Response Builder	✅(status, contentType, headers, body, cookies)	✅ (status, contentType, contentLength, headers, body, cookies, compression)
Handler (Expression Tree)	✅ sync ❌async	✅ sync ✅ async + RequestAborted
Routing	✅ (minimal, attribute, querystring, regexp, path, wildcard)	✅ (minimal, attribute, querystring, path, wildcard, host)
Minimal API	✅	✅
Controllers	✅	✅
SSL / HTTPS	✅ (SslContext)	✅ (SslContext, mutual authentication)
WebSocket	✅ (full broadcast)	✅ (smart broadcast using "rooms")
Server-Sent Events (SSE)	✅	✅ (smart broadcast using "rooms")
Basic Auth	❌	✅
Unix socket	✅	✅
Static files	✅ (Cache, FileWatcher)	✅ (Cache, FileWatcher, Last-Modified, Etag)
Cross-Origin Resource Sharing (CORS)	✅	✅
Body parsing (JSON)	✅	✅
Body parsing (form-urlencoded)	✅	✅
Body parsing (multipart/form-data)	✅	✅
Bag	❌	✅ (share data between middleware)
Auth	⚠️ custom IWebUser	✅ Principal / Identity
Custom JSON engine	✅	✅
HTTP pipelining	❌	✅
Idle Timeout	❌	✅
Request Protection	❌	✅(malformed)
Observability	✅ (traces) & global to all processes	✅ (traces, metrics, enrich) per SimpleWServer instance
Logging	❌	✅
Documentation	✅	✅ simplew.net
Tests	✅	✅ (more tests)
Support	❌	✅ Discord
Addons	❌	✅ Chaos, Firewall, Hosting, Jwt, Latency, Log4net, OpenID, Razor, Swagger, LetsEncrypt, Templates, Serilog, Log4net

Release Candidate 3

State of the Rewrite

A new Release Candidate is available due to a breaking change : IWebUser has been replaced with HttpPrincipal and HttpIdentity.

Why?

The old IWebUser has existed since the first release. Quite frankly, I don’t think anyone else ever used it except myself, as it was poorly designed and mostly a legacy of a previous system (yeah EmbedIO, I'm looking at you ^^).

With the upcoming version, and considering the significant effort put into easing migration from ASP.NET Core, this weak part needed a complete redesign.

So here we go with a new security Principal, heavily inspired by (but not identical to) ASP.NET Core’s principal model. All modules have been updated to support this new core security feature, and everything is now much better integrated.

I hope this is the last breaking change of this RC phase, which is of course still ongoing. Once I’ve migrated my main SaaS to its new Principal, things will accelerate quickly toward the official release.

Final words : I also have three very promising new modules in alpha. One of them is absolutely critical for most companies using ASP.NET Core, often the main reason why migrations to alternative solutions don’t happen. I want to break that barrier and I will !

feature / comparison

Feature / Aspect	SimpleW v16 (old)	SimpleW v26 (new)
NET runtime	NET8	NET8 but should consider NET9/NET10 for better perfs and RAM usage under heady load (e.g: NET8 400Mo, NET9 100Mo, NET10 70Mo)
Core architecture	⚠️ (tied to NetCoreServer)	✅ from scratch (custom, simple, clean)
Code readability	⚠️	✅
Overall design philosophy	⚠️ wrapper	✅ minimal, custom, fast
Long-term maintainability	⚠️ harder	✅ much easier
Performance	✅ (very high)	✅ (very high)
Middleware	❌	✅
Modules	❌	✅
Extensibility	⚠️ (callback, subclass)	✅ middleware, module, callback, subclass
Response Builder	✅(status, contentType, headers, body, cookies)	✅ (status, contentType, contentLength, headers, body, cookies, compression)
Handler (Expression Tree)	✅ sync ❌async	✅ sync ✅ async + RequestAborted
Routing	✅ (minimal, attribute, querystring, regexp, path, wildcard)	✅ (minimal, attribute, querystring, path, wildcard, host)
Minimal API	✅	✅
Controllers	✅	✅
SSL / HTTPS	✅ (SslContext)	✅ (SslContext, mutual authentication)
WebSocket	✅ (full broadcast)	✅ (smart broadcast using "rooms")
Server-Sent Events (SSE)	✅	✅ (smart broadcast using "rooms")
Basic Auth	❌	✅
Unix socket	✅	✅
Static files	✅ (Cache, FileWatcher)	✅ (Cache, FileWatcher, Last-Modified, Etag)
Cross-Origin Resource Sharing (CORS)	✅	✅
Body parsing (JSON)	✅	✅
Body parsing (form-urlencoded)	✅	✅
Body parsing (multipart/form-data)	✅	✅
Bag	❌	✅ (share data between middleware)
Auth	⚠️ custom IWebUser	✅ Principal / Identity
Custom JSON engine	✅	✅
HTTP pipelining	❌	✅
Idle Timeout	❌	✅
Request Protection	❌	✅(malformed)
Observability	✅ (traces) & global to all processes	✅ (traces, metrics, enrich) per SimpleWServer instance
Logging	❌	✅
Documentation	✅	✅ simplew.net
Tests	✅	✅ (more tests)
Support	❌	✅ Discord
Addons	❌	✅ Chaos, Firewall, Hosting, Jwt, Latency, Log4net, OpenID, Razor, Swagger, LetsEncrypt, Templates, Serilog, Log4net

Release Candidate 2

State of the Rewrite

A new Release Candidate due to a breaking change in the RouteAttribute.

Why ?

1. Only method and path are mandatory. All other properties are optional, which enables future extensions without breaking the API.
2. I finally added Host filtering in the RouteAttribute: it is now possible to target a method depending on the Host.

I also added some checks to detect and stop slow performance attacks on Request.

These two changes require an extended testing period to detect any regressions.

feature / comparison

Feature / Aspect	SimpleW v16 (old)	SimpleW v26 (new)
NET runtime	NET8	NET8 but should consider NET9/NET10 for better perfs and RAM usage under heady load (e.g: NET8 400Mo, NET9 100Mo, NET10 70Mo)
Core architecture	⚠️ (tied to NetCoreServer)	✅ from scratch (custom, simple, clean)
Code readability	⚠️	✅
Overall design philosophy	⚠️ wrapper	✅ minimal, custom, fast
Long-term maintainability	⚠️ harder	✅ much easier
Performance	✅ (very high)	✅ (very high)
Middleware	❌	✅
Modules	❌	✅
Extensibility	⚠️ (callback, subclass)	✅ middleware, module, callback, subclass
Response Builder	✅(status, contentType, headers, body, cookies)	✅ (status, contentType, contentLength, headers, body, cookies, compression)
Handler (Expression Tree)	✅ sync ❌async	✅ sync ✅ async + RequestAborted
Routing	✅ (minimal, attribute, querystring, regexp, path, wildcard)	✅ (minimal, attribute, querystring, path, wildcard, host)
Minimal API	✅	✅
Controllers	✅	✅
SSL / HTTPS	✅ (SslContext)	✅ (SslContext, mutual authentication)
WebSocket	✅ (full broadcast)	✅ (smart broadcast using "rooms")
Server-Sent Events (SSE)	✅	✅ (smart broadcast using "rooms")
Basic Auth	❌	✅
JWT auth	✅	✅
Unix socket	✅	✅
Static files	✅ (Cache, FileWatcher)	✅ (Cache, FileWatcher, Last-Modified, Etag)
Cross-Origin Resource Sharing (CORS)	✅	✅
Body parsing (JSON)	✅	✅
Body parsing (form-urlencoded)	✅	✅
Body parsing (multipart/form-data)	✅	✅
Bag	❌	✅ (share data between middleware)
WebUser / Identity	✅	✅
Custom JSON engine	✅	✅
HTTP pipelining	❌	✅
Idle Timeout	❌	✅
Request Protection	❌	✅(malformed)
Observability	✅ (traces) & global to all processes	✅ (traces, metrics, enrich) per SimpleWServer instance
Logging	❌	✅
Documentation	✅	✅ simplew.net
Tests	✅	✅ (more tests)
Support	❌	✅ Discord
Addons	❌	✅ Chaos, Firewall, Hosting, Latency, OpenID, Razor, Swagger, LetsEncrypt, Templates, Serilog, Log4net

Release Candidate

State of the Rewrite

Here we are, the last step : the Release Candidate.

I spent a few days thinking about the kind of logging system I wanted for SimpleW. I follow the rule n°1 that guides me : simplicity.

The logger is basically a simple emit() with a few methods on top. It supports sinks, and you can bridge your own logger on it. There are even two packages available for the most widely used .NET loggers : serilog and log4net.

There is a new SimpleWSServer.ConfigureClientIPResolver() methods that allow you to configure where the real client IP address comes from. It replaced the one in the Firewall package (so this is a breaking change for the SimpleW.Service.Firewall).

Finally, there are a few minor fixes in the HttpSession and a new Bag feature that allows data to be shared between middlewares.

The documentation is up to date !

feature / comparison

Feature / Aspect	SimpleW v16 (old)	SimpleW v26 (new)
NET runtime	NET8	NET8 but should consider NET9/NET10 for better perfs and RAM usage under heady load (e.g: NET8 400Mo, NET9 100Mo, NET10 70Mo)
Core architecture	⚠️ (tied to NetCoreServer)	✅ from scratch (custom, simple, clean)
Code readability	⚠️	✅
Overall design philosophy	⚠️ wrapper	✅ minimal, custom, fast
Long-term maintainability	⚠️ harder	✅ much easier
Performance	✅ (very high)	✅ (very high)
Middleware	❌	✅
Modules	❌	✅
Extensibility	⚠️ (callback, subclass)	✅ middleware, module, callback, subclass
Response Builder	✅(status, contentType, headers, body, cookies)	✅ (status, contentType, contentLength, headers, body, cookies, compression)
Handler (Expression Tree)	✅ sync ❌async	✅ sync ✅ async + RequestAborted
Routing	✅ (minimal, attribute, querystring, regexp, path, wildcard)	✅ (minimal, attribute, querystring, path, wildcard)
Minimal API	✅	✅
Controllers	✅	✅
SSL / HTTPS	✅ (SslContext)	✅ (SslContext, mutual authentication)
WebSocket	✅ (full broadcast)	✅ (smart broadcast using "rooms")
Server-Sent Events (SSE)	✅	✅ (smart broadcast using "rooms")
Basic Auth	❌	✅
JWT auth	✅	✅
Unix socket	✅	✅
Static files	✅ (Cache, FileWatcher)	✅ (Cache, FileWatcher, Last-Modified, Etag)
Cross-Origin Resource Sharing (CORS)	✅	✅
Body parsing (JSON)	✅	✅
Body parsing (form-urlencoded)	✅	✅
Body parsing (multipart/form-data)	✅	✅
Bag	❌	✅ (share data between middleware)
WebUser / Identity	✅	✅
Custom JSON engine	✅	✅
HTTP pipelining	❌	✅
Idle Timeout	❌	✅
Request Protection	❌	✅(malformed)
Observability	✅ (traces) & global to all processes	✅ (traces, metrics, enrich) per SimpleWServer instance
Logging	❌	✅
Documentation	✅	✅ simplew.net
Tests	✅	✅ (more tests)
Support	❌	✅ Discord
Addons	❌	✅ Chaos, Firewall, Hosting, Latency, OpenID, Razor, Swagger, LetsEncrypt, Templates, Serilog, Log4net

Consolidating Beta

State of the Rewrite

I’m consolidating and polishing the entire codebase :

• No API changes, things are boring stable now.
• I’m focusing on addon development : three new ones have been added: LetsEncrypt, OpenID, and Templates.
• I’m hardening the HttpRequestParser against malformed requests and well-known attack patterns.
• I also want to make migration from ASP.NET Core easier by adding helpers and utilities (for example, a Bag to pass data across middleware).
• Fixed a few minor bugs in HttpSession.
• Added new methods and events to the SimpleWServer class.
• Improved documentation

Feature / Aspect	SimpleW v16 (current)	SimpleW v26 (in progress)
NET runtime	NET8	NET8 but should consider NET9/NET10 for better perfs and RAM usage under heady load (e.g: NET8 400Mo, NET9 100Mo, NET10 70Mo)
Core architecture	⚠️ (tied to NetCoreServer)	✅ from scratch (custom, simple, clean)
Code readability	⚠️	✅
Overall design philosophy	⚠️ wrapper	✅ minimal, custom, fast
Long-term maintainability	⚠️ harder	✅ much easier
Performance	✅ (very high)	✅ (very high)
Middleware	❌	✅
Modules	❌	✅
Extensibility	⚠️ (callback, subclass)	✅ midlleware, module, callback, subclass
Response Builder	✅(status, contentType, headers, body, cookies)	✅ (status, contentType, contentLength, headers, body, cookies, compression)
Handler (Expression Tree)	✅ sync ❌async	✅ sync ✅ async + RequestAborted
Routing	✅ (minimal, attribute, querystring, regexp, path, wildcard)	✅ (minimal, attribute, querystring, path, wildcard)
Minimal API	✅	✅
Controllers	✅	✅
SSL / HTTPS	✅ (SslContext)	✅ (SslContext)
WebSocket	✅(full broadcast)	✅ (smart broadcast using "rooms")
Server-Sent Events (SSE)	✅	✅ (smart broadcast using "rooms")
Basic Auth	❌	✅
JWT auth	✅	✅
Unix socket	✅	✅
Static files	✅ (Cache, FileWatcher)	✅ (Cache, FileWatcher, Last-Modified, Etag)
Cross-Origin Resource Sharing (CORS)	✅	✅
Body parsing (JSON)	✅	✅
Body parsing (form-urlencoded)	✅	✅
Body parsing (multipart/form-data)	✅	✅
WebUser / Identity	✅	✅
Custom JSON engine	✅	✅
HTTP pipelining	❌	✅
Idle Timeout	❌	✅
Request Protection	❌	✅(malformed)
Observability	✅ (traces) & global to all processes	✅ (traces, metrics, enrich) per SimpleWServer instance
Documentation	✅	✅ simplew.net
Tests	✅	✅ (more tests)
Support	❌	✅ Discord
Add-Ons	❌	✅ Chaos, Firewall, Hosting, Latency, LetsEncrypt, OpenID, Razor, Swagger, Templates

Open Beta

State of the Rewrite

Here we are : the beta is now available !

In the previous thread, I mentioned Add-ons, there are already a few available :

• Chaos: provides a chaos engineering module.
• Firewall: IP allow/block lists, rate limiting, and related telemetry.
• Hosting: if you like the way ASP.NET is initialized as a service, this one is for you.
• Latency: artificially delays HTTP responses in a controlled and deterministic way.
• Razor: if you like the Razor template engine, this one is for you.
• Swagger: provides Swagger / OpenAPI documentation support for the SimpleW web server.

How do you use them ?
I spent a crazy amount of time in writing the documentation, read it!

Feature / Aspect	SimpleW v16 (current)	SimpleW v26 (in progress)
NET runtime	NET8	NET8 but should consider NET9/NET10 for better perfs and RAM usage under heady load (e.g: NET8 400Mo, NET9 100Mo, NET10 70Mo)
Core architecture	⚠️ (tied to NetCoreServer)	✅ from scratch (custom, simple, clean)
Code readability	⚠️	✅
Overall design philosophy	⚠️ wrapper	✅ minimal, custom, fast
Long-term maintainability	⚠️ harder	✅ much easier
Performance	✅ (very high)	✅ (very high)
Middleware	❌	✅
Modules	❌	✅
Extensibility	⚠️ (callback, subclass)	✅ midlleware, module, callback, subclass
Response Builder	✅(status, contentType, headers, body, cookies)	✅ (status, contentType, contentLength, headers, body, cookies, compression)
Handler (Expression Tree)	✅ sync ❌async	✅ sync ✅ async + RequestAborted
Routing	✅ (minimal, attribute, querystring, regexp, path, wildcard)	✅ (minimal, attribute, querystring, path, wildcard)
Minimal API	✅	✅
Controllers	✅	✅
SSL / HTTPS	✅ (SslContext)	✅ (SslContext)
WebSocket	✅(full broadcast)	✅ (smart broadcast using "rooms")
Server-Sent Events (SSE)	✅	✅
Basic Auth	❌	✅
JWT auth	✅	✅
Unix socket	✅	✅
Static files	✅ (Cache, FileWatcher)	✅ (Cache, FileWatcher, Last-Modified, Etag)
Cross-Origin Resource Sharing (CORS)	✅	✅
Body parsing (JSON)	✅	✅
Body parsing (form-urlencoded)	✅	✅
Body parsing (multipart/form-data)	✅	✅
WebUser / Identity	✅	✅
Custom JSON engine	✅	✅
HTTP pipelining	❌	✅
Idle Timeout	❌	✅
Request Protection	❌	✅(malformed)
Observability	✅ (traces) & global to all processes	✅ (traces, metrics, enrich) per SimpleWServer instance
Documentation	✅	✅ simplew.net
Tests	✅	✅ (more tests)
Support	❌	✅ Discord
Add-Ons	❌	✅ Chaos, Firewall, Hosting, Latency, Razor, Swagger

Last alpha

State of the Rewrite

I've fixed a few bugs in the StaticFilesModule (invalid response, cache invalidation) and improved its performance. I also fixed some Map() handler issues related to QueryString url decode and optimized the HttpRequest parsing time in some areas.

The WebSocketModule is finally out and its design is not bad :

• Jwt can be pass through the connect (a small valid hack with the sec-sub-protocol).
• broadcasts are using the notion of room to target specific clients which is a far away cleaner approach than using Dictionary<Session, Object>.

All of this has been in production in one of my SaaS products for the past three weeks, Beta is coming soon !!

And because a product is more quickly adopt when there is an ecosystem around, this new v26 will introduce something very cool : AddOns 🤫🙂

Feature / Aspect	SimpleW v16 (current)	SimpleW v26 (in progress)
NET runtime	NET8	NET8 but should consider NET9/NET10 for better perfs and RAM usage under heady load (e.g: NET8 400Mo, NET9 100Mo, NET10 70Mo)
Core architecture	⚠️ (tied to NetCoreServer)	✅ from scratch (custom, simple, clean)
Code readability	⚠️	✅
Overall design philosophy	⚠️ wrapper	✅ minimal, custom, fast
Long-term maintainability	⚠️ harder	✅ much easier
Performance	✅ (very high)	✅ (very high)
Middleware	❌	✅
Modules	❌	✅
Extensibility	⚠️ (callback, subclass)	✅ midlleware, module, callback, subclass
Response Builder	✅(status, contentType, headers, body, cookies)	✅ (status, contentType, contentLength, headers, body, cookies, compression)
Handler (Expression Tree)	✅ sync ❌async	✅ sync ✅ async
Routing	✅ (minimal, attribute, querystring, regexp, path, wildcard)	✅ (minimal, attribute, querystring, path, wildcard)
Minimal API	✅	✅
Controllers	✅	✅
SSL / HTTPS	✅ (SslContext)	✅ (SslContext)
WebSocket	✅(full broadcast)	✅ (smart broadcast using "rooms")
Server-Sent Events (SSE)	✅	✅
Basic Auth	❌	✅
JWT auth	✅	✅
Unix socket	✅	✅
Static files	✅ (Cache, FileWatcher)	✅ (Cache, FileWatcher, Last-Modified, Etag)
Cross-Origin Resource Sharing (CORS)	✅	✅
Body parsing (JSON)	✅	✅
Body parsing (form-urlencoded)	✅	✅
Body parsing (multipart/form-data)	✅	✅
WebUser / Identity	✅	✅
Custom JSON engine	✅	✅
HTTP pipelining	❌	✅
Idle Timeout	❌	✅
Request Protection	❌	(malformed)✅
Observability	✅ (traces)	✅ (traces, metrics, enrich)
Documentation	✅	✅ simplew.net
Tests	✅	✅ (more tests)
Support	❌	✅ Discord

Happy New Year

State of the Rewrite

I haven't changed the API for a week, and given the commit rhythm, it's a good indicator that things are stabilizing.
I'm running one of my oldest services on the alpha, finding bugs, fixing them and loop.
WebSockets, the last feature, are still a work in progress and will require more attention and work 🥵.

The documentation of the next version is up to date and running on the new simplew.net domain 😎 !

Feature / Aspect	SimpleW v16 (current)	SimpleW v26 (in progress)
NET runtime	NET8	NET8 but should consider NET9/NET10 for better perfs and RAM usage under heady load (e.g: NET8 400Mo, NET9 100Mo, NET10 70Mo)
Core architecture	⚠️ (tied to NetCoreServer)	✅ from scratch (custom, simple, clean)
Code readability	⚠️	✅
Overall design philosophy	⚠️ wrapper	✅ minimal, custom, fast
Long-term maintainability	⚠️ harder	✅ much easier
Performance	✅ (very high)	✅ (very high)
Extensibility	⚠️ (callback, subclass)	✅ midlleware, module, callback, subclass
Middleware	❌	✅
Modules	❌	✅
Minimal API	✅	✅
Response Builder	✅(status, contentType, headers, body, cookies)	✅ (status, contentType, headers, body, cookies, compression)
Handler (Expression Tree)	✅ sync ❌async	✅ sync ✅ async
Routing	✅ (minimal, attribute, querystring, regexp, path, wildcard)	✅ (minimal, attribute, querystring, path, wildcard)
Controllers	✅	✅
SSL / HTTPS	✅ (SslContext)	✅ (SslContext)
WebSocket	✅	⚠️ WIP
Server-Sent Events (SSE)	✅	⚠️ WIP
Basic Auth	❌	✅
JWT auth	✅	✅
Unix socket	✅	✅
Static files	✅	✅
Cross-Origin Resource Sharing (CORS)	✅	✅
Body parsing (JSON)	✅	✅
Body parsing (form-urlencoded)	✅	✅
Body parsing (multipart/form-data)	✅	✅
WebUser / Identity	✅	✅
Custom JSON engine	✅	✅
HTTP pipelining	❌	✅
Idle Timeout	❌	✅
Observability	✅ (traces)	✅ (traces, metrics, enrich)
Documentation	✅	✅ simplew.net
Support	❌	✅ Discord

Winter is coming

State of the Rewrite

A lot of progress since last week : the API is stabilizing (SimpleWServer, HttpSession, HttpRequest, HttpResponse, Router), but I still have to find the best approach for modules. There is a full test suite to prevent regressions and the nightly nuget is usable (you need to enable pre-release).

I archived the current version to a v16 folder and the rewrite is now in master.

Feature / Aspect	SimpleW v16 (current)	SimpleW v26 (in progress)
NET runtime	NET8	NET8 but should consider NET9/NET10 for better perfs and RAM usage under heady load (e.g: NET8 400Mo, NET9 100Mo, NET10 70Mo)
Core architecture	⚠️ (tied to NetCoreServer)	✅ from scratch (custom, simple, clean)
Code readability	⚠️	✅
Overall design philosophy	⚠️ wrapper	✅ minimal, custom, fast
Long-term maintainability	⚠️ harder	✅ much easier
Performance	✅ (very high)	✅ (very high)
Extensibility	⚠️ (callback, subclass)	✅ (midlleware, module, callback, subclass)
Middleware	❌	✅
Modules	❌	✅
Minimal API	✅	✅
Response Builder	✅(status, contentType, headers, body, cookies)	✅ (status, contentType, headers, body, cookies, compression)
Handler (Expression Tree)	✅ sync ❌async	✅ sync ✅ async
Routing	✅ (minimal, attribute, querystring, regexp, path, wildcard)	✅ (minimal, attribute, querystring, path, wildcard)
Controllers	✅	✅
SSL / HTTPS	✅ (SslContext)	✅ (SslContext)
WebSocket	✅	⚠️ WIP
Server-Sent Events (SSE)	✅	📅 TODO
JWT auth	✅	📅 TODO
Unix socket	✅	✅
Static files	✅	✅
Cross-Origin Resource Sharing (CORS)	✅	⚠️ WIP
Body parsing (JSON)	✅	✅
Body parsing (form-urlencoded)	✅	✅
Body parsing (multipart/form-data)	✅	✅
WebUser / Identity	✅	📅 TODO
Custom JSON engine	✅	✅
HTTP pipelining	❌	✅
Idle Timeout	❌	✅
Logging	✅	📅 TODO
Observability (logs, traces)	✅	📅 TODO
Documentation	✅	⚠️ WIP

Documentation

There are two documentation flavors (the switch is in the top right corner) :

• current production v16 : freeze
• the new rewrite v26 : copy/paste WIP, I have a lot of pages to update

Teasing

"SimpleW vs Aspnet", coming soon to your theather 🍿🔥