简介

Nested-List 是一个使用 operator 库构建的一个嵌套列表操作库，主要用于对元素不是基本数据类型的列表进行排序、删除等操作，里面的大多函数使用了 operator 库，可以简化项目代码编写量。

Nested-List 可以使用 pip 进行安装：pip install Nested-List

Nested-List-1.0.x 有 4 个可用函数，分别是排序、删除元素、最大值和最小值，Nested-List 会自动判断传入的列表的元素是什么类型，并调用相应的处理函数，无论进行哪些操作，都要保证列表里的元素是同一类型，这是这个库的工作基础。

def sort(nl, *key, order=False):
    ...

def delete_items(dl, keys, values, compare=None):
    ...

def max(nl, *keys):
    ...

def min(nl, *keys):
    ...

每个函数使用时都需要传入需要操作的列表。

排序

排序可根据列表中元素的属性来对元素进行排序，排序顺序默认是升序，当 order 字段设置为 True 或者"DESC"时，将会降序排序，当传入值不符合规定时将会按照默认排序处理，有一个注意点是如果要设置 order 的值，要在全部参数传入完成后再传入 order 的值。

import nested_list as ntls

dict_list = [
    {'name':'one', 'age':11},
    {'name':'two', 'age':5},
    {'name':'three','age':26},
    {'name':'four','age':19}
]

ntls.sort(dict_list,'age',order=False)
print(dict_list)

# 排序完的输出将会是[{'name': 'two', 'age': 5}, {'name': 'one', 'age': 11}, {'name': 'four', 'age': 19}, {'name': 'three', 'age': 26}]

当然列表里的元素也可以是对象，但是你要确保你的对象都是同一类型的对象，并可以指定可排序属性

class User:
    def __init__(self, name, age):
        self.name = name
        self.age = age
    def __repr__(self):
        return 'User({})'.format(self.age)

user_list = [
    User('one',18),
    User('two',9),
    User('three',7),
    User('four',15)
]

ntls.sort(user_list, 'age')
print(user_list)

# 排序完的输出将会是[User(7), User(9), User(15), User(18)], 如果你不重写__repr__, 那么将会打印的列表里将会是对象信息, 你将看不到排序效果

你可以传入多个参数来进行多次排序，如下

ntls.sort(user_list, 'id', 'age',order="DESC")

此时 sort 函数将会先根据 id 进行降序排序，排序完再根据 age 排序一次

删除元素

delete_items 可根据列表的中元素的属性值来删除元素，同样的，delete_items 处理的列表元素类型也可以是对象，但使用 delete_items 的时候传入参数有两个个注意点：

1、无论要根据的属性有多少个，传入时只能存为一个可迭代对象传入，在 Python 里，虽然字符串可以被迭代，传入字符串也不会报错，但会得出错误的执行结果，所以建议传入一个 tuple 或者 list

2、当传入属性值只有一个时，传入的判断值不需要存入可迭代对象，直接传入即可，否则会出现错误的执行结果；当传入属性值有多个时，传入的判断值只能存为 tuple 对象传入

以下是例子：

# 单个属性时正确的使用方式
ntls.delete_items(user_list, ['age'], 7)
# 或者可以这样
ntls.delete_items(user_list, ('age'), 7)

# 单个属性时错误的使用方式
ntls.delete_items(user_list, ['age'], (7))
ntls.delete_items(user_list, 'age', 7)

# 传入多个属性时正确的使用方式
ntls.delete_items(user_list, None, ['age','name'],(7,'four'))

# 传入多个属性时错误的使用方式
ntls.delete_items(user_list, None, ['age','name'],7,'four')
ntls.delete_items(user_list, None, ['age','name'],[7,'four'])

最大值与最小值

如果要根据元素中某个属性来找出最值，可以调用 max 传入 key 来处理，Nested-List 底层也是这么使用，对于 Nested-List 来说，只是引入了 operator 的 attrgetter 和 itemgetter 来传入 key 并进行了简单的包装，Nested-List 的 max 和 min 也是返回了 Python 内置的 max 和 min 函数的工作结果。

对于 Nested-List 的 max 和 min 的使用方法如下

ntls.max(user_list, "age")

当有多个判断属性时，可直接传入多个属性名称

ntls.max(user_list, "age", "id")

致谢

感谢《Python Cookbook》3rd Edition 的作者和翻译者，本项目的开发离不开 Python Cookbook 3rd Edition Documentation 里面的内容带给我的帮助和启发。

Nested-List 起初的开发是针对项目中对列表中字典的排序，但随后的开发中在《Python Cookbook》3rd Edition 的翻译文档中学习到了更加方便且有效率的方法，按照其中的思路将功能打包在一起供给其它人使用，同时 Nested-List 变得不再只能对列表中的字典进行操作，也可以对列表或者其他对象使用。

链接

Nested-List GitHub仓库主页：https://github.com/korilin/Nested-List (opens new window)

Python Cookbook 3rd Edition Documentation：https://python3-cookbook.readthedocs.io/zh_CN/latest/index.html (opens new window)