How to confirm success of subreddit.submit function?

subreddit.submit() returns a Submisison object. How can I check whether the submission was successful or not? None of the fields in a submission indicate this information. thanks!

[jarhill0]

We can’t accurately document Reddit’s exceptions since Reddit has gone closed-source. All of those end up as APIException, which we have documentation for.

[jarhill0]

@RylanSchaeffer Thank you for expressing your concerns.

In my experience, PRAW’s handling of this is in line with most other Python libraries. That is, for most other libraries, if a function returns without raising an exception, then it has succeeded. This is also true of the Python standard library; for instance, Python’s file handling will throw an exception such as FileNotFoundError under certain conditions, but lack of exceptions indicates success.

In what ways can we make this clearer? I want new users of PRAW to be as comfortable as possible. One option might be to write another tutorial like this one and the other two that we already have. The new tutorial could focus on a few tasks which might fail and how to handle failure. Do you have another suggestion?

Thanks for your input!