salespyforce 1.4.0.dev0__py3-none-any.whl → 1.4.0.dev2__py3-none-any.whl

salespyforce/utils/tests/test_soql.py

@@ -1,23 +1,23 @@
 # -*- coding: utf-8 -*-
+# bandit: skip=B101
 """
-:Module:         salespyforce.utils.tests.test_sobjects
+:Module:         salespyforce.utils.tests.test_soql
 :Synopsis:       This module is used by pytest to test performing SOQL queries
 :Created By:     Jeff Shurtliff
 :Last Modified:  Jeff Shurtliff
-:Modified Date:  29 May 2023
+:Modified Date:  20 Dec 2025
 """
 
-from . import resources
 
-
-def test_soql_query():
+def test_soql_query(salesforce_unit):
     """This function tests the ability to perform a SOQL query.
 
     .. versionadded:: 1.1.0
+
+    .. version-changed:: 1.4.0
+       The function now utilizes the ``salesforce_unit`` fixture.
     """
-    sfdc_object = resources.get_core_object()
     soql_statement = 'SELECT Id FROM Account LIMIT 1'
-    soql_response = sfdc_object.soql_query(soql_statement)
+    soql_response = salesforce_unit.soql_query(soql_statement)
     assert 'done' in soql_response and soql_response.get('done') is True
     assert 'totalSize' in soql_response and 'records' in soql_response
-

salespyforce/utils/tests/test_sosl.py

@@ -1,10 +1,11 @@
 # -*- coding: utf-8 -*-
+# bandit: skip=B101
 """
-:Module:         salespyforce.utils.tests.test_sobjects
-:Synopsis:       This module is used by pytest to test performing SOQL queries
+:Module:         salespyforce.utils.tests.test_sosl
+:Synopsis:       This module is used by pytest to test performing SOSL queries
 :Created By:     Jeff Shurtliff
 :Last Modified:  Jeff Shurtliff
-:Modified Date:  29 May 2023
+:Modified Date:  20 Dec 2025
 """
 
 import requests
@@ -12,18 +13,17 @@ import requests
 from . import resources
 
 
-def test_search_string(monkeypatch):
+def test_search_string(monkeypatch, salesforce_unit):
     """This function tests the ability to search for a string using an SOSL query.
 
     .. versionadded:: 1.1.0
-    """
-    # Instantiate the core object
-    sfdc_object = resources.get_core_object()
 
