帮助识别和变形对象的例程集合。
morph的Python项目详细描述
morph提供以下功能来帮助识别对象类型：
| Name | Functionality |
|---|---|
| ^{tt1}$ | Is obj a string? |
| ^{tt2}$ | Is obj a sequence-like (i.e. iterable) type (but not a string or dict)? |
| ^{tt3}$ | Is obj a dict-like type? This means that it must have at least the following methods: keys(), values(), and items(). |
morf提供以下功能来帮助变形对象：
| Name | Functionality |
|---|---|
| ^{tt4}$ | Converts obj to a bool; if string-like, it is matched against a list of “truthy” or “falsy” strings; if bool-like, returns itself; then, if the default parameter is not ^{tt5}$ (which defaults to ^{tt6}$), returns that; otherwise throws a ValueError exception. |
| ^{tt7}$ | Converts obj to a list; if string-like, it splits it according to Unix shell semantics (if keyword split is truthy, the default); if sequence-like, returns itself converted to a list (optionally flattened if keyword flat is truthy, the default), and otherwise returns a list with itself as single object. |
| ^{tt8}$ | Extracts a subset of key/value pairs from a dict-like object where the key is a specific value or has a specific prefix. |
| ^{tt9}$ | Converse of morph.pick(). |
| ^{tt10}$ | Converts a multi-dimensional list or dict type to a one-dimensional list or dict. |
| ^{tt11}$ | Reverses the effects of flatten (note that lists cannot be unflattened). |
| ^{tt12}$ | Recursively transforms sequences & dicts in object. |
扁平化
当展平类似序列的对象（即列表或元组）时， morph.flatten递归地将多维数组减少为 单一维度，但仅适用于每个派生列表的元素 是列表式的。例如：
[1,[2,[3,'abc','def',{'foo':['zig',['zag','zog']]}],4]]# is morphed to[1,2,3,'abc','def',{'foo':['zig',['zag','zog']]},4]
当展开一个类似dict的对象时，它会折叠list-and-dict- 子键分为索引和点式顶级键。例如：
{'a':{'b':1,'c':[2,{'d':3,'e':4,}]}}# is morphed to{'a.b':1,'a.c[0]':2,'a.c[1].d':3,'a.c[1].e':4,}
（这在处理ini文件时非常有用，因为它只能 扁平化：扁平化和非扁平化函数允许转换 在复杂结构和平面ini文件之间）。
请注意，列表永远不能是不平坦的，而不平坦的听写是 不保证往返一致。后者可能发生在 要压平的字条上有带特殊字符的键， 例如句点（'.'）或方括号（'[]'）。
挑选和省略
morph的pick和omit函数允许您提取一组键 （或属性）来自一个类似于dict的对象（或普通对象）。这些 不管 提供的值–即，如果None作为源给定，则为空dict 被退回。此外，以下可选关键字参数 接受：
dict：
指定应返回的类类型，默认为 到标准pythondict类型。
前缀：
对于pick，指定仅以指定的 字符串将被返回（并为指定的键过滤）。 把前缀从键中去掉。如果没有指定键， 这将只返回具有指定前缀的键。
对于省略键，指定以指定值开头的键 应该从返回的dict中删除。
树：
如果指定并truthy，则指定为pick或 省略被计算为多维项地址，如 由morph.flatten生成的。
示例：
d={'foo':'bar','zig.a':'b','zig.c':'d'}morph.pick(d,'foo','zig.a')# ==> {'foo', 'bar', 'zig.a': 'b'}morph.pick(d,prefix='zig.')# ==> {'a': 'b', 'c': 'd'}morph.pick(d,'c',prefix='zig.')# ==> {'c': 'd'}morph.omit(d,'foo')# ==> {'zig.a': 'b', 'zig.c': 'd'}morph.omit(d,prefix='zig.')# ==> {'foo': 'bar'}classmydict(dict):passmorph.pick(dict(foo='bar',zig='zag'),'foo',dict=mydict)# ==> mydict({'foo': 'bar'})
由于某些限制，这也适用于对象属性。为了 示例：
classX():def__init__(self):self.foo='bar'self.zig1='zog'self.zig2='zug'defzigMethod(self):passx=X()morph.pick(x,'foo','zig1')# ==> {'foo': 'bar', 'zig1': 'zog'}morph.pick(x,prefix='zig')# ==> {'1': 'zog', '2': 'zug'}morph.pick(x)# ==> {}morph.omit(x,'foo')# ==> {'zig1': 'zog', 'zig2': 'zug'}morph.omit(x,prefix='zig')# ==> {'foo': 'bar'}morph.omit(x)# ==> {'foo': 'bar', 'zig1': 'zog', 'zig2': 'zug'}
转换
可以使用morph.xformhelper函数递归转换 列表和字典树中的所有项–这有效地允许 应用于嵌套list/dict的列表理解的易用性 结构。
示例：
morph.xform([2,[4,{6:8}]],lambdaval,**kws:val**2)# ==> [4, [16, {36: 64}]]
注意，回调函数xformer，作为第二个函数传递 morph.xform的参数应始终支持任意数字 关键字参数的 有点像**kws。
欢迎加入QQ群-->： 979659372
