Python-Fedex 开源项目使用教程

1. 项目的目录结构及介绍

Python-Fedex 项目的目录结构如下：

python-fedex/
├── docs/
│   ├── conf.py
│   ├── index.rst
│   └── ...
├── fedex/
│   ├── __init__.py
│   ├── client.py
│   ├── config.py
│   └── ...
├── tests/
│   ├── __init__.py
│   ├── test_client.py
│   └── ...
├── .gitignore
├── LICENSE
├── README.md
├── requirements.txt
└── setup.py

目录结构介绍

• docs/: 包含项目的文档文件，使用 Sphinx 生成文档。
  • conf.py: Sphinx 配置文件。
  • index.rst: 文档的主索引文件。
• fedex/: 包含项目的主要代码文件。
  • __init__.py: 使目录成为一个 Python 包。
  • client.py: 包含 FedEx API 的客户端实现。
  • config.py: 包含配置相关的代码。
• tests/: 包含项目的测试文件。
  • __init__.py: 使目录成为一个 Python 包。
  • test_client.py: 客户端的测试文件。
• .gitignore: Git 忽略文件列表。
• LICENSE: 项目的许可证文件。
• README.md: 项目的主说明文件。
• requirements.txt: 项目依赖的 Python 包列表。
• setup.py: 项目的安装脚本。

2. 项目的启动文件介绍

项目的启动文件主要是 fedex/client.py，该文件包含了 FedEx API 的客户端实现。以下是 client.py 的主要内容：

from zeep import Client as ZeepClient
from .config import Config

class Client:
    def __init__(self, key, password, account_number, meter_number, localization=None, test_mode=True):
        self.config = Config(key, password, account_number, meter_number, localization, test_mode)
        self.client = ZeepClient(self.config.wsdl_url)
        # 其他初始化代码

    def get_rates(self, shipment_details):
        # 获取费率的实现代码
        pass

    # 其他 API 方法

启动文件介绍

• Client 类：用于与 FedEx API 进行交互的客户端类。
  • __init__ 方法：初始化客户端，设置配置和 Zeep 客户端。
  • get_rates 方法：获取费率的实现方法。

3. 项目的配置文件介绍

项目的配置文件主要是 fedex/config.py，该文件包含了配置相关的代码。以下是 config.py 的主要内容：

class Config:
    def __init__(self, key, password, account_number, meter_number, localization=None, test_mode=True):
        self.key = key
        self.password = password
        self.account_number = account_number
        self.meter_number = meter_number
        self.localization = localization or 'en_US'
        self.test_mode = test_mode
        self.wsdl_url = self.get_wsdl_url()

    def get_wsdl_url(self):
        if self.test_mode:
            return 'https://wsbeta.fedex.com:443/web-services'
        else:
            return 'https://ws.fedex.com:443/web-services'

配置文件介绍

• Config 类：用于管理项目的配置。
  • __init__ 方法：初始化配置参数，包括 API 密钥、密码、账户号、计量号等。
  • get_wsdl_url 方法：根据测试模式返回相应的 WSDL URL。

以上是 Python-Fedex 开源项目的目录结构、启动文件和配置文件的介绍。希望这份教程能帮助你更好地理解和使用该项目。