summaryrefslogtreecommitdiff
path: root/src/leap/bitmask/provider/__init__.py
blob: 87f9a8b74b239f0766fc7a9ba406ad0b484a46db (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
# -*- coding: utf-8 -*-
# __init.py
# Copyright (C) 2013 LEAP
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program.  If not, see <http://www.gnu.org/licenses/>.
"""
Provider utilities.
"""
import os

from pkg_resources import parse_version

from leap.bitmask import __version__ as BITMASK_VERSION
from leap.common.check import leap_assert


# The currently supported API versions by the client.
SUPPORTED_APIS = ["1"]


def get_provider_path(domain):
    """
    Returns relative path for provider config.

    :param domain: the domain to which this providerconfig belongs to.
    :type domain: str
    :returns: the path
    :rtype: str
    """
    leap_assert(domain is not None, "get_provider_path: We need a domain")
    return os.path.join("leap", "providers", domain, "provider.json")


def supports_api(api_version):
    """
    :param api_version: the version number of the api that we need to check
    :type api_version: str

    :returns: if that version is supported or not.
    :return type: bool
    """
    return api_version in SUPPORTED_APIS


def supports_client(minimum_version):
    """
    :param minimum_version: the version number of the client that
                            we need to check.
    :type minimum_version: str

    :returns: True if that version is supported or False otherwise.
    :return type: bool
    """
    return parse_version(minimum_version) <= parse_version(BITMASK_VERSION)