chore: add a New() constructor + update examples

Signed-off-by: Manfred Touron <94029+moul@users.noreply.github.com>

README.md

@@ -21,12 +21,27 @@
 
 [embedmd]:# (example_test.go /import\ / $)
 ```go
-import "moul.io/zapconfig"
+import (
+	"go.uber.org/zap/zapcore"
+
+	"moul.io/zapconfig"
+)
 
 func Example() {
 	logger := zapconfig.Configurator{}.MustBuild()
 	logger.Info("hello!")
 }
+
+func Example_configuration() {
+	logger := zapconfig.New().
+		EnableStacktrace().
+		SetLevel(zapcore.DebugLevel).
+		SetOutputPath("stderr").
+		SetOutputPaths([]string{"stderr", "stdout", "./path/to/log.txt"}).
+		SetPreset("light-console").
+		MustBuild()
+	logger.Info("hello!")
+}
 ```
 
 ## Install

example_test.go

@@ -1,8 +1,23 @@
 package zapconfig_test
 
-import "moul.io/zapconfig"
+import (
+	"go.uber.org/zap/zapcore"
+
+	"moul.io/zapconfig"
+)
 
 func Example() {
 	logger := zapconfig.Configurator{}.MustBuild()
 	logger.Info("hello!")
 }
+
+func Example_configuration() {
+	logger := zapconfig.New().
+		EnableStacktrace().
+		SetLevel(zapcore.DebugLevel).
+		SetOutputPath("stderr").
+		SetOutputPaths([]string{"stderr", "stdout", "./path/to/log.txt"}).
+		SetPreset("light-console").
+		MustBuild()
+	logger.Info("hello!")
+}

zapconfig.go

@@ -18,6 +18,11 @@ type Configurator struct {
 	configErr  error
 }
 
+// New instanciates a Configurator.
+func New() *Configurator {
+	return &Configurator{}
+}
+
 // SetOutputPath sets zap.Config.OutputPaths and c.Config.ErrorOutputPaths with the given path.
 func (c *Configurator) SetOutputPath(dest string) *Configurator {
 	c.opts.OutputPaths = []string{dest}