flywheel-sdk 21.2.0__py3-none-any.whl

flywheel/api/custom_filters_api.py

@@ -0,0 +1,466 @@
+# coding: utf-8
+
+"""
+    Flywheel
+
+    No description provided (generated by Swagger Codegen https://github.com/swagger-api/swagger-codegen)  # noqa: E501
+
+    OpenAPI spec version: 0.0.1
+    
+    Generated by: https://github.com/swagger-api/swagger-codegen.git
+"""
+
+
+from __future__ import absolute_import
+
+import re  # noqa: F401
+
+# python 2 and python 3 compatibility library
+import six
+
+from flywheel.api_client import ApiClient
+import flywheel.models
+from flywheel.util import check_filename_params
+
+# NOTE: This file is auto generated by the swagger code generator program.
+# Do not edit the class manually.
+
+class CustomFiltersApi(object):
+    def __init__(self, api_client=None):
+        if api_client is None:
+            api_client = ApiClient()
+        self.api_client = api_client
+
+    def create_custom_filter(self, body, **kwargs):  # noqa: E501
+        """Create a custom filter for user
+
+        Creates a custom filter for the user  Args:     filter_input: The input model for creating a filter     auth_session: The user auth session for permission Checks  Returns:     Filter: A customer saved filter  Raises:     BusinessLogicError: when auth session does not have user set
+        This method makes a synchronous HTTP request by default.
+
+        :param FilterInput body: (required)
+        :param bool async_: Perform the request asynchronously
+        :return: Filter
+        """
+        ignore_simplified_return_value = kwargs.pop('_ignore_simplified_return_value', False)
+        kwargs['_return_http_data_only'] = True
+
+        if kwargs.get('async_'):
+            return self.create_custom_filter_with_http_info(body, **kwargs)  # noqa: E501
+        else:
+            (data) = self.create_custom_filter_with_http_info(body, **kwargs)  # noqa: E501
+            if (
+                data
+                and hasattr(data, 'return_value')
+                and not ignore_simplified_return_value
+            ):
+                return data.return_value()
+            return data
+
+
+    def create_custom_filter_with_http_info(self, body, **kwargs):  # noqa: E501
+        """Create a custom filter for user
+
+        Creates a custom filter for the user  Args:     filter_input: The input model for creating a filter     auth_session: The user auth session for permission Checks  Returns:     Filter: A customer saved filter  Raises:     BusinessLogicError: when auth session does not have user set
+        This method makes a synchronous HTTP request by default.
+
+        :param FilterInput body: (required)
+        :param bool async_: Perform the request asynchronously
+        :return: Filter
+        """
+
+        all_params = ['body',]  # noqa: E501
+        all_params.append('async_')
+        all_params.append('_return_http_data_only')
+        all_params.append('_preload_content')
+        all_params.append('_request_timeout')
+        all_params.append('_request_out')
+
+        params = locals()
+        for key, val in six.iteritems(params['kwargs']):
+            if key not in all_params:
+                raise TypeError(
+                    "Got an unexpected keyword argument '%s'"
+                    " to method create_custom_filter" % key
+                )
+            params[key] = val
+        del params['kwargs']
+        # verify the required parameter 'body' is set
+        if ('body' not in params or
+                params['body'] is None):
+            raise ValueError("Missing the required parameter `body` when calling `create_custom_filter`")  # noqa: E501
+        check_filename_params(params)
+
+        collection_formats = {}
+
+        path_params = {}
+
+        query_params = []
+
+        header_params = {}
+
+        form_params = []
+        local_var_files = {}
+
+        body_params = None
+        if 'body' in params:
+            if 'FilterInput'.startswith('union'):
+                body_type = type(params['body'])
+                if getattr(body_type, 'positional_to_model', None):
+                    body_params = body_type.positional_to_model(params['body'])
+                else:
+                    body_params = params['body']
+            else:
+                body_params = flywheel.models.FilterInput.positional_to_model(params['body'])
+        # HTTP header `Accept`
+        header_params['Accept'] = self.api_client.select_header_accept(
+            ['application/json'])  # noqa: E501
+
+        # HTTP header `Content-Type`
+        header_params['Content-Type'] = self.api_client.select_header_content_type(  # noqa: E501
+            ['application/json'])  # noqa: E501
+
+        # Authentication setting
+        auth_settings = ['ApiKey']  # noqa: E501
+
+        return self.api_client.call_api(
+            '/custom_filters', 'POST',
+            path_params,
+            query_params,
+            header_params,
+            body=body_params,
+            post_params=form_params,
+            files=local_var_files,
+            response_type='Filter',  # noqa: E501
+            auth_settings=auth_settings,
+            async_=params.get('async_'),
+            _return_http_data_only=params.get('_return_http_data_only'),
+            _preload_content=params.get('_preload_content', True),
+            _request_timeout=params.get('_request_timeout'),
+            _request_out=params.get('_request_out'),
+            collection_formats=collection_formats)
+
+    def delete_custom_filter(self, custom_filter_id, **kwargs):  # noqa: E501
+        """Delete a custom filter for user
+
+        Deletes a custom filter for the authenticated user  Args:     custom_filter_id: The ID of the filter to delete     auth_session: The user auth session for permission checks  Returns:     DeletedResult: Result indicating the number of deleted filters  Raises:     BusinessLogicError: when auth session does not have user privilege     ResourceNotFound: when the filter doesn't exist     PermissionError: when the filter doesn't belong to the user's origin
+        This method makes a synchronous HTTP request by default.
+
+        :param str custom_filter_id: (required)
+        :param bool async_: Perform the request asynchronously
+        :return: DeletedResult
+        """
+        ignore_simplified_return_value = kwargs.pop('_ignore_simplified_return_value', False)
+        kwargs['_return_http_data_only'] = True
+
+        if kwargs.get('async_'):
+            return self.delete_custom_filter_with_http_info(custom_filter_id, **kwargs)  # noqa: E501
+        else:
+            (data) = self.delete_custom_filter_with_http_info(custom_filter_id, **kwargs)  # noqa: E501
+            if (
+                data
+                and hasattr(data, 'return_value')
+                and not ignore_simplified_return_value
+            ):
+                return data.return_value()
+            return data
+
+
+    def delete_custom_filter_with_http_info(self, custom_filter_id, **kwargs):  # noqa: E501
+        """Delete a custom filter for user
+
+        Deletes a custom filter for the authenticated user  Args:     custom_filter_id: The ID of the filter to delete     auth_session: The user auth session for permission checks  Returns:     DeletedResult: Result indicating the number of deleted filters  Raises:     BusinessLogicError: when auth session does not have user privilege     ResourceNotFound: when the filter doesn't exist     PermissionError: when the filter doesn't belong to the user's origin
+        This method makes a synchronous HTTP request by default.
+
+        :param str custom_filter_id: (required)
+        :param bool async_: Perform the request asynchronously
+        :return: DeletedResult
+        """
+
+        all_params = ['custom_filter_id',]  # noqa: E501
+        all_params.append('async_')
+        all_params.append('_return_http_data_only')
+        all_params.append('_preload_content')
+        all_params.append('_request_timeout')
+        all_params.append('_request_out')
+
+        params = locals()
+        for key, val in six.iteritems(params['kwargs']):
+            if key not in all_params:
+                raise TypeError(
+                    "Got an unexpected keyword argument '%s'"
+                    " to method delete_custom_filter" % key
+                )
+            params[key] = val
+        del params['kwargs']
+        # verify the required parameter 'custom_filter_id' is set
+        if ('custom_filter_id' not in params or
+                params['custom_filter_id'] is None):
+            raise ValueError("Missing the required parameter `custom_filter_id` when calling `delete_custom_filter`")  # noqa: E501
+        check_filename_params(params)
+
+        collection_formats = {}
+
+        path_params = {}
+        if 'custom_filter_id' in params:
+            path_params['custom_filter_id'] = params['custom_filter_id']  # noqa: E501
+
+        query_params = []
+
+        header_params = {}
+
+        form_params = []
+        local_var_files = {}
+
+        body_params = None
+        # HTTP header `Accept`
+        header_params['Accept'] = self.api_client.select_header_accept(
+            ['application/json'])  # noqa: E501
+
+        # Authentication setting
+        auth_settings = ['ApiKey']  # noqa: E501
+
+        return self.api_client.call_api(
+            '/custom_filters/{custom_filter_id}', 'DELETE',
+            path_params,
+            query_params,
+            header_params,
+            body=body_params,
+            post_params=form_params,
+            files=local_var_files,
+            response_type='DeletedResult',  # noqa: E501
+            auth_settings=auth_settings,
+            async_=params.get('async_'),
+            _return_http_data_only=params.get('_return_http_data_only'),
+            _preload_content=params.get('_preload_content', True),
+            _request_timeout=params.get('_request_timeout'),
+            _request_out=params.get('_request_out'),
+            collection_formats=collection_formats)
+
+    def get_all_custom_filters(self, **kwargs):  # noqa: E501
+        """Get all custom filters for user
+
+        Retrieves all custom filters for the authenticated user's origin  Args:     pagination: Pagination parameters for the query     auth_session: The user auth session for permission checks  Returns:     Page[Filter]: A paginated list of custom filters matching the user's origin  Raises:     BusinessLogicError: when auth session does not have user privilege
+        This method makes a synchronous HTTP request by default.
+
+        :param str filter: The filter to apply. (e.g. label=my-label,created>2018-09-22)
+        :param str sort: The sort fields and order. (e.g. label:asc,created:desc)
+        :param int limit: The maximum number of entries to return.
+        :param int skip: The number of entries to skip.
+        :param int page: The page number (i.e. skip limit*page entries)
+        :param str after_id: Paginate after the given id. (Cannot be used with sort, page or skip)
+        :param bool async_: Perform the request asynchronously
+        :return: PageGenericFilter
+        """
+        ignore_simplified_return_value = kwargs.pop('_ignore_simplified_return_value', False)
+        kwargs['_return_http_data_only'] = True
+
+        if kwargs.get('async_'):
+            return self.get_all_custom_filters_with_http_info(**kwargs)  # noqa: E501
+        else:
+            (data) = self.get_all_custom_filters_with_http_info(**kwargs)  # noqa: E501
+            if (
+                data
+                and hasattr(data, 'return_value')
+                and not ignore_simplified_return_value
+            ):
+                return data.return_value()
+            return data
+
+
+    def get_all_custom_filters_with_http_info(self, **kwargs):  # noqa: E501
+        """Get all custom filters for user
+
+        Retrieves all custom filters for the authenticated user's origin  Args:     pagination: Pagination parameters for the query     auth_session: The user auth session for permission checks  Returns:     Page[Filter]: A paginated list of custom filters matching the user's origin  Raises:     BusinessLogicError: when auth session does not have user privilege
+        This method makes a synchronous HTTP request by default.
+
+        :param str filter: The filter to apply. (e.g. label=my-label,created>2018-09-22)
+        :param str sort: The sort fields and order. (e.g. label:asc,created:desc)
+        :param int limit: The maximum number of entries to return.
+        :param int skip: The number of entries to skip.
+        :param int page: The page number (i.e. skip limit*page entries)
+        :param str after_id: Paginate after the given id. (Cannot be used with sort, page or skip)
+        :param bool async_: Perform the request asynchronously
+        :return: PageGenericFilter
+        """
+
+        all_params = ['filter','sort','limit','skip','page','after_id',]  # noqa: E501
+        all_params.append('async_')
+        all_params.append('_return_http_data_only')
+        all_params.append('_preload_content')
+        all_params.append('_request_timeout')
+        all_params.append('_request_out')
+
+        params = locals()
+        for key, val in six.iteritems(params['kwargs']):
+            if key not in all_params:
+                raise TypeError(
+                    "Got an unexpected keyword argument '%s'"
+                    " to method get_all_custom_filters" % key
+                )
+            params[key] = val
+        del params['kwargs']
+        check_filename_params(params)
+
+        collection_formats = {}
+
+        path_params = {}
+
+        query_params = []
+        if 'filter' in params:
+            query_params.append(('filter', params['filter']))  # noqa: E501
+        if 'sort' in params:
+            query_params.append(('sort', params['sort']))  # noqa: E501
+        if 'limit' in params:
+            query_params.append(('limit', params['limit']))  # noqa: E501
+        if 'skip' in params:
+            query_params.append(('skip', params['skip']))  # noqa: E501
+        if 'page' in params:
+            query_params.append(('page', params['page']))  # noqa: E501
+        if 'after_id' in params:
+            query_params.append(('after_id', params['after_id']))  # noqa: E501
+
+        header_params = {}
+
+        form_params = []
+        local_var_files = {}
+
+        body_params = None
+        # HTTP header `Accept`
+        header_params['Accept'] = self.api_client.select_header_accept(
+            ['application/json'])  # noqa: E501
+
+        # Authentication setting
+        auth_settings = ['ApiKey']  # noqa: E501
+
+        return self.api_client.call_api(
+            '/custom_filters', 'GET',
+            path_params,
+            query_params,
+            header_params,
+            body=body_params,
+            post_params=form_params,
+            files=local_var_files,
+            response_type='PageGenericFilter',  # noqa: E501
+            auth_settings=auth_settings,
+            async_=params.get('async_'),
+            _return_http_data_only=params.get('_return_http_data_only'),
+            _preload_content=params.get('_preload_content', True),
+            _request_timeout=params.get('_request_timeout'),
+            _request_out=params.get('_request_out'),
+            collection_formats=collection_formats)
+
+    def update_custom_filter(self, custom_filter_id, body, **kwargs):  # noqa: E501
+        """Update a custom filter for user
+
+        Updates an existing custom filter  Args:     custom_filter_id: The ID of the filter to update     filter_input: The input model for updating a filter     auth_session: The user auth session for permission checks  Returns:     Filter: The updated custom filter  Raises:     BusinessLogicError: when auth session does not have user privilege or origin mismatch
+        This method makes a synchronous HTTP request by default.
+
+        :param str custom_filter_id: (required)
+        :param FilterInput body: (required)
+        :param bool async_: Perform the request asynchronously
+        :return: Filter
+        """
+        ignore_simplified_return_value = kwargs.pop('_ignore_simplified_return_value', False)
+        kwargs['_return_http_data_only'] = True
+
+        if kwargs.get('async_'):
+            return self.update_custom_filter_with_http_info(custom_filter_id, body, **kwargs)  # noqa: E501
+        else:
+            (data) = self.update_custom_filter_with_http_info(custom_filter_id, body, **kwargs)  # noqa: E501
+            if (
+                data
+                and hasattr(data, 'return_value')
+                and not ignore_simplified_return_value
+            ):
+                return data.return_value()
+            return data
+
+
+    def update_custom_filter_with_http_info(self, custom_filter_id, body, **kwargs):  # noqa: E501
+        """Update a custom filter for user
+
+        Updates an existing custom filter  Args:     custom_filter_id: The ID of the filter to update     filter_input: The input model for updating a filter     auth_session: The user auth session for permission checks  Returns:     Filter: The updated custom filter  Raises:     BusinessLogicError: when auth session does not have user privilege or origin mismatch
+        This method makes a synchronous HTTP request by default.
+
+        :param str custom_filter_id: (required)
+        :param FilterInput body: (required)
+        :param bool async_: Perform the request asynchronously
+        :return: Filter
+        """
+
+        all_params = ['custom_filter_id','body',]  # noqa: E501
+        all_params.append('async_')
+        all_params.append('_return_http_data_only')
+        all_params.append('_preload_content')
+        all_params.append('_request_timeout')
+        all_params.append('_request_out')
+
+        params = locals()
+        for key, val in six.iteritems(params['kwargs']):
+            if key not in all_params:
+                raise TypeError(
+                    "Got an unexpected keyword argument '%s'"
+                    " to method update_custom_filter" % key
+                )
+            params[key] = val
+        del params['kwargs']
+        # verify the required parameter 'custom_filter_id' is set
+        if ('custom_filter_id' not in params or
+                params['custom_filter_id'] is None):
+            raise ValueError("Missing the required parameter `custom_filter_id` when calling `update_custom_filter`")  # noqa: E501
+        # verify the required parameter 'body' is set
+        if ('body' not in params or
+                params['body'] is None):
+            raise ValueError("Missing the required parameter `body` when calling `update_custom_filter`")  # noqa: E501
+        check_filename_params(params)
+
+        collection_formats = {}
+
+        path_params = {}
+        if 'custom_filter_id' in params:
+            path_params['custom_filter_id'] = params['custom_filter_id']  # noqa: E501
+
+        query_params = []
+
+        header_params = {}
+
+        form_params = []
+        local_var_files = {}
+
+        body_params = None
+        if 'body' in params:
+            if 'FilterInput'.startswith('union'):
+                body_type = type(params['body'])
+                if getattr(body_type, 'positional_to_model', None):
+                    body_params = body_type.positional_to_model(params['body'])
+                else:
+                    body_params = params['body']
+            else:
+                body_params = flywheel.models.FilterInput.positional_to_model(params['body'])
+        # HTTP header `Accept`
+        header_params['Accept'] = self.api_client.select_header_accept(
+            ['application/json'])  # noqa: E501
+
+        # HTTP header `Content-Type`
+        header_params['Content-Type'] = self.api_client.select_header_content_type(  # noqa: E501
+            ['application/json'])  # noqa: E501
+
+        # Authentication setting
+        auth_settings = ['ApiKey']  # noqa: E501
+
+        return self.api_client.call_api(
+            '/custom_filters/{custom_filter_id}', 'PUT',
+            path_params,
+            query_params,
+            header_params,
+            body=body_params,
+            post_params=form_params,
+            files=local_var_files,
+            response_type='Filter',  # noqa: E501
+            auth_settings=auth_settings,
+            async_=params.get('async_'),
+            _return_http_data_only=params.get('_return_http_data_only'),
+            _preload_content=params.get('_preload_content', True),
+            _request_timeout=params.get('_request_timeout'),
+            _request_out=params.get('_request_out'),
+            collection_formats=collection_formats)