如何在运行时添加入口点，让importlib.metadata.entry_points()能够找到它？

嘿，这个问题确实踩中了importlib.metadata和旧pkg_resources的核心差异——前者完全基于已注册的分发包（distribution）元数据来读取入口点，不像pkg_resources有直接的动态添加接口。下面给你两种靠谱的实现思路：

方法一：注册虚拟分发包（推荐，兼容性较好） #

这种方式通过自定义分发包和Finder，让importlib.metadata主动识别我们的运行时入口点，完全符合官方API规范：

1. 导入必要模块并定义自定义分发类
   这个类只需要实现最核心的entry_points()方法，返回我们要添加的入口点集合：

   import importlib.metadata
   from importlib.metadata import Distribution, EntryPoint, DistributionFinder
   import sys
   
   class RuntimeEntryPointDistribution(Distribution):
       def __init__(self, entry_points):
           self._custom_entries = entry_points
   
       def entry_points(self):
           # 按入口点分组整理成标准格式
           groups = {}
           for ep in self._custom_entries:
               groups.setdefault(ep.group, []).append(ep)
           return importlib.metadata.EntryPoints(groups)
   
       # 必须实现name属性，避免元数据查询报错
       @property
       def name(self):
           return "runtime-dynamic-entrypoints"
   

2. 实现自定义Finder
   Finder负责让importlib.metadata找到我们的虚拟分发包：

   class RuntimeEntryPointFinder(DistributionFinder):
       def __init__(self, entry_points):
           self.entry_points = entry_points
   
       def find_distributions(self, context=None):
           yield RuntimeEntryPointDistribution(self.entry_points)
   

3. 创建并注册你的入口点
   比如添加一个console_scripts类型的入口点，指向你代码里的函数：

   # 定义入口点：名称=my_command，指向my_module模块里的main函数
   my_ep = EntryPoint(
       name="my_command",
       value="my_module:main",
       group="console_scripts"
   )
   
   # 注册Finder到系统元路径
   sys.meta_path.append(RuntimeEntryPointFinder([my_ep]))
   

4. 验证效果
   现在调用entry_points()就能找到你添加的内容了：

   # 查找指定分组和名称的入口点
   found_ep = importlib.metadata.entry_points(
       group="console_scripts"
   ).select(name="my_command")
   
   print(found_ep.value)  # 输出: my_module:main
   

方法二：直接修改分发缓存（简单但依赖内部API） #

如果你只需要在特定Python版本（3.8+）快速实现，可以直接操作importlib.metadata的内部缓存，省去写Finder的步骤：

import importlib.metadata
from importlib.metadata import EntryPoint

# 定义入口点
my_ep = EntryPoint(
    name="my_plugin",
    value="my_plugins:cool_plugin",
    group="my_plugin_group"
)

# 创建虚拟分发包
class TempDistribution(importlib.metadata.Distribution):
    def entry_points(self):
        return importlib.metadata.EntryPoints({
            "my_plugin_group": [my_ep]
        })

    @property
    def name(self):
        return "temp-entrypoints"

# 写入内部缓存
importlib.metadata._distribution_cache["temp-entrypoints"] = TempDistribution()

关键注意事项 #

• 入口点的value必须遵循模块名:目标对象格式（比如my_module:func或my_module:MyClass），否则后续加载会失败。
• 运行时添加的入口点仅在当前程序生命周期有效，重启后会消失，完全符合临时注入的需求。
• 如果你需要兼容Python 3.7及更早版本，可能需要额外安装importlib-metadata三方库，API用法和官方一致。

内容的提问来源于stack exchange，提问作者flying sheep