class SingleAPISpec:
    """
    Convenience class used to help DataverseAPILink when making API functions
    """
    
    ATTR_NAMES = ['new_function_name', 'name', 'url_path', 'use_api_key', 'num_id_vals', 'use_param_dict']
    URL_PLACEHOLDER = '{{ID_VAL}}'
    
    def __init__(self, spec_list):
        if not type(spec_list) in (list,tuple):
            raise Exception('Bad spec.  Expected list or tuple.\nReceived: %s' % type(spec_list))
            
        num_params = len(spec_list)    
        if not num_params in (5,6):
            raise Exception('Expected 5 or 6 values.\nReceived: %s' % spec_list)

        # Lazy way to add attributes
        for idx, attr in enumerate(self.ATTR_NAMES):
            if (idx) == num_params:
                self.__dict__[attr] = None          # only 5 params given, param_dict not needed
            else:
                self.__dict__[attr] = spec_list[idx]                
                # e.g., 1st iteration is equivalent of "self.new_function_name = spec_list[0]"
            
            
    def get_code_str(self, dv_link_function_to_call='make_api_get_call'):
        """
        Used to create functions within the DataverseAPILink class
        """
        if self.use_param_dict is True:
            # call_name, url_path, use_api_key=False, id_val=None, params_dict={}
            code_str = """
def %s(self, param_dict, *args):
    url_path = '%s'
    if args:
        for val in args:
            if not type(val) in (str, unicode):
                val = `val`
            url_path = url_path.replace('%s', val, 1)
        #url_path += '/' + str(id_val)
    print 'OK!'
    print 'param_dict', param_dict
    return self.%s('%s', url_path, %s, None, param_dict)""" \
                            % (self.new_function_name\
                                , self.url_path
                                , SingleAPISpec.URL_PLACEHOLDER
                                , dv_link_function_to_call
                                , self.name
                                , self.use_api_key)

        else:
            code_str = """
def %s(self, *args):
    url_path = '%s'
    if args:
        for val in args:
            if not type(val) in (str, unicode):
                val = `val`
            url_path = url_path.replace('%s', val, 1)
        #url_path += '/' + str(id_val)

    return self.%s('%s', url_path, %s)""" \
                            % (self.new_function_name\
                                , self.url_path
                                , SingleAPISpec.URL_PLACEHOLDER
                                , dv_link_function_to_call
                                , self.name
                                , self.use_api_key)
        print code_str
        return code_str