labpack/storage/appdata.py
def save(self, record_key, record_data, overwrite=True, secret_key=''):

        ''' 
            a method to create a record in the collection folder

        :param record_key: string with name to assign to record (see NOTES below)
        :param record_data: byte data for record body
        :param overwrite: [optional] boolean to overwrite records with same name
        :param secret_key: [optional] string with key to encrypt data
        :return: string with name of record

        NOTE:   record_key may only contain alphanumeric, /, _, . or -
                characters and may not begin with the . or / character.

        NOTE:   using one or more / characters splits the key into
                separate segments. these segments will appear as a
                sub directories inside the record collection and each
                segment is used as a separate index for that record
                when using the list method
                eg. lab/unittests/1473719695.2165067.json is indexed:
                [ 'lab', 'unittests', '1473719695.2165067', '.json' ]
        '''

        title = '%s.save' % self.__class__.__name__
            
    # validate inputs
        input_fields = {
            'record_key': record_key,
            'secret_key': secret_key
        }
        for key, value in input_fields.items():
            if value:
                object_title = '%s(%s=%s)' % (title, key, str(value))
                self.fields.validate(value, '.%s' % key, object_title)
    
    # validate byte data
        if not isinstance(record_data, bytes):
            raise ValueError('%s(record_data=b"...") must be byte data.' % title)
        
    # construct and validate file path
        file_path = os.path.join(self.collection_folder, record_key)
        file_path = self.fields.validate(file_path, '.record_key_path')
        file_root, file_name = os.path.split(file_path)
        self.fields.validate(file_name, '.record_key_comp')
        while file_root != self.collection_folder:
            file_root, path_node = os.path.split(file_root)
            self.fields.validate(path_node, '.record_key_comp')

    # check overwrite exception
        from os import path, makedirs
        if not overwrite:
            if path.exists(file_path):
                raise Exception('%s(record_key="%s") already exists. To overwrite, set overwrite=True' % (title, record_key))

    # create directories in path to file
        file_root, file_node = path.split(file_path)
        if file_root:
            if not path.exists(file_root):
                makedirs(file_root)
            
    # encrypt data
        if secret_key:
            from labpack.encryption import cryptolab
            record_data, secret_key = cryptolab.encrypt(record_data, secret_key)
    
    # save file
        with open(file_path, 'wb') as f:
            f.write(record_data)
            f.close()
    
    # erase file date from drep files
        import re
        if re.search('\\.drep$', file_name):
            from os import utime
            file_time = 1
            utime(file_path, times=(file_time, file_time))

        return record_key
 
            a method to create a record in the collection folder

        :param record_key: string with name to assign to record (see NOTES below)
        :param record_data: byte data for record body
        :param overwrite: [optional] boolean to overwrite records with same name
        :param secret_key: [optional] string with key to encrypt data
        :return: string with name of record

        NOTE:   record_key may only contain alphanumeric, /, _, . or -
                characters and may not begin with the . or / character.

        NOTE:   using one or more / characters splits the key into
                separate segments. these segments will appear as a
                sub directories inside the record collection and each
                segment is used as a separate index for that record
                when using the list method
                eg. lab/unittests/1473719695.2165067.json is indexed:
                [ 'lab', 'unittests', '1473719695.2165067', '.json' ]
        
a method to create a record in the collection folder
a method to create a record in the collection folder
def save(self, record_key, record_data, overwrite=True, secret_key=''):
        title = '%s.save' % self.__class__.__name__
        input_fields = {
            'record_key': record_key,
            'secret_key': secret_key
        }
        for key, value in input_fields.items():
            if value:
                object_title = '%s(%s=%s)' % (title, key, str(value))
                self.fields.validate(value, '.%s' % key, object_title)
        if not isinstance(record_data, bytes):
            raise ValueError('%s(record_data=b"...") must be byte data.' % title)
        file_path = os.path.join(self.collection_folder, record_key)
        file_path = self.fields.validate(file_path, '.record_key_path')
        file_root, file_name = os.path.split(file_path)
        self.fields.validate(file_name, '.record_key_comp')
        while file_root != self.collection_folder:
            file_root, path_node = os.path.split(file_root)
            self.fields.validate(path_node, '.record_key_comp')
        from os import path, makedirs
        if not overwrite:
            if path.exists(file_path):
                raise Exception('%s(record_key="%s") already exists. To overwrite, set overwrite=True' % (title, record_key))
        file_root, file_node = path.split(file_path)
        if file_root:
            if not path.exists(file_root):
                makedirs(file_root)
        if secret_key:
            from labpack.encryption import cryptolab
            record_data, secret_key = cryptolab.encrypt(record_data, secret_key)
        with open(file_path, 'wb') as f:
            f.write(record_data)
            f.close()
        import re
        if re.search('\\.drep$', file_name):
            from os import utime
            file_time = 1
            utime(file_path, times=(file_time, file_time))
        return record_key
