Metadata-Version: 2.1
Name: TimePinner
Version: 0.2.0
Summary: 一个用于代码中计时的小工具。
Home-page: https://gitee.com/g1879/TimePinner
Author: g1879
Author-email: g1879@qq.com
License: MIT
Keywords: stopwatch
Classifier: Programming Language :: Python :: 3.6
Classifier: Development Status :: 4 - Beta
Classifier: Topic :: Utilities
Classifier: License :: OSI Approved :: BSD License
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: TimePinner-stubs

## 简介

TimePinner 是一个简单的计时工具。

类似于代码中的秒表。

可标记多个点，以记录若干段时间长度。

每段时间可以命名，以方便记忆，也可跳过无须记录的时间段。

当前版本：v0.2.0

## 安装与导入

### 安装

```python
pip install TimePinner
```

---

### 导入

```python
from TimePinner import Pinner
```

---

## 使用方法

### 创建对象

```python
from TimePinner import Pinner

pinner = Pinner()
```

---

### 记录时间点

使用`pin()`方法记录一个时间点，并返回时间差，可以通过`text`参数给该时间点命名。

可用`show`参数设置是否打印。

也可以在创建对象时用`show_everytime`参数设置是否打印。

`pin()`的`show`参数比创建对象时`show_everytime`参数优先级高。

如果`all_time`参数为`True`，打印和返回的是与第一个时间点的时间差。

```python
pinner = Pinner()
pinner.pin()  # 记录起始点
sleep(1)
pinner.pin('记录1')
sleep(2)
pinner.pin('记录2', show=False)  # 不打印该节点
```

输出：

```console
0.0
记录1：1.0084643
```

---

### 跳过时间段

有些时间段无须记录，用`skip()`方法跳过。下一个记录会以当前点作为起始。

```python
pinner.skip()
```

---

### 打印结果

通过`show()`方法，可以把记录到的时间段打印出来。

如果`all_time`参数为`True`，打印出来的是每个时间点与第一个时间点的时间差。

```console
记录1：1.007383
记录2：2.0145351000000002
```

---

### 获取结果

通过`records()`方法获取各个记录的时间段，每个时间段为一个两位元组。

如果`all_time`参数为`True`，打印出来的是每个时间点与第一个时间点的时间差。

```python
print(pinner.records())
```

输出：

```console
[('记录1', 1.0084643), ('记录2', 2.0126551999999998)]
```

---

### 获取最短的时间段

通过`winner()`方法可以获取最短的时间段，用于对比几段代码运行时间。

如果`all_time`参数为`True`，打印出来的是每个时间点与第一个时间点的时间差。

```python
print(pinner.winner())
```

输出：

```console
('记录1', 1.0084643)
```

---

### 重置

使用`reset()`方法清空已有记录并重新开始计时。
