mirror of
				https://github.com/go-gitea/gitea.git
				synced 2025-10-29 10:57:44 +09:00 
			
		
		
		
	Migrate to dep (#3972)
* Update makefile to use dep * Migrate to dep * Fix some deps * Try to find a better version for golang.org/x/net * Try to find a better version for golang.org/x/oauth2
This commit is contained in:
		
				
					committed by
					
						 Lauris BH
						Lauris BH
					
				
			
			
				
	
			
			
			
						parent
						
							d7fd9bf7bb
						
					
				
				
					commit
					3f3383dc0a
				
			
							
								
								
									
										110
									
								
								vendor/github.com/go-macaron/toolbox/README.md
									
									
									
										generated
									
									
										vendored
									
									
								
							
							
						
						
									
										110
									
								
								vendor/github.com/go-macaron/toolbox/README.md
									
									
									
										generated
									
									
										vendored
									
									
								
							| @@ -1,110 +0,0 @@ | ||||
| toolbox | ||||
| ======= | ||||
|  | ||||
| Middleware toolbox provides health chcek, pprof, profile and statistic services for [Macaron](https://github.com/go-macaron/macaron). | ||||
|  | ||||
| [API Reference](https://gowalker.org/github.com/go-macaron/toolbox) | ||||
|  | ||||
| ### Installation | ||||
|  | ||||
| 	go get github.com/go-macaron/toolbox | ||||
| 	 | ||||
| ## Usage | ||||
|  | ||||
| ```go | ||||
| // main.go | ||||
| import ( | ||||
| 	"gopkg.in/macaron.v1" | ||||
| 	"github.com/go-macaron/toolbox" | ||||
| ) | ||||
|  | ||||
| func main() { | ||||
|   	m := macaron.Classic() | ||||
|   	m.Use(toolbox.Toolboxer(m)) | ||||
| 	m.Run() | ||||
| } | ||||
| ``` | ||||
|  | ||||
| Open your browser and visit `http://localhost:4000/debug` to see the effects. | ||||
|  | ||||
| ## Options | ||||
|  | ||||
| `toolbox.Toolboxer` comes with a variety of configuration options: | ||||
|  | ||||
| ```go | ||||
| type dummyChecker struct { | ||||
| } | ||||
|  | ||||
| func (dc *dummyChecker) Desc() string { | ||||
| 	return "Dummy checker" | ||||
| } | ||||
|  | ||||
| func (dc *dummyChecker) Check() error { | ||||
| 	return nil | ||||
| } | ||||
|  | ||||
| // ... | ||||
| m.Use(toolbox.Toolboxer(m, toolbox.Options{ | ||||
| 	URLPrefix:			"/debug",			// URL prefix for toolbox dashboard. | ||||
| 	HealthCheckURL:		"/healthcheck", 	// URL for health check request. | ||||
| 	HealthCheckers: []HealthChecker{ | ||||
| 		new(dummyChecker), | ||||
| 	},										// Health checkers. | ||||
| 	HealthCheckFuncs: []*toolbox.HealthCheckFuncDesc{ | ||||
| 		&toolbox.HealthCheckFuncDesc{ | ||||
| 			Desc: "Database connection", | ||||
| 			Func: func() error { return "OK" }, | ||||
| 		}, | ||||
| 	},										// Health check functions. | ||||
| 	PprofURLPrefix:		"/debug/pprof/", 	// URL prefix of pprof. | ||||
| 	ProfileURLPrefix:	"/debug/profile/", 	// URL prefix of profile. | ||||
| 	ProfilePath:		"profile", 			// Path store profile files. | ||||
| })) | ||||
| // ... | ||||
| ``` | ||||
|  | ||||
| ## Route Statistic | ||||
|  | ||||
| Toolbox also comes with a route call statistic functionality: | ||||
|  | ||||
| ```go | ||||
| import ( | ||||
| 	"os" | ||||
| 	"time" | ||||
| 	//... | ||||
| 	"github.com/go-macaron/toolbox" | ||||
| ) | ||||
|  | ||||
| func main() { | ||||
| 	//... | ||||
| 	m.Get("/", func(t toolbox.Toolbox) { | ||||
| 		start := time.Now() | ||||
| 		 | ||||
| 		// Other operations. | ||||
| 		 | ||||
| 		t.AddStatistics("GET", "/", time.Since(start)) | ||||
| 	}) | ||||
| 	 | ||||
| 	m.Get("/dump", func(t toolbox.Toolbox) { | ||||
| 		t.GetMap(os.Stdout) | ||||
| 	}) | ||||
| } | ||||
| ``` | ||||
|  | ||||
| Output take from test: | ||||
|  | ||||
| ``` | ||||
| +---------------------------------------------------+------------+------------------+------------------+------------------+------------------+------------------+ | ||||
| | Request URL                                       | Method     | Times            | Total Used(s)    | Max Used(μs)     | Min Used(μs)     | Avg Used(μs)     | | ||||
| +---------------------------------------------------+------------+------------------+------------------+------------------+------------------+------------------+ | ||||
| | /api/user                                         | POST       |                2 |         0.000122 |       120.000000 |         2.000000 |        61.000000 | | ||||
| | /api/user                                         | GET        |                1 |         0.000013 |        13.000000 |        13.000000 |        13.000000 | | ||||
| | /api/user                                         | DELETE     |                1 |         0.000001 |         1.400000 |         1.400000 |         1.400000 | | ||||
| | /api/admin                                        | POST       |                1 |         0.000014 |        14.000000 |        14.000000 |        14.000000 | | ||||
| | /api/user/unknwon                                 | POST       |                1 |         0.000012 |        12.000000 |        12.000000 |        12.000000 | | ||||
| +---------------------------------------------------+------------+------------------+------------------+------------------+------------------+------------------+ | ||||
| ``` | ||||
|  | ||||
| ## License | ||||
|  | ||||
| This project is under Apache v2 License. See the [LICENSE](LICENSE) file for the full license text. | ||||
		Reference in New Issue
	
	Block a user