Update to 8.0.3 | Request logger improvements, error handlers improvements. Read HISTORY.md

Former-commit-id: fb5eca0dc955d8c07fdba35b47068008565dbbd1

_examples/README.md

@@ -11,7 +11,8 @@ It doesn't always contain the "best ways" but it does cover each important featu
 - [Hello world!](hello-world/main.go)
 - [Glimpse](overview/main.go)
 - [Tutorial: Online Visitors](tutorial/online-visitors/main.go)
-- [Tutorial: URL Shortener using BoltDB](tutorial/url-shortener/main.go)
+- [Tutorial: URL Shortener using BoltDB](https://medium.com/@kataras/a-url-shortener-service-using-go-iris-and-bolt-4182f0b00ae7)
+- [Tutorial: How to turn your Android Device into a fully featured Web Server](https://medium.com/@kataras/how-to-turn-an-android-device-into-a-web-server-9816b28ab199)
 
 ### HTTP Listening 
 
@@ -24,7 +25,7 @@ It doesn't always contain the "best ways" but it does cover each important featu
     * [common net.Listener](http-listening/custom-listener/main.go)
     * [SO_REUSEPORT for unix systems](http-listening/custom-listener/unix-reuseport/main.go)
 - Custom HTTP Server
-    * [iris way](http-listening/custom-httpserver/easy-way/main.go)
+    * [easy way](http-listening/custom-httpserver/easy-way/main.go)
     * [std way](http-listening/custom-httpserver/std-way/main.go)
     * [multi server instances](http-listening/custom-httpserver/multi/main.go)
 - Graceful Shutdown
@@ -81,12 +82,12 @@ Navigate through examples for a better understanding.
 - [Basic](routing/basic/main.go)
 - [Custom HTTP Errors](routing/http-errors/main.go)
 - [Dynamic Path](routing/dynamic-path/main.go)
-    * [Root Level Wildcard Path](routing/dynamic-path/root-wildcard/main.go)
+    * [root level wildcard path](routing/dynamic-path/root-wildcard/main.go)
 - [Reverse routing](routing/reverse/main.go)
 - [Custom wrapper](routing/custom-wrapper/main.go)
 - Custom Context
-    * [Method Overriding](routing/custom-context/method-overriding/main.go)
-    * [New Implementation](routing/custom-context/new-implementation/main.go)
+    * [method overriding](routing/custom-context/method-overriding/main.go)
+    * [new implementation](routing/custom-context/new-implementation/main.go)
 - [Route State](routing/route-state/main.go)
 
 ### Subdomains
@@ -134,8 +135,8 @@ Navigate through examples for a better understanding.
 - [Embedding Files Into App Executable File](file-server/embedding-files-into-app/main.go)
 - [Send/Force-Download Files](file-server/send-files/main.go)
 - Single Page Applications
-    * [Single Page Application](file-server/single-page-application/basic/main.go)
-    * [Embedded Single Page Application](file-server/single-page-application/embedded-single-page-application/main.go)
+    * [single Page Application](file-server/single-page-application/basic/main.go)
+    * [embedded Single Page Application](file-server/single-page-application/embedded-single-page-application/main.go)
 
 ### How to Read from `context.Request() *http.Request`
 
@@ -156,6 +157,7 @@ Navigate through examples for a better understanding.
 ### Miscellaneous
 
 - [Request Logger](http_request/request-logger/main.go)
+    * [log requests to a file](http_request/request-logger/request-logger-file/main.go)
 - [Localization and Internationalization](miscellaneous/i18n/main.go)
 - [Recovery](miscellaneous/recover/main.go)
 - [Profiling (pprof)](miscellaneous/pprof/main.go)

_examples/http_request/request-logger/main.go

@@ -22,24 +22,25 @@ func main() {
 
 	app.Use(customLogger)
 
-	app.Get("/", func(ctx context.Context) {
-		ctx.Writef("hello")
-	})
+	h := func(ctx context.Context) {
+		ctx.Writef("Hello from %s", ctx.Path())
+	}
+	app.Get("/", h)
 
-	app.Get("/1", func(ctx context.Context) {
-		ctx.Writef("hello")
-	})
+	app.Get("/1", h)
 
-	app.Get("/2", func(ctx context.Context) {
-		ctx.Writef("hello")
-	})
+	app.Get("/2", h)
 
-	// log http errors should be done manually
-	errorLogger := logger.New()
-
-	app.OnErrorCode(iris.StatusNotFound, func(ctx context.Context) {
-		errorLogger(ctx)
-		ctx.Writef("My Custom 404 error page ")
+	// http errors have their own handlers, therefore
+	// registering a middleare should be done manually.
+	/*
+	 app.OnErrorCode(404 ,customLogger, func(ctx context.Context) {
+	 	ctx.Writef("My Custom 404 error page ")
+	 })
+	*/
+	// or catch all http errors:
+	app.OnAnyErrorCode(customLogger, func(ctx context.Context) {
+		ctx.Writef("My Custom error page")
 	})
 
 	// http://localhost:8080

_examples/http_request/request-logger/request-logger-file/main.go

@@ -0,0 +1,109 @@
+package main
+
+import (
+	"os"
+	"strings"
+	"time"
+
+	"github.com/kataras/iris"
+	"github.com/kataras/iris/context"
+	"github.com/kataras/iris/middleware/logger"
+)
+
+const deleteFileOnExit = true
+
+func main() {
+	app := iris.New()
+	r, close := newRequestLogger()
+	defer close()
+
+	app.Use(r)
+	app.OnAnyErrorCode(r, func(ctx context.Context) {
+		ctx.HTML("<h1> Error: Please try <a href ='/'> this </a> instead.</h1>")
+	})
+
+	h := func(ctx context.Context) {
+		ctx.Writef("Hello from %s", ctx.Path())
+	}
+
+	app.Get("/", h)
+
+	app.Get("/1", h)
+
+	app.Get("/2", h)
+
+	// http://localhost:8080
+	// http://localhost:8080/1
+	// http://localhost:8080/2
+	// http://lcoalhost:8080/notfoundhere
+	app.Run(iris.Addr(":8080"))
+}
+
+// get a filename based on the date, file logs works that way the most times
+// but these are just a sugar.
+func todayFilename() string {
+	today := time.Now().Format("Jan 02 2006")
+	return today + ".txt"
+}
+
+func newLogFile() *os.File {
+	filename := todayFilename()
+	// open an output file, this will append to the today's file if server restarted.
+	f, err := os.OpenFile(filename, os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
+	if err != nil {
+		panic(err)
+	}
+
+	return f
+}
+
+var excludeExtensions = [...]string{
+	".js",
+	".css",
+	".jpg",
+	".png",
+	".ico",
+	".svg",
+}
+
+func newRequestLogger() (h context.Handler, close func() error) {
+	close = func() error { return nil }
+
+	c := logger.Config{
+		Status:  true,
+		IP:      true,
+		Method:  true,
+		Path:    true,
+		Columns: true,
+	}
+
+	logFile := newLogFile()
+	close = func() error {
+		err := logFile.Close()
+		if deleteFileOnExit {
+			err = os.Remove(logFile.Name())
+		}
+		return err
+	}
+
+	c.LogFunc = func(now time.Time, latency time.Duration, status, ip, method, path string) {
+		output := logger.Columnize(now.Format("2006/01/02 - 15:04:05"), latency, status, ip, method, path)
+		logFile.Write([]byte(output))
+	}
+
+	//	we don't want to use the logger
+	// to log requests to assets and etc
+	c.AddSkipper(func(ctx context.Context) bool {
+		path := ctx.Path()
+		for _, ext := range excludeExtensions {
+			if strings.HasSuffix(path, ext) {
+				return true
+			}
+		}
+		return false
+	})
+
+	h = logger.New(c)
+
+	return
+}