salespyforce 1.4.0.dev0__tar.gz → 1.4.0.dev2__tar.gz

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

@@ -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.dev0 → salespyforce-1.4.0.dev2}/README.md

@@ -14,7 +14,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>
@@ -91,6 +91,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.
 
@@ -98,14 +102,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.dev0 → salespyforce-1.4.0.dev2}/pyproject.toml

@@ -1,33 +1,33 @@
 [project]
 name = "salespyforce"
-version = "1.4.0.dev0"
+version = "1.4.0.dev2"
 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" }
+    { name = "Jeff Shurtliff", email = "jeffshurtliff@gmail.com" }
 ]
 keywords = ["salesforce", "sfdc", "api", "rest", "tooling", "python"]
 
 classifiers = [
-  "Development Status :: 4 - Beta",
-  "Intended Audience :: Developers",
-  "License :: OSI Approved :: MIT License",
-  "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",
-  "Topic :: Software Development :: Libraries",
-  "Topic :: Internet :: WWW/HTTP"
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "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",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Internet :: WWW/HTTP"
 ]
 
 dependencies = [
-  "PyYAML>=6.0.3,<7",
-  "requests>=2.32.5",
+    "PyYAML>=6.0.3,<7",
+    "requests>=2.32.5",
 ]
 
 [project.urls]
@@ -41,7 +41,7 @@ Documentation = "https://salespyforce.readthedocs.io/en/latest/"
 # --------------------------------------------------------------------
 [tool.poetry]
 packages = [
-  { include = "salespyforce", from = "src" }
+    { include = "salespyforce", from = "src" }
 ]
 
 include = ["LICENSE", "README.md"]

{salespyforce-1.4.0.dev0 → salespyforce-1.4.0.dev2}/src/salespyforce/api.py

@@ -4,7 +4,7 @@
 :Synopsis:          Defines the basic functions associated with the Salesforce API
 :Created By:        Jeff Shurtliff
 :Last Modified:     Jeff Shurtliff
-:Modified Date:     17 Feb 2023
+:Modified Date:     29 Jan 2026
 """
 
 import requests
@@ -117,6 +117,49 @@ def api_call_with_payload(sfdc_object, method, endpoint, payload, params=None, h
     return response
 
 
+def delete(sfdc_object, endpoint, params=None, headers=None, timeout=30, show_full_error=True, return_json=True):
+    """This method performs a DELETE request against the Salesforce instance.
+
+    .. version-added:: 1.4.0
+
+    :param sfdc_object: The instantiated SalesPyForce object
+    :param endpoint: The API endpoint to query
+    :type endpoint: str
+    :param params: The query parameters (where applicable)
+    :type params: dict, None
+    :param headers: Specific API headers to use when performing the API call
+    :type headers: dict, None
+    :param timeout: The timeout period in seconds (defaults to ``30``)
+    :type timeout: int, str, None
+    :param show_full_error: Determines if the full error message should be displayed (defaults to ``True``)
+    :type show_full_error: bool
+    :param return_json: Determines if the response should be returned in JSON format (defaults to ``True``)
+    :returns: The API response in JSON format or as a ``requests`` object
+    """
+    # Define the parameters as an empty dictionary if none are provided
+    params = {} if params is None else params
+
+    # Define the headers
+    default_headers = _get_headers(sfdc_object.access_token)
+    headers = default_headers if not headers else headers
+
+    # Make sure the endpoint begins with a slash
+    endpoint = f'/{endpoint}' if not endpoint.startswith('/') else endpoint
+
+    # Perform the API call
+    response = requests.delete(f'{sfdc_object.instance_url}{endpoint}', headers=headers, params=params,
+                               timeout=timeout)
+    if response.status_code >= 300:
+        if show_full_error:
+            raise RuntimeError(f'The DELETE request failed with a {response.status_code} status code.\n'
+                               f'{response.text}')
+        else:
+            raise RuntimeError(f'The DELETE request failed with a {response.status_code} status code.')
+    if return_json:
+        response = response.json()
+    return response
+
+
 def _get_headers(_access_token, _header_type='default'):
     """This function returns the appropriate HTTP headers to use for different types of API calls."""
     headers = {

{salespyforce-1.4.0.dev0 → salespyforce-1.4.0.dev2}/src/salespyforce/core.py

@@ -6,7 +6,7 @@
 :Example:           ``sfdc = Salesforce(helper=helper_file_path)``
 :Created By:        Jeff Shurtliff
 :Last Modified:     Jeff Shurtliff
-:Modified Date:     17 Nov 2025
+:Modified Date:     30 Jan 2026
 """
 
 import re
