Utility function to convert a handle string to a canonical instance.
Parameters
handle_str (str or Handle) – A string that represents a DocuShare handle like ‘Document-20202’.
If an instance of Handle is given, this method simply returns the same instance.
Returns
A canonical instance that represents the given handle.