CSV to Beancount Converter

This project provides a simple utility to convert CSV files into Beancount format. It is designed to facilitate the management of financial data by transforming structured CSV data into a format compatible with Beancount accounting software.

Project Structure

csv-to-beancount
├── src
│   ├── main.py          # Entry point for the application
│   ├── converter.py     # Logic for converting CSV to Beancount
│   ├── config.py        # Configuration settings loader
│   └── utils
│       └── file_utils.py # Utility functions for file operations
├── config
│   └── settings.yaml    # Configuration file with fixed values
├── data
│   └── example.csv      # Sample CSV file for conversion
├── requirements.txt      # Project dependencies
└── README.md            # Project documentation

Installation

To set up the project, clone the repository and install the required dependencies:

git clone <repository-url>
cd csv-to-beancount
pip install -r requirements.txt

Usage

To convert a CSV file to Beancount format, run the following command:

python src/main.py data/example.csv

This command will read the specified CSV file, convert its contents into Beancount format using the defined mappings in the configuration file, and save the output to a Beancount file.

Configuration

The configuration settings are stored in config/settings.yaml. You can modify this file to adjust account mappings and other constants used during the conversion process.

Contributing

Contributions are welcome! Please feel free to submit a pull request or open an issue for any enhancements or bug fixes.

License

This project is licensed under the MIT License. See the LICENSE file for more details.

1.8 KiB Raw Blame History