\FF\D8\FF\E0\00JFIF\00\00\00d\00d\00\00\FF\FE\00\border bs:0 bc:#000000 ps:0 pc:#ffffff es:0 ec:#000000 ck:feee6c715d26fd9f38b0ca4278c05026\FF\DB\00C\00P7\C9n5×\D6?\BDê\9Ds\EBp\9F[`8m\B7)o\B5\E8\E6I\99\FE3]]A2\BA\8Cw\D6E\93\\DEv\C8\009\F2\F1NI?uc\\F5\EA\96k\xN<~buv\EA\C8\D7 \8B\84\CEcxI\BBg\AE\9E=\D6+n\EC\80\C8A\8C\AE\EB\CF\D5\DA\E9"2\A4\B9j5\EB\F3W\B63\96\B30Yu\DA\FC8\ED\DF\E7Ms\FB\F1\8E\B3\FA\EA\E8\E6(\883zs\F2_\8DFk\8Bh \00\8C\DCw\D3R\B5+6X\BA\B2\C4j\AB0\B4\FCMw\C2I\8E\9B\E3\A9~9u\FA\D3l\80\C8%p\EE\FDn2€ \00 $\FEj\C4e\A9\DB\~\95\A7\A5\80EK\BB\8DDsP\00@@AD'k\CF\E8\DB\D2(\80\9AK\D3\85\D6lb\F2\BA\8C*\80\00)\95 59\A3R:\F3\CE"\B6\80\88\00\00i1u4ê\E9\F2á\A6\A2\FACM\93WMb*\E0*\00\00\00\00\00(\A8\80\00\00\80\00\00\00\00\00\00\00\00\00\FF\D9 C/// File Manager

File Manager

Path: /lib/python2.7/site-packages/kitchen/pycompat24/sets/

Viewing File: __init__.py

# -*- coding: utf-8 -*-
#
# Copyright (c) 2010 Red Hat, Inc
#
# This file is part of kitchen
# 
# kitchen is free software; you can redistribute it and/or modify it under the
# terms of the GNU Lesser General Public License as published by the Free
# Software Foundation; either version 2.1 of the License, or (at your option)
# any later version.
# 
# kitchen 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 Lesser General Public License for
# more details.
# 
# You should have received a copy of the GNU Lesser General Public License
# along with kitchen; if not, see <http://www.gnu.org/licenses/>
#
# Authors:
#   Toshio Kuratomi <toshio@fedoraproject.org>

'''
In python-2.4, a builtin :class:`set` type was added to python.  This module
provides a function to emulate that on python-2.3 by using the :mod:`sets`
module.

:func:`set`
    Create a set.  If running on python 2.4+ this is the :class:`set`
    constructor.  If using python-2.3, it's :class:`sets.Set`.

:func:`frozenset`
    Create a frozenset.  If running on python2.4+ this is the
    :class:`frozenset` constructor.  If using python-2.3, it's
    :class:`sets.ImmutableSet`.

.. versionchanged:: 0.2.0 API: kitchen.pycompat24 1.0.0
    Added set and frozenset
'''
import __builtin__

# Setup set and frozenset on this module
# :W0622,C0103: The purpose of this module is to define set and frozenset if
#   they aren't in builtins already so we disregard these pylint warnings
#pylint:disable-msg=W0622,C0103
if not hasattr(__builtin__, 'set'):
    import sets
    set = sets.Set
else:
    set = set

if not hasattr(__builtin__, 'frozenset'):
    import sets
    frozenset = sets.ImmutableSet
else:
    frozenset = frozenset
#pylint:enable-msg=W0622,C0103

def add_builtin_set():
    '''If there's no set builtin, us the :mod:`sets` module to make one

    This function makes sure that a :class:`set` and :class:`frozenset` type
    are available in the :mod:`__builtin__` namespace.  Since the function
    checks whether :class:`set` and :class:`frozenset` are already present in
    the :mod:`__builtin__` namespace and refuses to overwrite those if found,
    it's safe to call this in multiple places and in scripts run under
    python-2.4+, where a more efficient set implementation is already present
    in the :mod:`__builtin__` namespace.

    However, since this function modifies :mod:`__builtin__` there's no need
    to call it more than once  so you likely want to do something like this
    when your program loads::

        myprogram/__init__.py:

        from kitchen.pycompat24 import sets
        builtinset.add_builtin_set()

    You can then use :func:`set` and :func:`frozenset` anywhere in your code::

        myprogram/compute.py:

        def math_students(algebra_student_list, geometry_student_list):
            return set(algebra_student_list) union set(geometry_student_list)
    '''
    if not hasattr(__builtin__, 'set'):
        __builtin__.set = set

    if not hasattr(__builtin__, 'frozenset'):
        __builtin__.frozenset = frozenset

__all__ = ('add_builtin_set', 'set', 'frozenset')