try_catch.go

package try

/*
Converts a panic to an error, idempotently adding a stacktrace.
*/
func Catch(fun func()) (err error) {
	defer Rec(&err)
	if fun != nil {
		fun()
	}
	return
}

/*
Converts a panic to an error, if the error satisfies the provided test.
Otherwise re-panics. Idempotently adds a stacktrace.
*/
func CatchOnly(test func(error) bool, fun func()) (err error) {
	defer RecOnly(&err, test)
	if fun != nil {
		fun()
	}
	return
}

/*
Shortcut for `Catch() != nil`. Useful when you want to handle all errors while
ignoring their content.
*/
func Caught(fun func()) bool {
	return Catch(fun) != nil
}

/*
Shortcut for `CatchOnly() != nil`. Useful when you want to handle a specific
error while ignoring its content.
*/
func CaughtOnly(test func(error) bool, fun func()) bool {
	return CatchOnly(test, fun) != nil
}

/*
Runs a function, catching and ignoring ALL panics.
*/
func Ignoring(fun func()) {
	defer Ignore()
	if fun != nil {
		fun()
	}
}

/*
Runs a function, catching and ignoring only the panics that satisfy the provided
test. Idempotently adds a stacktrace to all panics.
*/
func IgnoringOnly(test func(error) bool, fun func()) {
	defer IgnoreOnly(test)
	if fun != nil {
		fun()
	}
}

/*
Runs a function, "transmuting" the resulting panics by calling the provided
transformer, which may choose to suppress or wrap specific error types. See
`Trans`.
*/
func Transing(trans func(error) error, fun func()) {
	defer Trans(trans)
	if fun != nil {
		fun()
	}
}