salespyforce 1.4.0.dev2__tar.gz → 1.5.0__tar.gz

{salespyforce-1.4.0.dev2 → salespyforce-1.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: salespyforce
-Version: 1.4.0.dev2
+Version: 1.5.0
 Summary: A Python toolset for performing Salesforce API calls
 License: MIT License
          
@@ -23,13 +23,24 @@ License: MIT License
          LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
          OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
          SOFTWARE.
-Keywords: salesforce,sfdc,api,rest,tooling,python
+Keywords: salesforce,sfdc,sfdx,api,rest,tooling,python
 Author: Jeff Shurtliff
 Author-email: jeffshurtliff@gmail.com
+Maintainer: Jeff Shurtliff
+Maintainer-email: jeffshurtliff@gmail.com
 Requires-Python: >=3.9,<4.0
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: License :: OSI Approved :: MIT License
+Classifier: License :: Freely Distributable
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: System Administrators
+Classifier: Intended Audience :: Developers
+Classifier: Environment :: Web Environment
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Internet :: WWW/HTTP :: Site Management
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: System :: Systems Administration
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.9
@@ -37,17 +48,22 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Software Development :: Libraries
-Classifier: Topic :: Internet :: WWW/HTTP
 Requires-Dist: PyYAML (>=6.0.3,<7)
-Requires-Dist: requests (>=2.32.5)
-Project-URL: Documentation, https://salespyforce.readthedocs.io/en/latest/
+Requires-Dist: certifi (>=2024.7.4)
+Requires-Dist: idna (>=3.15,<4)
+Requires-Dist: requests (>=2.32.5,<2.33.0) ; python_version < "3.10"
+Requires-Dist: requests (>=2.33.0,<3) ; python_version >= "3.10"
+Requires-Dist: tomli (>=2.0.0) ; python_version < "3.11"
+Requires-Dist: urllib3 (>=2.6.3,<2.7.0) ; python_version < "3.10"
+Requires-Dist: urllib3 (>=2.7.0,<3) ; python_version >= "3.10"
+Project-URL: Changelog, https://salespyforce.readthedocs.io/en/latest/CHANGELOG.html
+Project-URL: Documentation, https://salespyforce.readthedocs.io/en/stable/
 Project-URL: Homepage, https://github.com/jeffshurtliff/salespyforce
 Project-URL: Issue Tracker, https://github.com/jeffshurtliff/salespyforce/issues
 Project-URL: Repository, https://github.com/jeffshurtliff/salespyforce
 Description-Content-Type: text/markdown
 
-# salespyforce
+# SalesPyForce
 A Python toolset for performing Salesforce API calls
 
 <table>
@@ -63,24 +79,24 @@ 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.4.0.dev1-blue">
+                <img alt="PyPI" src="https://img.shields.io/badge/pypi-1.4.0.rc0-blue">
             </a>
         </td>
     </tr>
     <tr>
         <td>Build Status</td>
         <td>
-            <a href="https://github.com/jeffshurtliff/salespyforce/blob/master/.github/workflows/pythonpackage.yml">
+            <a href="https://github.com/jeffshurtliff/salespyforce/blob/master/.github/workflows/ci.yml">
                 <img alt="GitHub Workflow Status" 
-                src="https://img.shields.io/github/actions/workflow/status/jeffshurtliff/salespyforce/pythonpackage.yml?branch=master">
+                src="https://img.shields.io/github/actions/workflow/status/jeffshurtliff/salespyforce/ci.yml?branch=master">
             </a>
         </td>
     </tr>
     <tr>
         <td>Supported Versions</td>
         <td>
-            <a href='https://pypi.org/project/salespyforce/'>
-                <img alt="PyPI - Python Version" src="https://img.shields.io/pypi/pyversions/salespyforce">
+            <a href="https://pypi.org/project/salespyforce/">
+                <img alt="PyPI - Supported Python Versions" src="https://img.shields.io/pypi/pyversions/salespyforce">
             </a>
         </td>
     </tr>
@@ -95,8 +111,8 @@ A Python toolset for performing Salesforce API calls
     <tr>
         <td>Documentation</td>
         <td>
-            <a href='https://salespyforce.readthedocs.io/en/latest/?badge=latest'>
-                <img src='https://readthedocs.org/projects/salespyforce/badge/?version=latest' alt='Documentation Status' />
+            <a href="https://salespyforce.readthedocs.io/en/latest/?badge=latest">
+                <img src="https://readthedocs.org/projects/salespyforce/badge/?version=latest" alt="Documentation Status" />
             </a>
         </td>
     </tr>
@@ -145,14 +161,47 @@ salespyforce is a Python toolkit focused on interacting with Salesforce APIs, wi
 that centralizes authentication, version selection, and access to helper feature sets (Chatter, Knowledge).
 
 ## Installation
+
+> [!IMPORTANT]
+> SalesPyForce `1.5.0` is the final release that supports Python `3.9`, `3.10`, and `3.11`.<br>
+> SalesPyForce `2.0.0` and newer will require Python `3.12` or newer.
+
 The package can be installed via pip using the syntax below.
 
 ```sh
 pip install salespyforce --upgrade
 ```
 
-## Change Log
-The change log can be found in the [documentation](https://salespyforce.readthedocs.io/en/latest/changelog.html).
+## Development and Testing
+For local development, this repository uses split test directories:
+`tests/unit/` and `tests/integration/`.
+
+```sh
+poetry install
+poetry run pytest -q
+```
+
+### Development Quality Checks
+
+This repository uses [Ruff](https://docs.astral.sh/ruff/) for linting, import sorting, and formatting.
+The standard maximum line length for this package is `130` characters.
+
+Line-length exceptions should be rare and limited to comments or special cases where wrapping harms readability.
+When an exception is required, use a targeted per-line `# noqa: E501` comment.
+
+```sh
+poetry run ruff check .
+poetry run ruff check . --fix
+poetry run ruff format .
+poetry run ruff format --check .
+```
+
+These checks are enforced in CI via `.github/workflows/ci.yml`.
+
+## Changelog
+The changelog can be found in the [documentation](https://salespyforce.readthedocs.io) for the
+[stable](https://salespyforce.readthedocs.io/en/stable/CHANGELOG.html) and
+[latest](https://salespyforce.readthedocs.io/en/latest/CHANGELOG.html) versions.
 
 ## Usage
 This section provides basic usage instructions for the package.
@@ -233,7 +282,7 @@ sfdc = Salesforce(helper=HELPER_FILE)
 ```
 
 ## Documentation
-The documentation is located here: [https://salespyforce.readthedocs.io/en/latest/](https://salespyforce.readthedocs.io/en/latest/)
+The documentation is located here: [https://salespyforce.readthedocs.io/en/stable/](https://salespyforce.readthedocs.io/en/stable/)
 
 ## License
 [MIT License](https://github.com/jeffshurtliff/salespyforce/blob/master/LICENSE)

{salespyforce-1.4.0.dev2 → salespyforce-1.5.0}/README.md

@@ -1,4 +1,4 @@
-# salespyforce
+# SalesPyForce
 A Python toolset for performing Salesforce API calls
 
 <table>
@@ -14,24 +14,24 @@ 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.4.0.dev1-blue">
+                <img alt="PyPI" src="https://img.shields.io/badge/pypi-1.4.0.rc0-blue">
             </a>
         </td>
     </tr>
     <tr>
         <td>Build Status</td>
         <td>
-            <a href="https://github.com/jeffshurtliff/salespyforce/blob/master/.github/workflows/pythonpackage.yml">
+            <a href="https://github.com/jeffshurtliff/salespyforce/blob/master/.github/workflows/ci.yml">
                 <img alt="GitHub Workflow Status" 
-                src="https://img.shields.io/github/actions/workflow/status/jeffshurtliff/salespyforce/pythonpackage.yml?branch=master">
+                src="https://img.shields.io/github/actions/workflow/status/jeffshurtliff/salespyforce/ci.yml?branch=master">
             </a>
         </td>
     </tr>
     <tr>
         <td>Supported Versions</td>
         <td>
-            <a href='https://pypi.org/project/salespyforce/'>
-                <img alt="PyPI - Python Version" src="https://img.shields.io/pypi/pyversions/salespyforce">
+            <a href="https://pypi.org/project/salespyforce/">
+                <img alt="PyPI - Supported Python Versions" src="https://img.shields.io/pypi/pyversions/salespyforce">
             </a>
         </td>
     </tr>
@@ -46,8 +46,8 @@ A Python toolset for performing Salesforce API calls
     <tr>
         <td>Documentation</td>
         <td>
-            <a href='https://salespyforce.readthedocs.io/en/latest/?badge=latest'>
-                <img src='https://readthedocs.org/projects/salespyforce/badge/?version=latest' alt='Documentation Status' />
+            <a href="https://salespyforce.readthedocs.io/en/latest/?badge=latest">
+                <img src="https://readthedocs.org/projects/salespyforce/badge/?version=latest" alt="Documentation Status" />
             </a>
         </td>
     </tr>
@@ -96,14 +96,47 @@ salespyforce is a Python toolkit focused on interacting with Salesforce APIs, wi
 that centralizes authentication, version selection, and access to helper feature sets (Chatter, Knowledge).
 
 ## Installation
+
+> [!IMPORTANT]
+> SalesPyForce `1.5.0` is the final release that supports Python `3.9`, `3.10`, and `3.11`.<br>
+> SalesPyForce `2.0.0` and newer will require Python `3.12` or newer.
+
 The package can be installed via pip using the syntax below.
 
 ```sh
 pip install salespyforce --upgrade
 ```
 
-## Change Log
-The change log can be found in the [documentation](https://salespyforce.readthedocs.io/en/latest/changelog.html).
+## Development and Testing
+For local development, this repository uses split test directories:
+`tests/unit/` and `tests/integration/`.
+
+```sh
+poetry install
+poetry run pytest -q
+```
+
+### Development Quality Checks
+
+This repository uses [Ruff](https://docs.astral.sh/ruff/) for linting, import sorting, and formatting.
+The standard maximum line length for this package is `130` characters.
+
+Line-length exceptions should be rare and limited to comments or special cases where wrapping harms readability.
+When an exception is required, use a targeted per-line `# noqa: E501` comment.
+
+```sh
+poetry run ruff check .
+poetry run ruff check . --fix
+poetry run ruff format .
+poetry run ruff format --check .
+```
+
+These checks are enforced in CI via `.github/workflows/ci.yml`.
+
+## Changelog
+The changelog can be found in the [documentation](https://salespyforce.readthedocs.io) for the
+[stable](https://salespyforce.readthedocs.io/en/stable/CHANGELOG.html) and
+[latest](https://salespyforce.readthedocs.io/en/latest/CHANGELOG.html) versions.
 
 ## Usage
 This section provides basic usage instructions for the package.
@@ -184,7 +217,7 @@ sfdc = Salesforce(helper=HELPER_FILE)
 ```
 
 ## Documentation
-The documentation is located here: [https://salespyforce.readthedocs.io/en/latest/](https://salespyforce.readthedocs.io/en/latest/)
+The documentation is located here: [https://salespyforce.readthedocs.io/en/stable/](https://salespyforce.readthedocs.io/en/stable/)
 
 ## License
 [MIT License](https://github.com/jeffshurtliff/salespyforce/blob/master/LICENSE)

salespyforce-1.5.0/pyproject.toml

@@ -0,0 +1,115 @@
+# --------------------------------------------------------------------
+# Core Project Configuration
+# --------------------------------------------------------------------
+[project]
+name = "salespyforce"
+version = "1.5.0"
+description = "A Python toolset for performing Salesforce API calls"
+readme = "README.md"
+requires-python = ">=3.9,<4.0"
+license = { file = "LICENSE" }
+authors = [
+    { name = "Jeff Shurtliff", email = "jeffshurtliff@gmail.com" }
+]
+maintainers = [
+    { name = "Jeff Shurtliff", email = "jeffshurtliff@gmail.com" }
+]
+keywords = ["salesforce", "sfdc", "sfdx", "api", "rest", "tooling", "python"]
+
+classifiers = [
+    # Project maturity
+    "Development Status :: 5 - Production/Stable",
+
+    # License
+    "License :: OSI Approved :: MIT License",
+    "License :: Freely Distributable",
+
+    # Intended audience and environment
+    "Intended Audience :: Information Technology",
+    "Intended Audience :: System Administrators",
+    "Intended Audience :: Developers",
+    "Environment :: Web Environment",
+    "Operating System :: OS Independent",
+    "Topic :: Internet :: WWW/HTTP",
+    "Topic :: Internet :: WWW/HTTP :: Site Management",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: System :: Systems Administration",
+
+    # Supported Python versions
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+
+dependencies = [
+    "PyYAML>=6.0.3,<7",
+    "requests>=2.32.5,<2.33.0; python_version < '3.10'",
+    "requests>=2.33.0,<3; python_version >= '3.10'",
+    "urllib3>=2.6.3,<2.7.0; python_version < '3.10'",
+    "urllib3>=2.7.0,<3; python_version >= '3.10'",
+    "idna>=3.15,<4",
+    "certifi>=2024.7.4",    # Explicit pin to mitigate CA removals (e-Tugra, GLOBALTRUST)
+
+    # Backport of tomllib for Python < 3.11
+    "tomli>=2.0.0; python_version < '3.11'",
+]
+
+[project.urls]
+Homepage = "https://github.com/jeffshurtliff/salespyforce"
+Repository = "https://github.com/jeffshurtliff/salespyforce"
+Documentation = "https://salespyforce.readthedocs.io/en/stable/"
+Changelog = "https://salespyforce.readthedocs.io/en/latest/CHANGELOG.html"
+"Issue Tracker" = "https://github.com/jeffshurtliff/salespyforce/issues"
+
+# --------------------------------------------------------------------
+# Poetry-specific Configuration
+# --------------------------------------------------------------------
+[tool.poetry]
+packages = [
+    { include = "salespyforce", from = "src" }
+]
+
+include = ["LICENSE", "README.md"]
+
+[tool.poetry.group.dev.dependencies]
+pytest = [
+    { version = ">=8.4.2,<9", python = ">=3.9,<3.10" },
+    { version = ">=9.0.3,<10", python = ">=3.10" },
+]
+pytest-cov = "^7.0.0"
+bandit = { version = "^1.7.8", extras = ["sarif"] }
+Sphinx = "^7.4.7"
+pydata-sphinx-theme = "^0.15.4"
+myst-parser = "^3.0.1"
+sphinx-favicon = "^1.0.1"
+ruff = "^0.15.8"
+soupsieve = ">=2.8.4,<3"
+pygments = ">=2.20.0,<3"
+twine = ">=6.2.0,<7"
+
+[tool.ruff]
+target-version = "py39"
+line-length = 130
+src = ["src", "tests"]
+extend-exclude = ["docs_legacy"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP"]
+ignore = ["UP006", "UP007", "UP009", "UP035", "UP045"]
+
+[tool.ruff.format]
+quote-style = "single"
+indent-style = "space"
+line-ending = "lf"
+
+[tool.pytest.ini_options]
+testpaths = ["tests/unit", "tests/integration"]
+pythonpath = ["src"]
+
+[build-system]
+requires = ["poetry-core>=1.2.0"]
+build-backend = "poetry.core.masonry.api"

{salespyforce-1.4.0.dev2 → salespyforce-1.5.0}/src/salespyforce/__init__.py

@@ -3,8 +3,8 @@
 :Module:            salespyforce
 :Synopsis:          This is the ``__init__`` module for the salespyforce package
 :Created By:        Jeff Shurtliff
-:Last Modified:     Jeff Shurtliff
-:Modified Date:     08 May 2023
+:Last Modified:     Jeff Shurtliff (via GPT-5.5-codex)
+:Modified Date:     15 Jul 2026
 """
 
 from . import core
@@ -27,8 +27,7 @@ def define_connection_info():
 
 
 # Allow the core.compile_connection_info() function to be executed directly
-def compile_connection_info(base_url, org_id, username, password, endpoint_url,
-                            client_id, client_secret, security_token):
+def compile_connection_info(base_url, org_id, username, password, endpoint_url, client_id, client_secret, security_token):
     """This function compiles the connection info into a dictionary that can be consumed by the core object.
 
     :param base_url: The base URL of the Salesforce instance
@@ -49,5 +48,6 @@ def compile_connection_info(base_url, org_id, username, password, endpoint_url,
     :type security_token: str
     :returns: The connection info in a dictionary
     """
-    return core.compile_connection_info(base_url, org_id, username, password, endpoint_url,
-                                        client_id, client_secret, security_token)
+    return core.compile_connection_info(
+        base_url, org_id, username, password, endpoint_url, client_id, client_secret, security_token
+    )