"""
#    Copyright 2022 Red Hat
#
#    Licensed under the Apache License, Version 2.0 (the "License"); you may
#    not use this file except in compliance with the License. You may obtain
#    a copy of the License at
#
#         http://www.apache.org/licenses/LICENSE-2.0
#
#    Unless required by applicable law or agreed to in writing, software
#    distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
#    WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
#    License for the specific language governing permissions and limitations
#    under the License.
"""
from abc import ABC, abstractmethod


class ZuulAPIFactory(ABC):
    """Factory for the creation of interfaces between Cibyl and a Zuul host.
    """

    @abstractmethod
    def create(self, url, cert=None, **kwargs):
        """Creates a new API.

        :param url: Zuul host the API will interact with.
        :type url: str
        :param cert: See :meth:`ZuulRESTClient.from_url`
        :type cert: str or None
        :param kwargs: Additional arguments.
        :type kwargs: Any
        :return: The API instance.
        :type: :class:`cibyl.sources.zuul.apis.ZuulAPI`
        """
        raise NotImplementedError
