Metadata-Version: 2.4
Name: fastload-data
Version: 0.1.0
Summary: Efficient chunked loader for large CSV and Excel files
Author-email: Stepan Bogdanov <Stemix17ap@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/Dinozavrik104/fastload
Project-URL: Repository, https://github.com/Dinozavrik104/fastload.git
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: openpyxl>=3.0.9
Requires-Dist: tqdm>=4.66.0
Requires-Dist: chardet>=5.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Dynamic: license-file

# fastload
**fastload** is a lightweight Python library for loading large CSV and Excel files in chunks, with automatic encoding and delimiter detection, and progress bars.

## Features
- Chunked reading – process huge files without memory overflow.
- Auto‑detect encoding (via `chardet`) – handles UTF‑8, CP1251, etc.
- Auto‑detect delimiter – supports `,`, `;`, `\t`, `|`.
- Progress bars with `tqdm`.
- Excel support for `.xlsx` and `.xlsm` (via `openpyxl`).
- File‑type auto‑detection with `load_file()`.

## Installation
```bash
pip install fastload
```
For development:
```bash
pip install -e .
```

## Quick Start
**CSV**
```python
from fastload import load_csv
for chunk in load_csv('huge_file.csv', chunk_size=10000):
    process(chunk)
```
**Excel**
```python
from fastload import load_excel
for chunk in load_excel('data.xlsx', sheet_name='Sheet1'):
    process(chunk)
```
**Auto‑detect**
```python
from fastload import load_file
for chunk in load_file('data.csv'):
    process(chunk)
```

## Requirements
- Python 3.8+
- Dependencies: `openpyxl`, `tqdm`, `chardet`

## License
MIT – see [LICENSE](LICENSE)

## Author
Stepan Bogdanov – [GitHub](https://github.com/Dinozavrik104)

## Contributing
Contributions are welcome – open an issue or submit a pull request.
