如何生成与GitHub一致的HelloSign Python SDK？

1. 使用仓库内的官方定制配置 #

官方的Python SDK并非通过默认参数生成，必须从hellosign-openapi仓库获取两个核心资源：

• 官方专属的生成器配置文件（通常命名为openapi-generator-python-config.yaml，可在sdks/python目录或仓库根目录找到）
• 官方自定义的模板文件（若存在，存放于仓库的templates/python目录下）

2. 调整生成命令参数 #

修改你的生成命令，加入官方配置与模板路径，同时移除--skip-validate-spec参数（该参数会跳过规范验证，大概率是导致API类缺失的原因）：

java -jar openapi-generator-cli-官方对应版本.jar generate \
  -i D:\openapi-sdk.yaml \
  -g python \
  -o c:\temp\hellosign_python \
  -c [本地存放的官方配置文件路径] \
  --template-dir [本地存放的官方Python模板目录路径] \
  --additional-properties packageName=hellosign.sdk

3. 匹配官方使用的OpenAPI Generator版本 #

你当前使用的是6.6.0版本，但官方SDK可能基于特定版本的生成器构建。去hellosign-openapi仓库的README文档或CI工作流配置文件（如.github/workflows目录下的文件）中查找官方使用的生成器版本，替换为对应版本的jar包——版本不一致会直接导致生成的文件结构、__init__.py内容出现差异。

4. 补充官方手动编写的代码 #

官方SDK中包含部分生成器无法自动生成的自定义代码，比如：

• __init__.py中的导出逻辑
• 客户端的整合封装代码
• 额外的工具类或辅助方法

生成完成后，对比官方sdks/python目录下的文件，将这些手动编写的代码复制到你生成的SDK对应位置。

5. 验证生成结果 #

生成后逐一核对以下内容，确保与官方版本一致：

• 生成的API类数量是否完整
• __init__.py中的导出语句结构是否匹配
• 客户端类的组织形式（是单一整合客户端还是分离式）
• requirements.txt、setup.py等依赖配置文件的内容是否一致

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