summaryrefslogtreecommitdiffstats
path: root/ipalib/compat.py
blob: 70f098b16bcc2646459c1d2cb012ca87d44c4461 (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
50
51
# Authors:
#   Jason Gerard DeRose <jderose@redhat.com>
#
# Copyright (C) 2009  Red Hat
# see file 'COPYING' for use and warranty information
#
# This program is free software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License as
# published by the Free Software Foundation; version 2 only
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

"""
Abstracts some compatability issues for Python2.4 - Python2.6.

The ``json`` module was added in Python2.6, which previously was in a seperate
package and called ``simplejson``.  This hack abstracts the difference so you
can use the ``json`` module generically like this:

>>> from compat import json
>>> json.dumps({'hello': 'world'})
'{"hello": "world"}'

In Python 2.6 the ``parse_qs()`` function was moved from the ``cgi`` module to
the ``urlparse`` module.  Although ``cgi.parse_qs()`` is still available and
only raises a ``PendingDeprecationWarning``, we still provide some
future-proofing here so you can import ``parse_qs()`` generically like this:

>>> from compat import parse_qs
>>> parse_qs('hello=world&how=are+you%3F')
{'how': ['are you?'], 'hello': ['world']}

For more information, see *What's New in Python 2.6*:

    http://docs.python.org/whatsnew/2.6.html
"""

import sys
if sys.version_info[:2] >= (2, 6):
    import json
    from urlparse import parse_qs
else:
    import simplejson as json
    from cgi import parse_qs