brynq-sdk-alight 1.0.0__py3-none-any.whl

brynq_sdk_alight/time_quotas.py

@@ -0,0 +1,114 @@
+from typing import Any, Dict, List, Optional, Union
+
+from .schemas.timequota import TimeQuota, TimeQuotas
+from .schemas.payments import PayServEmpExtensionCreate
+from .schemas import EmployeeCreate as EmployeeModel
+
+
+class TimeQuotas:
+    """
+    High-level Time Quotas API. Sends TimeQuotas via PayServEmpExtension.
+
+    Usage:
+        alight = Alight()
+        xml = alight.time_quotas.create(time_quotas=[...], person_id="35561", employee_id="35561ZZGB")
+        xml = alight.time_quotas.update(time_quotas=[...], person_id="35561", employee_id="35561ZZGB")
+    """
+
+    def __init__(self, client: Any):
+        self._client = client
+
+    def _build_extension_with_time_quotas(self, time_quotas: List[Union[TimeQuota, Dict[str, Any]]]) -> Dict[str, Any]:
+        """
+        Wrap raw time quota dictionaries into the schema-backed extension payload.
+
+        Running through `TimeQuota` and `TimeQuotas` ensures aliases (like unit/identifier wrappers)
+        are applied before the data touches the XSD validation layer.
+
+        Example:
+            >>> self._build_extension_with_time_quotas(
+            ...     [{"quota_code": "VAC", "balance": "40", "valid_from": "2024-01-01"}]
+            ... )
+        """
+        quota_models = [q if isinstance(q, TimeQuota) else TimeQuota(**q) for q in time_quotas]
+        wrapper = TimeQuotas(time_quotas=quota_models)
+        ext = PayServEmpExtensionCreate(time_quotas=wrapper)  # type: ignore[arg-type]
+        return ext.to_nested_dict()
+
+    def create(
+        self,
+        *,
+        time_quotas: List[Union[TimeQuota, Dict[str, Any]]],
+        person_id: str,
+        employee_id: str,
+        logical_id: Optional[str] = None,
+        envelope_options: Optional[Dict[str, Any]] = None,
+        pretty_print: bool = True,
+    ) -> str:
+        """
+        Generate an ADD envelope that pushes quota balances through the extension block.
+
+        Example:
+            >>> alight.time_quotas.create(
+            ...     time_quotas=[{"quota_code": "VAC", "balance": "40"}],
+            ...     person_id="35561",
+            ...     employee_id="35561ZZGB",
+            ... )
+
+        Passing quota dictionaries directly keeps the calling code small—the helper expands wrappers like
+        `quota_code.value` and runs schema validation before serializing to XML.
+        """
+        extension_data = self._build_extension_with_time_quotas(time_quotas)
+
+        employee_model = EmployeeModel(
+            person_id=person_id,
+            employee_id=employee_id,
+        )
+
+        return self._client.generate_employee_xml(
+            employee=employee_model,
+            action_code="ADD",
+            logical_id=logical_id,
+            extension_data=extension_data,
+            envelope_options=envelope_options,
+            pretty_print=pretty_print,
+        )
+
+    def update(
+        self,
+        *,
+        time_quotas: List[Union[TimeQuota, Dict[str, Any]]],
+        person_id: str,
+        employee_id: str,
+        logical_id: Optional[str] = None,
+        envelope_options: Optional[Dict[str, Any]] = None,
+        pretty_print: bool = True,
+    ) -> str:
+        """
+        Generate a CHANGE envelope for quota adjustments using the same normalization flow as `create`.
+
+        Keeps the employee identifiers consistent with the flat dictionary interface while ensuring the
+        extension payload remains schema-valid.
+
+        Example:
+            >>> alight.time_quotas.update(
+            ...     time_quotas=[{"quota_code": "VAC", "balance": "32"}],
+            ...     person_id="35561",
+            ...     employee_id="35561ZZGB",
+            ... )
+        """
+        extension_data = self._build_extension_with_time_quotas(time_quotas)
+
+        employee_model = EmployeeModel(
+            person_id=person_id,
+            employee_id=employee_id,
+        )
+
+        return self._client.generate_employee_xml(
+            employee=employee_model,
+            action_code="CHANGE",
+            logical_id=logical_id,
+            extension_data=extension_data,
+            envelope_options=envelope_options,
+            pretty_print=pretty_print,
+        )

brynq_sdk_alight-1.0.0.dist-info/METADATA

