# pydlt_plus

**Repository Path**: nostmabole/pydlt_plus

## Basic Information

- **Project Name**: pydlt_plus
- **Description**: 基于pydlt进行了二次封装，对dlt文件进行读写，读取dlt文件添加过滤和小语种支持。
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 0
- **Created**: 2023-10-25
- **Last Updated**: 2025-01-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# pydlt_plus

#### 介绍
基于pydlt进行了二次封装，对dlt文件进行读写，读取dlt文件添加过滤和小语种支持。

#### 软件架构
基于pydlt进行修改和二次开发。


#### 安装教程

1.  pip install pydlt-plus

#### 使用说明

1. 读取dlt文件内容：

```python
# read 1 message from file
with DltFileFilter("filepath") as reader:
    message = reader.read_message()

# read all messages from file
with DltFileFilter("filepath") as reader:
    messages = reader.read_messages()

# read all messages
for message in DltFileFilter("filepath"):
    # handle each message
```

2. 读取文件并过滤，或者将dlt文件转为其他格式：

可以选择进行过滤或者不进行过滤，如果选择不进行过滤，则直接将原始dlt文件转换为其他格式。

过滤信息参数可以是字符串、列表或者为None（None表示不进行过滤）。

output_type 可以是列表（默认值）、文本文件名（格式为.txt或者.log），或者JSON文件名。

- 如果使用默认值列表(`list`)，函数将返回符合过滤条件的消息列表。
- 如果提供文本文件名作为output_type，则函数将把符合过滤条件的内容写入该文件，并返回文本文件名。
- 如果提供JSON文件名作为output_type，则函数将把符合过滤条件的内容写入JSON文件中，其中关键字为过滤的关键字，值为符合关键字的内容，并返回JSON文件名。

以下是一个简单的示例：

```python
dff = DltFileFilter("log_10.4.dlt", "utf8")

# 过滤信息并保存为txt文件
dff.read_file(["abc", "神奈川県"], output_type="aaaa.txt")

# 不进行过滤，将dlt转为txt
dff.read_file(output_type="aaaa.txt")

#过滤信息的例子
filter_info = "adc"  # 过滤字符串abc
filter_info = ["abc", "神奈川県"]  # 过滤字符串 abc 或者 "神奈川県"，满足其一即可
filter_info = [["abc", "神奈川県"]]  # 过滤字符串 abc 和 "神奈川県"， 两者必须全都满足
```