# 软件工程与基础第二次作业

**Repository Path**: sun-sihan/Hw

## Basic Information

- **Project Name**: 软件工程与基础第二次作业
- **Description**: 用剪刀的鱿鱼免试影响
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-10-26
- **Last Updated**: 2024-08-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 软件工程与基础第二次作业

#### 功能介绍

  ①基本功能：实现一个命令行文本计数统计程序。能正确统计导入的纯英文txt文本中的字符数，单词数，句子数。

  ②拓展功能：统计代码行、空行、注释行等，并提供相应命令接口。

  ③单元测试和性能测试

#### 详细使用方法

  **准备**：将代码下载至合适位置，后文我会将该位置称为**目标目录**，如，我的目标目录是`D:\VscodeWorkspace\Python\Statistics\Hw`

  1. <kbd>Win</kbd> + <kbd>R</kbd>  $~~$ 或者 $~$ 右击 **开始** 图标，如下图，点击 **运行**

<p align="center">
    <img src="Image/cmd.png" width="30%" />
    <br/>
</p>     
   
  2. 在文字栏中输入`cmd`

<p align="center">
    <img src="Image/CMD1.jpg" width="50%" />
    <br/>
</p>  
     

  3. **在命令行根目录切换至目标目录**
     如下图输入这几条指令，你可将你的命令行目录移动至目标目录

<p align="center">
    <img src="Image/Path.jpg" width="50%" />
    <br/>
</p>  
  &emsp;&emsp;  下面是要用到的命令
  <br/>

  ```python
  cd /
  D:    # 文件下载在D盘时，需要切换至D盘
  cd D:\VscodeWorkspace\Python\Statistics\Hw
  # 这个地址是下载文件所在的文件夹
  ```
  &emsp;&emsp;**P.S.** 相关路径文件夹名最好不要有空格
    
  4. **开始使用**
   
  &emsp;&emsp;输入结构：`<exe文件路径>v0.x.exe -<指令> <待统计文件路径>file`

  &emsp;&emsp;案例1： `v0.2\v0.2.exe -w TestMaterial\LuXun.txt`
  
  &emsp;&emsp;结果如下：

<p align="center">
    <img src="Image/wordCount.jpg" width=80%" />
    <br/>
</p>

<p align="center">
单词个数统计
</p>

  &emsp;&emsp;案例2： `v0.3\v0.3.exe -e -d -n TestMaterial\Python_Test.py`
  
  &emsp;&emsp;结果如下：

<p align="center">
    <img src="Image/Py_Test.jpg" width=80%" />
    <br/>
</p>

<p align="center">
代码统计
</p>

  5. **指令表**




|  指令   | 功能  | 对应版本 | 说明 |
| :--:  | :--:  | :--: | :--: |
| -c | 统计字符数 | v0.2&emsp;v0.3 | 英文字符 |
| -w | 统计单词数 | v0.2&emsp;v0.3 |
| -s | 统计句子数 | v0.2&emsp;v0.3 |
| -d | 统计代码行数 | v0.3 |
| -e | 统计空行数 | v0.3 | 包括代码末尾空行 |
| -n | 统计注释行数 | v0.3 | 支持C、C++、Java、Python和HTML |

#### 文件结构

文件结构较乱，屎山的压迫感又来了，为方便使用理解，附上脑图

```mermaid
graph LR

Hw--> Image
Image-->Markdown插图
Image-->测试结果

Hw--> TestMaterial
TestMaterial-->纯英文txt测试文件
TestMaterial-->C语言测试文件
TestMaterial-->Python测试文件
TestMaterial-->单元测试txt测试文件

Hw--> v0.1
subgraph C [空项目]
v0.1-->Python文件1
end

Hw--> v0.2
v0.2-->Python文件2
v0.2-->exe文件2
v0.2-->杂2-.-A(构建exe相关文件)

Hw--> v0.3
v0.3-->Python文件3
v0.3-->Python单元测试文件
v0.3-->Python函数文件
v0.3-->exe文件3
v0.3-->杂3

Hw--> README

Hw-->杂
```

#### 运行结果

1. v0.2 对`TestMaterial\LuXun.txt`字符，单词，句子统计

  &emsp;&emsp;指令： `v0.2\v0.2.exe -c -w -s TestMaterial\LuXun.txt`

<table rules="none" align="center">
    <center>
    <img src="Image/Test1.jpg" width=95%" />
    <br/>
    </center>	
</table>

2. v0.3 对`C_Test.c`代码行数，空行数，注释行数

  &emsp;&emsp;指令： `v0.3\v0.3.exe -e -d -n TestMaterial\C_Test.c`

<table rules="none" align="center">
    <center>
    <img src="Image/Test2.jpg" width=95%" />
    <br/>
    </center>	
</table>

3. 文件`v0.3test.py`是我专门写的单元测试文件，下面是它 对`Uint_Test.txt`单元测试 & 性能测试

<table rules="none" align="center">
    <center>
    <img src="Image/UnitTest.jpg" width=95%" />
    <br/>
    </center>	
</table>



#### 指令备忘录（个人）

   ```v0.2\v0.2.exe -w -c TestMaterial\LuXun.txt```

   ```python v0.3\v0.3.py -e -d TestMaterial\LuXun.txt```

   ```python v0.3\v0.3.py -e -d -n TestMaterial\C_Test.c```

   `python v0.3\v0.3.py -e -d -n TestMaterial\Python_Test.py`

   `python D:\VscodeWorkspace\Python\Statistics\Hw\v0.2\v0.2.py -w D:\VscodeWorkspace\Python\Statistics\Hw\TestMaterial\周树人.txt`

   `pyinstaller --onefile D:\VscodeWorkspace\Python\Statistics\Hw\v0.2\v0.2.py`

   `pyinstaller --onefile D:\VscodeWorkspace\Python\Statistics\Hw\v0.3\v0.3.py`

   `v0.3\v0.3.exe -e -d -n TestMaterial\Python_Test.py`

   `v0.3\v0.3.exe -w -c -s -e -d -n TestMaterial\Uint_Test.txt`