Merge pull request #335 from ej2/0.9.6

0.9.6

Author: ej2

.github/workflows/codecov.yaml

@@ -0,0 +1,4 @@
+- name: Upload coverage reports to Codecov
+  uses: codecov/codecov-action@v3
+  env:
+    CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}

.github/workflows/pylint.yml

@@ -7,7 +7,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ["3.8", "3.9", "3.10"]
+        python-version: ["3.8", "3.9", "3.10", "3.11"]
     steps:
     - uses: actions/checkout@v3
     - name: Set up Python ${{ matrix.python-version }}

CHANGELOG.rst

@@ -1,5 +1,15 @@
 Changelog
 =========
+* 0.9.6 (January 2, 2024)
+    * Replace RAuth with requests_oauthlib
+    * Removed python 2 code from client.py
+    * Removed unused dependencies from Pipfile
+    * Added new fields to Employee object
+    * Added VendorAddr to Bill object
+    * Added new fields to Estimate object
+    * Fix TaxInclusiveAmt and vendor setting 1099 creation
+    * Updated readme and contributing
+
 * 0.9.5 (November 1, 2023)
     * Added the ability to void all voidable QB types
     * Added to_ref to CreditMemo object

Pipfile

@@ -4,14 +4,14 @@ url = "https://pypi.org/simple"
 verify_ssl = true
 
 [dev-packages]
+coverage = "*"
+twine = "*"
+pytest = "*"
+pytest-cov = "*"
 
 [packages]
-urllib3 = ">=1.26.5"
-bleach = ">=3.3.0"
+urllib3 = ">=2.1.0"
 intuit-oauth = "==1.2.4"
-rauth = ">=0.7.3"
 requests = ">=2.31.0"
 simplejson = ">=3.19.1"
-nose = "*"
-coverage = "*"
-twine = "*"
+requests_oauthlib = ">=1.3.1"

Pipfile.lock

@@ -54,14 +54,14 @@ Then create a QuickBooks client object passing in the AuthClient, refresh token,
             company_id='COMPANY_ID',
         )
 
