U >Ke @sDddlZddlmZdddZdddZd gZGd d d ZdS) N)utilsz$Revision: 1.7 $ z$Date: 2007/02/11 09:05:49 $ DbfRecordc@seZdZdZdZd$ddZeddZd d Ze eZd d Z e e Z d%d dZ e e Z ddZ ddZ d&ddZddZddZddZddZddZd d!Zd"d#ZdS)'raDBF record. Instances of this class shouldn't be created manually, use `dbf.Dbf.newRecord` instead. Class implements mapping/sequence interface, so fields could be accessed via their names or indexes (names is a preferred way to access fields). Hint: Use `store` method to save modified record. Examples: Add new record to the database: db = Dbf(filename) rec = db.newRecord() rec["FIELD1"] = value1 rec["FIELD2"] = value2 rec.store() Or the same, but modify existed (second in this case) record: db = Dbf(filename) rec = db[2] rec["FIELD1"] = value1 rec["FIELD2"] = value2 rec.store() )dbfindexdeleted fieldDataNFcCs>||_||_||_|dkr0dd|jjD|_n t||_dS)a$Instance initialization. Arguments: dbf: A `Dbf.Dbf` instance this record belongs to. index: An integer record index or None. If this value is None, record will be appended to the DBF. deleted: Boolean flag indicating whether this record is a deleted record. data: A sequence or None. This is a data of the fields. If this argument is None, default values will be used. NcSsg|] }|jqS) defaultValue.0Z_fdr r @/tmp/pip-unpacked-wheel-5xrpv5dc/tablib/packages/dbfpy/record.py Qsz&DbfRecord.__init__..)rr r headerfieldsr list)selfrr r datar r r__init__;s zDbfRecord.__init__cCs|jjj|j|jjjSN)rr headerLengthr recordLengthrr r rVszDbfRecord.cCs,|j|jj||jj|j|jjS)aoReturn raw record contents read from the stream. Arguments: dbf: A `Dbf.Dbf` instance containing the record. index: Index of the record in the records' container. This argument can't be None in this call. Return value is a string containing record data in DBF format. )streamseekrrrreadclsrr r r r rawFromStreamYszDbfRecord.rawFromStreamcCs||||||S)a]Return a record read from the stream. Arguments: dbf: A `Dbf.Dbf` instance new record should belong to. index: Index of the record in the records' container. This argument can't be None in this call. Return value is an instance of the current class. ) fromStringr"r r r r fromStreamns zDbfRecord.fromStreamcs(|||ddkfdd|jjDS)aReturn record read from the string object. Arguments: dbf: A `Dbf.Dbf` instance new record should belong to. string: A string new record should be created from. index: Index of the record in the container. If this argument is None, record will be appended. Return value is an instance of the current class. r*csg|]}|qSr )ZdecodeFromRecordrstringr rrsz(DbfRecord.fromString..)rr)r!rr'r r r&rr#szDbfRecord.fromStringcCsvdtdd|jjD}g}|jjD]D}||}|tjkrR|||ddfq&||||t|fq&d|S)Nz%%%ds: %%s (%%s)css|]}t|VqdSr)len)r_fldr r r sz%DbfRecord.__repr__..Nonezvalue cannot be decoded )maxr fieldNamesrZ INVALID_VALUEappendtypejoin)r _templateZ_rvr)Z_valr r r__repr__s  zDbfRecord.__repr__cCsX|d|jj|j|jjt|t |j t |jkrT|jjddS)zWrite data to the dbf stream. Note: This isn't a public method, it's better to use 'store' instead publicly. Be design ``_write`` method should be called only from the `Dbf` instance. FN) _validateIndexrrrpositionwritebytestoStringsysgetfilesystemencodingr r(rr r r_writes zDbfRecord._writeTcCs\|jdkr|sXtdn@|jdkr2td|jn&|rX|j|jjjkrXtd|jjjdS)zValid ``self.index`` value. If ``allowUndefined`` argument is True functions does nothing in case of ``self.index`` pointing to None object. NzIndex is undefinedrzIndex can't be negative (%s)z$There are only %d records in the DBF)r ValueErrorrrZ recordCount)rZallowUndefinedZ checkRanger r rr5s   zDbfRecord._validateIndexcCs<||jdkr,t|j|_|j|n ||j|j<dS)zStore current record in the DBF. If ``self.index`` is None, this record will be appended to the records of the DBF this records belongs to; or replaced otherwise. N)r5r r(rr/rr r rstores   zDbfRecord.storecCs d|_dS)zMark method as deleted.TN)r rr r rdeleteszDbfRecord.deletecCs.dd|jgddt|jjj|jDS)z#Return string packed record values.z *cSsg|]\}}||qSr )Z encodeValue)rZ_defZ_datr r rrsz&DbfRecord.toString..)r1r ziprrrr rr r rr9szDbfRecord.toStringcCs|jddS)zReturn a flat list of fields. Note: Change of the list's values won't change real values stored in this object. N)r rr r rasListszDbfRecord.asListcCstddt|jj|jDS)zReturn a dictionary of fields. Note: Change of the dicts's values won't change real values stored in this object. cSsg|]}|qSr r )rZ_ir r rrsz$DbfRecord.asDict..)dictrArr.r rr r rasDictszDbfRecord.asDictcCs&t|tr|j|S|j|j|S)z*Return value by field name or field index. isinstanceintr rZindexOfFieldName)rkeyr r r __getitem__s  zDbfRecord.__getitem__cCs*t|tr|j|S||j|j|<dS)z=Set field value by integer index of the field or string name.NrE)rrHvaluer r r __setitem__s  zDbfRecord.__setitem__)NFN)N)TF)__name__ __module__ __qualname____doc__ __slots__rpropertyr6r" classmethodr$r#r3r<r5r>r?r9rBrDrIrKr r r rrs(       )r:r@r __version____date____all__rr r r rs