Metadata-Version: 2.1
Name: listwrap
Version: 0.0.3
Summary: Formatting lists of strings.
Author-email: Zach Kurtz <zkurtz@gmail.com>
Project-URL: Source, https://github.com/zkurtz/listwrap
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE

# listwrap

Formatting lists of strings.

Use cases include subtasks of automatic config generation or any other highly structured context such as programmatically constructing human-readable SQL statements.

Links:
- [Documentation](https://zkurtz.github.io/listwrap/listwrap.html)
- [We're on pypi](https://pypi.org/project/listwrap/) (so `pip install listwrap`)

## Examples

```
>>> from listwrap import align
>>> print(align(["a", "b", "c"]))
    "a",
    "b",
    "c",
>>> print(align(["a", "b", "c"], quote=None))
    a,
    b,
    c,
>>> print(align(["a", "b", "c"], indent=1))
 "a",
 "b",
 "c",
>>> print(align(["a", "b", "c"], indent=0, vertical=False))
"a","b","c",
```
Several formatting other options are supported; see the `align` method docstring.

## Development

Create and activate a virtual env for dev ops:
```
git clone git@github.com:zkurtz/listwrap.git
cd listwrap
pip install uv
uv sync
source .venv/bin/activate
```
