https://github.com/gopher-fleece/gleece
Building, documenting, validating, securing and customizing REST APIs through code-first development
https://github.com/gopher-fleece/gleece
api gleece go golang openapi openapi3 openapi30 openapi31 rest-api routes
Last synced: 4 months ago
JSON representation
Building, documenting, validating, securing and customizing REST APIs through code-first development
- Host: GitHub
- URL: https://github.com/gopher-fleece/gleece
- Owner: gopher-fleece
- License: mit
- Created: 2025-01-08T07:53:15.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-11T20:54:34.000Z (about 1 year ago)
- Last Synced: 2025-04-12T01:07:53.383Z (about 1 year ago)
- Topics: api, gleece, go, golang, openapi, openapi3, openapi30, openapi31, rest-api, routes
- Language: Go
- Homepage: https://docs.gleece.dev
- Size: 956 KB
- Stars: 70
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
**Gleece** - Bringing joy and ease to API development in Go! 🚀
[](https://github.com/gopher-fleece/gleece/actions/workflows/build.yml)
[](https://goreportcard.com/report/gopher-fleece/gleece)
[](https://coveralls.io/github/gopher-fleece/gleece?branch=main)
[](https://github.com/gopher-fleece/gleece/blob/main/go.mod)
[](https://marketplace.visualstudio.com/items?itemName=haim-kastner.gleece-extension)
[](https://www.libhunt.com/r/gleece)
[](https://github.com/gopher-fleece/gleece/releases)
[](https://pkg.go.dev/github.com/gopher-fleece/gleece)
[](https://spec.openapis.org/oas/v3.0.0)
[](https://spec.openapis.org/oas/v3.1.0)
[](https://gin-gonic.com/)
[](https://echo.labstack.com/)
[](https://github.com/gorilla/mux)
[](https://github.com/go-chi/chi)
[](https://github.com/gofiber/fiber)
[](https://github.com/gopher-fleece/gleece/stargazers)
[](https://github.com/gopher-fleece/gleece/blob/master/LICENSE)
---
## About
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](https://docs.gleece.dev/docs/about/concept) section of our documentation
## Documentation
Explore the complete [documentation site](https://docs.gleece.dev/docs/intro) to get started quickly.
You can also check out our [example project](https://github.com/gopher-fleece/gleecexample#readme), 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](https://github.com/gopher-fleece/gleece/issues)
## Under the hood
*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](https://docs.gleece.dev/docs/about/architecture) section of our documentation.
## Look & Feel
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.
## Visual Studio Code Extension
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](https://github.com/gopher-fleece/gleece-vscode-extension#readme).
To install it search `Gleece` in the "Extension" tab or go to the [Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=haim-kastner.gleece-extension).
## Our Initiative
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](https://github.com/lukeautry/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:
* [Haim Kastner's Gleece Project blog post](https://blog.castnet.club/en/blog/gleece-project)
* [A Holistic View on APIs as an Ecosystem](https://zuplo.com/learning-center/holistic-view-of-apis) in *Zuplo*'s learning center
## Security
To report security concerns or vulnerabilities, please follow the instructions in our [Security Policy](./SECURITY.md).
## Contact
For general inquiries or feedback, please reach out to us at [contact@gleece.dev](mailto:contact@gleece.dev).
Anyway, we'd love to hear from you, especially if you or your company use Gleece.
## Help us grow!
*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!
---
## License
Gleece is licensed under the [MIT LICENSE](./LICENSE).