From cab8303b290e6111eaf9669d59c31768e747cbed Mon Sep 17 00:00:00 2001
From: "Gerasimos (Makis) Maropoulos" <kataras2006@hotmail.com>
Date: Sat, 29 Oct 2022 22:06:09 +0300
Subject: [PATCH] release v0.1.8

---
 .github/workflows/ci.yml |  2 +-
 HISTORY.md               |  4 ++
 LICENSE                  | 46 +++++++++----------
 README.md                | 14 +++---
 doc.go                   | 98 ++++++++++++++++------------------------
 go.mod                   |  2 +-
 golog.go                 |  7 +++
 logger.go                |  8 ++--
 8 files changed, 87 insertions(+), 94 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 7c84c8e..20dbad2 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -14,7 +14,7 @@ jobs:
 
     strategy:
       matrix:
-        go_version: [1.18.x]
+        go_version: [1.19.x]
     steps:
 
     - name: Set up Go 1.x
diff --git a/HISTORY.md b/HISTORY.md
index 63fc5bb..c570d16 100644
--- a/HISTORY.md
+++ b/HISTORY.md
@@ -1,3 +1,7 @@
+## Sat 29 October 2022 | v0.1.8
+
+Add `golog.Now` variable so 3rd-parties can customize the time.Now functionality used in golog.Log.Time and Timestamp.
+
 ## Wed 09 Decemember | v0.1.6
 
 Fix `Clone` not inherite the parent's formatters field (fixes `SetLevelFormat` on childs).
diff --git a/LICENSE b/LICENSE
index 0eb4e6d..fff2ab0 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,29 +1,29 @@
-Copyright (c) 2017-2022 Gerasimos Maropoulos.
+BSD 3-Clause License
 
+Copyright (c) 2017-2022, Gerasimos (Makis) Maropoulos (kataras2006@hotmail.com)
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are
-met:
+modification, are permitted provided that the following conditions are met:
 
-   * Redistributions of source code must retain the above copyright
-notice, this list of conditions and the following disclaimer.
-   * Redistributions in binary form must reproduce the above
-copyright notice, this list of conditions and the following disclaimer
-in the documentation and/or other materials provided with the
-distribution.
-   * Neither the name of golog nor the names of its
-contributors may be used to endorse or promote products derived from
-this software without specific prior written permission.
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
 
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
-A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
-OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
-THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
\ No newline at end of file
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/README.md b/README.md
index 39ebd0c..37fbc56 100644
--- a/README.md
+++ b/README.md
@@ -1,10 +1,10 @@
 # ✒️ golog
 
