Metadata-Version: 2.4
Name: gaojie-niceutils
Version: 0.1.0
Summary: A collection of handy Python utility functions for file I/O, data processing, and more.
Author: gaojie
License: MIT
Project-URL: Homepage, https://github.com/gaojie/gaojie-niceutils
Keywords: utilities,json,pickle,file-io,data-processing
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy
Requires-Dist: pandas
Requires-Dist: requests
Requires-Dist: jsonlines
Requires-Dist: tqdm
Provides-Extra: excel
Requires-Dist: openpyxl; extra == "excel"
Provides-Extra: parquet
Requires-Dist: pyarrow; extra == "parquet"
Dynamic: license-file

# gaojie-niceutils

A collection of handy Python utility functions for file I/O, data processing, and more.

## Installation

```bash
pip install gaojie-niceutils
```

## Quick Start

```python
from niceutils import load_json, dump_json, load_jsonl, dump_jsonl

# JSON
data = load_json("data.json")
dump_json(data, "output.json")

# JSONL
rows = load_jsonl("data.jsonl")
dump_jsonl(rows, "output.jsonl")
```

## Features

- **JSON / JSONL / Pickle I/O** – `load_json`, `dump_json`, `load_jsonl`, `dump_jsonl`, `load_pkl`, `dump_pkl`
- **Text & CSV** – `load_txt`, `csv2json`
- **XML parsing** – `parse_xml`, `parse_xml_all`
- **Regex helpers** – `re_search`, `find_all`
- **Dict / list utilities** – `sort_dict`, `get_dist`, `pd2list`, `pd2dict`
- **File system helpers** – `mkdir_p`, `list_files`, `root2files`
- **Date & time** – `get_date`, `get_cur_time`, `get_current_time_str`
- **Math** – `cosine_sim`

## License

MIT
