Skip to content

Commit 878d1a9

Browse files
committed
remove obsolete section about nested result type
1 parent 496b815 commit 878d1a9

File tree

1 file changed

+0
-18
lines changed

1 file changed

+0
-18
lines changed

README.md

Lines changed: 0 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -89,24 +89,6 @@ default_features = false
8989
features = ["dbx_files", "dbx_users"]
9090
```
9191

92-
## Result Types and Errors
93-
94-
Routes return a nested result type: `Result<Result<T, E>, dropbox_sdk::Error>`.
95-
The outer `Result` is `Err` if something went wrong in the course of actually
96-
making the request, such as network I/O errors or failure to serialize or
97-
deserialize the request data. This `Result`'s `Ok` variant is another `Result`
98-
where the `Ok` value is the deserialized successful result of the call, and the
99-
`Err` value is the strongly-typed error returned by the API. This inner error
100-
indicates some problem with the request, such as file not found, lacking
101-
permissions, etc.
102-
103-
The rationale for splitting the errors this way is that the former category
104-
usually can't be handled in any way other than by retrying the request, whereas
105-
the latter category indicate problems with the actual request itself and
106-
probably should not be retried. Since most callers can't handle I/O errors in
107-
any sensible way, this allows them to use the `?` syntax to pass it up the
108-
stack, while still handling errors returned by the server.
109-
11092
## Tests
11193

11294
The tests are auto-generated from the spec as well, but unlike the main code,

0 commit comments

Comments
 (0)