Metadata-Version: 2.1
Name: ocbc_dbs_statement_parser
Version: 0.1.2
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: pandas==2.0.3
Requires-Dist: pycountry==24.6.1
Requires-Dist: pypdf==4.3.1

# 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.