@@ -0,0 +1,20 @@
+Metadata-Version: 2.4
+Name: brynq_sdk_alight
+Version: 1.0.0
+Summary: Alight SDK for the BrynQ.com platform
+Author: BrynQ
+Author-email: support@brynq.com
+License: BrynQ License
+Requires-Dist: requests<=3,>=2
+Requires-Dist: xsdata>=25.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pydantic-xml>=2.0.0
+Requires-Dist: xsdata-pydantic>=24.0.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: description
+Dynamic: license
+Dynamic: requires-dist
+Dynamic: summary
+
+Alight SDK for the BrynQ.com platform

brynq_sdk_alight-1.0.0.dist-info/RECORD

@@ -0,0 +1,44 @@
+brynq_sdk_alight/__init__.py,sha256=ox3r7tZwgzyPAdA8SWrRJwjD8XQLYph1swA21k9s5Sw,43336
+brynq_sdk_alight/address.py,sha256=xi14zO_l2hdXMVzxDcKaeEyhh6y0LBhgidTZ6ws0dek,2180
+brynq_sdk_alight/employee.py,sha256=9E-zlgD7eSPiS7p5brRPpf9X9JFSsyETkv5bXfqv0dU,2692
+brynq_sdk_alight/job.py,sha256=0sO6_Z5VJRUdGqDh__X3J9u1pLlf4Mzq8v1UzKhzPQY,2674
+brynq_sdk_alight/leave.py,sha256=7hYWbkxXFLWEjzBqallYCOg6kVGXxd_FCsRsE_TXTns,2993
+brynq_sdk_alight/pay_elements.py,sha256=XJA1KexjHX8ottQWSsgD8jip2M5LmLlhiTU3Ldp51co,3519
+brynq_sdk_alight/salary.py,sha256=KfSYW-WrW4L0OqxfE2oUTDJERaCmhCTptRSft07NsrA,3716
+brynq_sdk_alight/termination.py,sha256=IhvJ61GteSnOx2v98eDf2WOIhLn1jDdIdio5N4kCNQI,3427
+brynq_sdk_alight/time_elements.py,sha256=ssYHzpx_hJ-f7RTyYpq_7OrfZBdPUrxfU5Fx418TabM,4360
+brynq_sdk_alight/time_quotas.py,sha256=dag3OEzUge81IX61093SZ_RwJGynBY0zcuVn0XO7xb0,4143
+brynq_sdk_alight/archive/flat_wrapper.py,sha256=-5yK5P3daAItmSIXfqfiPssSZ3Lje-dItGBqNAhwSB8,5677
+brynq_sdk_alight/archive/hrxml_generator.py,sha256=b52bfGmLKUsCPGFtMr6KWCcc11XPAf8GOR4v7UBAVOU,9852
+brynq_sdk_alight/archive/managers.py,sha256=hJpEK5Ni2ddAYde64ER4HAbVY6fb7XKkFXhr1Ixyhb8,5890
+brynq_sdk_alight/archive/managers_generic.py,sha256=41t_NRzA0THoFcu_0peUhaBmxdpY6k8PbOJxzQs6IeQ,4916
+brynq_sdk_alight/archive/managers_old_complex.py,sha256=aAw0xWN-hGjVgcki6nTyR65aykEdTWlwlrCMryrpaEs,12516
+brynq_sdk_alight/archive/managers_simple.py,sha256=EiHTVocRAmBQdO4ipxXAQtgdIPrM5IG-V6m2BRoQ-p8,8601
+brynq_sdk_alight/schemas/__init__.py,sha256=nDqu5nKvrts-cDHNWYbBJWz-ouq6BtOazdwT1z165nc,537
+brynq_sdk_alight/schemas/absence.py,sha256=2BlTvF3ecRfYqF27QvkKo5J6k1ZMFypSZpuhY6pPuWo,3402
+brynq_sdk_alight/schemas/address.py,sha256=Rl6dqE8piDQv1oA8PA7IId14uVp03vK21DGopP4dPiM,4473
+brynq_sdk_alight/schemas/employee.py,sha256=nTDooXDUkU_TqZGYoR58fwJTnxV7rDgn7IFJyn0Waz4,26840
+brynq_sdk_alight/schemas/job.py,sha256=M6vNeR5asDj3EaguRaMeQoi5LO2GquTLvmxg9-tjws4,4995
+brynq_sdk_alight/schemas/leave.py,sha256=BUJ7V5I4c-t-U6Keyaoqr81FfguzoxtJ4-Yg6e1e0q8,2183
+brynq_sdk_alight/schemas/payments.py,sha256=69O40UoOa8FG7VAWSWk-x_c7co2Sxn_LG95hYkCYpOI,15331
+brynq_sdk_alight/schemas/salary.py,sha256=B1wykXINd-oqG1Agk8bSDB9HneWejChnZeDtBzts-CY,2343
+brynq_sdk_alight/schemas/termination.py,sha256=dbKiMUkaUExqks1ZyRKJklejpQxZ5MtOfzuhejhZxSU,1761
+brynq_sdk_alight/schemas/timequota.py,sha256=kq-u5zkKIRtTGqJBTZQBSmvifaTg_P-UCc5GSzIAb1U,2926
+brynq_sdk_alight/schemas/utils.py,sha256=6mOI_kbkaw4MAuqponZZNqUAsPfwy-6pNd6OBCgZzxs,16284
+brynq_sdk_alight/schemas/generated_envelope_xsd_schema/__init__.py,sha256=2mPTceQnAvE9jayO_HlvcJ77swycTOo1yaQWSzU_ZUU,909937
+brynq_sdk_alight/schemas/generated_envelope_xsd_schema/process_pay_serv_emp.py,sha256=B0h8e3hMz0udXUV0dYjjsc3ZqVp2gDw3RqJwclfSFsk,17349645
+brynq_sdk_alight/schemas/generated_xsd_schemas/__init__.py,sha256=BwVA8LuNjTwjQHGP-IDubRt5zZSXkNglMHn1oTTL9Eg,289863
+brynq_sdk_alight/schemas/generated_xsd_schemas/csec_person.py,sha256=102ahqr03fBkNOLty79rYpQhEBU6qBkV1kKn2ub1iFo,1119803
+brynq_sdk_alight/schemas/generated_xsd_schemas/hrxml_indicative_data.py,sha256=V2AlkYyUuIXFJkR9LbkVRUWy-j2WBlRrrcaHqN5AzbA,3190892
+brynq_sdk_alight/schemas/generated_xsd_schemas/openapplications_bod.py,sha256=wdMkcGgn3i_IDwoaLouMTV4ifwFM5zyc_dmcpX4axwY,1179590
+brynq_sdk_alight/schemas/generated_xsd_schemas/openapplications_code_list_currency_code_iso_7_04.py,sha256=bCHsvtH_0H7Z2B2nY4ohz-7Br5ZKSfne5wiBqPWNW4E,12893
+brynq_sdk_alight/schemas/generated_xsd_schemas/openapplications_code_list_language_code_iso_7_04.py,sha256=64sQtW4XAL2gYjH3w3goxqBLZ1DNM3OLgByAJIwNwec,369
+brynq_sdk_alight/schemas/generated_xsd_schemas/openapplications_code_list_mimemedia_type_code_iana_7_04.py,sha256=-UuDNEh-ffD0HA94qPR707keQAJocqI_VJX1claA93s,378
+brynq_sdk_alight/schemas/generated_xsd_schemas/openapplications_code_list_unit_code_unece_7_04.py,sha256=RjuRRlfuIVrXyium230AR0RkBNXmenYuB1TkH_9_ltM,354
+brynq_sdk_alight/schemas/generated_xsd_schemas/openapplications_code_lists.py,sha256=YSjUKQI3j0BxDIk3jOipJ8bSvFRH3M7OU4g7lFqP4Gc,15244
+brynq_sdk_alight/schemas/generated_xsd_schemas/openapplications_qualified_data_types.py,sha256=fwhRh2bkBdMvpRpRnITAv-1wiYKf1H20HCeIWa0ziyE,2696
+brynq_sdk_alight/schemas/generated_xsd_schemas/openapplications_unqualified_data_types.py,sha256=cbea-P7N45ktP7tFcQMZvKbvTE9-x81NV7CumP4G10I,69646
+brynq_sdk_alight-1.0.0.dist-info/METADATA,sha256=WHiP4JjfFpqL-a3PkHXoRmqvt12QigKePvZRPuFRnUQ,497
+brynq_sdk_alight-1.0.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+brynq_sdk_alight-1.0.0.dist-info/top_level.txt,sha256=4S5DPwjBXkLhf4SonK9dvZsdc5ijVT8Zeyro8vv82-I,17
+brynq_sdk_alight-1.0.0.dist-info/RECORD,,

brynq_sdk_alight-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

brynq_sdk_alight-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+brynq_sdk_alight