def get_notification_rules(**kwargs):
    ''' Get list of existing notification rules for the specified monitor '''
    required = ['monitorId', 'monitorType']
    optional = []

    get_args = validate_kwargs(required, optional, **kwargs)
    return get(action='getNotificationRules', **get_args)

def add_notification_rule(**kwargs):
    ''' Add a notification rule for monitor - contact pair '''
    required = ['monitorId', 'monitorType', 'period', 'notifyBackup',
                'continuousAlerts', 'failureCount']

    optional = ['weekdayFrom', 'weekdayTo', 'timeFrom', 'timeTo',
                'contactGroup', 'contactId', 'minFailedLocationCount',
                'paramName', 'paramValue', 'comparingMethod']

    post_args = validate_kwargs(required, optional, **kwargs)

    # paramName and paramValue are required when monitorType is custom
    if post_args.get('monitorType', None) is 'custom':
        if not (post_args.has_key('paramName') \
            and post_args.has_key('paramValue')):
            raise MonitisError('paramName and paramValue are required')
    # comparingMethod is required when paramName and paramValue are present
    if post_args.has_key('paramName') or post_args.has_key('paramValue'):
        if not post_args.has_key('comparingMethod'):
            raise MonitisError('comparingMethod is required')

    # either contact_group or contact_id must be specified
    if not (post_args.has_key('contactGroup') \
        or post_args.has_key('contactId')):
        raise MonitisError('Either contactName or contactGroup is required')

    return post(action='addNotificationRule', **post_args)

def edit_internal_ping_monitor(**kwargs):
    ''' Edit the specified Ping monitor '''
    required = ['testId']
    required.extend(common_required)
    optional = []
    req_args = validate_kwargs(required, optional, **kwargs)
    return post(action='editInternalPingMonitor', **req_args)

def add_page_module(**kwargs):
    ''' Add a module to the specified page. '''
    required = ['moduleName', 'pageId', 'column', 'row', 'dataModuleId']
    optional = ['height']

    req_args = validate_kwargs(required, optional, **kwargs)
    return post(action='addPageModule', **req_args)

def add_drive_monitor(**kwargs):
    ''' Add a new internal drive monitor '''
    required = ['agentkey', 'driveLetter']
    required.extend(common_required)
    optional = []
    req_args = validate_kwargs(required, optional, **kwargs)
    return post(action='addDriveMonitor', **req_args)

def edit_memory_monitor(**kwargs):
    """ Edit the specified memory monitor """
    required = ["testId"]
    required.extend(common_required)
    optional = ["freeLimit", "freeSwapLimit", "freeVirtualLimit", "bufferedLimit", "cachedLimit"]
    req_args = validate_kwargs(required, optional, **kwargs)
    return post(action="editMemoryMonitor", **req_args)

def confirm_contact(**kwargs):
    ''' Confirm the specified contact '''
    required = ['contactId', 'confirmationKey']
    optional = []

    post_args = validate_kwargs(required, optional, **kwargs)
    return post(action='confirmContact', **post_args)

def add_internal_ping_monitor(**kwargs):
    ''' Add a new internal ping monitor '''
    required = ['userAgentId', 'url']
    required.extend(common_required)
    optional = []
    req_args = validate_kwargs(required, optional, **kwargs)
    return post(action='addInternalPingMonitor', **req_args)

def add_memory_monitor(**kwargs):
    """ Add a new internal memory monitor """
    required = ["agentkey"]
    required.extend(common_required)
    optional = ["freeLimit", "freeSwapLimit", "freeVirtualLimit", "bufferedLimit", "cachedLimit"]
    req_args = validate_kwargs(required, optional, **kwargs)
    return post(action="addMemoryMonitor", **req_args)

def add_process_monitor(**kwargs):
    ''' Add a new internal process monitor '''
    required = ['agentkey', 'processName']
    required.extend(common_required)
    optional = []
    req_args = validate_kwargs(required, optional, **kwargs)
    return post(action='addProcessMonitor', **req_args)

def edit_process_monitor(**kwargs):
    ''' Edit the specified process monitor '''
    required = ['testId']
    required.extend(common_required)
    optional = []
    req_args = validate_kwargs(required, optional, **kwargs)
    return post(action='editProcessMonitor', **req_args)

def edit_internal_http_monitor(**kwargs):
    ''' Edit the specified http monitor '''
    required = ['testId', 'urlParams']
    required.extend(common_required)
    optional = []
    req_args = validate_kwargs(required, optional, **kwargs)
    return post(action='editInternalHttpMonitor', **req_args)

def edit_load_average_monitor(**kwargs):
    """ Edit the specified load monitor """
    required = ["testId"]
    required.extend(common_required)
    optional = []
    req_args = validate_kwargs(required, optional, **kwargs)
    return post(action="editLoadAverageMonitor", **req_args)

def add_load_average_monitor(**kwargs):
    """ Add a new internal load monitor """
    required = ["agentkey"]
    required.extend(common_required)
    optional = []
    req_args = validate_kwargs(required, optional, **kwargs)
    return post(action="addLoadAverageMonitor", **req_args)

def edit_agent(**kwargs):
    ''' Edit an existing custom agent '''
    required = {'name': 'name', 'agent_id': 'agentId'}
    optional = {'params': 'params'}

    req_args = validate_kwargs(required, optional, **kwargs)

    return post(action='editAgent', **req_args)

def edit_contact(**kwargs):
    '''  '''
    required = ['contactId']
    optional = ['firstName', 'lastName', 'account', 'contactType', 'timezone',
                'portable', 'code', 'country', 'textType']

    post_args = validate_kwargs(required, optional, **kwargs)
    return post(action='editContact', **post_args)

def agent_info(**kwargs):
    ''' Get information for the specified agent '''
    required = {'agent_id': 'agentId'}
    optional = {}

    req_args = validate_kwargs(required, optional, **kwargs)

    return get(action='agentInfo', **req_args)

def transaction_test_result(**kwargs):
    ''' Get results for the specified Transaction or
    Full Page Load monitor
    '''
    required = ['monitorId', 'year', 'month', 'day']
    optional = ['locationIds', 'timezone']
    req_args = validate_kwargs(required, optional, **kwargs)
    return get(action='transactionTestResult', **req_args)

def get_recent_alerts(**kwargs):
    ''' Get recent alerts history

    Start date and end date are in miliseconds since the Epoch'''
    required = []
    optional = ['timezone', 'startDate', 'endDate']
    post_args = validate_kwargs(required, optional, **kwargs)
    return get(action='recentAlerts', **post_args)

def add_agent(**kwargs):
    ''' Register a new custom agent in Monitis '''
    required = {'name': 'name'}
    optional = {'params': 'params'}

    req_args = validate_kwargs(required, optional, **kwargs)

    return post(action='addAgent', **req_args)