1
0
mirror of https://github.com/aclindsa/ofxgo.git synced 2024-10-30 05:20:05 -04:00
Golang library for querying and parsing OFX
Go to file
2017-09-20 20:30:59 -04:00
cmd/ofx Clarify use of Currency vs. OrigCurrency 2017-04-19 21:31:45 -04:00
samples/valid_responses Test parsing of some sample responses 2017-04-10 20:01:01 -04:00
.travis.yml .travis.yml: Add Go 1.9.x 2017-09-20 20:30:59 -04:00
bank_test.go Use CurrSymbol instead of String to represent currencies 2017-04-17 20:20:22 -04:00
bank.go Clarify use of Currency vs. OrigCurrency 2017-04-19 21:31:45 -04:00
client.go client: Retry HTTP requests for empty responses with cookies 2017-09-01 08:41:15 -04:00
common_test.go go vet 2017-04-10 06:05:03 -04:00
common.go Clarify use of Currency vs. OrigCurrency 2017-04-19 21:31:45 -04:00
constants_test.go Make the OFX spec version an 'enum' 2017-04-17 10:54:20 -04:00
constants.go Make the OFX spec version an 'enum' 2017-04-17 10:54:20 -04:00
creditcard_test.go Use CurrSymbol instead of String to represent currencies 2017-04-17 20:20:22 -04:00
creditcard.go Add transaction UID validation to all messages 2017-04-18 20:22:07 -04:00
doc.go Update/improve documentation 2017-05-09 16:30:35 -04:00
generate_constants.py Make the OFX spec version an 'enum' 2017-04-17 10:54:20 -04:00
invstmt_test.go Use CurrSymbol instead of String to represent currencies 2017-04-17 20:20:22 -04:00
invstmt.go Clarify use of Currency vs. OrigCurrency 2017-04-19 21:31:45 -04:00
leaf_elements.go Add more leaf elements missed earlier 2017-04-03 20:48:01 -04:00
LICENSE Add license 2017-04-08 11:48:55 -04:00
profile_test.go Make the OFX spec version an 'enum' 2017-04-17 10:54:20 -04:00
profile.go Add transaction UID validation to all messages 2017-04-18 20:22:07 -04:00
README.md Add MoneyGo reference to README 2017-06-05 21:12:04 -04:00
request_test.go request_test: Point out first difference in marshalled string 2017-03-31 20:16:44 -04:00
request.go Add OFX version to Valid() calls 2017-04-17 11:11:46 -04:00
response_test.go Test parsing of some sample responses 2017-04-10 20:01:01 -04:00
response.go Check Valid() when parsing responses 2017-04-17 20:37:40 -04:00
seclist.go Add transaction UID validation to all messages 2017-04-18 20:22:07 -04:00
signon_test.go Make the OFX spec version an 'enum' 2017-04-17 10:54:20 -04:00
signon.go Add OFX version to Valid() calls 2017-04-17 11:11:46 -04:00
signup_test.go Make the OFX spec version an 'enum' 2017-04-17 10:54:20 -04:00
signup.go Add transaction UID validation to all messages 2017-04-18 20:22:07 -04:00
types_test.go Add validation of banking requests and responses 2017-04-18 19:46:23 -04:00
types.go go vet and golint 2017-04-18 19:50:04 -04:00
util.go Switch to own clone of xml encoding library 2017-03-22 20:59:40 -04:00

OFXGo

Go Report Card Build Status Coverage Status GoDoc

OFXGo is a library for querying OFX servers and/or parsing the responses. It also provides an example command-line client to demonstrate the use of the library.

Goals

The main purpose of this project is to provide a library to make it easier to query financial information with OFX from the comfort of Golang, without having to marshal/unmarshal to SGML or XML. The library does not intend to abstract away all of the details of the OFX specification, which would be difficult to do well. Instead, it exposes the OFX SGML/XML hierarchy as structs which mostly resemble it. Its primary goal is to enable the creation of other personal finance software in Go (as it was created to allow me to fetch OFX transactions for my own project, MoneyGo).

Because the OFX specification is rather... 'comprehensive,' it can be difficult for those unfamiliar with it to figure out where to start. To that end, I have created a sample command-line client which uses the library to do simple tasks (currently it does little more than list accounts and query for balances and transactions). My hope is that by studying its code, new users will be able to figure out how to use the library much faster than staring at the OFX specification (or this library's API documentation). The command-line client also serves as an easy way for me to test/debug the library with actual financial institutions, which frequently have 'quirks' in their implementations. The command-line client can be found in the cmd/ofx directory of this repository.

Library documentation

Documentation can be found with the go doc tool, or at https://godoc.org/github.com/aclindsa/ofxgo

Using the command-line client

To install the command-line client and test it out, you may do the following:

$ go get -v github.com/aclindsa/ofxgo/cmd/ofx && go install -v github.com/aclindsa/ofxgo/cmd/ofx

Once installed (at ~/go/bin/ofx by default, if you haven't set $GOPATH), the command's usage should help you to use it (./ofx --help for a listing of the available subcommands and their purposes, ./ofx subcommand --help for individual subcommand usage).