Lightbug is a simple and sweet HTTP framework for Mojo that builds on best practice from systems programming, such as the Golang FastHTTP and Rust may_minihttp.
This is not production ready yet. We're aiming to keep up with new developments in Mojo, but it might take some time to get to a point when this is safe to use in real-world applications.
Lightbug currently has the following features:
- Set up a server to listen on a given host/port
- Assign your own custom handler to a route
- Craft HTTP requests and responses with built-in primitives
- Everything is fully typed, with no
def
functions used
We're working on support for the following (contributors welcome!):
- Pure Mojo networking (while most of the code is in Mojo, we call Python's
socket
library in several parts of the code) - Better error handling, improved form/multipart and JSON support
- Multiple simultaneous connections, parallelization and performance optimizations
- WebSockets, HTTP 2.0
The test coverage is also something we're working on.
The plan is to get to a feature set similar to Python frameworks like Starlette, but with better performance.
The only hard dependency for lightbug_http
is Mojo.
Learn how to set it up on the Modular website.
Once you have Mojo up and running on your local machine,
-
Clone the repo
git clone https://github.com/saviorand/mojo-web
Alternatively, start the project in Github Codespaces for quick setup:
-
Add your handler in
main.mojo
by passing a struct that satisfies the following trait:trait HTTPService: fn func(self, req: HTTPRequest) raises -> HTTPResponse: ...
For example, to make a
Printer
service that simply prints the request to console:@value struct Printer(HTTPService): fn func(self, req: HTTPRequest) raises -> HTTPResponse: let body = req.body_raw print(String(body)) return OK(body)
Routing is not in scope for this library, but you can easily set up routes yourself:
@value struct ExampleRouter(HTTPService): fn func(self, req: HTTPRequest) raises -> HTTPResponse: let body = req.body_raw let uri = req.uri() if uri.path() == "/": print("I'm on the index path!") if uri.path() == "/first": print("I'm on /first!") elif uri.path() == "/second": print("I'm on /second!") elif uri.path() == "/echo": print(String(body)) return OK(body)
We plan to add routing in a future library called
lightbug_api
, see Roadmap for more details. -
Run
mojo main.mojo
. This will start up a server listening onlocalhost:8080
. Or, if you prefer to import the server into your own app:from lightbug_http.io.bytes import Bytes from lightbug_http.python.server import PythonServer from lightbug_http.service import Printer fn main() raises: var server = PythonServer() let handler = Printer() server.listen_and_serve("0.0.0.0:8080", handler)
Feel free to change the settings in
listen_and_serve()
to serve on a particular host and port.
Our vision is to develop three libraries, with lightbug_http
(this repo) as a starting point:
lightbug_http
- HTTP infrastructure and basic API developmentlightbug_api
- (coming later in 2024!) Tools to make great APIs fast, with support for OpenAPI spec and domain driven designlightbug_web
- (release date TBD) Full-stack web framework for Mojo, similar to NextJS or SvelteKit
The idea is to get to a point where the entire codebase of a simple modern web application can be written in Mojo.
We don't make any promises, though -- this is just a vision, and whether we get there or not depends on many factors, including the support of the community.
See the open issues and submit your own to help drive the development of Lightbug.
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated. See CONTRIBUTING.md for more details on how to contribute.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star!
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature
) - Commit your Changes (
git commit -m 'Add some AmazingFeature'
) - Push to the Branch (
git push origin feature/AmazingFeature
) - Open a Pull Request
Distributed under the MIT License. See LICENSE.txt
for more information.
Project Link: https://github.com/saviorand/mojo-web
We were drawing a lot on the following projects:
- FastHTTP (Golang)
- may_minihttp (Rust)
- FireTCP (One of the earliest Mojo TCP implementations!)