https://github.com/arthurfdlr/beancount-bd

💸 Beancount Importer for Bourse Direct trades history (HTML table) - Pypi package
https://github.com/arthurfdlr/beancount-bd

accounting banking beancount finance personal-finance plaintext-accounting pypi python

Last synced: about 2 months ago
JSON representation

💸 Beancount Importer for Bourse Direct trades history (HTML table) - Pypi package

• Host: GitHub
• URL: https://github.com/arthurfdlr/beancount-bd
• Owner: ArthurFDLR
• License: mit
• Created: 2022-08-29T04:46:58.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2023-02-07T02:49:23.000Z (almost 2 years ago)
• Last Synced: 2024-10-10T22:39:24.757Z (3 months ago)
• Topics: accounting, banking, beancount, finance, personal-finance, plaintext-accounting, pypi, python
• Language: Python
• Homepage:
• Size: 28.3 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# Beancount Bourse Direct Importer

[![GitHub Workflow Status](https://img.shields.io/github/workflow/status/ArthurFDLR/beancount-bd/beancount-bd?style=for-the-badge)](https://github.com/ArthurFDLR/beancount-bd/actions)

[![PyPI](https://img.shields.io/pypi/v/beancount-bd?style=for-the-badge)](https://pypi.org/project/beancount-bd/)

[![PyPI - Version](https://img.shields.io/pypi/pyversions/beancount-bd.svg?style=for-the-badge)](https://pypi.org/project/beancount-bd/)

[![GitHub](https://img.shields.io/github/license/ArthurFDLR/beancount-bd?style=for-the-badge)](https://github.com/ArthurFDLR/beancount-bd/blob/master/LICENSE.txt)

[![Linting](https://img.shields.io/badge/code%20style-black-000000.svg?style=for-the-badge)](https://github.com/psf/black)

`beancount-bd` provides an order history importer for the brooker [Bourse Direct](http://www.boursedirect.fr) to the [Beancount](http://furius.ca/beancount/) format.

## Installation

```console

    $ pip install beancount-bd

```

## Usage

Add ```BDImporter``` to your [Beancount importers config file](https://beancount.github.io/docs/importing_external_data.html#configuration).

```python

CONFIG = [

    BDImporter(

        account='Assets:FR:BD:PEA',

        fee_category='Expenses:Finances:Commission',

        tickers_lut={

            "AM.E.P.SP500": "PE500",

            "LY.PEANASD": "PUST",

            "MSC.EM": "PAEEM",

            "MSC.EUR": "PCEU",

        }

    ),

]

```

## Contribution

Feel free to contribute!

Please make sure you have Python 3.6+ and [`Poetry`](https://poetry.eustace.io/) installed.

1. Git clone the repository - `git clone https://github.com/ArthurFDLR/beancount-bd`

2. Install the packages required for development - `poetry install`

3. That's basically it. You should now be able to run lint checks and the test suite - `make lint test`.