-If you need to access a minor version (See [Minor versions](https://developer.intuit.com/docs/0100_quickbooks_online/0200_dev_guides/accounting/minor_versions) for
+If you need to access a minor version (See [Minor versions](https://developer.intuit.com/app/developer/qbo/docs/learn/explore-the-quickbooks-online-api/minor-versions#working-with-minor-versions) for
 details) pass in minorversion when setting up the client:
 
     client = QuickBooks(
         auth_client=auth_client,
         refresh_token='REFRESH_TOKEN',
         company_id='COMPANY_ID',
-        minorversion=59
+        minorversion=69
     )
 
 Object Operations
@@ -74,7 +74,9 @@ List of objects:
 
 **Note:** The maximum number of entities that can be returned in a
 response is 1000. If the result size is not specified, the default
-number is 100. (See [Intuit developer guide](https://developer.intuit.com/docs/0100_accounting/0300_developer_guides/querying_data) for details)
+number is 100. (See [Query operations and syntax](https://developer.intuit.com/app/developer/qbo/docs/learn/explore-the-quickbooks-online-api/data-queries) for details)
+
+**Warning:** You should never allow user input to pass into a query without sanitizing it first! This library DOES NOT sanitize user input! 
 
 Filtered list of objects:
 
@@ -104,6 +106,8 @@ List with custom Where Clause (do not include the `"WHERE"`):
 
     customers = Customer.where("Active = True AND CompanyName LIKE 'S%'", qb=client)
 
+  
+
 List with custom Where and ordering
 
     customers = Customer.where("Active = True AND CompanyName LIKE 'S%'", order_by='DisplayName', qb=client)
@@ -112,7 +116,7 @@ List with custom Where Clause and paging:
 
     customers = Customer.where("CompanyName LIKE 'S%'", start_position=1, max_results=25, qb=client)
 
-Filtering a list with a custom query (See [Intuit developer guide](https://developer.intuit.com/docs/0100_accounting/0300_developer_guides/querying_data) for
+Filtering a list with a custom query (See [Query operations and syntax](https://developer.intuit.com/app/developer/qbo/docs/learn/explore-the-quickbooks-online-api/data-queries) for
 supported SQL statements):
 
     customers = Customer.query("SELECT * FROM Customer WHERE Active = True", qb=client)

README.md

@@ -1,32 +1,35 @@
 # 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. 
+I am accepting pull requests. Sometimes life gets busy and it takes me a little while to get everything reviewed and 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](https://nose.readthedocs.io/en/latest/index.html) and [Coverage](https://coverage.readthedocs.io/en/latest/) to run the test suite.   
+I use [pytest](https://docs.pytest.org/en/7.4.x/contents.html), [Coverage](https://coverage.readthedocs.io/en/latest/), and [pytest-cov](https://pytest-cov.readthedocs.io/en/latest/) 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:
 
 1. Create/login into your [Intuit Developer account](https://developer.intuit.com).
 2. On your Intuit Developer account, create a Sandbox company and an App. 
-3. 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:
+3. Go to the Intuit Developer OAuth 2.0 Playground and fill out the form to get a **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 COMPANY_ID="<Realm ID>"  
   export REFRESH_TOKEN="<Refresh token>"
   ```
 
-  *Note*: You will need to update the access token when it expires. 
+  *Note*: You will need to update the refresh token when it expires. 
 
-5. Install *nose* and *coverage*. Using Pip:
-  `pip install nose coverage`
+5. Install *pytest*, *coverage*, and *pytest-cov*. Using Pip (or whatever):
+  `pip install pytest coverage pytest-cov`
 
-6. Run `nosetests . --with-coverage --cover-package=quickbooks`
+6. Run all tests: ```pytest  --cov```  
+   Run only unit tests: ```pytest tests/unit --cov```   
+   Run only integration tests: ```pytest tests/intergration --cov``` 
+
+
 
 ## 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.

contributing.md

@@ -1,30 +1,14 @@
-import warnings
-
-try:  # Python 3
-    import http.client as httplib
-    from urllib.parse import parse_qsl
-    from functools import partial
-    to_bytes = lambda value, *args, **kwargs: bytes(value, "utf-8", *args, **kwargs)
-except ImportError:  # Python 2
-    import httplib
-    from urlparse import parse_qsl
-    to_bytes = str
-
+import http.client as httplib
 import textwrap
-import codecs
 import json
-
-from . import exceptions
 import base64
 import hashlib
 import hmac
 
-try:
-    from rauth import OAuth1Session, OAuth1Service, OAuth2Session
-except ImportError:
-    print("Please import Rauth:\n\n")
-    print("http://rauth.readthedocs.org/en/latest/\n")
-    raise
+from . import exceptions
+from requests_oauthlib import OAuth2Session
+
+to_bytes = lambda value, *args, **kwargs: bytes(value, "utf-8", *args, **kwargs)
 
 
 class Environments(object):
@@ -102,10 +86,13 @@ def _start_session(self):
             self.auth_client.refresh(refresh_token=self.refresh_token)
 
         self.session = OAuth2Session(
-            client_id=self.auth_client.client_id,
-            client_secret=self.auth_client.client_secret,
-            access_token=self.auth_client.access_token,
+            self.auth_client.client_id,
+            token={
+                'access_token': self.auth_client.access_token,
+                'refresh_token': self.auth_client.refresh_token,
+            }
         )
+
         return self.auth_client.refresh_token
 
     def _drop(self):

quickbooks/client.py

@@ -1,7 +1,7 @@
 from quickbooks.objects.detailline import DetailLine, ItemBasedExpenseLine, AccountBasedExpenseLine, \
     TDSLine
 from .base import Ref, LinkedTxn, QuickbooksManagedObject, QuickbooksTransactionEntity, \
-    LinkedTxnMixin
+    LinkedTxnMixin, Address
 from .tax import TxnTaxDetail
 from ..mixins import DeleteMixin
 
@@ -20,6 +20,7 @@ class Bill(DeleteMixin, QuickbooksManagedObject, QuickbooksTransactionEntity, Li
         "AttachableRef": Ref,
         "DepartmentRef": Ref,
         "TxnTaxDetail": TxnTaxDetail,
+        "VendorAddr": Address,
     }
 
     list_dict = {
@@ -53,6 +54,7 @@ def __init__(self):
         self.VendorRef = None
         self.DepartmentRef = None
         self.APAccountRef = None
+        self.VendorAddr = None
 
         self.LinkedTxn = []
         self.Line = []

quickbooks/objects/bill.py

@@ -174,7 +174,6 @@ class AccountBasedExpenseLineDetail(QuickbooksBaseObject):
     def __init__(self):
         super(AccountBasedExpenseLineDetail, self).__init__()
         self.BillableStatus = None
-        self.TaxAmount = 0
         self.TaxInclusiveAmt = 0
 
         self.CustomerRef = None
@@ -234,8 +233,8 @@ def __init__(self):
         super(ItemBasedExpenseLineDetail, self).__init__()
         self.BillableStatus = None
         self.UnitPrice = 0
-        self.TaxInclusiveAmt = 0
         self.Qty = 0
+        self.TaxInclusiveAmt = 0
         self.ItemRef = None
         self.ClassRef = None
         self.PriceLevelRef = None