goPy 项目技术文档

1. 安装指南

1.1 环境要求

• 确保已安装 Go 语言环境（建议版本 1.16 或更高）。
• 根据需要支持的 Python 版本，安装相应的 Python 环境。

1.2 安装步骤

1. 克隆项目代码库到本地：

   git clone https://github.com/qur/gopy.git
   

2. 切换到所需的 Python 版本分支：
   • 对于 Python 2.6：

     git checkout python2.6
     

   • 对于 Python 2.7：

     git checkout python2.7
     

   • 对于 Python 3.11：

     git checkout python3.11
     

3. 安装依赖项：

   go mod tidy
   

4. 编译项目：

   go build
   

2. 项目的使用说明

2.1 概述

goPy 项目旨在为 Go 语言提供 Python API 的绑定，使得开发者可以在 Go 代码中以自然的方式使用 Python 的 API。

2.2 使用示例

以下是一个简单的示例，展示如何在 Go 代码中使用 goPy：

package main

import (
    "fmt"
    "github.com/qur/gopy"
)

func main() {
    // 初始化 Python 环境
    gopy.Initialize()

    // 创建一个 Python 字符串对象
    pyStr := gopy.NewString("Hello, Python!")

    // 打印 Python 字符串对象
    fmt.Println(pyStr.ToString())

    // 关闭 Python 环境
    gopy.Finalize()
}

2.3 注意事项

• 在使用 goPy 时，确保 Python 环境已正确配置。
• 不同版本的 Python 分支可能存在差异，请根据实际需求选择合适的分支。

3. 项目 API 使用文档

3.1 初始化与关闭

• gopy.Initialize(): 初始化 Python 环境。
• gopy.Finalize(): 关闭 Python 环境。

3.2 创建 Python 对象

• gopy.NewString(value string) *gopy.PyString: 创建一个 Python 字符串对象。
• gopy.NewInt(value int) *gopy.PyInt: 创建一个 Python 整数对象。
• gopy.NewList() *gopy.PyList: 创建一个 Python 列表对象。

3.3 对象方法

• ToString() string: 将 Python 对象转换为 Go 字符串。
• ToInt() int: 将 Python 对象转换为 Go 整数。
• Append(item interface{}): 向 Python 列表中添加元素。

4. 项目安装方式

4.1 通过源码安装

1. 克隆项目代码库：

   git clone https://github.com/qur/gopy.git
   

2. 切换到所需分支：

   git checkout python3.11
   

3. 编译并安装：

   go install
   

4.2 通过 Go 模块安装

1. 在 Go 项目中添加依赖：

   import "github.com/qur/gopy"
   

2. 使用 go mod tidy 安装依赖：

   go mod tidy
   

通过以上步骤，您可以顺利安装并使用 goPy 项目，享受在 Go 语言中使用 Python API 的便利。