Gecko [ goons4good.org ]

Name	Size	Permission	Date
controls	[ DIR ]	drwxr-xr-x	2022-07-26 09:09
extop	[ DIR ]	drwxr-xr-x	2022-07-26 09:09
schema	[ DIR ]	drwxr-xr-x	2022-07-26 09:09
__init__.py	2.2 KB	-rw-r--r--	2014-03-24 06:20
__init__.pyc	3.27 KB	-rw-r--r--	2015-03-06 00:13
__init__.pyo	2.87 KB	-rw-r--r--	2015-03-06 00:13
async.py	8.38 KB	-rw-r--r--	2014-03-07 15:01
async.pyc	10.81 KB	-rw-r--r--	2015-03-06 00:13
async.pyo	10.81 KB	-rw-r--r--	2015-03-06 00:13
cidict.py	2.64 KB	-rw-r--r--	2011-06-08 15:35
cidict.pyc	4.57 KB	-rw-r--r--	2015-03-06 00:13
cidict.pyo	4.15 KB	-rw-r--r--	2015-03-06 00:13
dn.py	2.73 KB	-rw-r--r--	2011-06-08 15:35
dn.pyc	3.47 KB	-rw-r--r--	2015-03-06 00:13
dn.pyo	3.47 KB	-rw-r--r--	2015-03-06 00:13
filter.py	1.44 KB	-rw-r--r--	2011-10-26 14:46
filter.pyc	1.83 KB	-rw-r--r--	2015-03-06 00:13
filter.pyo	1.83 KB	-rw-r--r--	2015-03-06 00:13
functions.py	3.32 KB	-rw-r--r--	2011-11-25 07:22
functions.pyc	4.05 KB	-rw-r--r--	2015-03-06 00:13
functions.pyo	3.8 KB	-rw-r--r--	2015-03-06 00:13
ldapobject.py	35.23 KB	-rw-r--r--	2014-03-07 15:01
ldapobject.pyc	39.8 KB	-rw-r--r--	2015-03-06 00:13
ldapobject.pyo	39.41 KB	-rw-r--r--	2015-03-06 00:13
logger.py	330 B	-rw-r--r--	2011-03-21 10:19
logger.pyc	899 B	-rw-r--r--	2015-03-06 00:13
logger.pyo	899 B	-rw-r--r--	2015-03-06 00:13
modlist.py	4.25 KB	-rw-r--r--	2011-06-08 15:35
modlist.pyc	3.88 KB	-rw-r--r--	2015-03-06 00:13
modlist.pyo	3.88 KB	-rw-r--r--	2015-03-06 00:13
resiter.py	945 B	-rw-r--r--	2011-10-26 14:46
resiter.pyc	1.23 KB	-rw-r--r--	2015-03-06 00:13
resiter.pyo	1.23 KB	-rw-r--r--	2015-03-06 00:13
sasl.py	4 KB	-rw-r--r--	2014-03-24 06:20
sasl.pyc	5.24 KB	-rw-r--r--	2015-03-06 00:13
sasl.pyo	4.95 KB	-rw-r--r--	2015-03-06 00:13
syncrepl.py	16.91 KB	-rw-r--r--	2015-03-06 00:13
syncrepl.pyc	14.31 KB	-rw-r--r--	2015-03-06 00:13
syncrepl.pyo	14.31 KB	-rw-r--r--	2015-03-06 00:13

Rename

"""
functions.py - wraps functions of module _ldap

See http://www.python-ldap.org/ for details.

\$Id: functions.py,v 1.28 2011/11/23 17:27:46 stroeder Exp $

Compability:
- Tested with Python 2.0+ but should work with Python 1.5.x
- functions should behave exactly the same like in _ldap

Usage:
Directly imported by ldap/__init__.py. The symbols of _ldap are
overridden.

Thread-lock:
Basically calls into the LDAP lib are serialized by the module-wide
lock _ldapmodule_lock.
"""

from ldap import __version__

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

import sys,pprint,_ldap,ldap

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

def _ldap_function_call(lock,func,*args,**kwargs):
  """
  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
  """
  if lock:
    lock.acquire()
  if __debug__:
    if ldap._trace_level>=1:
      ldap._trace_file.write('*** %s.%s %s\n' % (
        '_ldap',func.__name__,
        pprint.pformat((args,kwargs))
      ))
      if ldap._trace_level>=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,e:
    if __debug__ and ldap._trace_level>=2:
      ldap._trace_file.write('=> LDAPError: %s\n' % (str(e)))
    raise
  if __debug__ and ldap._trace_level>=2:
    ldap._trace_file.write('=> result:\n%s\n' % (pprint.pformat(result)))
  return result

def initialize(uri,trace_level=0,trace_file=sys.stdout,trace_stack_limit=None):
  """
  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.
  """
  return LDAPObject(uri,trace_level,trace_file,trace_stack_limit)

def open(host,port=389,trace_level=0,trace_file=sys.stdout,trace_stack_limit=None):
  """
  Return LDAPObject instance by opening LDAP connection to
  specified LDAP host

Parameters:
  host
        LDAP host and port, e.g. localhost
  port
        integer specifying the port number to use, e.g. 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.
  """
  import warnings
  warnings.warn('ldap.open() is deprecated! Use ldap.initialize() instead.', DeprecationWarning,2)
  return initialize('ldap://%s:%d' % (host,port),trace_level,trace_file,trace_stack_limit)

init = open

def get_option(option):
  """
  get_option(name) -> value

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

def set_option(option,invalue):
  """
  set_option(name, value)

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