mirror of
https://codeberg.org/forgejo/forgejo.git
synced 2024-12-18 03:17:56 +01:00
70ea2300ca
* Vendor: update gitea.com/macaron/session to a177a270 * make vendor * Vendor: update gitea.com/macaron/macaron to 0db5d458 * make vendor * Vendor: update gitea.com/macaron/cache to 905232fb * make vendor * Vendor: update gitea.com/macaron/i18n to 4ca3dd0c * make vendor * Vendor: update gitea.com/macaron/gzip to efa5e847 * make vendor * Vendor: update gitea.com/macaron/captcha to e8597820 * make vendor |
||
|---|---|---|
| .. | ||
| .drone.yml | ||
| .gitignore | ||
| context.go | ||
| go.mod | ||
| go.sum | ||
| LICENSE | ||
| logger.go | ||
| macaron.go | ||
| macaronlogo.png | ||
| README.md | ||
| recovery.go | ||
| render.go | ||
| response_writer.go | ||
| return_handler.go | ||
| router.go | ||
| static.go | ||
| tree.go | ||
| util_go17.go | ||
| util_go18.go | ||
Macaron
Package macaron is a high productive and modular web framework in Go.
Getting Started
The minimum requirement of Go is 1.6.
To install Macaron:
go get gitea.com/macaron/macaron
The very basic usage of Macaron:
package main
import "gitea.com/macaron/macaron"
func main() {
m := macaron.Classic()
m.Get("/", func() string {
return "Hello world!"
})
m.Run()
}
Features
- Powerful routing with suburl.
- Flexible routes combinations.
- Unlimited nested group routers.
- Directly integrate with existing services.
- Dynamically change template files at runtime.
- Allow to use in-memory template and static files.
- Easy to plugin/unplugin features with modular design.
- Handy dependency injection powered by inject.
- Better router layer and less reflection make faster speed.
Middlewares
Middlewares allow you easily plugin/unplugin features for your Macaron applications.
There are already many middlewares to simplify your work:
- render - Go template engine
- static - Serves static files
- gzip - Gzip compression to all responses
- binding - Request data binding and validation
- i18n - Internationalization and Localization
- cache - Cache manager
- session - Session manager
- csrf - Generates and validates csrf tokens
- captcha - Captcha service
- pongo2 - Pongo2 template engine support
- sockets - WebSockets channels binding
- bindata - Embed binary data as static and template files
- toolbox - Health check, pprof, profile and statistic services
- oauth2 - OAuth 2.0 backend
- authz - ACL/RBAC/ABAC authorization based on Casbin
- switcher - Multiple-site support
- method - HTTP method override
- permissions2 - Cookies, users and permissions
- renders - Beego-like render engine(Macaron has built-in template engine, this is another option)
- piwik - Server-side piwik analytics
Use Cases
- Gogs: A painless self-hosted Git Service
- Grafana: The open platform for beautiful analytics and monitoring
- Peach: A modern web documentation server
- Go Walker: Go online API documentation
- Switch: Gopm registry
- Critical Stack Intel: A 100% free intel marketplace from Critical Stack, Inc.
Getting Help
Credits
- Basic design of Martini.
- Logo is modified by @insionng based on Tribal Dragon.
License
This project is under the Apache License, Version 2.0. See the LICENSE file for the full license text.