ds_provider_simployer_py_lib.linked_service
===========================================

.. py:module:: ds_provider_simployer_py_lib.linked_service

.. autoapi-nested-parse::

   **File:** ``__init__.py``
   **Region:** ``ds_provider_simployer_py_lib/linked_service``

   Simployer Linked Service

   This module implements a linked service for Simployer and provides a session.

   .. rubric:: Example

   >>> from uuid import UUID
   >>> linked_service = SimployerLinkedService(
   ...     id=UUID("00000000-0000-0000-0000-000000000000"),
   ...     name="test-name",
   ...     version="1.0.0",
   ...     settings=SimployerLinkedServiceSettings(
   ...         client_id="your_client_id",
   ...         client_secret="your_client_secret",
   ...     ),
   ... )
   >>> linked_service.connect()
   >>> linked_service.test_connection()



Submodules
----------

.. toctree::
   :maxdepth: 1

   /autoapi/ds_provider_simployer_py_lib/linked_service/simployer/index


Classes
-------

.. autoapisummary::

   ds_provider_simployer_py_lib.linked_service.SimployerLinkedService
   ds_provider_simployer_py_lib.linked_service.SimployerLinkedServiceSettings


Package Contents
----------------

.. py:class:: SimployerLinkedService

   Bases: :py:obj:`ds_protocol_http_py_lib.HttpLinkedService`\ [\ :py:obj:`SimployerLinkedServiceSettingsType`\ ], :py:obj:`Generic`\ [\ :py:obj:`SimployerLinkedServiceSettingsType`\ ]


   Linked service for connecting to Simployer using client credentials.



   .. py:attribute:: settings
      :type:  SimployerLinkedServiceSettingsType


   .. py:property:: type
      :type: ds_provider_simployer_py_lib.enums.ResourceType


      Get the type of the linked service.

      :returns: ResourceType


   .. py:method:: __post_init__() -> None

      Post-init method to set up the linked service.

      If self.settings.custom is None and auth_type is CUSTOM, populates custom with
      default OAuth2 client credentials settings. This allows callers to preconfigure
      custom auth settings or subclasses to override the behavior.

      :returns: None



.. py:class:: SimployerLinkedServiceSettings

   Bases: :py:obj:`ds_protocol_http_py_lib.HttpLinkedServiceSettings`


   Settings required to connect to Simployer API using client credentials.

   .. attribute:: client_id

      Client ID for authentication

   .. attribute:: client_secret

      Client secret for authentication

   .. attribute:: token_endpoint

      Token endpoint (default: https://simplauth.simployer.com/oauth/token)

   .. attribute:: audience

      Audience identifier (default: https://hrconnect.simployer.com)

   .. attribute:: api_version

      API version to use (default: v1)

   .. attribute:: host

      API host URL (default: https://hrconnect.simployer.com)

   .. attribute:: auth_type

      Authentication type (default: CUSTOM)

   .. attribute:: custom

      Custom authentication settings, required if auth_type is CUSTOM


   .. py:attribute:: client_id
      :type:  str

      The client ID for authentication.


   .. py:attribute:: client_secret
      :type:  str

      The client secret for authentication.


   .. py:attribute:: token_endpoint
      :type:  str
      :value: 'https://simplauth.simployer.com/oauth/token'


      The token endpoint URL.


   .. py:attribute:: audience
      :type:  str
      :value: 'https://hrconnect.simployer.com'


      The audience identifier.


   .. py:attribute:: api_version
      :type:  str
      :value: 'v1'


      The API version to use.


   .. py:attribute:: host
      :type:  str
      :value: 'https://hrconnect.simployer.com'


      The API host URL.


   .. py:attribute:: auth_type
      :type:  ds_protocol_http_py_lib.enums.AuthType

      The authentication type to use.


   .. py:attribute:: custom
      :type:  ds_protocol_http_py_lib.linked_service.CustomAuthSettings | None
      :value: None


      Custom authentication settings, required if auth_type is CUSTOM.