Comment 4 for bug 667183

checkUpload/canUpload would be fine. The current behavior is also fine, if documented properly. (quality of +apidoc documentation is definitely a huge shortcoming for us right now)

There's a network boundary between the client and the server, so there's always going to be some un-Pythonic behavior. We've tried to minimize this by mapping 2xx-3xx error codes onto normal Python object operations, and 4xx-5xx error codes onto Python exceptions, but some stuff will still not make sense.