Metadata-Version: 2.5
Name: iietls
Version: 0.0.1
Summary: Stream CSV rows with an explicit encoding.
Project-URL: Homepage, https://pypi.org/project/iietls/
Author-email: lqxnjk <lqxnjk@qq.com>
License: MIT
License-File: LICENSE
Keywords: csv,delimiter,encoding,rows,streaming
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# iietls

[English](#english) | 中文

带显式编码的 CSV 流式读写。

## 安装

```console
pip install iietls
```

## 用法

```python
from iietls import iter_rows, write_rows

for row in iter_rows("data.csv", n_encoding="gbk"):
    handle(row)

write_rows("out.csv", ["a", "b"], [[1, 2], [3, 4]])
```

## 说明

逐行产出，不整份读入内存。编码必须显式传入（默认 UTF-8），中文环境常见的 GBK 文件请显式写 `n_encoding="gbk"`。列数与表头不一致时抛 `ValueError`，不自动截断补齐。

## 许可证

MIT

---

<a id="english"></a>
## English

Stream CSV rows with an explicit encoding.

## Install

```console
pip install iietls
```

## Usage

```python
from iietls import iter_rows, write_rows

for row in iter_rows("data.csv", n_encoding="gbk"):
    handle(row)

write_rows("out.csv", ["a", "b"], [[1, 2], [3, 4]])
```

## Notes

Rows are yielded one at a time, so file size does not bound memory. The encoding is explicit (UTF-8 by default). A row whose width differs from the header raises `ValueError` instead of being silently padded or truncated.

## License

MIT
