Metadata-Version: 2.5
Name: lxj
Version: 0.0.4
Summary: 把行数据渲染成对齐的纯文本表格。
Project-URL: Homepage, https://pypi.org/project/lxj/
Author-email: lqxnjk <lqxnjk@qq.com>
License: MIT
License-File: LICENSE
Keywords: align,console,format,table,text
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

# lxj

[English](#english) | 中文

把行数据渲染成对齐的纯文本表格。

## 安装

```console
pip install lxj
```

## 用法

```python
from lxj import render_table

print(render_table(["name", "n"], [["a", 1], ["beta", 22]]))
# name  n
# ----  --
# a     1
# beta  22

print(render_table(["n"], [["1"], ["22"]], n_align="right"))
```

## 说明

列宽按字符数计算（宽字符仍算一列），行尾空格会剪掉。列数不齐、对齐方式数量不符、对齐值非法，都抛 `ValueError`——缺一格是数据问题，不是排版偏好。

## 许可证

MIT

---

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

Render rows as an aligned plain-text table.

## Install

```console
pip install lxj
```

## Usage

```python
from lxj import render_table

print(render_table(["name", "n"], [["a", 1], ["beta", 22]]))
# name  n
# ----  --
# a     1
# beta  22

print(render_table(["n"], [["1"], ["22"]], n_align="right"))
```

## Notes

Column widths are measured in characters and trailing spaces are trimmed. Ragged rows, a mismatched alignment list and an unknown alignment all raise `ValueError`.

## License

MIT
