# second_homework

**Repository Path**: zlh114514/second_homework

## Basic Information

- **Project Name**: second_homework
- **Description**: 软件技术基础第二次作业
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-30
- **Last Updated**: 2025-10-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 文本计数统计程序

## 项目简介

这是一个命令行文本计数统计程序，能够统计纯英文文本文件中的单词数和句子数。项目采用渐进式开发，从空项目开始，逐步实现基础功能和扩展功能。

## 功能总览

| 功能类别 | 功能名称 | 命令行参数 | 支持版本 | 功能描述 |
|---------|---------|------------|----------|----------|
| **基础功能** | 单词数统计 | `-w, --words` | v0.2, v0.3 | 统计文本中的英文单词数量 |
| | 句子数统计 | `-s, --sentences` | v0.2, v0.3 | 统计文本中的句子数量（以. ! ?分隔） |
| | 字符数统计 | `-c, --chars` | v0.3 | 统计文本中的字符总数（含空格和换行） |
| **扩展功能** | 总行数统计 | `-l, --lines` | v0.3 | 统计文件的总行数 |
| | 代码行统计 | `--code-lines` | v0.3 | 统计代码文件中的代码行数 |
| | 空行统计 | `--blank-lines` | v0.3 | 统计文件中的空行数量 |
| | 注释行统计 | `--comment-lines` | v0.3 | 统计代码文件中的注释行数 |

## 版本历史

### v0.1 - 空项目
- 初始化项目结构
- 创建基础目录和文件
- 设置Git仓库
- 验证基本运行环境



### v0.2 - 基础功能完成
- 实现单词数统计功能 (`-w`)
- 实现句子数统计功能 (`-s`) 
- 添加命令行参数解析
- 支持基本的文本文件分析
- 提供测试文件 `count.txt`



### v0.3 - 扩展功能完成
- 实现字符数统计 (`-c`)
- 实现代码行统计 (`--code-lines`)
- 实现空行统计 (`--blank-lines`)
- 实现注释行统计 (`--comment-lines`)
- 支持多种编程语言文件分析
- 提供测试文件 `count.txt`
- 提供源代码文件 `wc3.py` 作为被测对象



## 文件结构

```
123/
├── v0.1/                    # 空项目版本
│   ├── dist/
│   │   └── wc1.exe          # 可执行文件
│   └── build/              # 构建过程文件（PyInstaller生成）
│       └── wc1/             # 临时构建文件
│           ├── ...         # 构建过程文件（可忽略）
├── v0.2/                    # 基础功能版本
│   ├── dist/
│   │   ├── wc2.exe          # 可执行文件
│   │   └── count.txt       # 测试文本文件
│   └── build/              # 构建过程文件（PyInstaller生成）
│       └── wc2/             # 临时构建文件
│           ├── ...         # 构建过程文件（可忽略）
├── v0.3/                    # 扩展功能版本
│   ├── dist/
│   │   ├── wc3.exe          # 可执行文件
│   │   ├── count.txt       # 测试文本文件
│   │   └── wc3.py          # 源代码文件（作为被测对象）
│   └── build/              # 构建过程文件（PyInstaller生成）
│       └── wc3/             # 临时构建文件
│           ├── ...         # 构建过程文件（可忽略）
├── 空项目试验.png               # v0.1运行效果
├── 基础功能.png             # v0.2运行效果
└── 拓展功能.png             # v0.3运行效果
```

## 使用说明

### 运行方法

每个版本都提供了打包好的可执行文件和测试文件，位于各版本的 `dist` 文件夹中：

```bash
# v0.2 基础功能版本
cd v0.2/dist
.\wc.exe -w count.txt      # 统计单词数
.\wc.exe -s count.txt      # 统计句子数

# v0.3 扩展功能版本  
cd v0.3/dist
.\wc.exe -c count.txt      # 统计字符数
.\wc.exe -w count.txt      # 统计单词数
.\wc.exe -s count.txt      # 统计句子数
.\wc.exe --code-lines wc3.py    # 统计代码行数
.\wc.exe --comment-lines wc3.py # 统计注释行数
```

### 测试文件说明

- **count.txt** - v0.2与v0.3 版本的 `dist` 文件夹中都包含这个测试文件，是用于测试的纯英文文本文件，包含多个句子和单词，方便用户快速测试程序功能。
- **wc3.py** - v0.3 版本额外提供的源代码文件，作为被测对象，可以测试程序的代码行数和注释行数统计功能。


## 项目演进

1. **v0.1** - 建立项目框架，验证开发环境
2. **v0.2** - 实现核心文本分析功能，提供测试文件
3. **v0.3** - 扩展多语言支持和代码分析功能，提供测试文件和源代码作为被测对象

每个版本都包含相应的可执行文件、源代码和测试文件，展示了从简单到复杂的完整开发流程。

## 测试方法

每个版本都提供了测试文件，用户可以直接使用这些文件测试程序功能：

```bash
# 基础功能测试
cd v0.2/dist
.\wc.exe -w count.txt
.\wc.exe -s count.txt

# 扩展功能测试
cd v0.3/dist
.\wc.exe -c count.txt
.\wc.exe -w count.txt
.\wc.exe -s count.txt
.\wc.exe --blank-lines count.txt # 统计空行数

# 代码分析功能测试（使用wc3.py作为被测对象）
.\wc.exe -l wc3.py           # 统计总行数
.\wc.exe --code-lines wc3.py # 统计代码行数
.\wc.exe --comment-lines wc3.py # 统计注释行数

# 组合测试
.\wc.exe -l --code-lines --blank-lines --comment-lines wc3.py
```