builder by value

pass builder by value, therefore it is not allocated

benchmark                         old ns/op     new ns/op     delta
BenchmarkAllocProperty/props0     100           83.3          -16.70%
BenchmarkAllocProperty/props1     319           296           -7.21%
BenchmarkAllocProperty/props2     628           606           -3.50%
BenchmarkAllocProperty/props3     1033          1009          -2.32%
BenchmarkAllocProperty/props4     1485          1439          -3.10%
BenchmarkAllocProperty/props5     2012          1952          -2.98%
BenchmarkAllocProperty/props6     2573          2486          -3.38%
BenchmarkAllocProperty/props7     3201          3115          -2.69%
BenchmarkAllocProperty/props8     3829          3751          -2.04%

benchmark                         old allocs     new allocs     delta
BenchmarkAllocProperty/props0     2              1              -50.00%
BenchmarkAllocProperty/props1     5              4              -20.00%
BenchmarkAllocProperty/props2     8              7              -12.50%
BenchmarkAllocProperty/props3     11             10             -9.09%
BenchmarkAllocProperty/props4     14             13             -7.14%
BenchmarkAllocProperty/props5     17             16             -5.88%
BenchmarkAllocProperty/props6     20             19             -5.00%
BenchmarkAllocProperty/props7     23             22             -4.35%
BenchmarkAllocProperty/props8     26             25             -3.85%

benchmark                         old bytes     new bytes     delta
BenchmarkAllocProperty/props0     176           96            -45.45%
BenchmarkAllocProperty/props1     672           592           -11.90%
BenchmarkAllocProperty/props2     1168          1088          -6.85%
BenchmarkAllocProperty/props3     1664          1584          -4.81%
BenchmarkAllocProperty/props4     2160          2080          -3.70%
BenchmarkAllocProperty/props5     2656          2576          -3.01%
BenchmarkAllocProperty/props6     3152          3072          -2.54%
BenchmarkAllocProperty/props7     3648          3568          -2.19%
BenchmarkAllocProperty/props8     4144          4064          -1.93%

Author: funny-falcon

builder.go

@@ -18,15 +18,15 @@ type ErrorBuilder struct {
 }
 
 // NewErrorBuilder creates error builder from an existing error type.
-func NewErrorBuilder(t *Type) *ErrorBuilder {
+func NewErrorBuilder(t *Type) ErrorBuilder {
 	getMode := func() callStackBuildMode {
 		if !t.modifiers.CollectStackTrace() {
 			return stackTraceOmit
 		}
 		return stackTraceCollect
 	}
 
-	return &ErrorBuilder{
+	return ErrorBuilder{
 		errorType:     t,
 		mode:          getMode(),
 		isTransparent: t.modifiers.Transparent(),
@@ -37,7 +37,7 @@ func NewErrorBuilder(t *Type) *ErrorBuilder {
 // For non-errorx errors, a stack trace is collected.
 // Otherwise, it is inherited by default, as error wrapping is typically performed 'en passe'.
 // Note that even if an original error explicitly omitted the stack trace, it could be added on wrap.
-func (eb *ErrorBuilder) WithCause(err error) *ErrorBuilder {
+func (eb ErrorBuilder) WithCause(err error) ErrorBuilder {
 	eb.cause = err
 	if Cast(err) != nil {
 		eb.mode = stackTraceBorrow
@@ -50,7 +50,7 @@ func (eb *ErrorBuilder) WithCause(err error) *ErrorBuilder {
 // Transparent wrap hides the current error type from the type checks and exposes the error type of the cause instead.
 // The same holds true for traits, and the dynamic properties are visible from both cause and transparent wrapper.
 // Note that if the cause error is non-errorx, transparency will still hold, type check against wrapper will still fail.
-func (eb *ErrorBuilder) Transparent() *ErrorBuilder {
+func (eb ErrorBuilder) Transparent() ErrorBuilder {
 	if eb.cause == nil {
 		panic("wrong builder usage: wrap modifier without non-nil cause")
 	}
@@ -64,7 +64,7 @@ func (eb *ErrorBuilder) Transparent() *ErrorBuilder {
 // This is typically a way to handle an error received from another goroutine - say, a worker pool.
 // When stack traces overlap, formatting makes a conservative attempt not to repeat itself,
 // preserving the *original* stack trace in its entirety.
-func (eb *ErrorBuilder) EnhanceStackTrace() *ErrorBuilder {
+func (eb ErrorBuilder) EnhanceStackTrace() ErrorBuilder {
 	if eb.cause == nil {
 		panic("wrong builder usage: wrap modifier without non-nil cause")
 	}
@@ -81,7 +81,7 @@ func (eb *ErrorBuilder) EnhanceStackTrace() *ErrorBuilder {
 // WithConditionallyFormattedMessage provides a message for an error in flexible format, to simplify its usages.
 // Without args, leaves the original message intact, so a message may be generated or provided externally.
 // With args, a formatting is performed, and it is therefore expected a format string to be constant.
-func (eb *ErrorBuilder) WithConditionallyFormattedMessage(message string, args ...interface{}) *ErrorBuilder {
+func (eb ErrorBuilder) WithConditionallyFormattedMessage(message string, args ...interface{}) ErrorBuilder {
 	if len(args) == 0 {
 		eb.message = message
 	} else {
@@ -92,7 +92,7 @@ func (eb *ErrorBuilder) WithConditionallyFormattedMessage(message string, args .
 }
 
 // Create returns an error with specified params.
-func (eb *ErrorBuilder) Create() *Error {
+func (eb ErrorBuilder) Create() *Error {
 	return &Error{
 		errorType:   eb.errorType,
 		message:     eb.message,
@@ -112,7 +112,7 @@ const (
 	stackTraceOmit    callStackBuildMode = 4
 )
 
-func (eb *ErrorBuilder) assembleStackTrace() *stackTrace {
+func (eb ErrorBuilder) assembleStackTrace() *stackTrace {
 	switch eb.mode {
 	case stackTraceCollect:
 		return eb.collectOriginalStackTrace()
@@ -127,19 +127,19 @@ func (eb *ErrorBuilder) assembleStackTrace() *stackTrace {
 	}
 }
 
-func (eb *ErrorBuilder) collectOriginalStackTrace() *stackTrace {
+func (eb ErrorBuilder) collectOriginalStackTrace() *stackTrace {
 	return collectStackTrace()
 }
 
-func (eb *ErrorBuilder) borrowStackTraceFromCause() *stackTrace {
+func (eb ErrorBuilder) borrowStackTraceFromCause() *stackTrace {
 	originalStackTrace := eb.extractStackTraceFromCause(eb.cause)
 	if originalStackTrace != nil {
 		return originalStackTrace
 	}
 	return collectStackTrace()
 }
 
-func (eb *ErrorBuilder) combineStackTraceWithCause() *stackTrace {
+func (eb ErrorBuilder) combineStackTraceWithCause() *stackTrace {
 	currentStackTrace := collectStackTrace()
 
 	originalStackTrace := eb.extractStackTraceFromCause(eb.cause)
@@ -150,7 +150,7 @@ func (eb *ErrorBuilder) combineStackTraceWithCause() *stackTrace {
 	return currentStackTrace
 }
 
-func (eb *ErrorBuilder) extractStackTraceFromCause(cause error) *stackTrace {
+func (eb ErrorBuilder) extractStackTraceFromCause(cause error) *stackTrace {
 	if typedCause := Cast(cause); typedCause != nil {
 		return typedCause.stackTrace
 	}