django-copybook 0.1.4

Convert Objects and Django models to/from fixed format records.

This app allows you to convert objects into fixed width records.

In version 0.1.0 we introduce an entirely new (albeit similar) interface that breaks all dependency on Django and removes the necessity of manually setting the order of fields. We call it ‘fixedwidth’.

Usage:

from djcopybook.fixedwidth import Record from djcopybook.fixedwidth import fields

class Person(Record):

first_name = fields.StringField(length=20) last_name = fields.StringField(length=30) siblings = fields.IntegerField(length=2) birth_date = fields.DateField(length=10, format=”%Y-%m-%d”)

>>> p = Person(first_name="Joe", last_name="Smith", siblings=3, birth_date="1982-09-11")
>>> p.birth_date
datetime.date(1982, 9, 11)
>>> p.to_record()
'Joe                 Smith                         031982-09-11'

You can also set attributes after a record has been instantiated, give fields default values, and other fun stuff.

When you have a record instance, the data values will always be their python value, and when you do a to_record on the Record as a whole or an individual field it will have the fixedwidth format.

New in version 0.1.2:

Convert records from a fixed width format back into record objects

USAGE:

class Person(Record):

first_name = fields.StringField(length=20) last_name = fields.StringField(length=30) siblings = fields.IntegerField(length=2) birth_date = fields.DateField(length=10, format=”%Y-%m-%d”)

>>> fixedwidth_record = 'Joe                 Smith                         031982-09-11'
>>> person = Person.from_record(fixedwidth_record)
>>> person.first_name
'Joe'
>>> person.last_name
'Smith'
>>> person.siblings
3
>>> person.birth_date
datetime.date(1982, 9, 11)

New in version 0.1.1:

ListField: lets you have one field whose values are made of another complete record. Similar to COBOL’s OCCURS functionality. Declaring length on the ListField tells how many times that record repeats.

USAGE:

class PhoneNumber(Record):

identifier = fields.StringField(length=10, default=”Mobile”) area_code = fields.IntegerField(length=3) prefix = fields.IntegerField(length=3) suffix = fields.IntegerField(length=4)

class Person(Record):

first_name = fields.StringField(length=20) last_name = fields.StringField(length=30) siblings = fields.IntegerField(length=2) birth_date = fields.DateField(length=10, format=”%Y-%m-%d”) phone_numbers = fields.ListField(record=PhoneNumber, length=3)

>>> phone_one = PhoneNumber(area_code=515, prefix=555, suffix=2222)
>>> person = Person(first_name="Joe", last_name="Smith", siblings=3,
               birth_date="1982-09-11", phone_numbers=[phone_one])

>>> person.to_record()
'Joe                 Smith                         031982-09-11Mobile    [phone]Mobile    [phone]Mobile    [phone]'

Notes:

Because we are using OrderedDict, the new fixedwidth implementation will only work on Python 2.7 and above. (you can copy the OrderdDict class yourself if you need < 2.7)

The previous Django model implementation is pending deprecation.