Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Initial Release #1

Merged
merged 175 commits into from
Sep 8, 2024
Merged

Initial Release #1

merged 175 commits into from
Sep 8, 2024

Conversation

mookums
Copy link
Collaborator

@mookums mookums commented Sep 6, 2024

This is the initial release of zzz, a micro framework for building networked services. This is still alpha software and should be treated as such, but it is running on real hardware here. zzz is meant to be useful for both writing general networked applications while also remaining viable for embedded and bare-metal use-cases.

HTTP/1.1

This initial version ships with a very fast and purely Zig HTTP/1.1 implementation. This protocol implementation should be fairly stable but is missing some core functionality that might be nice to have for HTTP/1.1.

This includes but is not limited to:

  • URL Query Parsing
  • Form Data Parsing
  • Chunked Encoding
  • Compression (gzip)
  • Middlewares (maybe not?)

TLS

zzz ships with support for TLS through BearSSL (and by porting it). This allows us to have TLS implementation that is abtracted away from the I/O, allowing for whatever Async and Socket primitives you are using to handle any of the I/O.

Async Model

zzz uses an event loop with async callbacks as the method to achieve fast and scalable performance. This is done by implementing an Async struct, that contains pointers to various different methods that get called during the servers lifetime. There will be more about the Async mode here (add link to blog post about modular async)

This initial version includes a (mostly) functional IO Uring backend. For any other platforms, you will have to implement a custom backend. There is an example of a Custom backend provided and can be extended to support pretty much any I/O abstraction.

The Async model needs to implement FS functionality for async reading and writing of files.

@mookums mookums self-assigned this Sep 6, 2024
@mookums mookums merged commit f51be86 into main Sep 8, 2024
2 checks passed
@mookums mookums deleted the ssl branch September 8, 2024 21:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant