Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

Betterment plugin for ofxstatement

Project description

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Betterment plugin for ofxstatement
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. image:: https://img.shields.io/travis/cmayes/ofxstatement-betterment.svg
:target: https://travis-ci.org/cmayes/ofxstatement-betterment

.. image:: https://img.shields.io/pypi/v/ofxstatement-betterment.svg
:target: https://pypi.python.org/pypi/ofxstatement-betterment

.. image:: https://coveralls.io/repos/cmayes/ofxstatement-betterment/badge.svg?branch=master&service=github
:target: https://coveralls.io/github/cmayes/ofxstatement-betterment?branch=master

This is an `ofxstatement`_ plugin for `Betterment`_ CSV statements downloaded
from the site's `activity`_ page. `ofxstatement`_ converts the CSV into a
series of "check" transactions in an OFX file, so `Moneydance`_ (for instance)
will only consider bank and credit card accounts for the generated OFX file's
import. Given Betterment's daily gain/loss transaction data, the "check"
transaction type works well enough.

.. _ofxstatement: https://github.com/kedder/ofxstatement
.. _Betterment: https://www.betterment.com/
.. _activity: https://wwws.betterment.com/app/#activity
.. _Moneydance: http://moneydance.com/

`ofxstatement`_ is a tool for converting proprietary bank statements into the
OFX format, suitable for importing into GnuCash, Moneydance, and other compatible
applications. The plugin for ofxstatement parses a particular proprietary bank
statement format and produces a common data structure that is then formatted
into an OFX file.

Requirements
============

As with `ofxstatement`_, this plugin requires Python 3. You will need to have
`ofxstatement`_ installed; the package will be brought in as a dependency if
you install the plugin via `pip`_.

.. _pip: https://pypi.python.org/pypi/pip

Installation
============

You can install the plugin via most of the normal Python methods (be sure to
install using your environment's python3 installation)

pip
---

::

pip3 install ofxstatement-betterment

setup.py
--------

::

cd ofxstatement-betterment; python setup.py install

Configuration
=============

Note that you can specify 'bank' and 'account' in ofxstatement's configuration file (accessible
using the `ofxstatement edit-config` command or directly at
`~/.local/share/ofxstatement/config.ini` (on Linux, at least). Setting these values makes it
easier for your personal finance application to recognize which account the file's data
belongs to.

Also note that transactions for zero amounts are filtered by default. If you wish to include
zero-amount transactions, set 'zero_filter' to 'false' in your settings. Here is an example
of a settings block for the betterment plugin::

[betterment]
account = 8675309
plugin = betterment
zero_filter = false

Usage
=====

Export your Betterment `activity`_ into a CSV file (it's currently `transactions.csv`). Then run::

$ ofxstatement convert -t betterment transactions.csv betterment.ofx

You can then import `betterment.ofx` into the personal finance application of your choice.





History
-------

0.1.0 (2015-09-26)
------------------

* Uploaded to pypi
* Added to github

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for ofxstatement-betterment, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size ofxstatement_betterment-0.1.0-py3-none-any.whl (7.9 kB) File type Wheel Python version 3.4 Upload date Hashes View
Filename, size ofxstatement-betterment-0.1.0.tar.gz (18.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page