Skip to main content

Beta Open Bank Project Python Utilities

Project description

Open Bank Project CLI

A command line utility (CLI) to work with the Open Bank Project sandbox called obp.

With the obp cli you can:

  • Initiate an api connection to the sandbox
    • note you still need to sign-up from the sandbox homepage first to create your username & password
  • Get your DirectLogin token
  • Get your user information
  • Get your user id
  • Get banks
  • Get (your) accounts held at the bank

Also, depending on your account access you may:

  • Create a bank account
  • Add roles to a user
  • Import/Delete branches
  • Import dummy bank data

Install

pip install --user obp-python # Requires at least python 3

Warning: If your operating system defaults to python 2, your pip command might be:

pip3 install --user obp-python
#or 
pip3.6 install --user obp-python

Usage

Usage: obp [OPTIONS] COMMAND [ARGS]...

Options:
  --help  Show this message and exit.

Commands:
  addaccount              ๐Ÿ“ Add a bank account
  addbank                 ๐Ÿฆ Add a bank
  addcustomer             ๐Ÿง™ Add a customer
  addfx                   ๐Ÿ“‰ Add exchange rate (FX)
  addrole                 ๐Ÿšง Add a role for current user
  adduser                 ๐Ÿ“ Add a user
  answerconsent           ๐Ÿšง Answer consent
  createconsent           ๐Ÿšง Add a consent
  deletebranches          โš ๏ธ ๐Ÿฆ Delete all branches
  deletecardbyid          โš ๏ธ ๐Ÿ’ณ Delete card by id
  getaccountbyid          ๐Ÿ“ Get account by id (includes balance)
  getaccountsheld         ๐Ÿ“ Get list of accounts held
  getaccounttransactions  ๐Ÿ“ Get transactions for an account
  getauth                 ๐Ÿ”‘ Get your DirectLogin token
  getbanks                ๐Ÿฆ Get list of banks
  getcardbyid             ๐Ÿ’ณ Get card by id
  getcardbynumber         ๐Ÿ’ณ Get card by card number
  getcards                ๐Ÿ’ณ Get list of cards at bank
  getconsents             ๐Ÿšง Get consents
  getcustomers            ๐Ÿ‘ฅ Get list of customers
  getuser                 ๐Ÿ˜ƒ Get your user info
  getuserid               ๐Ÿ“‹ Get your user id
  getuseridbyusername     ๐Ÿ“‹ Get user id by username
  importaccounts          ๐Ÿšœ Import accounts from spreadsheet template
  importbranches          ๐Ÿšœ Import branches from spreadsheet template
  importcardattribues     ๐Ÿšœ Import card attributes from spreadsheet template
  importcards             ๐Ÿšœ Import cards from spreadsheet template
  importcustomers         ๐Ÿšœ Import customers from spreadsheet template
  importtransactions      ๐Ÿšœ Import transactions from spreadsheet template
  importusers             ๐Ÿšœ Import users from spreadsheet template
  init                    ๐Ÿ’ก Initalize connection to your Open Bank Project...
  linkusertocustomer      ๐Ÿ”— Link user to a customer
  revokeconsent           ๐Ÿšง Revoke consent
  sandboximport           ๐Ÿšœ Bulk import sandbox data from json input

Examples

You must initalize the obp cli once, by doing:

obp init

Generate Direct Login Token

obp init 
Please enter your API_HOST: api.example.com
Please enter your username:
Please enter your password: : 
Repeat for confirmation: 
... generating direct login token
Please enter your OBP_CONSUMER_KEY: # Go to api.example.com, then "Get API Key" to generate consumer key.
obp getauth # Displays your DirectLogin token

Contributing

Note You can ignore this is your just using the utlity. This is just for developing the utlity.

To work on this utility as a developer:

Building
# Setup python3 environment
virtualenv -p python3 venv
. venv/bin/activate
git clone <this-repo>
# Building wheels etc
python setup.py sdist bdist_wheel
# Installing your edits locally:
pip install -e <path-to-this-repo> # -e means Install  a  project  in editable mode (i.e.  setuptools "developmode")
# Work on utility..submit pull request 

Update history
  • 0.19 Added sandboximport utility obp sandboximport --example
  • 0.0.9 Switch to use OBP_API_HOST instead of OBP_ENDPOINT

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 obp-python, version 0.203
Filename, size File type Python version Upload date Hashes
Filename, size obp_python-0.203-py3-none-any.whl (64.5 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size obp_python-0.203.tar.gz (30.0 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page