# 命令行文本计数统计程序

**Repository Path**: yoyoee/command-line-text-counter

## Basic Information

- **Project Name**: 命令行文本计数统计程序
- **Description**: 软件技术基础第二次作业
实现一个命令行文本计数统计程序。能正确统计导入的纯英文txt文本中的字符数，单词数，句子数。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-03
- **Last Updated**: 2025-11-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 命令行文本计数统计程序

## 项目简介及其相关的用法

### 项目简介
本项目是一个基于Python的命令行文本统计工具，功能类似于Linux下的wc命令。它可以统计纯英文文本中的字符数、单词数、句子数，并扩展支持统计代码文件中的代码行、空行、注释行。项目通过版本迭代（v0.1到v0.3）逐步实现功能，同时包含单元测试和性能测试模块，确保代码的正确性和性能表现。

### 命令行用法
#### 命令模式
##### 基础版本
python wc_basic.py [参数] [文件名]
##### 扩展版本
python wc_advanced.py [参数] [文件名]
#### 参数说明
| 参数  | 功能说明  |
|---|---|
| -c  | 统计字符数  |
| -w  |  统计单词数 |
| -s  | 统计句子数  |
| -a  | 统计所有基础信息  |
| -cl  | 统计代码行数  |
| -el  | 统计空行数  |
| -ml  | 统计注释行数  |
| -all  | 统计所有信息  |



## 文件列表及其相关说明
| 文件名  | 说明  |
|---|---|
| v0.1.py  | 空项目，仅用于版本迭代记录，无实际功能。   |
| wc_basic.py  | 基础功能版本 (v0.2)，实现字符数、单词数、句子数统计，支持命令行参数调用  |
| test_wc_basic.py  | 基础功能单元测试，，测试字符统计、单词统计、句子统计功能，包含边界测试和复杂文本测试  |
| test_file1.txt  | 简单英文文本测试文件  |
| test_file2.txt  | 中等复杂度英文文本测试文件  |
|  wc_advanced.py | 扩展功能版本 (v0.3)，在基础功能上增加代码行、空行、注释行统计，支持更丰富的命令行参数  |
| test_wc_advanced.py  | 扩展功能单元测试，测试代码行、空行、注释行统计，包含混合内容测试和边界情况测试  |
| performance_test.py  | 性能测试，测试程序在不同数据量下的性能表现，包含压力测试和性能分析  |
| test_code.py  | 代码测试文件（用于测试代码分析功能） |
| v0.2运行结果.png  |  wc_basic.py运行结果截图  |
| v0.2 单元测试结果.png  | test_wc_basic.py运行结果截图  |
| v0.3运行结果.png  |  wc_advanced.py运行结果截图 |
| v0.3 单元测试结果.png  |  test_wc_advanced.py运行结果截图 |
| v0.3性能测试结果.png  |  performance_test.py运行结果截图  |


![输入图片说明](%E5%B1%8F%E5%B9%95%E6%88%AA%E5%9B%BE%202025-11-03%20085924.png)

## 例程运行及其相关结果
### 1.  v0.2基础功能
- 命令：
- python wc_basic.py -c test_file1.txt
- python wc_basic.py -w test_file1.txt
- python wc_basic.py -s test_file1.txt
- python wc_basic.py -a test_file1.txt
- python wc_basic.py -c test_file2.txt
- python wc_basic.py -w test_file2.txt
- python wc_basic.py -s test_file2.txt
- python wc_basic.py -a test_file2.txt
- 结果：
![输入图片说明](https://foruda.gitee.com/images/1762126247424869241/48815e2b_16300332.png "v0.2运行结果.png")

### 2.  v0.2单元测试

- 命令：
python test_wc_basic.py
- 结果：
![输入图片说明](v0.2%20%E5%8D%95%E5%85%83%E6%B5%8B%E8%AF%95%E7%BB%93%E6%9E%9C.png)

### 3.  v0.3扩展功能

- 命令：
- python wc_advanced.py -c test_code.py
- python wc_advanced.py -w test_code.py
- python wc_advanced.py -s test_code.py
- python wc_advanced.py -cl test_code.py
- python wc_advanced.py -el test_code.py
- python wc_advanced.py -ml test_code.py
- python wc_advanced.py -all test_code.py
- 结果：
![输入图片说明](https://foruda.gitee.com/images/1762126753443987379/0c4c1b8c_16300332.png "v0.3运行结果.png")

### 4.  v0.3单元测试

- 命令：
python test_wc_advanced.py
- 结果：
![输入图片说明](v0.3%20%E5%8D%95%E5%85%83%E6%B5%8B%E8%AF%95%E7%BB%93%E6%9E%9C.png)

### 5.  v0.3性能测试

- 命令：
python performance_test.py
- 结果：
![输入图片说明](https://foruda.gitee.com/images/1762126880688955208/678f417a_16300332.png "v0.3性能测试结果.png")