// ------------------------------------------------------------------------
// 🚀 Project active3
// 🔗 Active Thing (activething.com) git.activething.com/go
//
//    File name  active.go
// ✍️ Created by DEV
// 📅 Modified   04/05/2024
//
// 🔒 Copyright 2024 activething.com
//  
// 📜 LICENSE --------------------------------------------------------------
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
// ------------------------------------------------------------------------

package wrap

const(

	errNilWrapMsg  string = "error trying to wrap % into a nil error"
	errNilCauseMsg string = "error trying to wrap % into a nil cause"
)




var (


	G = struct {

		ErrNilWrap 	ErrCode

		InfoLink 	string
		InfoHelp 	string

	}{
		ErrNilWrap  : ErrCode("wrap-nil-error"),

		InfoLink	: "https://git.activething.com/go/active",
		InfoHelp	: "https://doc.activething.com/go/active",

	}
)




func TryWithCause(err error, cause error) error {
	if err == nil && cause == nil {
		return nil
	}
	if err == nil {
		return cause
	}
	if cause == nil {
		return err
	}
	return *WithCause(err,cause)
}


func TryWrapWithInfo (err error) error {
	if err == nil {
		return nil
	}
	return *WithInfo(err)
}


func TryWrapWithTrace(err error, offset int) error {
	if err == nil {
		return nil
	}
	return *WithTrace(err,offset)
}


func TryWrapWithMessage (err error, message string) error {
	if err == nil { return nil }
	return *WithMessage(err,message)
}