def upload_file(file=nil,
                        category=nil,
                        project=nil,
                        generate_objects=false,
                        read_timeout=600,
                        low_priority_processing=false)
            __upload_file(file,
                          category,
                          project,
                          generate_objects,
                          read_timeout,
                          low_priority_processing)
        end
def upload_file(file=nil,
                        category=nil,
                        project=nil,
                        generate_objects=false,
                        read_timeout=600,
                        low_priority_processing=false)
            __upload_file(file,
                          category,
                          project,
                          generate_objects,
                          read_timeout,
                          low_priority_processing)
        end
Uploads a file to OpenAsset.

 @param file [String] the path to the file being uploaded
 @param category [Categories Object,String,Integer] containing Target Category ID in OpenAsset (Required)
 @param project [Projects Object, String, Integer] Project ID in OpenAsset (Specified only when Category is project based)
 @return [JSON Object] HTTP response JSON object. Returns Files objects array if generate_objects flag is set

 FOR PROJECT UPLOADS
 @example
          rest_client.upload_file('/path/to/file', category_obj, project_obj)
          rest_client.upload_file('/path/to/file','2','10')
          rest_client.upload_file('/path/to/file', 2, 10)
          rest_client.upload_file('/path/to/file', category_obj, project_obj, true)
          rest_client.upload_file('/path/to/file','2','10', true)
          rest_client.upload_file('/path/to/file', 2, 10, true)


 FOR REFERENCE UPLOADS
 @example
          rest_client.upload_file('/path/to/file', category_obj)
          rest_client.upload_file('/path/to/file','2')
          rest_client.upload_file('/path/to/file', 2,)
          rest_client.upload_file('/path/to/file', category_obj, nil, true)
          rest_client.upload_file('/path/to/file','2', nil, true)
          rest_client.upload_file('/path/to/file', 2, nil, true)