datadog/datadog-agent-six-cci

Datadog Agent Six

警告: 该仓库已被弃用，不再维护。

镜像概述

Datadog Agent Six 是一个围绕 CPython API 的 C++ 包装器，提供 C89 兼容的公共 API，支持多 Python 版本的嵌入和扩展后端。它允许客户端应用程序与 CPython 解耦，在运行时动态决定使用哪个 Python 版本，并相应地加载适当的后端库。

核心功能与特性

• 提供 C89 兼容的公共 API，可被 Go 等外部语言使用
• 完全抽象 Python，实现客户端应用与 CPython 的解耦
• 支持多 Python 版本，可在运行时动态选择
• 通过 dlopen 动态加载适当的后端库
• 提供统一接口，简化 Python 嵌入和扩展过程

架构设计

libdatadog-agent-six

Six 通过 include/datadog_agent_six.h 暴露 C89 兼容 API。使用 make2 和 make3 函数可在运行时加载相应的 Python 后端。在底层，该库提供 Six C++ 接口，任何受支持的后端都必须实现此接口，详情参见 include/six.h。

Two 和 Three 后端

libdatadog-agent-three 和 libdatadog-agent-two 库通过链接不同版本的 CPython 库，分别提供对 Python 3 和 Python 2 的扩展与嵌入支持。

Common 模块

common 文件夹包含编译到 libdatadog-agent-three 和 libdatadog-agent-two 中的 C/C++ 模块，以避免代码重复。大多数用于扩展嵌入式解释器的代码都位于此目录。

系统需求

• C/C++ 编译器
• Python 2.7.x 开发包
• Python 3.7.x 开发包
• CMake 3.12 或更高版本
• 具有 cgo 能力的 Go 编译器（用于运行测试）

构建方法

使用 CMake 构建 Six：

1. 首先运行配置器/生成器：

   sh
   cmake .
   

2. 然后运行 make 构建项目：

   sh
   make
   

使用示例

demo 目录下提供了 C 应用程序示例，展示如何使用 Six。运行示例前，需要在 Python 环境中安装一些依赖。推荐使用虚拟环境：

如果本地克隆了 integrations-core 仓库，可通过以下命令安装所需依赖：

sh
pip install /path_to_integrations_core/datadog_checks_base
pip install /path_to_integrations_core/directory

运行演示

根据虚拟环境提供的 Python 版本，运行相应命令：

Python 2 (OSX):

sh
DYLD_LIBRARY_PATH=./three:./two ./demo/demo 2 $VIRTUAL_ENV

Python 2 (Unix):

sh
LD_LIBRARY_PATH=./three:./two ./demo/demo 2 $VIRTUAL_ENV

Python 3 (OSX):

sh
DYLD_LIBRARY_PATH=./three:./two ./demo/demo 3 $VIRTUAL_ENV

Python 3 (Unix):

sh
LD_LIBRARY_PATH=./three:./two ./demo/demo 3 $VIRTUAL_ENV

测试方法

测试用例使用 Golang 和 cgo 编写，从根目录运行测试套件：

sh
make -C test

注意事项

该项目已被官方标记为弃用，不再接收更新和维护。建议寻找替代方案或迁移到最新的 Datadog Agent 组件。