Metadata-Version: 2.1
Name: ocbc_dbs_statement_parser
Version: 0.1.6
Summary: A tool to parse OCBC and DBS bank and credit card statements from PDF files
Home-page: https://github.com/seahyc/bank_statement_parser
Author: Seah Ying Cong
Author-email: seahyingcong@gmail.com
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.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Python: >=3.7, <3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: camelot-py ==0.11.0
Requires-Dist: cffi ==1.17.1
Requires-Dist: chardet ==5.2.0
Requires-Dist: charset-normalizer ==3.3.2
Requires-Dist: click ==8.1.7
Requires-Dist: cryptography ==43.0.1
Requires-Dist: et-xmlfile ==1.1.0
Requires-Dist: ghostscript ==0.7
Requires-Dist: importlib-resources ==6.4.5
Requires-Dist: numpy ==1.24.4
Requires-Dist: opencv-python ==4.10.0.84
Requires-Dist: openpyxl ==3.1.5
Requires-Dist: pandas ==2.0.3
Requires-Dist: pdfminer.six ==20240706
Requires-Dist: pdftopng ==0.2.3
Requires-Dist: pycountry ==24.6.1
Requires-Dist: pycparser ==2.22
Requires-Dist: pypdf ==4.3.1
Requires-Dist: python-dateutil ==2.9.0.post0
Requires-Dist: pytz ==2024.1
Requires-Dist: six ==1.16.0
Requires-Dist: tabulate ==0.9.0
Requires-Dist: typing-extensions ==4.12.2
Requires-Dist: tzdata ==2024.1
Requires-Dist: zipp ==3.20.2

# OCBC DBS Statement Parser

A Python tool to parse bank statements from PDF files, specifically designed for OCBC and DBS statements but potentially compatible with other banks.

## Requirements

- Python 3.7 or 3.8

# Installation

```
pip install ocbc-dbs-statement-parser
```

# Usage

```
python -m src.cli <pdf_path> [--debug] [--verify]
```


For more information, run:

```
python -m src.cli --help
```

## Features

- Extracts transactions from bank account and credit card statements
- Supports various date formats
- Verifies transaction totals
- Debug mode for detailed output

## Development

### Setup

1. Clone the repository
2. Create a virtual environment: `python -m venv venv`
3. Activate the virtual environment:
   - Windows: `venv\Scripts\activate`
   - macOS/Linux: `source venv/bin/activate`
4. Install dependencies: `pip install -r requirements.txt`

### Testing

To run tests using pytest, execute the following command:

```
pytest tests/test_main.py
```

## Dependencies

The main dependencies for this project are:

- camelot-py==0.11.0
- pandas==2.0.3
- pycountry==24.6.1
- pypdf==4.3.1

For a complete list of dependencies, please refer to the `requirements.txt` file.

## License

This project is licensed under the MIT License.

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.
