text: # Copyright (c) 2019 Dubalu LLC
  # Copyright (c) 2017 Elasticsearch
  #
  # Licensed to the Apache Software Foundation (ASF) under one or more
  # contributor license agreements.  See the NOTICE file distributed with
  # this work for additional information regarding copyright ownership.
  # The ASF licenses this file to you 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 __future__ import unicode_literals
  
  import weakref
  from datetime import date, datetime
  from functools import wraps
  from ..compat import string_types, quote_plus, PY2
  
  
  # parts of URL to be omitted
  SKIP_IN_PATH = (None, '', b'', [], ())
  
  
  def _escape(value):
      """
      Escape a single value of a URL string or a query parameter. If it is a list
      or tuple, turn it into a comma-separated string first.
      """
  
      # make sequences into comma-separated stings
      if isinstance(value, (list, tuple)):
          value = ','.join(value)
  
      # dates and datetimes into isoformat
      elif isinstance(value, (date, datetime)):
          value = value.isoformat()
  
      # make bools into true/false strings
      elif isinstance(value, bool):
          value = str(value).lower()
  
      # don't decode bytestrings
      elif isinstance(value, bytes):
          return value
  
      # encode strings to utf-8
      if isinstance(value, string_types):
          if PY2 and isinstance(value, unicode):
              return value.encode('utf-8')
          if not PY2 and isinstance(value, str):
              return value.encode('utf-8')
  
      return str(value)
  
  
  def make_path(parts):
      """
      Create a URL string from parts, omit all `None` values and empty strings.
      Convert lists nad tuples to comma separated values.
      """
      #TODO: maybe only allow some parts to be lists/tuples ?
      path = '/' + '/'.join(
          # preserve ',' and '*' in url for nicer URLs in logs
          quote_plus(_escape(p), b',*') for p in parts if p not in SKIP_IN_PATH)
      if parts[-1] in SKIP_IN_PATH:
          path += '/'
      return path
  
  
  # parameters that apply to all methods
  GLOBAL_PARAMS = ('pretty', 'human', 'routing')
  
  
  def query_params(*accepted_params):
      """
      Decorator that pops all accepted parameters from method's kwargs and puts
      them in the params argument.
      """
      def _wrapper(func):
          @wraps(func)
          def _wrapped(*args, **kwargs):
              params = {}
              if 'params' in kwargs:
                  params = kwargs.pop('params').copy()
              for p in accepted_params + GLOBAL_PARAMS:
                  if p in kwargs:
                      v = kwargs.pop(p)
                      if v is not None:
                          params[p] = _escape(v)
  
              # don't treat ignore and request_timeout as other params to avoid escaping
              for p in ('ignore', 'request_timeout'):
                  if p in kwargs:
                      params[p] = kwargs.pop(p)
              return func(*args, params=params, **kwargs)
          return _wrapped
      return _wrapper
  
  
  class NamespacedClient(object):
      def __init__(self, client):
          self.client = client
  
      @property
      def transport(self):
          return self.client.transport
  
  
  class AddonClient(NamespacedClient):
      @classmethod
      def infect_client(cls, client):
          addon = cls(weakref.proxy(client))
          setattr(client, cls.namespace, addon)
          return client
  