Convert ordereddict.py line endings to unix
authorEli Bendersky <eliben@gmail.com>
Sat, 23 Mar 2013 13:44:19 +0000 (06:44 -0700)
committerEli Bendersky <eliben@gmail.com>
Sat, 23 Mar 2013 13:44:19 +0000 (06:44 -0700)
elftools/common/ordereddict.py

index e1589be6b91170f25f90b262d3d29ebb7f599ef7..18ee0458fe75d8a181439e95aead1536e02f1b91 100644 (file)
-#-------------------------------------------------------------------------------\r
-# elftools: port of OrderedDict to work on Python < 2.7\r
-#\r
-# Taken from http://code.activestate.com/recipes/576693/ , revision 9\r
-# Code by Raymond Hettinger. License: MIT\r
-#-------------------------------------------------------------------------------\r
-try:\r
-    from thread import get_ident as _get_ident\r
-except ImportError:\r
-    from dummy_thread import get_ident as _get_ident\r
-\r
-try:\r
-    from _abcoll import KeysView, ValuesView, ItemsView\r
-except ImportError:\r
-    pass\r
-\r
-\r
-class OrderedDict(dict):\r
-    'Dictionary that remembers insertion order'\r
-    # An inherited dict maps keys to values.\r
-    # The inherited dict provides __getitem__, __len__, __contains__, and get.\r
-    # The remaining methods are order-aware.\r
-    # Big-O running times for all methods are the same as for regular dictionaries.\r
-\r
-    # The internal self.__map dictionary maps keys to links in a doubly linked list.\r
-    # The circular doubly linked list starts and ends with a sentinel element.\r
-    # The sentinel element never gets deleted (this simplifies the algorithm).\r
-    # Each link is stored as a list of length three:  [PREV, NEXT, KEY].\r
-\r
-    def __init__(self, *args, **kwds):\r
-        '''Initialize an ordered dictionary.  Signature is the same as for\r
-        regular dictionaries, but keyword arguments are not recommended\r
-        because their insertion order is arbitrary.\r
-\r
-        '''\r
-        if len(args) > 1:\r
-            raise TypeError('expected at most 1 arguments, got %d' % len(args))\r
-        try:\r
-            self.__root\r
-        except AttributeError:\r
-            self.__root = root = []                     # sentinel node\r
-            root[:] = [root, root, None]\r
-            self.__map = {}\r
-        self.__update(*args, **kwds)\r
-\r
-    def __setitem__(self, key, value, dict_setitem=dict.__setitem__):\r
-        'od.__setitem__(i, y) <==> od[i]=y'\r
-        # Setting a new item creates a new link which goes at the end of the linked\r
-        # list, and the inherited dictionary is updated with the new key/value pair.\r
-        if key not in self:\r
-            root = self.__root\r
-            last = root[0]\r
-            last[1] = root[0] = self.__map[key] = [last, root, key]\r
-        dict_setitem(self, key, value)\r
-\r
-    def __delitem__(self, key, dict_delitem=dict.__delitem__):\r
-        'od.__delitem__(y) <==> del od[y]'\r
-        # Deleting an existing item uses self.__map to find the link which is\r
-        # then removed by updating the links in the predecessor and successor nodes.\r
-        dict_delitem(self, key)\r
-        link_prev, link_next, key = self.__map.pop(key)\r
-        link_prev[1] = link_next\r
-        link_next[0] = link_prev\r
-\r
-    def __iter__(self):\r
-        'od.__iter__() <==> iter(od)'\r
-        root = self.__root\r
-        curr = root[1]\r
-        while curr is not root:\r
-            yield curr[2]\r
-            curr = curr[1]\r
-\r
-    def __reversed__(self):\r
-        'od.__reversed__() <==> reversed(od)'\r
-        root = self.__root\r
-        curr = root[0]\r
-        while curr is not root:\r
-            yield curr[2]\r
-            curr = curr[0]\r
-\r
-    def clear(self):\r
-        'od.clear() -> None.  Remove all items from od.'\r
-        try:\r
-            for node in self.__map.itervalues():\r
-                del node[:]\r
-            root = self.__root\r
-            root[:] = [root, root, None]\r
-            self.__map.clear()\r
-        except AttributeError:\r
-            pass\r
-        dict.clear(self)\r
-\r
-    def popitem(self, last=True):\r
-        '''od.popitem() -> (k, v), return and remove a (key, value) pair.\r
-        Pairs are returned in LIFO order if last is true or FIFO order if false.\r
-\r
-        '''\r
-        if not self:\r
-            raise KeyError('dictionary is empty')\r
-        root = self.__root\r
-        if last:\r
-            link = root[0]\r
-            link_prev = link[0]\r
-            link_prev[1] = root\r
-            root[0] = link_prev\r
-        else:\r
-            link = root[1]\r
-            link_next = link[1]\r
-            root[1] = link_next\r
-            link_next[0] = root\r
-        key = link[2]\r
-        del self.__map[key]\r
-        value = dict.pop(self, key)\r
-        return key, value\r
-\r
-    # -- the following methods do not depend on the internal structure --\r
-\r
-    def keys(self):\r
-        'od.keys() -> list of keys in od'\r
-        return list(self)\r
-\r
-    def values(self):\r
-        'od.values() -> list of values in od'\r
-        return [self[key] for key in self]\r
-\r
-    def items(self):\r
-        'od.items() -> list of (key, value) pairs in od'\r
-        return [(key, self[key]) for key in self]\r
-\r
-    def iterkeys(self):\r
-        'od.iterkeys() -> an iterator over the keys in od'\r
-        return iter(self)\r
-\r
-    def itervalues(self):\r
-        'od.itervalues -> an iterator over the values in od'\r
-        for k in self:\r
-            yield self[k]\r
-\r
-    def iteritems(self):\r
-        'od.iteritems -> an iterator over the (key, value) items in od'\r
-        for k in self:\r
-            yield (k, self[k])\r
-\r
-    def update(*args, **kwds):\r
-        '''od.update(E, **F) -> None.  Update od from dict/iterable E and F.\r
-\r
-        If E is a dict instance, does:           for k in E: od[k] = E[k]\r
-        If E has a .keys() method, does:         for k in E.keys(): od[k] = E[k]\r
-        Or if E is an iterable of items, does:   for k, v in E: od[k] = v\r
-        In either case, this is followed by:     for k, v in F.items(): od[k] = v\r
-\r
-        '''\r
-        if len(args) > 2:\r
-            raise TypeError('update() takes at most 2 positional '\r
-                            'arguments (%d given)' % (len(args),))\r
-        elif not args:\r
-            raise TypeError('update() takes at least 1 argument (0 given)')\r
-        self = args[0]\r
-        # Make progressively weaker assumptions about "other"\r
-        other = ()\r
-        if len(args) == 2:\r
-            other = args[1]\r
-        if isinstance(other, dict):\r
-            for key in other:\r
-                self[key] = other[key]\r
-        elif hasattr(other, 'keys'):\r
-            for key in other.keys():\r
-                self[key] = other[key]\r
-        else:\r
-            for key, value in other:\r
-                self[key] = value\r
-        for key, value in kwds.items():\r
-            self[key] = value\r
-\r
-    __update = update  # let subclasses override update without breaking __init__\r
-\r
-    __marker = object()\r
-\r
-    def pop(self, key, default=__marker):\r
-        '''od.pop(k[,d]) -> v, remove specified key and return the corresponding value.\r
-        If key is not found, d is returned if given, otherwise KeyError is raised.\r
-\r
-        '''\r
-        if key in self:\r
-            result = self[key]\r
-            del self[key]\r
-            return result\r
-        if default is self.__marker:\r
-            raise KeyError(key)\r
-        return default\r
-\r
-    def setdefault(self, key, default=None):\r
-        'od.setdefault(k[,d]) -> od.get(k,d), also set od[k]=d if k not in od'\r
-        if key in self:\r
-            return self[key]\r
-        self[key] = default\r
-        return default\r
-\r
-    def __repr__(self, _repr_running={}):\r
-        'od.__repr__() <==> repr(od)'\r
-        call_key = id(self), _get_ident()\r
-        if call_key in _repr_running:\r
-            return '...'\r
-        _repr_running[call_key] = 1\r
-        try:\r
-            if not self:\r
-                return '%s()' % (self.__class__.__name__,)\r
-            return '%s(%r)' % (self.__class__.__name__, self.items())\r
-        finally:\r
-            del _repr_running[call_key]\r
-\r
-    def __reduce__(self):\r
-        'Return state information for pickling'\r
-        items = [[k, self[k]] for k in self]\r
-        inst_dict = vars(self).copy()\r
-        for k in vars(OrderedDict()):\r
-            inst_dict.pop(k, None)\r
-        if inst_dict:\r
-            return (self.__class__, (items,), inst_dict)\r
-        return self.__class__, (items,)\r
-\r
-    def copy(self):\r
-        'od.copy() -> a shallow copy of od'\r
-        return self.__class__(self)\r
-\r
-    @classmethod\r
-    def fromkeys(cls, iterable, value=None):\r
-        '''OD.fromkeys(S[, v]) -> New ordered dictionary with keys from S\r
-        and values equal to v (which defaults to None).\r
-\r
-        '''\r
-        d = cls()\r
-        for key in iterable:\r
-            d[key] = value\r
-        return d\r
-\r
-    def __eq__(self, other):\r
-        '''od.__eq__(y) <==> od==y.  Comparison to another OD is order-sensitive\r
-        while comparison to a regular mapping is order-insensitive.\r
-\r
-        '''\r
-        if isinstance(other, OrderedDict):\r
-            return len(self)==len(other) and self.items() == other.items()\r
-        return dict.__eq__(self, other)\r
-\r
-    def __ne__(self, other):\r
-        return not self == other\r
-\r
-    # -- the following methods are only used in Python 2.7 --\r
-\r
-    def viewkeys(self):\r
-        "od.viewkeys() -> a set-like object providing a view on od's keys"\r
-        return KeysView(self)\r
-\r
-    def viewvalues(self):\r
-        "od.viewvalues() -> an object providing a view on od's values"\r
-        return ValuesView(self)\r
-\r
-    def viewitems(self):\r
-        "od.viewitems() -> a set-like object providing a view on od's items"\r
-        return ItemsView(self)\r
-\r
+#-------------------------------------------------------------------------------
+# elftools: port of OrderedDict to work on Python < 2.7
+#
+# Taken from http://code.activestate.com/recipes/576693/ , revision 9
+# Code by Raymond Hettinger. License: MIT
+#-------------------------------------------------------------------------------
+try:
+    from thread import get_ident as _get_ident
+except ImportError:
+    from dummy_thread import get_ident as _get_ident
+
+try:
+    from _abcoll import KeysView, ValuesView, ItemsView
+except ImportError:
+    pass
+
+
+class OrderedDict(dict):
+    'Dictionary that remembers insertion order'
+    # An inherited dict maps keys to values.
+    # The inherited dict provides __getitem__, __len__, __contains__, and get.
+    # The remaining methods are order-aware.
+    # Big-O running times for all methods are the same as for regular dictionaries.
+
+    # The internal self.__map dictionary maps keys to links in a doubly linked list.
+    # The circular doubly linked list starts and ends with a sentinel element.
+    # The sentinel element never gets deleted (this simplifies the algorithm).
+    # Each link is stored as a list of length three:  [PREV, NEXT, KEY].
+
+    def __init__(self, *args, **kwds):
+        '''Initialize an ordered dictionary.  Signature is the same as for
+        regular dictionaries, but keyword arguments are not recommended
+        because their insertion order is arbitrary.
+
+        '''
+        if len(args) > 1:
+            raise TypeError('expected at most 1 arguments, got %d' % len(args))
+        try:
+            self.__root
+        except AttributeError:
+            self.__root = root = []                     # sentinel node
+            root[:] = [root, root, None]
+            self.__map = {}
+        self.__update(*args, **kwds)
+
+    def __setitem__(self, key, value, dict_setitem=dict.__setitem__):
+        'od.__setitem__(i, y) <==> od[i]=y'
+        # Setting a new item creates a new link which goes at the end of the linked
+        # list, and the inherited dictionary is updated with the new key/value pair.
+        if key not in self:
+            root = self.__root
+            last = root[0]
+            last[1] = root[0] = self.__map[key] = [last, root, key]
+        dict_setitem(self, key, value)
+
+    def __delitem__(self, key, dict_delitem=dict.__delitem__):
+        'od.__delitem__(y) <==> del od[y]'
+        # Deleting an existing item uses self.__map to find the link which is
+        # then removed by updating the links in the predecessor and successor nodes.
+        dict_delitem(self, key)
+        link_prev, link_next, key = self.__map.pop(key)
+        link_prev[1] = link_next
+        link_next[0] = link_prev
+
+    def __iter__(self):
+        'od.__iter__() <==> iter(od)'
+        root = self.__root
+        curr = root[1]
+        while curr is not root:
+            yield curr[2]
+            curr = curr[1]
+
+    def __reversed__(self):
+        'od.__reversed__() <==> reversed(od)'
+        root = self.__root
+        curr = root[0]
+        while curr is not root:
+            yield curr[2]
+            curr = curr[0]
+
+    def clear(self):
+        'od.clear() -> None.  Remove all items from od.'
+        try:
+            for node in self.__map.itervalues():
+                del node[:]
+            root = self.__root
+            root[:] = [root, root, None]
+            self.__map.clear()
+        except AttributeError:
+            pass
+        dict.clear(self)
+
+    def popitem(self, last=True):
+        '''od.popitem() -> (k, v), return and remove a (key, value) pair.
+        Pairs are returned in LIFO order if last is true or FIFO order if false.
+
+        '''
+        if not self:
+            raise KeyError('dictionary is empty')
+        root = self.__root
+        if last:
+            link = root[0]
+            link_prev = link[0]
+            link_prev[1] = root
+            root[0] = link_prev
+        else:
+            link = root[1]
+            link_next = link[1]
+            root[1] = link_next
+            link_next[0] = root
+        key = link[2]
+        del self.__map[key]
+        value = dict.pop(self, key)
+        return key, value
+
+    # -- the following methods do not depend on the internal structure --
+
+    def keys(self):
+        'od.keys() -> list of keys in od'
+        return list(self)
+
+    def values(self):
+        'od.values() -> list of values in od'
+        return [self[key] for key in self]
+
+    def items(self):
+        'od.items() -> list of (key, value) pairs in od'
+        return [(key, self[key]) for key in self]
+
+    def iterkeys(self):
+        'od.iterkeys() -> an iterator over the keys in od'
+        return iter(self)
+
+    def itervalues(self):
+        'od.itervalues -> an iterator over the values in od'
+        for k in self:
+            yield self[k]
+
+    def iteritems(self):
+        'od.iteritems -> an iterator over the (key, value) items in od'
+        for k in self:
+            yield (k, self[k])
+
+    def update(*args, **kwds):
+        '''od.update(E, **F) -> None.  Update od from dict/iterable E and F.
+
+        If E is a dict instance, does:           for k in E: od[k] = E[k]
+        If E has a .keys() method, does:         for k in E.keys(): od[k] = E[k]
+        Or if E is an iterable of items, does:   for k, v in E: od[k] = v
+        In either case, this is followed by:     for k, v in F.items(): od[k] = v
+
+        '''
+        if len(args) > 2:
+            raise TypeError('update() takes at most 2 positional '
+                            'arguments (%d given)' % (len(args),))
+        elif not args:
+            raise TypeError('update() takes at least 1 argument (0 given)')
+        self = args[0]
+        # Make progressively weaker assumptions about "other"
+        other = ()
+        if len(args) == 2:
+            other = args[1]
+        if isinstance(other, dict):
+            for key in other:
+                self[key] = other[key]
+        elif hasattr(other, 'keys'):
+            for key in other.keys():
+                self[key] = other[key]
+        else:
+            for key, value in other:
+                self[key] = value
+        for key, value in kwds.items():
+            self[key] = value
+
+    __update = update  # let subclasses override update without breaking __init__
+
+    __marker = object()
+
+    def pop(self, key, default=__marker):
+        '''od.pop(k[,d]) -> v, remove specified key and return the corresponding value.
+        If key is not found, d is returned if given, otherwise KeyError is raised.
+
+        '''
+        if key in self:
+            result = self[key]
+            del self[key]
+            return result
+        if default is self.__marker:
+            raise KeyError(key)
+        return default
+
+    def setdefault(self, key, default=None):
+        'od.setdefault(k[,d]) -> od.get(k,d), also set od[k]=d if k not in od'
+        if key in self:
+            return self[key]
+        self[key] = default
+        return default
+
+    def __repr__(self, _repr_running={}):
+        'od.__repr__() <==> repr(od)'
+        call_key = id(self), _get_ident()
+        if call_key in _repr_running:
+            return '...'
+        _repr_running[call_key] = 1
+        try:
+            if not self:
+                return '%s()' % (self.__class__.__name__,)
+            return '%s(%r)' % (self.__class__.__name__, self.items())
+        finally:
+            del _repr_running[call_key]
+
+    def __reduce__(self):
+        'Return state information for pickling'
+        items = [[k, self[k]] for k in self]
+        inst_dict = vars(self).copy()
+        for k in vars(OrderedDict()):
+            inst_dict.pop(k, None)
+        if inst_dict:
+            return (self.__class__, (items,), inst_dict)
+        return self.__class__, (items,)
+
+    def copy(self):
+        'od.copy() -> a shallow copy of od'
+        return self.__class__(self)
+
+    @classmethod
+    def fromkeys(cls, iterable, value=None):
+        '''OD.fromkeys(S[, v]) -> New ordered dictionary with keys from S
+        and values equal to v (which defaults to None).
+
+        '''
+        d = cls()
+        for key in iterable:
+            d[key] = value
+        return d
+
+    def __eq__(self, other):
+        '''od.__eq__(y) <==> od==y.  Comparison to another OD is order-sensitive
+        while comparison to a regular mapping is order-insensitive.
+
+        '''
+        if isinstance(other, OrderedDict):
+            return len(self)==len(other) and self.items() == other.items()
+        return dict.__eq__(self, other)
+
+    def __ne__(self, other):
+        return not self == other
+
+    # -- the following methods are only used in Python 2.7 --
+
+    def viewkeys(self):
+        "od.viewkeys() -> a set-like object providing a view on od's keys"
+        return KeysView(self)
+
+    def viewvalues(self):
+        "od.viewvalues() -> an object providing a view on od's values"
+        return ValuesView(self)
+
+    def viewitems(self):
+        "od.viewitems() -> a set-like object providing a view on od's items"
+        return ItemsView(self)
+