Gleece - Bringing joy and ease to API development in Go! 🚀
Developing APIs doesn’t have to be a chore - it should be simple, efficient, and enjoyable.
Gone are the days of manually writing repetitive boilerplate code or struggling to keep your API documentation in sync with your implementation.
With Gleece, you can:
- Simplify and standardize your API development process.
- Automatically generate OpenAPI v3.0.0 / v3.1.0 specifications directly from your code.
- Ensure your APIs are always up-to-date, well-documented and consistent.
- Effortlessly validate input data to ensure your APIs are reliable and secure.
- Adopt a security first approach with simple yet powerful authorization flows.
- Customize behavior to your exact needs by extending or overriding the routes templates.
- Bring your own router - works seamlessly with Gin, Echo, Gorilla Mux, Chi, & Fiber.
Gleece aims to make Go developers’ lives easier by seamlessly integrating API routing, validation, and documentation into a single cohesive workflow without sacrificing performance.
For more information, check out the concept section of our documentation
Explore the complete documentation site to get started quickly.
You can also check out our example project, which demonstrates how to set up and use Gleece in a real-world scenario. This hands-on reference will help you integrate Gleece seamlessly.
If you've encountered a gap in the documentation or feel some topic is inadequately covered, please let us know via GitHub Issues
Gleece is almost exclusively a design/build time framework/transpiler- there are no magic tricks or runtime shenanigans.
Once your API implementation is ready, use Gleece's CLI to generate routes according to your chosen engine.
These generated routes work just like any manually written code and need to be registered to your engine's router instance through your application code.
You can continue to use your engine's native calls, middlewares, and other features as before - Gleece's generated code acts only as a complementary plugin to your router.
For a deeper look into Gleece's internals, please see the architecture section of our documentation.
Here’s a practical snippet of how Gleece simplifies your API development:
All other aspects, including HTTP routing generation, authorization enforcement, payload validation, error handling, and OpenAPI v3 specification generation, are handled by Gleece.
To enhance your development experience with Gleece, we provide an official Visual Studio Code extension that provides intelligent annotation highlighting and improved code visibility.
For more information and capabilities see the Gleece VS Code Extension.
To install it search Gleece in the "Extension" tab or go to the Visual Studio Marketplace.
We believe that API development should be code-first, focusing on the developer experience while maintaining industry standards. Coming from the TypeScript ecosystem, we were inspired by frameworks like TSOA that handle everything from routing and validation to OpenAPI generation - all from a single source of truth: your code.
Read more about our initiative and development philosophy:
-
A Holistic View on APIs as an Ecosystem in Zuplo's learning center
To report security concerns or vulnerabilities, please follow the instructions in our Security Policy.
For general inquiries or feedback, please reach out to us at [email protected].
Anyway, we'd love to hear from you, especially if you or your company use Gleece.
Gleece is a two-man passion project and requires enormous efforts;
If you find it interesting or useful, please help us grow by dropping a star or telling your colleagues about us!
Your support keeps us going!
Gleece is licensed under the MIT LICENSE.