+    .. version-changed:: 1.4.0
+       The function now utilizes the ``salesforce_unit`` fixture.
+    """
     # Overwrite the requests.post functionality with the mock_success_post() function
     monkeypatch.setattr(requests, 'get', resources.mock_sosl_get)
 
     # Perform the mock API call
-    result = sfdc_object.search_string('Account')
+    result = salesforce_unit.search_string('Account')
     assert 'searchRecords' in result
-

salespyforce/utils/tests/test_version_utils.py

@@ -0,0 +1,70 @@
+# -*- coding: utf-8 -*-
+# bandit: skip=B101
+"""
+:Module:         salespyforce.utils.tests.test_version_utils
+:Synopsis:       Pytest suite for salespyforce.utils.version helpers
+:Created By:     Jeff Shurtliff
+:Last Modified:  Jeff Shurtliff
+:Modified Date:  20 Dec 2025
+"""
+
+import importlib
+import importlib.metadata as importlib_metadata
+
+from salespyforce.utils import version as version_utils
+
+
+def test_get_full_version_returns_metadata(monkeypatch):
+    """This function tests get_full_version returns the package metadata."""
+    expected_version = "1.2.3"
+    monkeypatch.setattr(
+        version_utils, "version", lambda package: expected_version
+    )
+
+    assert version_utils.get_full_version() == expected_version
+
+
+def test_get_full_version_handles_missing_package(monkeypatch, caplog):
+    """This function tests get_full_version fallback when package is missing."""
+    def raise_not_found(_package):
+        raise version_utils.PackageNotFoundError("salespyforce")
+
+    monkeypatch.setattr(version_utils, "version", raise_not_found)
+
+    with caplog.at_level("WARNING"):
+        version_string = version_utils.get_full_version()
+
+    assert version_string == "0.0.0"
+    assert any("falling back to '0.0.0'" in message for message in caplog.messages)
+
+
+def test_get_major_minor_version_returns_two_components(monkeypatch):
+    """This function tests extracting the major.minor version components."""
+    monkeypatch.setattr(
+        version_utils, "get_full_version", lambda: "2.3.4"
+    )
+
+    assert version_utils.get_major_minor_version() == "2.3"
+
+
+def test_get_major_minor_version_returns_full_when_missing_minor(monkeypatch):
+    """This function tests get_major_minor_version with a single-part version."""
+    monkeypatch.setattr(version_utils, "get_full_version", lambda: "7")
+
+    assert version_utils.get_major_minor_version() == "7"
+
+
+def test_dunder_version_matches_full_version(monkeypatch):
+    """This function tests __version__ initialization uses get_full_version."""
+    real_version_function = importlib_metadata.version
+    expected_version = "9.8.7"
+    monkeypatch.setattr(
+        importlib_metadata, "version", lambda package: expected_version
+    )
+
+    reloaded_module = importlib.reload(version_utils)
+    assert reloaded_module.__version__ == expected_version
+    assert reloaded_module.get_full_version() == expected_version
+
+    importlib_metadata.version = real_version_function
+    importlib.reload(version_utils)

{salespyforce-1.4.0.dev0.dist-info → salespyforce-1.4.0.dev2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: salespyforce
-Version: 1.4.0.dev0
+Version: 1.4.0.dev2
 Summary: A Python toolset for performing Salesforce API calls
 License: MIT License
          
@@ -63,7 +63,7 @@ A Python toolset for performing Salesforce API calls
         <td>Latest Beta/RC Release</td>
         <td>
             <a href='https://pypi.org/project/salespyforce/#history'>
-                <img alt="PyPI" src="https://img.shields.io/badge/pypi-1.3.0rc3-blue">
+                <img alt="PyPI" src="https://img.shields.io/badge/pypi-1.4.0.dev1-blue">
             </a>
         </td>
     </tr>
@@ -140,6 +140,10 @@ A Python toolset for performing Salesforce API calls
     </tr>
 </table>
 
+## Overview
+salespyforce is a Python toolkit focused on interacting with Salesforce APIs, with a primary `Salesforce` class 
+that centralizes authentication, version selection, and access to helper feature sets (Chatter, Knowledge).
+
 ## Installation
 The package can be installed via pip using the syntax below.
 
@@ -147,14 +151,6 @@ The package can be installed via pip using the syntax below.
 pip install salespyforce --upgrade
 ```
 
-You may also clone the repository and install from source using below.
-
-```sh
-git clone git://github.com/jeffshurtliff/salespyforce.git
-cd salespyforce/
-python setup.py install
-```
-
 ## Change Log
 The change log can be found in the [documentation](https://salespyforce.readthedocs.io/en/latest/changelog.html).
 

salespyforce-1.4.0.dev2.dist-info/RECORD

@@ -0,0 +1,27 @@
+salespyforce/__init__.py,sha256=W2RY2_kojLcXtTHJrto5FtU6q1umVPaU1RZe_QkFgNY,2031
+salespyforce/api.py,sha256=fSMZYH1bpdZGS2sq924f1we0Bkubx8rrTx810Xyl3Ug,7732
+salespyforce/chatter.py,sha256=GI9iXmq2mrbrH7daW8Kc3gt2O04dRthSVocJq4BVwCU,7494
+salespyforce/core.py,sha256=x-D8HsjsRSS7ti1XnwSxKFfqysntI8TttgKBqjsKwh4,52661
+salespyforce/errors/__init__.py,sha256=Tnl4lB2ycpK2UmwmoBoSYuWDtovDNA4CxC5Cku2hDYs,320
+salespyforce/errors/exceptions.py,sha256=6ATDNCPNXnjOzXcaaLZVUy39lsFt2Se5cCvqkd_8faM,17057
+salespyforce/errors/handlers.py,sha256=8Hp-WrpYooMlC7cuuowTkOFyBH8OQFfHKmB8XxDPlyk,479
+salespyforce/knowledge.py,sha256=5a1kllrggh83vOmFrR-NLaz2YDpoKQweQ1B4e2AwghA,25407
+salespyforce/utils/__init__.py,sha256=ATE6BsWd2qDxsy1fQpvaoSJimZgfCmNPYpcFEucES6Q,292
+salespyforce/utils/core_utils.py,sha256=_uVVxHcVwCb-h6m-B7IKY77ItaSsHtGwydZN923yIic,7038
+salespyforce/utils/helper.py,sha256=zwbysqwddWwhp3mfzKJf0aeTTkVqoR35L9dLu6ZVJtU,5661
+salespyforce/utils/log_utils.py,sha256=-7qgSNCUQRstRgz2wXBX6LRWO-GMjIXS5WjxkHGvBHk,11936
+salespyforce/utils/tests/__init__.py,sha256=Iv7M9gPyKv5f5tR-pxc089cd2nrWn5M0ZZpWqiB2htc,242
+salespyforce/utils/tests/conftest.py,sha256=zYB5pYNtRHc6cIxY_cBMQHNM52Is6NjLfcCywCD3-Bw,6661
+salespyforce/utils/tests/resources.py,sha256=-PEqzLMsEQSVj3dz_8VTHXINbSeMvmjX3gZRMTJgoac,4774
+salespyforce/utils/tests/test_core_utils.py,sha256=8b3qjzr028wVeQAxBvIeajcqnWCsqUhNgqcquznGQKg,7272
+salespyforce/utils/tests/test_instantiate_object.py,sha256=O_DTljj_QCBZlDiA1KBUmSL2CZfsVU_7K2h6ypEN0D8,2002
+salespyforce/utils/tests/test_log_utils.py,sha256=FxPC21vXRQbFvqmTi_FL1DsGwuH8JHPkl9XytVoe7uY,2328
+salespyforce/utils/tests/test_sobjects.py,sha256=AeKli_LjSkeaspGxHZoZsM1IafKS2HkJ1wzajSXt6Dc,2120
+salespyforce/utils/tests/test_soql.py,sha256=SSOAN-4QZNpwUON-cLndb5W6AAs28Ja1u-Zt1WBx0VA,776
+salespyforce/utils/tests/test_sosl.py,sha256=3Ny1uF0onjcvI_InfMYRdh31rR5MJADTB3DWSm--EjE,868
+salespyforce/utils/tests/test_version_utils.py,sha256=njRKMiwtCCyUHEAFvfxvavuh03fJ_EupM1TUYmdsZAo,2465
+salespyforce/utils/version.py,sha256=uEWnq3DHmN9wZVohiRCRE1KzNF1XVhP4oVY4vBBgoVU,1781
+salespyforce-1.4.0.dev2.dist-info/LICENSE,sha256=b_Ch0pvcZN6Mr4dQ9Bo3It-J3MihQYcj_-EIdaZHuWw,1071
+salespyforce-1.4.0.dev2.dist-info/METADATA,sha256=7Loir-UVgxd2NpPpLKFQo-0nnt540mMC2ZSh-0uIyxA,10400
+salespyforce-1.4.0.dev2.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+salespyforce-1.4.0.dev2.dist-info/RECORD,,

salespyforce-1.4.0.dev0.dist-info/RECORD

@@ -1,23 +0,0 @@
-salespyforce/__init__.py,sha256=W2RY2_kojLcXtTHJrto5FtU6q1umVPaU1RZe_QkFgNY,2031
-salespyforce/api.py,sha256=JoqYyOo7Psx-l-bEC7iFdFfQVziIkqINcOKOnlpa_jM,5763
-salespyforce/chatter.py,sha256=GI9iXmq2mrbrH7daW8Kc3gt2O04dRthSVocJq4BVwCU,7494
-salespyforce/core.py,sha256=OPn5TsY9oCjg_jtEFWCq3yQz4-B7pTeYKsSGOtfo8yI,49148
-salespyforce/errors/__init__.py,sha256=Tnl4lB2ycpK2UmwmoBoSYuWDtovDNA4CxC5Cku2hDYs,320
-salespyforce/errors/exceptions.py,sha256=6ATDNCPNXnjOzXcaaLZVUy39lsFt2Se5cCvqkd_8faM,17057
-salespyforce/errors/handlers.py,sha256=8Hp-WrpYooMlC7cuuowTkOFyBH8OQFfHKmB8XxDPlyk,479
-salespyforce/knowledge.py,sha256=YCUbVDr8n23mdUzeuqlNToHIaaD9mzcSZ5Rvr_J8kAw,24770
-salespyforce/utils/__init__.py,sha256=ATE6BsWd2qDxsy1fQpvaoSJimZgfCmNPYpcFEucES6Q,292
-salespyforce/utils/core_utils.py,sha256=ESuQVb8L00KoP56_nAKTj3i09u_6BqK0MxJtYV5QbwI,5674
-salespyforce/utils/helper.py,sha256=zwbysqwddWwhp3mfzKJf0aeTTkVqoR35L9dLu6ZVJtU,5661
-salespyforce/utils/log_utils.py,sha256=085OBfJNxwJSjE3lQzmixjsK1s9akGvYG_kJpUPvDJ4,11799
-salespyforce/utils/tests/__init__.py,sha256=Iv7M9gPyKv5f5tR-pxc089cd2nrWn5M0ZZpWqiB2htc,242
-salespyforce/utils/tests/resources.py,sha256=-PEqzLMsEQSVj3dz_8VTHXINbSeMvmjX3gZRMTJgoac,4774
-salespyforce/utils/tests/test_instantiate_object.py,sha256=vxeXuzJ3OJrGlNFM4gOUfsifefRkr4tDUoElC90a0uo,1422
-salespyforce/utils/tests/test_sobjects.py,sha256=H_drUPsopu6y0nAxHZkZD1PAP5pd5jE15hqwC0qdDso,1846
-salespyforce/utils/tests/test_soql.py,sha256=xSVNuJo7U4vNqWXGbw2ue66p7-RQ-PuBlql1vkddl3M,715
-salespyforce/utils/tests/test_sosl.py,sha256=tKKirOtDFmROMGvMsPuG1cM603zQIeXXJHVgWYXOqYw,815
-salespyforce/utils/version.py,sha256=uEWnq3DHmN9wZVohiRCRE1KzNF1XVhP4oVY4vBBgoVU,1781
-salespyforce-1.4.0.dev0.dist-info/LICENSE,sha256=b_Ch0pvcZN6Mr4dQ9Bo3It-J3MihQYcj_-EIdaZHuWw,1071
-salespyforce-1.4.0.dev0.dist-info/METADATA,sha256=H5ENENMftGOHZAvC2BQUEJ02SEqTwU1WgErPbSdKvGg,10346
-salespyforce-1.4.0.dev0.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-salespyforce-1.4.0.dev0.dist-info/RECORD,,