def save ( self , record_key , record_data , overwrite = True , secret_key = '' ) : title = '%s.save' % self . __class__ . __name__ input_fields = { 'record_key' : record_key , 'secret_key' : secret_key } for key , value in input_fields . items ( ) : if value : object_title = '%s(%s=%s)' % ( title , key , str ( value ) ) self . fields . validate ( value , '.%s' % key , object_title ) if not isinstance ( record_data , bytes ) : raise ValueError ( '%s(record_data=b"...") must be byte data.' % title ) file_path = os . path . join ( self . collection_folder , record_key ) file_path = self . fields . validate ( file_path , '.record_key_path' ) file_root , file_name = os . path . split ( file_path ) self . fields . validate ( file_name , '.record_key_comp' ) while file_root != self . collection_folder : file_root , path_node = os . path . split ( file_root ) self . fields . validate ( path_node , '.record_key_comp' ) from os import path , makedirs if not overwrite : if path . exists ( file_path ) : raise Exception ( '%s(record_key="%s") already exists. To overwrite, set overwrite=True' % ( title , record_key ) ) file_root , file_node = path . split ( file_path ) if file_root : if not path . exists ( file_root ) : makedirs ( file_root ) if secret_key : from labpack . encryption import cryptolab record_data , secret_key = cryptolab . encrypt ( record_data , secret_key ) with open ( file_path , 'wb' ) as f : f . write ( record_data ) f . close ( ) import re if re . search ( '\\.drep$' , file_name ) : from os import utime file_time = 1 utime ( file_path , times = ( file_time , file_time ) ) return record_key
a method to create a record in the collection folder
a method to create a record in the collection folder
''' 
            a method to create a record in the collection folder

        :param record_key: string with name to assign to record (see NOTES below)
        :param record_data: byte data for record body
        :param overwrite: [optional] boolean to overwrite records with same name
        :param secret_key: [optional] string with key to encrypt data
        :return: string with name of record

        NOTE:   record_key may only contain alphanumeric, /, _, . or -
                characters and may not begin with the . or / character.

        NOTE:   using one or more / characters splits the key into
                separate segments. these segments will appear as a
                sub directories inside the record collection and each
                segment is used as a separate index for that record
                when using the list method
                eg. lab/unittests/1473719695.2165067.json is indexed:
                [ 'lab', 'unittests', '1473719695.2165067', '.json' ]
        ''' # validate inputs
 # validate byte data
 # construct and validate file path
 # check overwrite exception
 # create directories in path to file
 # encrypt data
 # save file
 # erase file date from drep files

string with name of record
NOTE:   record_key may only contain alphanumeric, /, _, . or
characters and may not begin with the . or / character.

using one or more / characters splits the key into
separate segments. these segments will appear as a
sub directories inside the record collection and each
segment is used as a separate index for that record
when using the list method
eg.
string with name of record NOTE : record_key may only contain alphanumeric / _ . or characters and may not begin with the . or / character . using one or more / characters splits the key into separate segments . these segments will appear as a sub directories inside the record collection and each segment is used as a separate index for that record when using the list method eg .
self
record_key
string with name to assign to record
string with name to assign to record
record_data
byte data for record body
byte data for record body
overwrite
[optional] boolean to overwrite records with same name
[ optional ] boolean to overwrite records with same name
secret_key
[optional] string with key to encrypt data
[ optional ] string with key to encrypt data