mirror of
https://github.com/opentffoundation/opentf.git
synced 2026-01-25 12:00:16 -05:00
158a90b25b
* Grafana provider * grafana_data_source resource. Allows data sources to be created in Grafana. Supports all data source types that are accepted in the current version of Grafana, and will support any future ones that fit into the existing structure. * Vendoring of apparentlymart/go-grafana-api This is in anticipation of adding a Grafana provider plugin. * grafana_dashboard resource * Website documentation for the Grafana provider.
95 lines
3.9 KiB
Markdown
95 lines
3.9 KiB
Markdown
Macaron [](https://drone.io/github.com/Unknwon/macaron/latest) [](http://gocover.io/github.com/Unknwon/macaron)
|
|
=======================
|
|
|
|
|
|
|
|
Package macaron is a high productive and modular web framework in Go.
|
|
|
|
##### Current version: 0.6.8
|
|
|
|
## Getting Started
|
|
|
|
The minimum requirement of Go is **1.3**.
|
|
|
|
To install Macaron:
|
|
|
|
go get github.com/Unknwon/macaron
|
|
|
|
The very basic usage of Macaron:
|
|
|
|
```go
|
|
package main
|
|
|
|
import "github.com/Unknwon/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](https://github.com/codegangsta/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](https://github.com/macaron-contrib) to simplify your work:
|
|
|
|
- gzip - Gzip compression to all requests
|
|
- render - Go template engine
|
|
- static - Serves static files
|
|
- [binding](https://github.com/macaron-contrib/binding) - Request data binding and validation
|
|
- [i18n](https://github.com/macaron-contrib/i18n) - Internationalization and Localization
|
|
- [cache](https://github.com/macaron-contrib/cache) - Cache manager
|
|
- [session](https://github.com/macaron-contrib/session) - Session manager
|
|
- [csrf](https://github.com/macaron-contrib/csrf) - Generates and validates csrf tokens
|
|
- [captcha](https://github.com/macaron-contrib/captcha) - Captcha service
|
|
- [pongo2](https://github.com/macaron-contrib/pongo2) - Pongo2 template engine support
|
|
- [sockets](https://github.com/macaron-contrib/sockets) - WebSockets channels binding
|
|
- [bindata](https://github.com/macaron-contrib/bindata) - Embed binary data as static and template files
|
|
- [toolbox](https://github.com/macaron-contrib/toolbox) - Health check, pprof, profile and statistic services
|
|
- [oauth2](https://github.com/macaron-contrib/oauth2) - OAuth 2.0 backend
|
|
- [switcher](https://github.com/macaron-contrib/switcher) - Multiple-site support
|
|
- [method](https://github.com/macaron-contrib/method) - HTTP method override
|
|
- [permissions2](https://github.com/xyproto/permissions2) - Cookies, users and permissions
|
|
- [renders](https://github.com/macaron-contrib/renders) - Beego-like render engine(Macaron has built-in template engine, this is another option)
|
|
|
|
## Use Cases
|
|
|
|
- [Gogs](http://gogs.io): A painless self-hosted Git Service
|
|
- [Peach](http://peachdocs.org): A modern web documentation server
|
|
- [Go Walker](https://gowalker.org): Go online API documentation
|
|
- [Switch](http://gopm.io): Gopm registry
|
|
- [YouGam](http://yougam.com): Online Forum
|
|
- [Critical Stack Intel](https://intel.criticalstack.com/): A 100% free intel marketplace from Critical Stack, Inc.
|
|
|
|
## Getting Help
|
|
|
|
- [API Reference](https://gowalker.org/github.com/Unknwon/macaron)
|
|
- [Documentation](http://go-macaron.com)
|
|
- [FAQs](http://go-macaron.com/docs/faqs)
|
|
- [](https://gitter.im/Unknwon/macaron?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
|
|
|
|
## Credits
|
|
|
|
- Basic design of [Martini](https://github.com/go-martini/martini).
|
|
- Logo is modified by [@insionng](https://github.com/insionng) based on [Tribal Dragon](http://xtremeyamazaki.deviantart.com/art/Tribal-Dragon-27005087).
|
|
|
|
## License
|
|
|
|
This project is under Apache v2 License. See the [LICENSE](LICENSE) file for the full license text.
|