» Python创建命令行程序grep » 2. 开发 » 2.1 目录结构

目录结构

lr_grepy/
│
├── grepy/
│   ├── __init__.py
│   ├── grep.py         # grep 功能的主要逻辑
│   └── utils.py        # 可能需要的实用函数
│
├── tests/
│   ├── __init__.py
│   ├── test_grep.py    # grep 功能的单元测试
│   └── test_utils.py   # 实用函数的单元测试
│
├── setup.py            # 打包和分发配置
├── requirements.txt    # 项目的依赖关系
├── README.md           # 项目文档
├── LICENSE             # 许可信息
└── grepy_cli.py        # 命令行接口脚本

各个文件夹/文件的解释:

  • grepy/: 主要模块。它包含了 grep 功能的核心逻辑。根据应用程序的复杂性,你可能需要在此包内再细分多个模块。

  • tests/: 应用程序的单元测试。grepy/ 包中的每个模块都应该在 tests/ 文件夹中有一个相应的测试模块。

  • setup.py: 此文件用于打包和分发。它定义了项目及其依赖项的元数据。

  • requirements.txt: 此文件列出了项目所需的依赖项。用户可以使用 pip install -r requirements.txt 来安装这些依赖项1

  • README.md: 项目的文档。它应该包含安装、配置和使用CLI应用程序的说明。

  • LICENSE:2 包含一个许可文件,指定软件分发的条款。

  • grepy_cli.py: 这是用户从命令行中运行以与工具交互的脚本。它应该处理命令行参数并调用 grepy/ 包提供的功能。

这种结构有助于很好地分离关注点,使得将来扩展项目变得容易。

Footnotes

  1. pip和PyPI是什么?

  2. 开源许可

上页下页