Ninja_UUID_Runner 项目使用教程

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

Ninja_UUID_Runner 项目的目录结构如下：

Ninja_UUID_Runner/
├── bin/
│   └── bin2uuids.py
├── config/
│   └── settings.json
├── src/
│   └── main.py
├── README.md
└── LICENSE

目录介绍

• bin/: 包含可执行文件，如 bin2uuids.py，用于生成和验证 UUID。
• config/: 包含项目的配置文件 settings.json，用于存储项目的配置信息。
• src/: 包含项目的主要源代码文件 main.py。
• README.md: 项目的说明文档。
• LICENSE: 项目的许可证文件。

2. 项目的启动文件介绍

项目的启动文件是 src/main.py。该文件包含了项目的主要逻辑和功能。以下是 main.py 的简要介绍：

# src/main.py

import uuid
import json
from config.settings import config

def generate_uuid(version=4):
    return uuid.uuid(version)

def validate_uuid(uuid_str):
    try:
        uuid.UUID(uuid_str)
        return True
    except ValueError:
        return False

def main():
    print("Ninja UUID Runner")
    print("1. Generate UUID")
    print("2. Validate UUID")
    choice = input("Choose an option: ")

    if choice == "1":
        version = int(input("Enter UUID version (1-5): "))
        print(generate_uuid(version))
    elif choice == "2":
        uuid_str = input("Enter UUID to validate: ")
        if validate_uuid(uuid_str):
            print("Valid UUID")
        else:
            print("Invalid UUID")
    else:
        print("Invalid option")

if __name__ == "__main__":
    main()

功能介绍

• generate_uuid(version): 根据指定的版本生成 UUID。
• validate_uuid(uuid_str): 验证给定的字符串是否为有效的 UUID。
• main(): 主函数，提供用户界面，允许用户选择生成 UUID 或验证 UUID。

3. 项目的配置文件介绍

项目的配置文件是 config/settings.json。该文件包含了项目的配置信息，如 UUID 生成的默认版本等。以下是 settings.json 的内容示例：

{
    "default_uuid_version": 4,
    "batch_size": 100
}

配置项介绍

• default_uuid_version: 默认的 UUID 生成版本。
• batch_size: 批量生成 UUID 时的数量。

通过修改 settings.json 文件，可以调整项目的默认行为和参数。