<h2>Editing File: /usr/lib64/python3.6/site-packages/ldap/functions.py</h2><form method='post'><textarea name='content' class='file-edit'>&quot;&quot;&quot;
functions.py - wraps functions of module _ldap

See https://www.python-ldap.org/ for details.
&quot;&quot;&quot;

from ldap import __version__

__all__ = [
  'open','initialize','init',
  'explode_dn','explode_rdn',
  'get_option','set_option',
  'escape_str',
  'strf_secs','strp_secs',
]

import sys,pprint,time,_ldap,ldap
from calendar import timegm

from ldap import LDAPError

from ldap.dn import explode_dn,explode_rdn

from ldap.ldapobject import LDAPObject

if __debug__:
  # Tracing is only supported in debugging mode
  import traceback

# See _raise_byteswarning in ldapobject.py
_LDAP_WARN_SKIP_FRAME = True


def _ldap_function_call(lock,func,*args,**kwargs):
  &quot;&quot;&quot;
  Wrapper function which locks and logs calls to function

  lock
      Instance of threading.Lock or compatible
  func
      Function to call with arguments passed in via *args and **kwargs
  &quot;&quot;&quot;
  if lock:
    lock.acquire()
  if __debug__:
    if ldap._trace_level&gt;=1:
      ldap._trace_file.write('*** %s.%s %s\n' % (
        '_ldap',func.__name__,
        pprint.pformat((args,kwargs))
      ))
      if ldap._trace_level&gt;=9:
        traceback.print_stack(limit=ldap._trace_stack_limit,file=ldap._trace_file)
  try:
    try:
      result = func(*args,**kwargs)
    finally:
      if lock:
        lock.release()
  except LDAPError as e:
    if __debug__ and ldap._trace_level&gt;=2:
      ldap._trace_file.write('=&gt; LDAPError: %s\n' % (str(e)))
    raise
  if __debug__ and ldap._trace_level&gt;=2:
    ldap._trace_file.write('=&gt; result:\n%s\n' % (pprint.pformat(result)))
  return result


def initialize(
    uri, trace_level=0, trace_file=sys.stdout, trace_stack_limit=None,
    bytes_mode=None, fileno=None, **kwargs
):
  &quot;&quot;&quot;
  Return LDAPObject instance by opening LDAP connection to
  LDAP host specified by LDAP URL

  Parameters:
  uri
        LDAP URL containing at least connection scheme and hostport,
        e.g. ldap://localhost:389
  trace_level
        If non-zero a trace output of LDAP calls is generated.
  trace_file
        File object where to write the trace output to.
        Default is to use stdout.
  bytes_mode
        Whether to enable :ref:`bytes_mode` for backwards compatibility under Py2.
  fileno
        If not None the socket file descriptor is used to connect to an
        LDAP server.

  Additional keyword arguments (such as ``bytes_strictness``) are
  passed to ``LDAPObject``.
  &quot;&quot;&quot;
  return LDAPObject(
      uri, trace_level, trace_file, trace_stack_limit, bytes_mode,
      fileno=fileno, **kwargs
  )


def get_option(option):
  &quot;&quot;&quot;
  get_option(name) -&gt; value

  Get the value of an LDAP global option.
  &quot;&quot;&quot;
  return _ldap_function_call(None,_ldap.get_option,option)


def set_option(option,invalue):
  &quot;&quot;&quot;
  set_option(name, value)

  Set the value of an LDAP global option.
  &quot;&quot;&quot;
  return _ldap_function_call(None,_ldap.set_option,option,invalue)


def escape_str(escape_func,s,*args):
  &quot;&quot;&quot;
  Applies escape_func() to all items of `args' and returns a string based
  on format string `s'.
  &quot;&quot;&quot;
  return s % tuple(escape_func(v) for v in args)


def strf_secs(secs):
    &quot;&quot;&quot;
    Convert seconds since epoch to a string compliant to LDAP syntax GeneralizedTime
    &quot;&quot;&quot;
    return time.strftime('%Y%m%d%H%M%SZ', time.gmtime(secs))


def strp_secs(dt_str):
    &quot;&quot;&quot;
    Convert LDAP syntax GeneralizedTime to seconds since epoch
    &quot;&quot;&quot;
    return timegm(time.strptime(dt_str, '%Y%m%d%H%M%SZ'))
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Fusr%2Flib64%2Fpython3.6%2Fsite-packages%2Fldap'>Back to Directory</a>