-
Notifications
You must be signed in to change notification settings - Fork 45
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Replace errutil with pkg/errors #22
Comments
I agree. If we can reduce 15 competing standards to 14, I would be happy to do so. |
Replacing is easy, but finding the ones without added context is much more difficult. |
Could you elaborate, what does "finding the ones without added context" refer to? I wish to get added info, e.g. include call stack for each error: https://godoc.org/github.com/pkg/errors#hdr-Adding_context_to_an_error Edit: Ah, I see what you mean now. Rather than using errors,WithStack you refer to adding our own context to the error using errors.Wrap. Yeah, that would be more difficult for sure. Where it makes sense we can do it, and use WithStack for others. |
Hmm, this may be a breaking change I just realized. Having changed to make use of pkg/errors to add call stack context to error values, then The errors branch fail with:
Have to investigate further. Perhaps this update will be part of the move to ljud/flac then, as it is a breaking change. |
We cannot use errors.WithStack [1] to maintain call stack information of zeros.Read as this method is invoked from io.Copy (in verifyPadding) which expects io.EOF. Note, the type of the returned error in the case of EOF becomes, "errors.withStack" with the concrete value: errors.withStack{error: io.EOF, stack: callers()} This broke the tests: https://travis-ci.org/mewkiz/flac/builds/383805346#L540 We cannot update the standard library to check for io.EOF using errors.Cause(err) == io.EOF. Thus, this seems like the only solution. Unfortunate, and a bit scare, as there may be other use of interfaces which break since the error returned is wrapped with added context. Hope this gets resolved in Go 2. I know @bradfitz among others have raised their interest in finding ways to improve and further simplify error handling mechanisms [2]. [1]: https://github.com/pkg/errors [2]: https://github.com/golang/go/wiki/Go2 Updates #22. Related to golang/go#21161.
Wow, that's a concealed footgun I didn't think about. Yeah, sounds good. If we find a solution we'll add it before the big move. |
I know, very scary. Especially as this will introduce issues in the future when we forget to be careful about handling the added context in the right way. I tried to find a solution that allows us to make the transition today, and there is a way. Basically, for each exposed API, we need to make sure that every error value returned is unwrapped if it is either an API global variables (e.g. frame.ErrInvalidSyncCode and meta.ErrReservedType) or a standard library error that we return to implement specific interfaces (e.g. return Having tried to do this, I can testify that this approach is fragile as hell. For instance, lets say we have frame.Frame.Parse return the concrete error values. Then since frame.Parse invokes frame.Frame.Parse, it cannot wrap the error, but also has to introspect it to unwrap if belonging to exposed error values, and otherwise wrap it. Now, what if we add a new function in a year or two, say So, for what it's worth. I think we keep it as is for now. I usually don't like the phrase Don't fix it if it aint broken. as even working things can be ugly as hell, and being a hobby project and all, its fun to build something beautiful. But this definitely requires more thought. Edit: correction, the errors branch works now, with test cases passing and all; and the latest changes of the master branch have been merged into the errors branch. However, this relies on the usage of |
Worth mentioning that the go 2 errors proposal was just accepted and due to land in go 1.13. golang/go#29934 |
Look into using error return paths (a la Zig), as implemented by for instance https://github.com/bracesdev/errtrace |
Currently we are using errutils at some places, e.g. https://github.com/karlek/flac/blob/66eeb19133306fb37c2cfa5b3dab532224c734f7/enc.go#L28
At other places, we return the error without added context.
I suggest we change from mewkiz/pkg/errutil to pkg/errors and at the same time make sure to add context to all returned errors. What are your thoughts @karlek?
The text was updated successfully, but these errors were encountered: