Project

General

Profile

1 11 aaronmk
# Useful functions and classes
2
3 1068 aaronmk
import collections
4
5 931 aaronmk
#### Function wrappers for statements
6
7
def noop(*args, **kw_args): pass
8
9
def and_(a, b): return a and b
10
11 791 aaronmk
#### Object metadata
12
13 341 aaronmk
def type_name(value): return type(value).__name__
14
15 135 aaronmk
def module(value): return type(value).__module__.split('.')
16
17
def root_module(value): return module(value)[0]
18
19 1233 aaronmk
#### Type checking and conversion
20 791 aaronmk
21
class ConstraintError(ValueError):
22
    def __init__(self, check_func, value):
23 795 aaronmk
        ValueError.__init__(self, str(value)+' must satisfy constraint '
24
            +check_func.__name__)
25 791 aaronmk
26 836 aaronmk
def cast(type_, val):
27 1046 aaronmk
    '''Passes None through. Does not cast a subclass to a superclass (which
28
    doesn't make sense in a dynamically-typed language).'''
29
    if val != None and not isinstance(val, type_): val = type_(val)
30 836 aaronmk
    return val
31
32 1233 aaronmk
def all_not_none(vals): return reduce(and_, map(lambda v: v != None, vals))
33
34 791 aaronmk
def is_str(val): return isinstance(val, basestring)
35
36 1007 aaronmk
def is_list(val): return isinstance(val, list)
37
38 1233 aaronmk
def bool2str(val):
39
    if val: return '1'
40
    else: return ''
41
42 1046 aaronmk
#### Basic types
43
44
def none_if(val, none_val):
45
    if cast(type(none_val), val) == none_val: return None
46
    else: return val
47
48 791 aaronmk
#### Iterables
49
50 135 aaronmk
def first(iter_): return iter_.next()
51
52 133 aaronmk
def skip(iter_, func):
53
    # Advance iter while func is True
54
    try:
55
        while func(iter_.curr()): iter_.next()
56
    except StopIteration: pass # nothing after the matching elements
57
58 1147 aaronmk
class WrapIter:
59
    def __init__(self, wrap_func, iterable):
60
        self.wrap_func = wrap_func
61
        self.iter_ = iterable.__iter__()
62
63
    def __iter__(self): return self
64
65
    def next(self): return self.wrap_func(self.iter_.next())
66 934 aaronmk
67 791 aaronmk
class CheckedIter:
68
    def __init__(self, check_func, iterable):
69
        self.check_func = check_func
70
        self.iter_ = iterable.__iter__()
71
72
    def __iter__(self): return self
73
74
    def next(self):
75
        entry = self.iter_.next()
76
        if self.check_func(entry): return entry
77
        else: raise ConstraintError(self.check_func, entry)
78
79 1008 aaronmk
#### Lists
80
81
def list_get(list_, idx, default=None):
82
    try: return list_[idx]
83
    except IndexError: return default
84
85 1281 aaronmk
def list_set(list_, idx, value, default=None):
86
    extra_needed = idx + 1 - len(list_)
87
    if extra_needed > 0: list_ += extra_needed*[default]
88
    list_[idx] = value
89
90
def list_setdefault(list_, idx, default=None):
91
    try: return list_[idx]
92
    except IndexError:
93
        list_set(list_, idx, default, default)
94
        return default
95
96 1147 aaronmk
def list_subset(list_, idxs):
97
    subset = []
98
    for idx in idxs:
99
        try: subset.append(list_[idx])
100
        except IndexError: pass
101
    return subset
102
103 1012 aaronmk
def list_eq_is(list0, list1):
104
    '''Compares two lists using is'''
105
    if len(list0) != len(list1): return False
106
    for i in xrange(len(list0)):
107
        if list0[i] is not list1[i]: return False
108
    return True
109
110 1344 aaronmk
def list_replace(list_, repl_elem, with_slice):
111
    list_ = list_[:] # don't modify input!
112
    while True:
113
        try: idx = list_.index(repl_elem)
114
        except ValueError: break
115
        list_[idx:idx+1] = with_slice
116
    return list_
117
118 1145 aaronmk
def list_flip(list_): return dict((v, i) for i, v in enumerate(list_))
119
120 791 aaronmk
#### Dicts
121
122 330 aaronmk
def rename_key(dict_, orig, new): dict_[new] = dict_.pop(orig)
123 466 aaronmk
124 467 aaronmk
def dict_subset(dict_, keys):
125
    subset = dict()
126
    for key in keys:
127
        try: subset[key] = dict_[key]
128
        except KeyError: pass
129
    return subset
130 1068 aaronmk
131
class DefaultDict(collections.defaultdict):
132
    def __init__(self, dict_, default=None):
133
        collections.defaultdict.__init__(self, lambda: default, dict_)
134
135
def dict_subset_right_join(dict_, keys):
136
    '''Gets a subset of a dict, using None for subset keys that don't exist'''
137
    return dict_subset(DefaultDict(dict_), keys)
138 1147 aaronmk
139
class ListDict:
140
    '''Views a list as a dict, given a key->index mapping'''
141
    def __init__(self, list_, keys, key_idxs=None):
142
        assert len(keys) == len(list_)
143
        if key_idxs == None: key_idxs = list_flip(keys)
144
        self.list = list_
145
        self.keys = keys
146
        self.key_idxs = key_idxs
147
148
    def __getitem__(self, key): return self.list[self.key_idxs[key]]
149
150 1178 aaronmk
    def __str__(self): return '{\n'+(''.join(str(k)+': '+str(v)+'\n'
151
        for k, v in zip(self.keys, self.list)))+'}\n'