@@ -60,7 +60,8 @@ class Salesforce(object):
         :param helper: The file path of a helper file
         :type helper: str, None
         :returns: The instantiated object
-        :raises: :py:exc:`TypeError`
+        :raises: :py:exc:`TypeError`,
+                 :py:exc:`RuntimeError`
         """
         # Define the default settings
         self._helper_settings = {}
@@ -147,6 +148,7 @@ class Salesforce(object):
         (`Reference <https://jereze.com/code/authentification-salesforce-rest-api-python/>`_)
 
         :returns: The API call response with the authorization information
+        :raises: :py:exc:`RuntimeError`
         """
         params = {
             'grant_type': 'password',
@@ -176,6 +178,7 @@ class Salesforce(object):
         :type show_full_error: bool
         :param return_json: Determines if the response should be returned in JSON format (defaults to ``True``)
         :returns: The API response in JSON format or as a ``requests`` object
+        :raises: :py:exc:`RuntimeError`
         """
         return api.get(self, endpoint=endpoint, params=params, headers=headers, timeout=timeout,
                        show_full_error=show_full_error, return_json=return_json)
@@ -201,6 +204,7 @@ class Salesforce(object):
         :type show_full_error: bool
         :param return_json: Determines if the response should be returned in JSON format (defaults to ``True``)
         :returns: The API response in JSON format or as a ``requests`` object
+        :raises: :py:exc:`RuntimeError`
         """
         return api.api_call_with_payload(self, method=method, endpoint=endpoint, payload=payload, params=params,
                                          headers=headers, timeout=timeout, show_full_error=show_full_error,
@@ -224,6 +228,7 @@ class Salesforce(object):
         :type show_full_error: bool
         :param return_json: Determines if the response should be returned in JSON format (defaults to ``True``)
         :returns: The API response in JSON format or as a ``requests`` object
+        :raises: :py:exc:`RuntimeError`
         """
         return api.api_call_with_payload(self, 'post', endpoint=endpoint, payload=payload, params=params,
                                          headers=headers, timeout=timeout, show_full_error=show_full_error,
@@ -247,6 +252,7 @@ class Salesforce(object):
         :type show_full_error: bool
         :param return_json: Determines if the response should be returned in JSON format (defaults to ``True``)
         :returns: The API response in JSON format or as a ``requests`` object
+        :raises: :py:exc:`RuntimeError`
         """
         return api.api_call_with_payload(self, 'patch', endpoint=endpoint, payload=payload, params=params,
                                          headers=headers, timeout=timeout, show_full_error=show_full_error,
@@ -270,16 +276,41 @@ class Salesforce(object):
         :type show_full_error: bool
         :param return_json: Determines if the response should be returned in JSON format (defaults to ``True``)
         :returns: The API response in JSON format or as a ``requests`` object
+        :raises: :py:exc:`RuntimeError`
         """
         return api.api_call_with_payload(self, 'put', endpoint=endpoint, payload=payload, params=params,
                                          headers=headers, timeout=timeout, show_full_error=show_full_error,
                                          return_json=return_json)
 
+    def delete(self, endpoint, params=None, headers=None, timeout=30, show_full_error=True, return_json=True):
+        """This method performs a DELETE request against the Salesforce instance.
+        (`Reference <https://jereze.com/code/authentification-salesforce-rest-api-python/>`_)
+
+        .. version-added:: 1.4.0
+
+        :param endpoint: The API endpoint to query
+        :type endpoint: str
+        :param params: The query parameters (where applicable)
+        :type params: dict, None
+        :param headers: Specific API headers to use when performing the API call
+        :type headers: dict, None
+        :param timeout: The timeout period in seconds (defaults to ``30``)
+        :type timeout: int, str, None
+        :param show_full_error: Determines if the full error message should be displayed (defaults to ``True``)
+        :type show_full_error: bool
+        :param return_json: Determines if the response should be returned in JSON format (defaults to ``True``)
+        :returns: The API response in JSON format or as a ``requests`` object
+        :raises: :py:exc:`RuntimeError`
+        """
+        return api.delete(self, endpoint=endpoint, params=params, headers=headers, timeout=timeout,
+                          show_full_error=show_full_error, return_json=return_json)
+
     def get_api_versions(self) -> list:
         """This method returns the API versions for the Salesforce releases.
         (`Reference <https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/dome_versions.htm>`_)
 
         :returns: A list containing the API metadata from the ``/services/data`` endpoint.
+        :raises: :py:exc:`RuntimeError`
         """
         return self.get('/services/data')
 
@@ -305,13 +336,19 @@ class Salesforce(object):
     def get_org_limits(self):
         """This method returns a list of all org limits.
 
-        .. versionadded:: 1.1.0
+        .. version-added:: 1.1.0
+
+        :returns: The Salesforce org governor limits data
+        :raises: :py:exc:`RuntimeError`
         """
         return self.get(f'/services/data/{self.version}/limits')
 
     def get_all_sobjects(self):
         """This method returns a list of all Salesforce objects. (i.e. sObjects)
         (`Reference <https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/dome_describeGlobal.htm>`_)
+
+        :returns: The list of all Salesforce objects
+        :raises: :py:exc:`RuntimeError`
         """
         return self.get(f'/services/data/{self.version}/sobjects')
 
@@ -325,6 +362,7 @@ class Salesforce(object):
         :param describe: Determines if the full (i.e. ``describe``) data should be returned (defaults to ``False``)
         :type describe: bool
         :returns: The Salesforce object data
+        :raises: :py:exc:`RuntimeError`
         """
         uri = f'/services/data/{self.version}/sobjects/{object_name}'
         uri = f'{uri}/describe' if describe else uri
@@ -337,15 +375,32 @@ class Salesforce(object):
         :param object_name: The name of the Salesforce object
         :type object_name: str
         :returns: The Salesforce object data
+        :raises: :py:exc:`RuntimeError`
         """
         return self.get_sobject(object_name, describe=True)
 
     def get_rest_resources(self):
         """This method returns a list of all available REST resources.
         (`Reference <https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/dome_discoveryresource.htm>`_)
+
+        :returns: The list of all available REST resources for the Salesforce org
+        :raises: :py:exc:`RuntimeError`
         """
         return self.get(f'/services/data/{self.version}')
 
+    @staticmethod
+    def get_18_char_id(record_id: str) -> str:
+        """This method converts a 15-character Salesforce record ID to its 18-character case-insensitive form.
+
+        .. version-added:: 1.4.0
+
+        :param record_id: The Salesforce record ID to convert (or return unchanged if already 18 characters)
+        :type record_id: str
+        :returns: The 18-character Salesforce record ID
+        :raises: :py:exc:`ValueError`
+        """
+        return core_utils.get_18_char_id(record_id=record_id)
+
     def soql_query(self, query, replace_quotes=True, next_records_url=False):
         """This method performs a SOQL query and returns the results in JSON format.
         (`Reference 1 <https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/dome_query.htm>`_,
@@ -358,6 +413,7 @@ class Salesforce(object):
         :param next_records_url: Indicates that the ``query`` parameter is a ``nextRecordsUrl`` value.
         :type next_records_url: bool
         :returns: The result of the SOQL query
+        :raises: :py:exc:`RuntimeError`
         """
         if next_records_url:
             query = re.sub(r'^.*/', '', query) if '/' in query else query
@@ -372,11 +428,12 @@ class Salesforce(object):
         """This method performs a SOSL query to search for a given string.
         (`Reference <https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_search.htm>`_)
 
-        .. versionadded:: 1.1.0
+        .. version-added:: 1.1.0
 
         :param string_to_search: The string for which to search
         :type string_to_search: str
         :returns: The SOSL response data in JSON format
+        :raises: :py:exc:`RuntimeError`
         """
         query = 'FIND {' + string_to_search + '}'
         query = core_utils.url_encode(query)
@@ -391,7 +448,8 @@ class Salesforce(object):
         :param payload: The JSON payload with the record details
         :type payload: dict
         :returns: The API response from the POST request
-        :raises: :py:exc:`RuntimeError`, :py:exc:`TypeError`
+        :raises: :py:exc:`RuntimeError`,
+                 :py:exc:`TypeError`
         """
         # Ensure the payload is in the appropriate format
         if not isinstance(payload, dict):
@@ -412,7 +470,8 @@ class Salesforce(object):
         :param payload: The JSON payload with the record details to be updated
         :type payload: dict
         :returns: The API response from the PATCH request
-        :raises: :py:exc:`RuntimeError`, :py:exc:`TypeError`
+        :raises: :py:exc:`RuntimeError`,
+                 :py:exc:`TypeError`
         """
         # Ensure the payload is in the appropriate format
         if not isinstance(payload, dict):
@@ -596,7 +655,8 @@ class Salesforce(object):
             :param return_uri: Determines if the URI of the article should be returned rather than the ID (``False`` by default)
             :type return_uri: bool
             :returns: The Article ID or Article URI, or a blank string if no article is found
-            :raises: :py:exc:`ValueError`
+            :raises: :py:exc:`ValueError`,
+                     :py:exc:`RuntimeError`
             """
             return knowledge_module.get_article_id_from_number(self.sfdc_object, article_number=article_number,
                                                                sobject=sobject, return_uri=return_uri)
@@ -616,6 +676,7 @@ class Salesforce(object):
             :param page_num: The starting page number (``1`` by default)
             :type page_num: int
             :returns: The list of retrieved knowledge articles
+            :raises: :py:exc:`RuntimeError`
             """
             return knowledge_module.get_articles_list(self.sfdc_object, query=query, sort=sort, order=order,
                                                       page_size=page_size, page_num=page_num)
@@ -629,6 +690,7 @@ class Salesforce(object):
             :param sobject: The Salesforce object to query (``Knowledge__kav`` by default)
             :type sobject: str, None
             :returns: The details for the knowledge article
+            :raises: :py:exc:`RuntimeError`
             """
             return knowledge_module.get_article_details(self.sfdc_object, article_id=article_id, sobject=sobject)
 
@@ -680,7 +742,8 @@ class Salesforce(object):
             :param sobject: The Salesforce object to query (``Knowledge__kav`` by default)
             :type sobject: str, None
             :returns: The article URL as a string
-            :raises: :py:exc:`ValueError`
+            :raises: :py:exc:`ValueError`,
+                     :py:exc:`RuntimeError`
             """
             return knowledge_module.get_article_url(self.sfdc_object, article_id=article_id,
                                                     article_number=article_number, sobject=sobject)
@@ -696,7 +759,9 @@ class Salesforce(object):
             :param full_response: Determines if the full API response should be returned instead of the article ID (``False`` by default)
             :type full_response: bool
             :returns: The API response or the ID of the article draft
-            :raises: :py:exc:`ValueError`, :py:exc:`TypeError`
+            :raises: :py:exc:`ValueError`,
+                     :py:exc:`TypeError`,
+                     :py:exc:`RuntimeError`
             """
             return knowledge_module.create_article(self.sfdc_object, article_data=article_data, sobject=sobject,
                                                    full_response=full_response)
@@ -714,7 +779,9 @@ class Salesforce(object):
             :param include_status_code: Determines if the API response status code should be returned (``False`` by default)
             :type include_status_code: bool
             :returns: A Boolean indicating if the update operation was successful, and optionally the API response status code
-            :raises: :py:exc:`ValueError`, :py:exc:`TypeError`, :py:exc:`RuntimeError`
+            :raises: :py:exc:`ValueError`,
+                     :py:exc:`TypeError`,
+                     :py:exc:`RuntimeError`
             """
             return knowledge_module.update_article(self.sfdc_object, record_id=record_id, article_data=article_data,
                                                    sobject=sobject, include_status_code=include_status_code)
@@ -781,7 +848,9 @@ class Salesforce(object):
             :param major_version: Determines if the published article should be a major version (``True`` by default)
             :type major_version: bool
             :returns: The API response from the POST request
-            :raises: :py:exc:`RuntimeError`, :py:exc:`TypeError`, :py:exc:`ValueError`
+            :raises: :py:exc:`RuntimeError`,
+                     :py:exc:`TypeError`,
+                     :py:exc:`ValueError`
             """
             return knowledge_module.publish_multiple_articles(self.sfdc_object, article_id_list=article_id_list,
                                                               major_version=major_version)
@@ -790,7 +859,7 @@ class Salesforce(object):
             """This method assigns a single data category for a knowledge article.
             (`Reference <https://itsmemohit.medium.com/quick-win-15-salesforce-knowledge-rest-apis-bb0725b2040e>`_)
 
-            .. versionadded:: 1.2.0
+            .. version-added:: 1.2.0
 
             :param article_id: The ID of the article to update
             :type article_id: str
@@ -809,7 +878,7 @@ class Salesforce(object):
             """This function archives a published knowledge article.
             (`Reference <https://developer.salesforce.com/docs/atlas.en-us.knowledge_dev.meta/knowledge_dev/knowledge_REST_archive_master_version.htm>`_)
 
-            .. versionadded:: 1.3.0
+            .. version-added:: 1.3.0
 
             :param article_id: The ID of the article to archive
             :type article_id: str
@@ -818,6 +887,18 @@ class Salesforce(object):
             """
             return knowledge_module.archive_article(self.sfdc_object, article_id=article_id)
 
+        def delete_article_draft(self, version_id):
+            """This function deletes an unpublished knowledge article draft.
+
+            .. version-added:: 1.4.0
+
+            :param version_id: The 15-character or 18-character ``Id`` (Knowledge Article Version ID) value
+            :type version_id: str
+            :returns: The API response from the DELETE request
+            :raises: :py:exc:`RuntimeError`
+            """
+            return knowledge_module.delete_article_draft(self.sfdc_object, version_id=version_id)
+
 
 def define_connection_info():
     """This function prompts the user for the connection information.

{salespyforce-1.4.0.dev0 → salespyforce-1.4.0.dev2}/src/salespyforce/knowledge.py

@@ -4,7 +4,7 @@
 :Synopsis:          Defines the Knowledge-related functions associated with the Salesforce API
 :Created By:        Jeff Shurtliff
 :Last Modified:     Jeff Shurtliff
-:Modified Date:     14 Nov 2023
+:Modified Date:     30 Jan 2026
 """
 
 from . import errors
@@ -20,7 +20,7 @@ def check_for_existing_article(sfdc_object, title, sobject=None, return_id=False
     (`Reference 1 <https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/dome_query.htm>`_,
     `Reference 2 <https://developer.salesforce.com/docs/atlas.en-us.knowledge_dev.meta/knowledge_dev/knowledge_development_soql_sosl_intro.htm>`_)
 
-    .. versionchanged:: 1.2.2
+    .. version-changed:: 1.2.2
        You can now specify whether archived articles are included in the query results.
 
     :param sfdc_object: The instantiated SalesPyForce object
@@ -230,7 +230,7 @@ def get_article_version(sfdc_object, article_id):
 def get_article_url(sfdc_object, article_id=None, article_number=None, sobject=None):
     """This function constructs the URL to view a knowledge article in Lightning or Classic.
 
-    .. versionchanged:: 1.2.0
+    .. version-changed:: 1.2.0
        Changed when lightning URLs are defined and fixed an issue with extraneous slashes.
 
     :param sfdc_object: The instantiated SalesPyForce object
@@ -483,7 +483,7 @@ def assign_data_category(sfdc_object, article_id, category_group_name, category_
     """This function assigns a single data category for a knowledge article.
     (`Reference <https://itsmemohit.medium.com/quick-win-15-salesforce-knowledge-rest-apis-bb0725b2040e>`_)
 
-    .. versionadded:: 1.2.0
+    .. version-added:: 1.2.0
 
     :param sfdc_object: The instantiated SalesPyForce object
     :type sfdc_object: class[salespyforce.Salesforce]
@@ -512,7 +512,7 @@ def archive_article(sfdc_object, article_id):
     """This function archives a published knowledge article.
     (`Reference <https://developer.salesforce.com/docs/atlas.en-us.knowledge_dev.meta/knowledge_dev/knowledge_REST_archive_master_version.htm>`_)
 
-    .. versionadded:: 1.3.0
+    .. version-added:: 1.3.0
 
     :param sfdc_object: The instantiated SalesPyForce object
     :type sfdc_object: class[salespyforce.Salesforce]
@@ -529,3 +529,19 @@ def archive_article(sfdc_object, article_id):
     # Perform the API call
     endpoint = f'/services/data/{sfdc_object.version}/knowledgeManagement/articleVersions/masterVersions/{article_id}'
     return sfdc_object.patch(endpoint, payload)
+
+
+def delete_article_draft(sfdc_object, version_id):
+    """This function deletes an unpublished knowledge article draft.
+    
+    .. version-added:: 1.4.0
+    
+    :param sfdc_object: The instantiated SalesPyForce object
+    :type sfdc_object: class[salespyforce.Salesforce]
+    :param version_id: The 15-character or 18-character ``Id`` (Knowledge Article Version ID) value
+    :type version_id: str
+    :returns: The API response from the DELETE request
+    :raises: :py:exc:`RuntimeError`
+    """
+    endpoint = f'/services/data/{sfdc_object.version}/sobjects/Knowledge__kav/{version_id}'
+    return sfdc_object.delete(endpoint)

{salespyforce-1.4.0.dev0 → salespyforce-1.4.0.dev2}/src/salespyforce/utils/core_utils.py

@@ -6,7 +6,7 @@
 :Example:           ``encoded_string = core_utils.encode_url(decoded_string)``
 :Created By:        Jeff Shurtliff
 :Last Modified:     Jeff Shurtliff
-:Modified Date:     29 May 2023
+:Modified Date:     30 Jan 2026
 """
 
 import random
@@ -23,6 +23,9 @@ from .. import errors
 # Initialize the logger for this module
 logger = log_utils.initialize_logging(__name__)
 
+# Define constants
+SALESFORCE_ID_SUFFIX_ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ012345'
+
 
 def url_encode(raw_string):
     """This function encodes a string for use in URLs.
@@ -60,7 +63,8 @@ def get_file_type(file_path):
     :param file_path: The full path to the file
     :type file_path: str
     :returns: The file type in string format (e.g. ``yaml`` or ``json``)
-    :raises: :py:exc:`FileNotFoundError`, :py:exc:`khoros.errors.exceptions.UnknownFileTypeError`
+    :raises: :py:exc:`FileNotFoundError`,
+             :py:exc:`salespyforce.errors.exceptions.UnknownFileTypeError`
     """
     file_type = 'unknown'
     if os.path.isfile(file_path):
@@ -97,6 +101,44 @@ def get_random_string(length=32, prefix_string=""):
     return f"{prefix_string}{''.join([random.choice(string.ascii_letters + string.digits) for _ in range(length)])}"
 
 
+def get_18_char_id(record_id: str) -> str:
+    """This function converts a 15-character Salesforce record ID to its 18-character case-insensitive form.
+
+    .. version-added:: 1.4.0
+
+    :param record_id: The Salesforce record ID to convert (or return unchanged if already 18 characters)
+    :type record_id: str
+    :returns: The 18-character Salesforce record ID
+    :raises: :py:exc:`ValueError`
+    """
+    # Ensure the provided record ID is a string
+    if not isinstance(record_id, str):
+        raise ValueError("Salesforce ID must be a string")
+
+    # Return the record ID unchanged if it is already 18 characters in length
+    if len(record_id) == 18:
+        return record_id
+
+    # Ensure the record ID is a valid 15-character value
+    if len(record_id) != 15:
+        raise ValueError("Salesforce ID must be 15 or 18 characters long")
+
+    # Define the checksum suffix (additional 3 characters)
+    suffix = ""
+    for i in range(0, 15, 5):
+        chunk = record_id[i:i + 5]
+        bitmask = 0
+
+        for index, char in enumerate(chunk):
+            if "A" <= char <= "Z":
+                bitmask |= 1 << index
+
+        suffix += SALESFORCE_ID_SUFFIX_ALPHABET[bitmask]
+
+    # Return the 18-character ID value
+    return record_id + suffix
+
+
 def get_image_ref_id(image_url):
     """This function parses an image URL to identify the reference ID (refid) value.
     (`Reference 1 <https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_sobject_rich_text_image_retrieve.htm>`_,