Magritte.md

Automate with Magritte

1. Meta-Describe the CSV Field You Care About

• Enable field mapping with anElementDesciption propertyAt: #csvFieldName put: aString. CSV fields which do not have a header corresponding to a Magritte #csvFieldName will be ignored.
• Customize CSV-to-object conversion via anElementDesciption propertyAt: #csvReader put: aValuable.

Example:

MyDomainClass>>#descriptionPhone
	<magritteDescription>
	^ MAStringDescription new
		accessor: #phone;
		propertyAt: #csvFieldName put: 'Phone';
		propertyAt: #csvReader put: [ :s | s select: #isDigit ];
		yourself

2. Read a CSV File

• The main entry point is MyDomainClass class>>#fromCSV: file.
• For exotic headers (i.e. not a single line with field names), override MyDomainClass class>>#readCSVHeaderWith:. You may for example want to skip irrevelant/blank lines).

Example:

file := self myFolder / 'myfile.csv'.
collectionOfMyDomainObjects := self fromCSV: file

where:

MyDomainClass class>>#readCSVHeaderWith: reader

	^ reader next; next; readHeader