Google i18n Address 项目使用教程

1. 项目目录结构及介绍

Google i18n Address 项目包含以下目录和文件：

google-i18n-address/
├── .github/
├── src/
│   └── i18naddress/
│       ├── __init__.py
│       ├── address.py
│       ├── validation.py
│       └── formatting.py
├── tests/
│   ├── __init__.py
│   ├── test_address.py
│   ├── test_validation.py
│   └── test_formatting.py
├── .gitignore
├── LICENSE
├── MANIFEST.in
├── README.md
└── pyproject.toml

• .github/：包含与 GitHub 仓库相关的文件，例如分支保护规则和代码质量检查配置。
• src/：源代码目录，包含项目的核心功能。
  • i18naddress/：包含项目的 Python 模块。
    • __init__.py：初始化模块，允许从 i18naddress 目录导入模块。
    • address.py：定义地址处理相关的类和函数。
    • validation.py：定义地址验证相关的类和函数。
    • formatting.py：定义地址格式化相关的类和函数。
• tests/：测试代码目录，包含用于验证项目功能的各种测试。
• .gitignore：指定 Git 忽略的文件和目录。
• LICENSE：项目的许可证文件，本项目使用 BSD-3-Clause 许可。
• MANIFEST.in：包含用于构建源分发的文件列表。
• README.md：项目的自述文件，提供项目的说明和基本信息。
• pyproject.toml：项目配置文件，包含项目的元数据和构建系统信息。

2. 项目的启动文件介绍

Google i18n Address 项目没有特定的启动文件，因为它是一个库项目，而不是一个应用程序。要使用这个库，你需要将其导入到你的 Python 代码中，并使用提供的函数和类。

例如，你可以使用以下代码来验证一个地址：

from i18naddress import normalize_address, InvalidAddressError

try:
    address = normalize_address({
        'country_code': 'US',
        'country_area': 'California',
        'city': 'Mountain View',
        'postal_code': '94043',
        'street_address': '1600 Amphitheatre Pkwy'
    })
    print(address)
except InvalidAddressError as e:
    print(e.errors)

3. 项目的配置文件介绍

pyproject.toml 文件是项目的主要配置文件，它包含项目的元数据和构建系统信息。以下是一个示例：

[build-system]
requires = ["setuptools", "wheel"]
build-backend = "setuptools.build_meta"

[tool.setuptools]
packages = ["i18naddress"]
python-requires = ">=3.6"

这个文件指定了构建系统需要使用的依赖（setuptools 和 wheel），以及构建后端是 setuptools.build_meta。它还指定了应该打包的 Python 包和支持的 Python 版本。在项目安装或构建时，这个文件将被使用。