-_golog_ is a zero-dependency simple, fast and easy-to-use level-based logger written in [Go Programming Language](https://golang.org/dl).
+_golog_ is a zero-dependency simple, fast and easy-to-use level-based logger written in [Go Programming Language](https://go.dev).
 
 ![Output from win terminal](screen.png)
 
-[![build status](https://img.shields.io/github/workflow/status/kataras/golog/CI/master)](https://github.com/kataras/golog/actions) [![report card](https://img.shields.io/badge/report%20card-a%2B-ff3333.svg?style=flat-square)](http://goreportcard.com/report/kataras/golog) [![godocs](https://img.shields.io/badge/online-documentation-0366d6.svg?style=flat-square)](https://godoc.org/github.com/kataras/golog) [![github issues](https://img.shields.io/github/issues/kataras/golog.svg?style=flat-square)](https://github.com/kataras/golog/issues?q=is%3Aopen+is%3Aissue)
+[![build status](https://img.shields.io/github/workflow/status/kataras/golog/CI/master)](https://github.com/kataras/golog/actions) [![report card](https://img.shields.io/badge/report%20card-a%2B-ff3333.svg?style=flat-square)](http://goreportcard.com/report/kataras/golog) [![godocs](https://img.shields.io/badge/online-documentation-0366d6.svg?style=flat-square)](https://pkg.go.dev/github.com/kataras/golog) [![github issues](https://img.shields.io/github/issues/kataras/golog.svg?style=flat-square)](https://github.com/kataras/golog/issues?q=is%3Aopen+is%3Aissue)
 
 <!-- ## 🥇 Features
 
@@ -23,7 +23,7 @@ Navigate through [_examples](_examples/) and [integrations](_examples/integratio
 
 ## 🚀 Installation
 
-The only requirement is the Go Programming Language[*](https://golang.org).
+The only requirement is the Go Programming Language[*](https://go.dev/dl).
 
 <details>
 <summary>Go modules</summary>
@@ -34,13 +34,13 @@ $ go get github.com/kataras/golog@latest
 
 Or edit your project's go.mod file and execute $ go build.
 
-```bash
+```mod
 module your_project_name
 
-go 1.15
+go 1.19
 
 require (
-    github.com/kataras/golog v0.1.4
+    github.com/kataras/golog v0.1.8
 )
 ```
 
@@ -49,7 +49,7 @@ require (
 </details>
 
 ```bash
-$ go get -u github.com/kataras/golog
+$ go get github.com/kataras/golog@latest
 ```
 
 ```go
diff --git a/doc.go b/doc.go
index 442967b..cc1f744 100644
--- a/doc.go
+++ b/doc.go
@@ -1,31 +1,32 @@
 /*
-Copyright (c) 2017-2021 Gerasimos Maropoulos.
+CBSD 3-Clause License
+
+Copyright (c) 2017-2022, Gerasimos (Makis) Maropoulos (kataras2006@hotmail.com)
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are
-met:
-
-   * Redistributions of source code must retain the above copyright
-notice, this list of conditions and the following disclaimer.
-   * Redistributions in binary form must reproduce the above
-copyright notice, this list of conditions and the following disclaimer
-in the documentation and/or other materials provided with the
-distribution.
-   * Neither the name of golog nor the names of its
-contributors may be used to endorse or promote products derived from
-this software without specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
-A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
-OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
-THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+modification, are permitted provided that the following conditions are met:
+
+ 1. Redistributions of source code must retain the above copyright notice, this
+    list of conditions and the following disclaimer.
+
+ 2. Redistributions in binary form must reproduce the above copyright notice,
+    this list of conditions and the following disclaimer in the documentation
+    and/or other materials provided with the distribution.
+
+ 3. Neither the name of the copyright holder nor the names of its
+    contributors may be used to endorse or promote products derived from
+    this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 /*
@@ -33,21 +34,19 @@ Package golog provides an easy to use foundation for your logging operations.
 
 Source code and other details for the project are available at GitHub:
 
-   https://github.com/kataras/golog
+	https://github.com/kataras/golog
 
-Current Version
+# Current Version
 
-0.1.7
+0.1.8
 
-Installation
+# Installation
 
 The only requirement is the Go Programming Language
 
-    $ go get -u github.com/kataras/golog
-
-
-Overview
+	$ go get github.com/kataras/golog@latest
 
+# Overview
 
 Example code:
 
@@ -77,10 +76,7 @@ Example code:
 		golog.Debug("This is a debug message")
 	}
 
-
-
-New
-
+# New
 
 Golog has a default, package-level initialized instance for you,
 however you can choose to create and use a logger instance for a
@@ -112,12 +108,11 @@ Example Code:
 		log.Debug("This is a debug message")
 	}
 
-Format
+# Format
 
 Golog sets colors to levels when its `Printer.Output` is actual a compatible terminal
 which can renders colors, otherwise it will downgrade itself to a white foreground.
 
-
 Golog has functions to print a formatted log too.
 
 Example Code:
@@ -127,8 +122,7 @@ Example Code:
 	golog.Errorf("[%d] This is an info %s", 1, "formatted log")
 	golog.Debugf("[%d] This is an info %s", 1, "formatted log")
 
-
-Output
+# Output
 
 Golog takes a simple `io.Writer` as its underline Printer's Output.
 
@@ -136,15 +130,13 @@ Example Code:
 
 	golog.SetOutput(io.Writer)
 
-
 You can even override the default line braker, "\n", by using the `golog#NewLine` function at startup.
 
 Example Code:
 
 	golog.NewLine("\r\n")
 
-
-Levels
+# Levels
 
 Golog is a leveled logger, therefore you can set a level and print
 whenever the print level is valid with the set-ed one.
@@ -162,14 +154,12 @@ Available built'n levels are:
 	// DebugLevel will print on any level, errors, warnings, infos and debug messages
 	DebugLevel
 
-
 Below you'll learn a way to add a custom level or modify an existing level.
 
 The default colorful text(or raw text for unsupported outputs) for levels
 can be overridden by using the `golog#ErrorText, golog#WarnText, golog#InfoText and golog#DebugText`
 functions.
 
-
 Example Code:
 
 	package main
@@ -203,10 +193,8 @@ Example Code:
 		golog.Debug("This is a debug message")
 	}
 
-
 Golog gives you the power to add or modify existing levels is via Level Metadata.
 
-
 Example Code:
 
 	package main
@@ -248,12 +236,10 @@ Example Code:
 		myLogger.Logf(SuccessLevel, "This is a success log message with green color")
 	}
 
-
 The logger's level can be changed via passing one of the
 level constants to the `Level` field or by
 passing its string representation to the `SetLevel` function.
 
-
 Example Code:
 
 	golog.SetLevel("disable")
@@ -263,8 +249,7 @@ Example Code:
 	golog.SetLevel("info")
 	golog.SetLevel("debug")
 
-
-Integrations
+# Integrations
 
 Transaction with your favorite, but deprecated logger is easy.
 Golog offers two basic interfaces, the `ExternalLogger` and the `StdLogger`
@@ -300,8 +285,7 @@ Outline:
 	// Look `golog#Handle` for more.
 	InstallStd(logger StdLogger)
 
-
-Logrus Integration
+# Logrus Integration
 
 Example Code:
 
@@ -348,8 +332,7 @@ Example Code:
 		golog.Error("this error message will be visible as text")
 	}
 
-
-Standard `log.Logger` Integration
+# Standard `log.Logger` Integration
 
 Example Code:
 
@@ -377,8 +360,7 @@ Example Code:
 		golog.Warn("this info message will not be visible")
 	}
 
-
-That's the basics
+# That's the basics
 
 But you should have a basic idea of the golog package by now, we just scratched the surface.
 If you enjoy what you just saw and want to learn more, please follow the below links:
@@ -390,4 +372,4 @@ Examples:
 package golog
 
 // Version is the version string representation of the "golog" package.
-const Version = "0.1.7"
+const Version = "0.1.8"
diff --git a/go.mod b/go.mod
index 1fe715a..9a2711a 100644
--- a/go.mod
+++ b/go.mod
@@ -1,6 +1,6 @@
 module github.com/kataras/golog
 
-go 1.18
+go 1.19
 
 require github.com/kataras/pio v0.0.11
 
diff --git a/golog.go b/golog.go
index 259111c..11aaa1e 100644
--- a/golog.go
+++ b/golog.go
@@ -2,10 +2,16 @@ package golog
 
 import (
 	"io"
+	"time"
 
 	"github.com/kataras/pio"
 )
 
+// Now is called to set the log's timestamp value.
+// It can be altered through initialization of the program
+// to customize the behavior of getting the current time.
+var Now func() time.Time = time.Now
+
 // NewLine can override the default package-level line breaker, "\n".
 // It should be called (in-sync) before  the print or leveled functions.
 //
@@ -199,6 +205,7 @@ func Install(logger ExternalLogger) {
 // it can be used only once per `golog#Logger` instance.
 //
 // Example Code:
+//
 //	import "log"
 //	myLogger := log.New(os.Stdout, "", 0)
 //	InstallStd(myLogger)
diff --git a/logger.go b/logger.go
index 0086963..540d25e 100644
--- a/logger.go
+++ b/logger.go
@@ -6,7 +6,6 @@ import (
 	"os"
 	"strings"
 	"sync"
-	"time"
 
 	"github.com/kataras/pio"
 )
@@ -90,7 +89,7 @@ func (l *Logger) acquireLog(level Level, msg string, withPrintln bool, fields Fi
 
 	log.NewLine = withPrintln
 	if l.TimeFormat != "" {
-		log.Time = time.Now()
+		log.Time = Now()
 		log.Timestamp = log.Time.Unix()
 	}
 	log.Level = level
@@ -142,7 +141,7 @@ var logHijacker = func(ctx *pio.Ctx) {
 	}
 
 	if prefix := logger.Prefix; len(prefix) > 0 {
-		fmt.Fprintf(w, prefix)
+		fmt.Fprint(w, prefix)
 	}
 
 	fmt.Fprint(w, l.Message)
@@ -500,6 +499,7 @@ func (l *Logger) Install(logger ExternalLogger) {
 // it can be used only once per `golog#Logger` instance.
 //
 // Example Code:
+//
 //	import "log"
 //	myLogger := log.New(os.Stdout, "", 0)
 //	InstallStd(myLogger)
@@ -568,7 +568,7 @@ func (l *Logger) Scan(r io.Reader) (cancel func()) {
 			}
 
 			if l.TimeFormat != "" {
-				formattedTime := time.Now().Format(l.TimeFormat)
+				formattedTime := Now().Format(l.TimeFormat)
 				line = append([]byte(formattedTime+" "), line...)
 			}