Thanks for continuing the discussion David.

> On Dec 21, 2015, at 1:30 PM, David Owens II <da...@owensd.io> wrote:
> 
> I’m just going to interject a few thoughts in here.
> 
>> On Dec 21, 2015, at 6:36 AM, Matthew Johnson <matt...@anandabits.com 
>> <mailto:matt...@anandabits.com>> wrote:
>> 
>> Hi David,
>> 
>> (my paraphrase: pattern matching is great and solves more of my concerns 
>> than I originally realized.) 
> 
> Awesome!
> 
>> I would also like to comment that there are some interesting related ideas 
>> for enhancing enums in the "[Pitch] Use enums as enum underlying types” 
>> thread.  They don’t directly impact the proposal but could make such use 
>> cases even more convenient if they are pursued independently.
> 
> I’m not sure I really like any of those proposals, but feedback for those is 
> better on that thread, and I’ve only taken a cursory look at them.

Sure, just wanted to mention them.  I’m not sure whether I like any of them 
either - even the ones I have posted.  I do think they are interesting to think 
about but I am not sure whether they are good ideas or not.

> 
>> The other concern I have is still valid, but I think a relatively 
>> straightforward solution is possible.
>> 
>> (my paraphrase: Converting from an inner-error to a publicly exposed error 
>> is tedious, boilerplate code.)
> 
> Maybe. I think that depends on the assumption that you do nothing other than 
> convert the inner error to a published error. Also, it assumes that all 
> “recoverable” inner errors stay “recoverable” outer errors.
> 
> I tend to use a lot of telemetry markers and assertions within my code, so 
> it’s not a one-liner conversion.
> 
> do {
>     try some.implementation.detail.throwing.api()
> }
> catch {
>     // what happens here?
> }
> 
> I actually think there are various options of what to do at this place:
> 
> Simply propagate the error out (basically untyped errors)
> Wrap the error (still exposes the internal implementation details)
> Convert the error to a published error type
> Promote the error to a non-recoverable error (e.g. fatalError())
> 
> All of these can have additional code in place, such as telemetry/logging or 
> debug assertions. While it might be the case that people simply want to wrap 
> an error, can we say that is the safe way to deal with the errors? I’m not 
> sure I’m willing to make that statement.

I agree.  I am proposing a solution to reduce boilerplate where either option 2 
or 3 is the right thing to do.  Obviously if you need to do something more 
complex you do need to handle the error, in which case it is not boilerplate.  
The suggestion of implicit conversion would not prevent you from doing this.

Please note: sometimes option 2 exposes implementation details but not 
necessarily.  The example I discussed was describing a scenario where a library 
has a family of possible errors it publishes as part of its API contract and 
two (or more) different ones may be generated by the same function.

> 
> I, obviously, recommend against doing options #1 and #2 above. I’ll talk 
> about conversion below. And I believe promotion would look something like 
> this:
> 
> guard ((try? some.implementation.detail.throwing.api()) != nil) else { 
> fatalError("bad mojo!") }
> 
> Or if I want the error:
> 
> do {
>     try some.implementation.detail.throwing.api()
> }
> catch {
>     Telemetry.LogFatalIssue(error)
>     fatalError("bad mojo!")
> }
> 
> In an ideal world, I would also like to be able to do something like this:
> 
> guard try some.implementation.detail.throwing.api() else {
>     Telemetry.LogFatalIssue(error)
>     fatalError("bad mojo!")    
> }
> 
> But that’s a syntax that’s out-of-scope for this proposal as well.
> 
>> This is the problem that `From` addresses in Rust.  Swift is not Rust and 
>> our solution will look different.  The point is that this is a problem and 
>> it can and has been solved.
>> 
>> My suggestion is that we should allow implicit conversion during error 
>> propagation.  If the published error type has one and only one non-failable, 
>> non-throwing initializer that takes a single argument of the type that is 
>> thrown (including enum case initializers with a single associated value of 
>> the thrown type) that initializer is used to implicitly convert to the 
>> published error type.  This conversion could be accomplished by synthesizing 
>> the necessary boilerplate or by some other means.
>> 
>> Now we have:
>> 
>> func functionThatCallsUnderlingyingThrows(_ whichError: Bool) throws 
>> MyPublishedError {
>>         try funcThatThrowsAnErrorThatMustBeTranslatedIntoMyPublishedError()
>> }
>> 
>> This looks as it should.  We don’t pay a price of boilerplate for carefully 
>> designing the errors we expose in our API contract.  This also handles 
>> automatic wrapping of errors where that is appropriate.
> 
> I would argue against implicit conversion. Again, this is about consistency 
> with the language. Also, Rust is using it’s macro system to generate the 
> code; it’s not actually doing implicit conversions either.

I understand that Rust is not doing implicit conversions, but the effect for 
the user is pretty much the same.  The try macro is converting the underlying 
error to the type that can be propagated.  As I stated, Swift is not Rust and 
deserves a different solution.  

Nevertheless, that does not minimize the need to solve the problem.  I maintain 
that the problem solved by the try macro is a significant one that is not 
addressed by the current proposal.  I would really like to see it addressed one 
way or another.

> 
> You could make it “nicer” by doing something like this:
> 
> try MyError.convertFrom(try 
> funcThatThrowsAnErrorThatMustBeTranslatedItoMyPublishedError())

Can you elaborate on how you think this would work?  If 
funcThatThrowsAnErrorThatMustBeTranslatedItoMyPublishedError actually throws it 
will be propagated to the next enclosing catch clause.  MyError.convertFrom 
will not have a chance to do anything with it.

> 
> All of the “boiler-plate” code (which you need to write the conversion code 
> regardless) can be put where it needs to be and kept out of all of the call 
> sites. You could then propose a “conversion” feature to Swift that would 
> allow explicit conversions:
> 
> try funcThatThrowsAnErrorThatMustBeTranslatedItoMyPublishedError() as MyError
> 
> This could call the conversion initializers.
> 

This would be casting the return value, not the error value.  Again, the error 
would be propagated to the next enclosing catch block.

I would probably be ok with the need to *explicitly* declare a conversion like 
this at the call site if that were possible (although I would want to consider 
concrete examples).  It just isn’t possible in the language today so 1) it’s 
hard to know exactly what it would look like and 2) it shouldn’t be part of the 
discussion unless we are considering adding something specific to the proposal.

Are you willing to explore adding *explicit* syntax to convert thrown errors to 
your proposal?  That seems like it might be a reasonable compromise between 
implicit conversions and manual boilerplate.  

I still prefer implicit conversions in this case and believe the value they 
bring to the table far outweighs their cost.  We are not talking about implicit 
conversion of arbitrary expressions here.  We are talking about implicit 
conversion specifically at the time of error propagation *from* the explicitly 
stated error type in throwing functions that are called *to* the explicitly 
stated error type in the calling function *if* an eligible initializer exists.  

This is a pretty narrow case with pretty obvious results IMO.  And it only 
kicks in if the underlying error is propagated out of the function so you still 
have the ability to catch it and log it, suppress it, convert to fatalError(), 
etc if you need to do that.

Matthew

_______________________________________________
swift-evolution mailing list
swift-evolution@swift.org
https://lists.swift.org/mailman/listinfo/swift-evolution

Reply via email to