PyXLL Examples 项目启动与配置教程

1. 项目目录结构及介绍

PyXLL Examples 项目目录结构如下：

pyxll-examples/
├── examples/
│   ├── basic/
│   │   ├── basic.xll
│   │   └── __init__.py
│   ├── advanced/
│   │   ├── advanced.xll
│   │   └── __init__.py
│   └── distribute/
│       ├── distribute.xll
│       └── __init__.py
├── tests/
│   ├── basic/
│   │   └── test_basic.py
│   ├── advanced/
│   │   └── test_advanced.py
│   └── distribute/
│       └── test_distribute.py
├── setup.py
└── README.md

• examples/ 目录包含不同示例模块的子目录。
  • basic/ 包含基础的 PyXLL 插件示例。
  • advanced/ 包含高级功能的 PyXLL 插件示例。
  • distribute/ 包含用于分发 PyXLL 插件的示例。
• tests/ 目录包含对示例模块的单元测试。
• setup.py 是用于构建和安装 PyXLL 插件的 Python 包配置文件。
• README.md 是项目的说明文件。

2. 项目的启动文件介绍

项目的启动主要是通过 examples/ 目录下的 .xll 文件实现的。.xll 文件是 Excel 的加载项文件，双击该文件或在 Excel 中通过“加载项”菜单添加，即可将 PyXLL 插件加载到 Excel 中。

例如，basic/ 目录下的 basic.xll 文件是基础示例的启动文件。加载此文件后，可以在 Excel 中使用定义的函数和功能。

3. 项目的配置文件介绍

项目的配置主要通过 setup.py 文件进行。setup.py 文件是 Python 包的配置文件，它定义了如何打包和安装 Python 项目。

以下是 setup.py 文件的基本结构：

from setuptools import setup, find_packages

setup(
    name='pyxll-examples',
    version='0.1.0',
    packages=find_packages(),
    # 这里可以定义其他配置项，如作者、描述、依赖等
    author='Author Name',
    author_email='[e-mail]',
    description='A collection of PyXLL examples',
    # 其他元数据和配置...
)

在这个配置文件中，可以指定项目的名称、版本、包含的包、作者信息、邮件地址和项目描述等。在安装或分发项目时，这些信息会被使用。

要配置项目，需要修改 setup.py 文件中的相应字段，以确保所有信息都是准确和最新的。