File: iterutils.py

package info (click to toggle)
python-fedora 1.1.1-5
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 1,436 kB
  • sloc: python: 3,362; xml: 107; makefile: 14
file content (57 lines) | stat: -rw-r--r-- 2,033 bytes parent folder | download | duplicates (5)
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
52
53
54
55
56
57
# -*- coding: utf-8 -*-
#
# Copyright (C) 2009  Red Hat, Inc.
# This file is part of python-fedora
#
# python-fedora 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.
#
# python-fedora 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 python-fedora; if not, see <http://www.gnu.org/licenses/>
#
'''
Functions to manipulate iterables

.. versionadded:: 0.3.17

.. versionchanged:: 0.3.21
    Deprecated in favor of the kitchen.iterutils module

.. moduleauthor:: Toshio Kuratomi <tkuratom@redhat.com>
'''
import warnings

from kitchen.iterutils import isiterable as _isiterable

warnings.warn('fedora.iterutils is deprecated.  Use kitchen.iterutils'
              ' instead', DeprecationWarning, stacklevel=2)


def isiterable(obj, include_string=True):
    '''*Deprecated* Use kitchen.iterutils.isiterable instead.

    .. warning::
        kitchen.iterutils.isiterable uses False as the default value for
        :attr:`include_string` instead of True.

    Check whether an object is an iterable.

    :arg obj: Object to test whether it is an iterable
    :include_string: If True (default), if `obj` is a str or unicode this
        function will return True.  If set to False, strings and unicodes will
        cause this function to return False.
    :returns: True if `obj` is iterable, otherwise False.
    '''
    warnings.warn('fedora.iterutils.isiterable is deprecated, use'
                  ' kitchen.iterutils.isiterable instead', DeprecationWarning,
                  stacklevel=2)
    return _isiterable(obj, include_string)

__all__ = ['isiterable']