o tBh4@shddlZddlZddlZddlZddlmZddlmZddl Z ddl Z ddl m Z GdddeZdS)N)mktime)quotec@seZdZdZeddZeddZed#dd Zed$d d Zed dZ e d$ddZ eddZ e d$ddZ e d$ddZ eddZeddZGdddeZGdddeZGdd d eZGd!d"d"eZdS)% APIHelpera/A Helper Class for various functions associated with API Calls. This class contains static methods for operations that need to be performed during API requests. All of the methods inside this class are static methods, there is no need to ever initialise an instance of this class. cCs|}|||S)aMerges two dictionaries into one as a shallow copy. Args: dict1 (dict): The first dictionary. dict2 (dict): The second dictionary. Returns: dict: A dictionary containing key value pairs from both the argument dictionaries. In the case of a key conflict, values from dict2 are used and those from dict1 are lost. )copyupdate)dict1dict2tempr h/var/www/html/riverr-enterprise-integrations-main/venv/lib/python3.10/site-packages/square/api_helper.py merge_dictss zAPIHelper.merge_dictscCsr|durdSt|tr)t}|D]}t|dr |t|q||q|}n t|dr3t|}t|dS)zJSON Serialization of a given object. Args: obj (object): The object to serialize. Returns: str: The JSON serialized string of the object. N_namesF) isinstancelisthasattrappendr to_dictionary jsonpickleencode)objvalueitemr r r json_serialize-s       zAPIHelper.json_serializeNFcs||durdSzt|}Wn ty|YSwdur|S|r,fdd|DSt|tr:fdd|DS|S)aJSON Deserialization of a given string. Args: json (str): The JSON serialized string to deserialize. Returns: dict: A dictionary representing the data contained in the JSON serialized string. Ncsi|] \}}||qSr r .0kvunboxing_functionr r bz.APIHelper.json_deserialize..csg|]}|qSr r relementrr r dz.APIHelper.json_deserialize..)rdecode ValueErroritemsrr)jsonras_dictdecodedr rr json_deserializeJs   zAPIHelper.json_deserializeindexedcsg}tjddkrttttttjt j f}n tttttjt j f}t |d|r_|dkr7|fdd|D7}|S|dkrJ|fddt |D7}|S|dkr[|fd d|D7}|St d |fd dt |D7}|S) aWConverts an array parameter to a list of key value tuples. Args: key (str): The name of the parameter. array (list): The value of the parameter. formatting (str): The type of key formatting expected. Returns: list: A list with key value tuples for the array elements. r unindexedcsg|] }d|fqS)z{0}[]formatr!keyr r r#~r z-APIHelper.serialize_array..r,c g|] \}}d||fqSz{0}[{1}]r/rindexr"r1r r r# plaincsg|]}|fqSr r r!r1r r r#r$zInvalid format provided.cr3r4r/r5r1r r r#r7)sys version_infostrintlongfloatbooldatetimedater CustomDater enumerater&)r2array formattingtuplesserializable_typesr r1r serialize_arrayhs"  zAPIHelper.serialize_arraycs|durtd|dur|S|D]B}||d}||dd}|dur'd}n t|tr9dfdd|D}nrCtt|dd nt|}|d |t|}q|S) aReplaces template parameters in the given url. Args: url (str): The query url string to replace the template parameters. parameters (dict): The parameters to replace in the url. Returns: str: URL with replaced parameters. N URL is None.rr/c3s,|]}rtt|ddnt|VqdSrJsafeNrr;rxrr r s*z@APIHelper.append_url_with_template_parameters..rMz{{{0}}})r&rrjoinrr;replacer0)url parametersr2r replace_valuer rRr #append_url_with_template_parameterss    z-APIHelper.append_url_with_template_parametersc Cs0|durtd|dur|S|D]\}}d|vrdnd}|durt|trdd|D}|dkrD|d||d d d |D7}q|d krZ|d||d dd |D7}q|dkrp|d||ddd |D7}q|d|ddd t|||D7}q|d||tt |dd7}q|S)a>Adds query parameters to a URL. Args: url (str): The URL string. parameters (dict): The query parameters to add to the URL. array_serialization (str): The format of array parameter serialization. Returns: str: URL with added query parameters. NrI?&cSsg|]}|r|qSr r r!r r r r#r$z>APIHelper.append_url_with_query_parameters..csvz {0}{1}={2},cs |] }tt|ddVqdSrLrOrPr r r rSz=APIHelper.append_url_with_query_parameters..psv|csr^rLrOrPr r r rSr_tsv csr^rLrOrPr r r rSr_z{0}{1}css,|]\}}d|tt|ddVqdS)z{0}={1}rJrMN)r0rr;rr r r rSs rJrM) r&r'rrr0rTrrHrr;)rVrWarray_serializationr2r seperatorr r r append_url_with_query_parameterssH   z*APIHelper.append_url_with_query_parameterscCsd}t||}|durtd|d}|d}|t||dkr$|nd}tdd|}|dkr9||dnd }|||S) zValidates and processes the given query Url to clean empty slashes. Args: url (str): The given query Url to process. Returns: str: Clean Url as string. z^https?://[^/]+NzInvalid Url format.rrZz//+rKrJ)rematchr&groupfindlensub)rVregexriprotocolr6 query_urlrWr r r clean_urls    zAPIHelper.clean_urlcCs,g}|D] \}}|t|||7}q|S)ajForm encodes a dictionary of form parameters Args: form_parameters (dictionary): The given dictionary which has atleast one model to form encode. array_serialization (str): The format of array parameter serialization. Returns: dict: A dictionary of form encoded properties of the model. )r'r form_encode)form_parametersrdencodedr2rr r r form_encode_parameterssz APIHelper.form_encode_parameterscCsg}|durgSt|tr&t|||D]}|t|d|d|7}q|St|trC|D]}|t|||d|d|7}q-|S|||f|S)aEncodes a model in a form-encoded manner such as person[Name] Args: obj (object): The given Object to form encode. instance_name (string): The base name to appear before each entry for this object. array_serialization (string): The format of array parameter serialization. Returns: dict: A dictionary of form encoded properties of the model. Nr[])rrrrHrrdictr)r instance_namerdretvalr"rr r r rrs  $zAPIHelper.form_encodecCst}dd|jDD]k}t||}t|tr;t||j|<|D]}||j|t|dr6t |n|q#q t|trgt||j|<|D]}t||drZt ||n||||j||<qJq t|drqt |n|||j|<q |S)aCreates a dictionary representation of a class instance. The keys are taken from the API description and may differ from language specific variable names of properties. Args: obj: The object to be converted into a dictionary. Returns: dictionary: A dictionary form of the model with properties in their API formats. cSsi|] \}}|dur||qSNr rr r r rCsz+APIHelper.to_dictionary..r ) ry__dict__r'getattrrrr rrrr)r dictionarynamerrr2r r r r2s  * 4$zAPIHelper.to_dictionarycCs|r||SdSr|r )funcrr r r when_definedUszAPIHelper.when_definedc@s2eZdZdZd ddZddZddZd d ZdS) zAPIHelper.CustomDatez A base class for wrapper classes of datetime. This class contains methods which help in appropriate serialization of datetime objects. NcCs$||_|s |||_dS||_dSr|)r@ from_datetimer)selfdtimerr r r __init__bs zAPIHelper.CustomDate.__init__cCs t|jSr|)r;rrr r r __repr__is zAPIHelper.CustomDate.__repr__cCs|jSr|)rrr r r __getstate__lsz!APIHelper.CustomDate.__getstate__cCsdSr|r )rstater r r __setstate__osz!APIHelper.CustomDate.__setstate__r|)__name__ __module__ __qualname____doc__rrrrr r r r rBYs   rBc@(eZdZdZeddZeddZdS)zAPIHelper.HttpDateTimez: A wrapper class for datetime to support HTTP date format.cCstjt|dddS)NFT)timeval localtimeusegmt)eut formatdater timetuplecls date_timer r r rvsz$APIHelper.HttpDateTime.from_datetimecCs"tjtt|}|||Sr|)r@ fromtimestampr mktime_tz parsedate_tzrrrr r r from_value{s z!APIHelper.HttpDateTime.from_valueNrrrr classmethodrrr r r r HttpDateTimers  rc@r)zAPIHelper.UnixDateTimez: A wrapper class for datetime to support Unix date format.cCst|Sr|)calendartimegm utctimetuplerr r r rsz$APIHelper.UnixDateTime.from_datetimecCstjt|}||t|Sr|)r@utcfromtimestampr>rr r r rsz!APIHelper.UnixDateTime.from_valueNrr r r r UnixDateTime  rc@r)zAPIHelper.RFC3339DateTimez9 A wrapper class for datetime to support Rfc 3339 format.cCs|Sr|) isoformatrr r r rsz'APIHelper.RFC3339DateTime.from_datetimecCstj|}|||Sr|)dateutilparserparserr r r rs  z$APIHelper.RFC3339DateTime.from_valueNrr r r r RFC3339DateTimerr)NF)r,)rrrr staticmethodr rr+rHrYrfrqrurrrrobjectrBrrrr r r r rs>    ! # 6    "  r)rhr9r@r email.utilsutilsrtimerrdateutil.parserrrequests.utilsrrrr r r r s