|
1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889 |
- """
- filters.py - misc stuff for handling LDAP filter strings (see RFC2254)
-
- See https://www.python-ldap.org/ for details.
-
- Compatibility:
- - Tested with Python 2.0+
- """
-
- from ldap import __version__
-
- from ldap.functions import strf_secs
-
- import time
-
-
- def escape_filter_chars(assertion_value,escape_mode=0):
- """
- Replace all special characters found in assertion_value
- by quoted notation.
-
- escape_mode
- If 0 only special chars mentioned in RFC 4515 are escaped.
- If 1 all NON-ASCII chars are escaped.
- If 2 all chars are escaped.
- """
- if escape_mode:
- r = []
- if escape_mode==1:
- for c in assertion_value:
- if c < '0' or c > 'z' or c in "\\*()":
- c = "\\%02x" % ord(c)
- r.append(c)
- elif escape_mode==2:
- for c in assertion_value:
- r.append("\\%02x" % ord(c))
- else:
- raise ValueError('escape_mode must be 0, 1 or 2.')
- s = ''.join(r)
- else:
- s = assertion_value.replace('\\', r'\5c')
- s = s.replace(r'*', r'\2a')
- s = s.replace(r'(', r'\28')
- s = s.replace(r')', r'\29')
- s = s.replace('\x00', r'\00')
- return s
-
-
- def filter_format(filter_template,assertion_values):
- """
- filter_template
- String containing %s as placeholder for assertion values.
- assertion_values
- List or tuple of assertion values. Length must match
- count of %s in filter_template.
- """
- return filter_template % tuple(escape_filter_chars(v) for v in assertion_values)
-
-
- def time_span_filter(
- filterstr='',
- from_timestamp=0,
- until_timestamp=None,
- delta_attr='modifyTimestamp',
- ):
- """
- If last_run_timestr is non-zero filterstr will be extended
- """
- if until_timestamp is None:
- until_timestamp = time.time()
- if from_timestamp < 0:
- from_timestamp = until_timestamp + from_timestamp
- if from_timestamp > until_timestamp:
- raise ValueError('from_timestamp %r must not be greater than until_timestamp %r' % (
- from_timestamp, until_timestamp
- ))
- return (
- '(&'
- '{filterstr}'
- '({delta_attr}>={from_timestr})'
- '(!({delta_attr}>={until_timestr}))'
- ')'
- ).format(
- filterstr=filterstr,
- delta_attr=delta_attr,
- from_timestr=strf_secs(from_timestamp),
- until_timestr=strf_secs(until_timestamp),
- )
- # end of time_span_filter()
|