plists 0.0.4

# 这是什麼？

这是一个用于读取、写入和管理[Apple plist文件](https://developer.apple.com/library/mac/documentation/Darwin/Reference/ManPages/man5/plist.5.html)的包。

# 安装

```
pip install plists
```

# 示例

## 读取plist文件

### 从文件读取V1（旧风格）plist

```
import plists

obj = plists.v1parser.parseFile("path_to_file")

# ... 使用obj作为正常Python对象
```

### 从字符串读取V1（旧风格）plist

```
import plists

obj = plists.v1parser.parse("some_loaded_string")

# ... 使用obj作为正常Python对象
```


### 从文件读取XML plist

```
from plists import xmlparser

obj = xmlparser.parseFile("path_to_file")

# ... 使用obj作为正常Python对象
```

### 从字符串读取XML plist

```
from plists import xmlparser

obj = xmlparser.parse("some_loaded_string")

# ... 使用obj作为正常Python对象
```

### 读取二进制plist

即将推出


## 将对象写入plist文件

### 写入旧风格plist

可以使用以下方法将对象写入旧风格plist

```
from plists import v1parser
from plists import v1writer

obj = v1parser.parseFile(<path_to_plist_file>)

v1writer.write(obj, outstream, indentString, level)
```

参数如下

* obj - 被序列化的对象
* outstream - 将对象序列化的输出流。如果此值为None，则将写入并返回新的字符串输出流。
* indentString - 要使用的缩进字符串。如果此值是None，则不应用缩进或美化。否则使用此值。
* level - 序列化时开始的级别。每个子节点将额外缩进一个级别（如果indentString不为None）。

### 写入XML plist

可以使用以下方法将对象写入xml plist

```
from plists import xmlparser
from plists import xmlwriter

obj = xmlparser.parseFile(<path_to_plist_file>)

xmlwriter.write(obj, outstream, indentString, level)
```

参数如下

* obj - 被序列化的对象
* outstream - 将对象序列化的输出流。如果此值为None，则将写入并返回新的字符串输出流。
* indentString - 要使用的缩进字符串。如果此值是None，则不应用缩进或美化。否则使用此值。
* level - 序列化时开始的级别。每个子节点将额外缩进一个级别（如果indentString不为None）。

### 写入二进制 plists

即将推出。