Metadata-Version: 2.1
Name: FuxuanTracer
Version: 0.0.2a0
Summary: A useful logging library for Python
Home-page: https://www.github.com/KOKOMI12345/FuxuanTracer
Author: 符玄
Author-email: 3072252442@qq.com
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
License-File: LICENSE


# FuxuanTracer

FuxuanTracer是一个基于Python的开源网络流量监控工具，它能够抓取网络数据包，并解析出网络连接的IP地址, 端口等信息, 方便用户进行网络流量监控。

## 安装

```bash
pip install FuxuanTracer
```

## Get Started

```python
from FuxuanTracer import DataPackAnalyzer

ins = DataPackAnalyzer()

devices = list(ins.getAvaliableDevice().keys())

# 我们选择第4个，因为那个是我的以太网设备
choose_divice =  devices[4]

# 设置过滤器, 注意: 每次调用 setFilter 都会重置过滤规则
ins.setFilter(WebProtocol="HTTPS", Port=[443])

# 抓取10个包
ins.catchDataPak(choose_divice, 100)

# 解析抓取的包
ins.analyze_packets(True,"result.log",False,True)
```

## 参数说明(analyze_packets)

- 1. True ,代表写入文件
- 2. result.log , 写入文件的文件名
- 3. False , 代表不用json格式写入文件
- 4. True , 代表应用过滤器

## 更新异步抓取数据包,可以无限抓取数据包

```python
# 异步抓取数据包

ins = DataPackAnalyzer()

devices = list(ins.getAvaliableDevice().keys())
choose_divice =  devices[4]
ins.setFilter(WebProtocol="HTTPS", Port=[443])

# 定义一个main函数，异步执行
async def main(ins=ins, choose_divice=choose_divice):
    await ins.AsyncProcess(
        use_device=choose_divice,
        write_to_file=True,
        file_path="result.log",
        json_fmt=False,
        enqueue=True
    )

# 异步执行main函数
asyncio.run(main())
```
