Contributing

I am accepting pull requests. Sometimes life gets busy and it takes me a little while to get everything merged in. To help speed up the process, please write tests to cover your changes. I will review/merge them as soon as possible.

Testing

I use nose and Coverage to run the test suite.

WARNING: The Tests connect to the QBO API and create/modify/delete data. DO NOT USE A PRODUCTION ACCOUNT!

Testing setup:

Create/login into your Intuit Developer account.
On your Intuit Developer account, create a Sandbox company and an App.
Go to the Intuit Developer OAuth 2.0 Playground and fill out the form to get an access token and refresh token. You will need to copy the following values into your enviroment variables:

export CLIENT_ID="<Client ID>"
export CLIENT_SECRET="<Client Secret>" 
export COMPANY_ID="<Realm ID>"
export ACCESS_TOKEN="<Access token>"
export REFRESH_TOKEN="<Refresh token>"

Note: You will need to update the access token when it expires.

Install nose and coverage. Using Pip: pip install nose coverage
Run nosetests . --with-coverage --cover-package=quickbooks

Creating new tests

Normal Unit tests that do not connect to the QBO API should be located under test/unit Test that connect to QBO API should go under tests/integration. Inheriting from QuickbooksTestCase will automatically setup self.qb_client to use when connecting to QBO.

Example:

from tests.integration.test_base import QuickbooksTestCase

class SampleTestCase(QuickbooksTestCase):
  def test_something(self):
    vendors = Vendor.all(max_results=1, qb=self.qb_client)