# zuoye

**Repository Path**: xuyusen0094/zuoye

## Basic Information

- **Project Name**: zuoye
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

wc_project

命令行文本计数统计程序

⸻

一、项目简介

本项目实现了一个简易版命令行文本统计工具 wc.py，可用于统计英文文本文件中的：
	•	字符数（-c）
	•	单词数（-w）
	•	句子数（-s）

此外，扩展功能（加分项）支持统计源代码文件中的：
	•	代码行数
	•	空行数
	•	注释行数（-C）

程序使用 Python 编写，逻辑简洁清晰，支持多文件输入，可在命令行中直接调用。

⸻

二、使用方法

1. 命令格式粗体

python wc.py [参数] [文件名]

2. 参数说明

参数	说明
-c	统计字符数
-w	统计单词数
-s	统计句子数
-C	统计代码文件中的代码行、空行、注释行
无参数	默认输出字符数、单词数、句子数


⸻

3. 示例

 统计字符数
python wc.py -c example_files/sample.txt

统计单词数
python wc.py -w example_files/sample.txt

同时统计三项（默认）
python wc.py example_files/sample.txt

扩展功能：统计代码行、空行、注释行
python wc.py -C example_files/sample_code.c

批量统计多个文件
python wc.py -w -s file1.txt file2.txt


⸻

三、文件说明

文件/目录	说明
wc.py	主程序，实现文本计数与命令行解析

README.md	项目说明文档

tests/test_wc.py	单元测试文件

perf/gen_large_file.py	生成大文本文件，用于性能测试

example_files/sample.txt	示例文本文件

example_files/sample_code.c	示例代码文件（用于扩展功能演示）


⸻

四、运行效果示例

示例文本 sample.txt 内容：

Hello world! This is a test. Don't panic?

运行结果：

$ python wc.py example_files/sample.txt
example_files/sample.txt: chars=42, words=7, sentences=3

示例代码文件 sample_code.c：

#include <stdio.h>
// comment line
int main() {
    printf("Hello\\n");
    return 0;
}

运行结果：

$ python wc.py -C example_files/sample_code.c
example_files/sample_code.c: code_lines=3, blank_lines=0, comment_lines=1


⸻

五、项目版本记录

版本号	更新内容
v0.1	创建空项目结构
v0.2	完成字符、单词、句子统计功能
v0.3	增加代码行、空行、注释行统计功能（加分项）


⸻

六、单元测试与性能测试
使用 pytest 编写单元测试：

pytest tests/test_wc.py


生成大文件并进行性能测试：

python perf/gen_large_file.py large.txt 20
python wc.py -w large.txt



⸻

七、依赖环境
	•	Python
⸻

八、作者信息
	•	作者：徐雨森
	
⸻