aboutsummaryrefslogtreecommitdiffhomepage
path: root/src/python/grpcio/grpc/beta/_metadata.py
blob: e135f4dff4f76126168f1bc543ae3f59ab5c80e2 (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
# Copyright 2017 gRPC authors.
#
# 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.
"""API metadata conversion utilities."""

import collections

_Metadatum = collections.namedtuple('_Metadatum', ('key', 'value',))


def _beta_metadatum(key, value):
    beta_key = key if isinstance(key, (bytes,)) else key.encode('ascii')
    beta_value = value if isinstance(value, (bytes,)) else value.encode('ascii')
    return _Metadatum(beta_key, beta_value)


def _metadatum(beta_key, beta_value):
    key = beta_key if isinstance(beta_key, (str,)) else beta_key.decode('utf8')
    if isinstance(beta_value, (str,)) or key[-4:] == '-bin':
        value = beta_value
    else:
        value = beta_value.decode('utf8')
    return _Metadatum(key, value)


def beta(metadata):
    if metadata is None:
        return ()
    else:
        return tuple(_beta_metadatum(key, value) for key, value in metadata)


def unbeta(beta_metadata):
    if beta_metadata is None:
        return ()
    else:
        return tuple(
            _metadatum(beta_key, beta_value)
            for beta_key, beta_value in beta_metadata)