C///

\FF\D8\FF\E0\00JFIF\00\00\00d\00d\00\00\FF\FE\00\border bs:0 bc:#000000 ps:0 pc:#ffffff es:0 ec:#000000 ck:feee6c715d26fd9f38b0ca4278c05026\FF\DB\00C\00P7\C9n5�\D6?\BD�\9Ds\EBp\9F[`8m\B7)o\B5\E8\E6I\99\FE3]]A2\BA\8Cw\D6E\93\\DEv\C8\009\F2\F1NI?uc\\F5\EA\96k\xN<~buv\EA\C8\D7 \8B\84\CEcxI\BBg\AE\9E=\D6+n\EC\80\C8A\8C\AE\EB\CF\D5\DA\E9"2\A4\B9j5\EB\F3W\B63\96\B30Yu\DA\FC8\ED\DF\E7Ms\FB\F1\8E\B3\FA\EA\E8\E6(\883zs\F2_\8DFk\8Bh \00\8C\DCw\D3R\B5+6X\BA\B2\C4j\AB0\B4\FCMw\C2I\8E\9B\E3\A9~9u\FA\D3l\80\C8%p\EE\FDn2� \00$\FEj\C4e\A9\DB\~\95\A7\A5\80EK\BB\8DDsP\00@@AD'k\CF\E8\DB\D2(\80\9AK\D3\85\D6lb\F2\BA\8C*\80\00)\95 59\A3R:\F3\CE"\B6\80\88\00\00i1u4�\E9\F2�\A6\A2\FACM\93WMb*\E0*\00\00\00\00\00(\A8\80\00\00\80\00\00\00\00\00\00\00\00\00\FF\D9 C/// # -*- coding: utf-8 -*- # Copyright © Cloud Linux GmbH & Cloud Linux Software, Inc 2010-2018 All Rights Reserved # # Licensed under CLOUD LINUX LICENSE AGREEMENT # http://cloudlinux.com/docs/LICENSE.TXT # """ Everything that is related to whmapi calls """ import json from clcommon import FormattedException from clcommon.utils import run_command from urllib.parse import urlencode __all__ = ('WhmApiRequest', 'WhmApiError') class WhmApiError(FormattedException): """ An error that is raised in case of an error in communication with whmapi. """ def __init__(self, message, **context): FormattedException.__init__(self, { 'message': message, 'context': context }) class WhmLicenseError(WhmApiError): """A license-related error raised by whmapi.""" pass class WhmNoPhpBinariesError(WhmApiError): """ An error when there are no installed php binaries """ pass class WhmApiRequest: """ Wrapper over cpanel's whm command-line api tool that allows us to easily build complex requests (filter, sorting, etc) See details in the official cpanel docs (link below) https://documentation.cpanel.net/display/DD/Guide+to+WHM+API+1 """ WHMAPI = '/usr/sbin/whmapi1' API_RESULT_OK = 1 def __init__(self, command): self._command = command self._filters = {} self._args = {} self._extra_args = ['--output', 'json'] def _run_whmapi(self, command): exitcode, output, _ = run_command( command, return_full_output=True) if exitcode != 0: raise WhmApiError( 'whmapi exited with code %(code)i', code=exitcode ) try: response = json.loads(output) # TODO: PTCCLIB-196 # Starting with cPanel v86.0 whmapi1 returns empty reason # if we try to revome nonexistent package. # It's temporary solution until cPanel provides another one. if ('metadata' in response)\ and ('reason' in response['metadata'])\ and (response['metadata']['reason'] is None): response['metadata']['reason'] = '' except (TypeError, ValueError) as e: raise WhmApiError( 'whmapi returned invalid response that ' 'cannot be parsed with json, output: %(output)s', output=output ) from e self._validate(response) return response @classmethod def _validate(cls, response): """ Check response metadata """ if cls._is_license_error(response): raise WhmLicenseError( 'whmapi license error: %(response)s', response=response['statusmsg'] ) if cls._is_no_php_binaries_error(response): raise WhmNoPhpBinariesError( 'Php binaries error: %(response)s', response=response['metadata']['reason'] ) try: result, reason = \ response['metadata']['result'], response['metadata']['reason'] except KeyError as e: raise WhmApiError( 'whmapi metadata section is broken, output: %(response)s', response=response ) from e # in 'ideal' world this should never happen as we check whmapi exitcode if result != WhmApiRequest.API_RESULT_OK: raise WhmApiError( 'whmapi failed to execute request, reason: %(reason)s', reason=reason ) @staticmethod def _is_license_error(response): """ Distinguish license-related WHM API errors from others. License errors are on the client's side, and should not be logged to sentry. An error is considered license-related if the API returns status 0 and the error message contains the word 'license' """ return ('statusmsg' in response and response['status'] == 0 and 'license' in response['statusmsg'].lower()) @staticmethod def _is_no_php_binaries_error(response): """ No binaries error can be detected by checking special message '“PHP” is not installed on the system' whmapi output """ return ('metadata' in response and 'reason' in response['metadata'] and '“PHP” is not installed on the system' in response['metadata']['reason']) def with_arguments(self, **kwargs): """ Add some extra arguments to subprocess call Useful for methods l