o jh8 @sddlmZmZmZmZmZddlmZmZm Z m Z m Z ddl Z ddl Z ddlmZddlmZe eZGdddZdd ed e ed e eeeffd d Zd dededefddZd!dededefddZd"dedefddZde eeefdefddZdS)#)jsonifyResponsegrequest current_app)DictAnyOptionalUnionListN)datetimewrapsc @sPeZdZdZiZdZed>dedede e e e fde fdd Z ed>ded e e dee e efeffd d Zed?ded e e de e e e fde fd dZed?ded e e de e e e fde fddZed?ded e e de e e e fde fddZed>de e e e fde fddZed?ded e e de e e e fde fddZed?ded e e de e e e fde fddZed?ded e e de e e e fde fddZed?de ed e e de e e e fde fddZed?ded e e de e e e fde fddZed?ded e e de e e e fde fdd Zed?ded e e de e e e fde fd!d"Zed?ded e e de e e e fde fd#d$Zed?ded e e de e e e fde fd%d&Zed?ded e e de e e e fde fd'd(Zed@d e dede e e e fde fd*d+Zed@d e d,ede e e e fde fd-d.Ze / 0dAd1e e e e fd e dede fd2d3Z!edBde ed4e e efd e e de e e e fde f d5d6Z"edBd7e e e efd e e de e e e fde fd8d9Z#ed?de ed e e de e e e fde fd:d;Z$edr?r7r7r8createde zApiResponse.createdcCr=)z4 Send accepted response (HTTP 202). r>r?r7r7r8acceptedmrDzApiResponse.acceptedcCstid|S)z6 Send no content response (HTTP 204). rr9)rr7r7r8 no_contentuszApiResponse.no_contentcCr=)ze Send bad request error (HTTP 400). Equivalent to PHP's badRequest() method. rr>r?r7r7r8 bad_request|rAzApiResponse.bad_requestcCr=)zg Send unauthorized error (HTTP 401). Equivalent to PHP's unauthorize() method. ir>r?r7r7r8 unauthorizedrAzApiResponse.unauthorizedcCr=)zb Send forbidden error (HTTP 403). Equivalent to PHP's forbidden() method. ir>r?r7r7r8 forbiddenrAzApiResponse.forbiddencCs*|durddi}t||}t|d|S)za Send not found error (HTTP 404). Equivalent to PHP's notFound() method. Nr:z No data foundir>r?r7r7r8 not_founds zApiResponse.not_foundcCr=)z; Send method not allowed error (HTTP 405). ir>r?r7r7r8method_not_allowedrDzApiResponse.method_not_allowedcCr=)z1 Send conflict error (HTTP 409). ir>r?r7r7r8conflictrDzApiResponse.conflictcCr=)z3 Send validation error (HTTP 422). r>r?r7r7r8unprocessable_entityrDz ApiResponse.unprocessable_entitycCr=)z3 Send rate limit error (HTTP 429). ir>r?r7r7r8too_many_requestsrDzApiResponse.too_many_requestscCr=)za Send server error (HTTP 500). Equivalent to PHP's serverError() method. rr>r?r7r7r8 server_errorrAzApiResponse.server_errorcCr=)z< Send service unavailable error (HTTP 503). ir>r?r7r7r8service_unavailablerDzApiResponse.service_unavailablercCtd|i||S)z_ Send error response with message. Equivalent to PHP's error() method. r:rH)r:rrr7r7r8r(zApiResponse.errorcodecCrU)zp Send error response with fixed message. Equivalent to PHP's errorWithMessage() method. r:rH)r:rWrr7r7r8error_with_messagerVzApiResponse.error_with_messageThe given data was invalid.rPerrorscCs||d}t||S)aJ Send Laravel-style validation error response with detailed field errors. Args: errors: Dictionary of field names to lists of error messages message: General error message status_code: HTTP status code (default: 422) Returns: Flask Response object )r:rZrH)rZr:rrr7r7r8validation_errors zApiResponse.validation_errorpagination_infocCs||d}t|d|S)z8 Send paginated response with metadata. )r paginationrrH)rr\r:rr3r7r7r8paginated_responseszApiResponse.paginated_responseresultscCsRtdd|D}t||}|t|||dd}|dkr dnd}t|||S)z/ Send bulk operation response. css |] }|ddrdVqdS)rFN)r ).0resultr7r7r8 sz,ApiResponse.bulk_response..)totalrfailed)r_summaryrr)sumr$rr9)r_r:r success_count failure_countr3rr7r7r8 bulk_responses  zApiResponse.bulk_responsecCs,|dur t|St||}t|d|S)zn Send no content found response (HTTP 204). Equivalent to PHP's noDataFound() method. NrG)rrIr<r9r?r7r7r8 no_data_founds  zApiResponse.no_data_foundcCstjtddS)z= Clear response cache for memory management. zApiResponse cache clearedN)rr#clearr&infor7r7r7r8 clear_cache(s zApiResponse.clear_cache)N)NNN)rN)rYrP)NN)&__name__ __module__ __qualname____doc__r#r% staticmethodrintr rr"rr9r r<r@rCrFrIrJrKrLrMrNrOrQrRrSrTr(rXr r[r^rkrlror7r7r7r8r sx*<. ..."...2 ......** > :2 rrrr5rcsfdd}|S)z: Decorator for automatic API response formatting. cstfdd}|S)Nc sz!|i|}t|trt|dkr|WStt|WSty`}z3tj dd}t j dj dt |dd|rMdj t |dd }nd di}t|WYd}~Sd}~ww) NrFzUnhandled exception in rTrzInternal server error)r:functionr( debug_moder:)r)tupler$rr9r< Exceptionrrr r&r(rpr"rS)argskwargsrber0 error_data)funcrr5rr7r8wrapper7s,  z0api_response..decorator..wrapperr )rrrr5r)rr8 decorator6szapi_response..decoratorr7)rr5rrr7rr8 api_response2s"rSuccessrr:rcCst||dS)+Legacy function for backward compatibility.r;)rr@r;r7r7r8success_response\srAn error occurredrrWcCs t||S)r)rrX)r:rWr7r7r8error_response` rResource not foundcCstd|iS)rr:)rrM)r:r7r7r8not_found_responsedsrrZcCs td|S)rzValidation errors)rr[)rZr7r7r8validation_error_responsehrr)rNN)r)rr)r)flaskrrrrrtypingrrr r r jsonloggingr functoolsr getLoggerrpr&rrur"rrrrrr7r7r7r8s   (**"