Unpack Nested Data：照亮你的数据结构

你是否曾在深不见底的嵌套字典或列表中，为一个关键值的确切位置而苦苦搜寻？当 data['settings']['database']['credentials'][0] 这样的路径让你头晕目眩时，UnpackNestedData 这个 Python 工具，就像一束精准的探照光，能瞬间照亮数据结构的每一个角落，直达目标。

想象这样一个场景：你有一个复杂的数据对象，它可能是来自 API 的 JSON 响应、配置文件，或是任何包含字典、列表、元组的混合结构。你需要快速知道某个特定的键（key）或值（value）藏在哪里。手动编写递归函数不仅繁琐，而且容易出错。UnpackNestedData 的核心函数 light() 正是为此而生。

核心功能：一键定位

只需调用 light(target, data)，它便会返回一个元组 (found, results)。found 是一个布尔值，告诉你目标是否存在。results 则是一个列表，包含了数据结构中所有直接包裹着目标的可迭代对象。它让你立刻获得了目标所在的上下文环境。

直观示例

以指南开头的复杂数据为例：寻找 'admin'。调用 light('admin', data)，得到 (True, [('admin', 'secret')])。这告诉你：找到了，而且它位于一个元组 ('admin', 'secret') 中。寻找键 'config'，则返回 (True, [{'name': 'payment', 'enabled': False, 'config': {...}}])，直接给出了包含 'config' 键的完整字典对象。这种"上下文感知"的返回方式，对于调试和数据探查至关重要。

设计哲学与优势

轻量无依赖：纯 Python 实现，开箱即用，不引入任何外部包。
类型安全：清晰地区分对待字典的键（key）和其他可迭代对象（如列表、元组）中的元素（value）。
结果直观：返回包含目标的直接父容器，而非冗长的路径字符串，让你能立即进行下一步操作。
应对复杂：能正确处理 None、非迭代对象，以及字典、列表、元组任意嵌套的混合结构。

开始使用

访问项目的 GitHub 仓库，将核心函数复制到你的工具库中，或者直接克隆项目。它的使用简单到只需一行导入、一次调用。无论是分析日志、审查配置，还是在数据处理管道中快速定位问题字段，UnpackNestedData 都能成为你工具箱中那把高效、精准的"手术刀"。

告别在嵌套数据迷宫中的盲目摸索。用一束光，看清所有结构。

How to Unpack Nested Data?

Suppose we have data like this:

python 复制代码

data = {
            "project": "Phoenix",
            "version": "2.0.1",
            "settings": {
                "debug": True,
                "database": {
                    "host": "localhost",
                    "port": 5432,
                    "credentials": ("admin", "secret")
                }
            },
            "modules": [
                {
                    "name": "auth",
                    "enabled": True,
                    "dependencies": ["crypto", "logger"]
                },
                {
                    "name": "payment",
                    "enabled": False,
                    "config": {
                        "gateway": "stripe",
                        "api_key": "sk_test_123"
                    }
                },
                (1, 2, "three"),
                42,
                "no_iteration_here",
            ],
            "metadata": None
}

You have your target key 'admin'. You're wondering where the key is in the data. The light function will shed light on all iterable objects that contain the key. It returns (l, values). If the key is in the nested data d, then l=True. All iterable objects containing the key in d compose the list values.

python 复制代码

>>> light('admin', data)
(True, [('admin', 'secret')])
>>> light('config', data)
(True, [{'name': 'payment', 'enabled': False, 'config': {'gateway': 'stripe', 'api_key': 'sk_test_123'}}])