摘要:在项目开发过程中,一个良好的项目结构对于团队的协作和代码的可维护性起着重要作用。通过使用自动生成项目结构文字样式的工具。不仅节省了手动编写项目结构的麻烦,还确保了结构的一致性和准确性。
本文分享自华为云社区《【Python】自动化构建项目结构样式》,作者: frica01。
引言
在使用Python或者其它编程语言的项目时候,编写README.md 往往是不可或缺的;
而在README.md 中,关于项目结构的样式展示,这个是可选的。不展示也无伤大雅,但有展示的话,有以下优点:
- 提供清晰的项目导航:包含项目结构的文字样式可以让读者快速了解项目的组织方式和文件结构。这对于新加入的开发人员或用户来说尤为重要,他们可以迅速找到所需的文件和模块,并理解它们之间的关系。
但是怎么去编写这个项目结构的样式,却很令人头疼。
手动编写和更新这些结构可能会变得很繁琐和容易出错。因此,有自动生成项目结构文字样式的工具或脚本可以极大地简化这个过程,提高效率并减少错误。
所以本文就是来解决这一痛点!!!
展示
应该没有人不心动吧!!!
下面使用笔者的一个PySide6/PyQT开发的一个项目的项目结构来作展示。
一个Python写的游戏辅助小工具。适用于 咸鱼之王后台挂机、鼠标连击等。
看以下动图展示:
再来看下面的截图
知识点
安装依赖
- 免安装,Python内置
导入模块
import os
主要使用到了os 模块的几个方法,如下(它们在处理文件和目录时非常有用,可以帮助你进行路径操作和文件系统操作):
使用这些函数可以更方便地处理文件路径和目录操作。
- os.path.join用于安全地连接路径
- os.path.isdir用于检查路径是否为目录
- os.path.basename用于提取路径的最后一部分
- os.getcwd用于获取当前工作目录。
为什么是自动化构建项目结构样式
基于以下的好处和作用,读者朋友又有什么理由会拒绝这份宝藏代码呢!!!
好处
通过使用自动生成项目结构文字样式的工具,可以轻松地生成项目的目录结构,并将其插入到README.md文件中。好处如下:
- 节省时间和精力:手动编写和更新项目结构的文字样式可能会很耗时且容易出错。自动生成工具可以快速而准确地生成项目结构,节省了手动处理的时间和精力。
- 保持一致性:自动生成工具可以确保项目结构的文字样式始终保持一致。无论项目如何演变和更新,都可以轻松地更新项目结构,以反映最新的变化,而无需手动更改README.md文件。
- 易于维护:通过自动生成工具生成的项目结构文字样式,可以更容易地进行维护和更新。当项目的文件或目录发生变化时,只需重新运行自动生成工具,即可更新README.md中的项目结构,而无需手动修改和调整。
- 提供清晰的项目导航:包含项目结构的文字样式可以让读者快速了解项目的组织方式和文件结构。这对于新加入的开发人员或用户来说尤为重要,他们可以迅速找到所需的文件和模块,并理解它们之间的关系。
综上所述,通过自动生成项目结构文字样式,可以简化编写README.md的过程,提高文档的一致性和可维护性,并为项目的使用者提供清晰的导航和理解。这样的工具可以帮助开发者更专注于项目的开发和功能实现,而不必过多关注文档的细节和更新。
作用
自动化构建项目结构样式在 Python 项目中具有以下作用:
- 项目文档:生成项目结构的文字样式可以作为项目文档的一部分,提供项目的概览和文件组织结构的信息。它可以帮助新加入的开发人员快速了解项目的组织和文件分布。
- 代码说明:项目结构文字样式可以与代码注释一起使用,对各个模块、包和文件进行说明。这有助于其他开发人员更好地理解代码的组织方式,快速找到所需的文件和模块。
- 项目展示:在项目演示或展示的过程中,使用项目结构文字样式可以直观地展示项目的文件和文件夹结构。这样可以帮助观众更好地理解项目的组织方式,并对项目的规模和复杂度有一个直观的认识。
总之,生成项目结构的文字样式可以在项目文档、代码说明和项目展示中提供清晰的项目结构信息,帮助开发人员更好地理解和使用项目。
代码
递归地遍历指定目录下的文件和文件夹,并按照特定的格式输出它们的结构。
# -*- coding: utf-8 -*-
# @Author : Frica01
# @Time : 2023-06-22 0:00
# @Name : project_structure_generator.py
import os
# 需要排除的文件夹列表
exclude_folders = ['.git', '.idea', '.vscode', 'venv', '__pycache__', 'project_structure_generator.py']
def generate_project_structure(directory, indent='', is_last=False, is_root=False, output_file=None):
"""
生成项目结构的文字样式
Args:
directory (str): 目录路径
indent (str): 缩进字符串
is_last (bool): 是否是最后一个元素
is_root (bool): 是否是根目录
output_file (file): 输出文件对象
Returns:
None
"""
# 获取目录中的文件和文件夹列表,并按照一定的规则排序
items = sorted(os.listdir(directory),
key=lambda x: (not os.path.isdir(os.path.join(directory, x)), x != '__init__.py', x))
num_items = len(items)
if is_root:
# 根目录名称
output_file.write(f"{os.path.basename(os.getcwd())}/n")
for i, item in enumerate(items):
if item in exclude_folders:
continue
item_path = os.path.join(directory, item)
is_item_last = i == num_items - 1
if os.path.isdir(item_path):
# 如果是目录,则添加目录标记并递归生成目录结构
marker = '└── ' if is_item_last else '├── '
output_file.write(f"{indent}{marker}{item}/n")
new_indent = indent + (' ' if is_last else '│ ')
generate_project_structure(item_path, new_indent, is_item_last, output_file=output_file)
else:
# 如果是文件,则添加文件标记
marker = '└── ' if is_item_last else '├── '
output_file.write(f"{indent}{marker}{item}n")
if __name__ == '__main__':
# 打开要写入的文件
with open('project_structure.txt', 'w') as file:
# 生成项目结构并写入文件
generate_project_structure('.', is_root=True, output_file=file)
print("目录结构已写入文件 project_structure.txt")
结语
在项目开发过程中,一个良好的项目结构对于团队的协作和代码的可维护性起着重要作用。通过使用自动生成项目结构文字样式的工具,如我们在代码中实现的 project_structure_generator.py,我们可以轻松地生成项目结构的可视化表示,并将其整理为一个文本文件。这个工具不仅节省了手动编写项目结构的麻烦,还确保了结构的一致性和准确性。
号外
7月7日,华为开发者大会2023 ( Cloud )将拉开帷幕,并将在国内30多个城市、海外10多个国家开设分会场,诚邀您参加这场不容错过的年度开发者盛会,让我们一起开启探索之旅!
我们将携手开发者、客户、合作伙伴,为您呈现华为云系列产品服务与丰富的创新实践,并与您探讨AI、大数据、数据库、PaaS、aPaaS、媒体服务、云原生、安全、物联网、区块链、开源等技术话题,展开全面深入的交流。
大会将汇聚全球科学家、行业领袖、技术专家、社区大咖,开设200多场开发者专题活动,为全球开发者提供面对面交流与合作的机会,共同探讨技术创新和业务发展。
大会官网:https://developer.huaweicloud.com/HDC.Cloud2023.html
参会购票:https://www.vmall.com/product/10086352254099.html?cid= 211761
点击参与开发者社区活动,观赏技术大咖秀、玩转技术梦工厂,有机会赢取4000元开发者礼包!
欢迎关注“华为云开发者联盟”公众号,获取大会议程、精彩活动和前沿干货。
点击关注,第一时间了解华为云新鲜技术~