# wc-tool

**Repository Path**: huang-beixuan/wc-tool

## Basic Information

- **Project Name**: wc-tool
- **Description**: 命令行文本计数统计程序
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-28
- **Last Updated**: 2025-10-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 文本计数统计程序 (WC Tool)

## 项目简介

一个功能强大的命令行文本计数统计程序，支持统计纯英文文本中的字符数、单词数、句子数，以及代码文件的分析功能。

## 功能特性

### 基础功能
- ✅ 统计字符数
- ✅ 统计单词数  
- ✅ 统计句子数
- ✅ 统计行数

### 扩展功能
- ✅ 代码文件分析
- ✅ 统计代码行、空行、注释行
- ✅ 完整的单元测试

## 安装和使用

### 使用方法

```bash
# 基本统计（字符、单词、句子、行数）
py src/wc.py samples/sample.txt

# 统计字符数
py src/wc.py -c samples/sample.txt

# 统计单词数  
py src/wc.py -w samples/sample.txt

# 统计句子数
py src/wc.py -s samples/sample.txt

# 代码分析
py src/wc.py --code samples/sample.py
```

## 运行示例

### 基本文本统计
```bash
$ py src/wc.py samples/sample.txt
文件: samples/sample.txt
------------------------------
字符数: 249
单词数: 43
句子数: 8
行数: 5
```

### 代码分析
```bash
$ py src/wc.py --code samples/sample.py
文件: samples/sample.py
------------------------------
总行数: 16
代码行: 12
空行: 2
注释行: 2
```

## 测试

运行单元测试：
```bash
py -m unittest discover tests -v
```

测试结果：
```
test_code_analysis (test_wc.TestTextCounter.test_code_analysis) ... ok
test_count_chars (test_wc.TestTextCounter.test_count_chars) ... ok
test_count_lines (test_wc.TestTextCounter.test_count_lines) ... ok
test_count_sentences (test_wc.TestTextCounter.test_count_sentences) ... ok
test_count_words (test_wc.TestTextCounter.test_count_words) ... ok
test_file_not_found (test_wc.TestTextCounter.test_file_not_found) ... ok
----------------------------------------------------------------------
Ran 6 tests in 0.082s
OK
```

## 版本历史

### v0.1 - 空项目
- 初始化项目结构
- 创建基础文件框架

### v0.2 - 基础功能
- 实现字符数统计
- 实现单词数统计  
- 实现句子数统计
- 实现行数统计
- 添加命令行参数解析

### v0.3 - 扩展功能
- 添加代码分析功能
- 支持多种注释格式识别
- 完善单元测试覆盖
- 修复文件编码问题
- 优化错误处理机制

## 文件结构

```
wc-tool/
├── .gitignore
├── README.md
├── requirements.txt
├── setup.py
├── samples/
│   ├── sample.txt
│   └── sample.py
├── src/
│   ├── __init__.py
│   └── wc.py
└── tests/
    ├── __init__.py
    └── test_wc.py
```

## 技术栈

- Python 3.14
- argparse (命令行参数解析)
- re (正则表达式)
- unittest (单元测试框架)

## 作者

黄备煊 - 2652935530@qq.com

## 许可证

本项目仅用于课程作业提交。