Konubinix' opinionated web of thoughts

Handling Errors and Panic in Rust

Fleeting

To panic! or Not To panic! - The Rust Programming Language

If someone calls your code and passes in values that don’t make sense, the best choice might be to call panic! and alert the person using your library to the bug in their code so they can fix it during development. Similarly, panic! is often appropriate if you’re calling external code that is out of your control and it returns an invalid state that you have no way of fixing.

However, when failure is expected, it’s more appropriate to return a Result than to make a panic! call. Examples include a parser being given malformed data or an HTTP request returning a status that indicates you have hit a rate limit. In these cases, returning a Result indicates that failure is an expected possibility that the calling code must decide how to handle.

https://doc.rust-lang.org/stable/book/ch09-03-to-panic-or-not-to-panic.html

Panicking when the contract is violated makes sense because a contract violation always indicates a caller-side bug and it’s not a kind of error you want the calling code to have to explicitly handle.

https://doc.rust-lang.org/stable/book/ch09-03-to-panic-or-not-to-panic.html