Skip to content
This repository
Fetching contributors…

Cannot retrieve contributors at this time

file 119 lines (87 sloc) 2.97 kb
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119
= SEP-005: Detailed !ItemBuilder API use =

[[PageOutline(2-5,Contents)]]

||'''SEP:'''||5||
||'''Title:'''||!ItemBuilder API||
||'''Author:'''||Ismael Carnales, Pablo Hoffman||
||'''Created:'''||2009-07-24||
||'''Status'''||Obsoleted by [wiki:SEP-008]||

Item class for examples:

{{{
#!python
class NewsItem(Item):
    url = fields.TextField()
    headline = fields.TextField()
    content = fields.TextField()
    published = fields.DateField()
}}}

== Setting expanders ==

{{{
#!python
class NewsItemBuilder(ItemBuilder):
    item_class = NewsItem

    headline = reducers.Reducer(extract, remove_tags(), unquote(), strip)
}}}

This approach will override the Reducer class for !BuilderFields depending on their Item Field class:

 * !MultivaluedField = PassValue
 * !TextField = JoinStrings
 * other = TakeFirst

== Setting reducers ==

{{{
#!python
class NewsItemBuilder(ItemBuilder):
    item_class = NewsItem

    headline = reducers.TakeFirst(extract, remove_tags(), unquote(), strip)
    published = reducers.Reducer(extract, remove_tags(), unquote(), strip)
}}}

As with the previous example this would select join_strings as the reducer for content

== Setting expanders/reducers new way ==

{{{
#!python
class NewsItemBuilder(ItemBuilder):
    item_class = NewsItem

    headline = BuilderField(extract, remove_tags(), unquote(), strip)
    content = BuilderField(extract, remove_tags(), unquote(), strip)

    class Reducer:
        headline = TakeFirst
}}}

== Extending !ItemBuilder ==

{{{
#!python
class SiteNewsItemBuilder(NewsItemBuilder):
    published = reducers.Reducer(extract, remove_tags(), unquote(), strip, to_date('%d.%m.%Y'))
}}}

== Extending !ItemBuilder using statich methods ==

{{{
#!python
class SiteNewsItemBuilder(NewsItemBuilder):
    published = reducers.Reducer(NewsItemBuilder.published, to_date('%d.%m.%Y'))
}}}

== Using default_builder ==

{{{
#!python
class DefaultedNewsItemBuilder(ItemBuilder):
    item_class = NewsItem

    default_builder = reducers.Reducer(extract, remove_tags(), unquote(), strip)
}}}

This will use default_builder as the builder for every field in the item class.
As a reducer is not set reducers will be set based on Item Field classess.

== Reset default_builder for a field ==

{{{
#!python
class DefaultedNewsItemBuilder(ItemBuilder):
    item_class = NewsItem

    default_builder = reducers.Reducer(extract, remove_tags(), unquote(), strip)
    url = BuilderField()
}}}

== Extending default !ItemBuilder ==

{{{
#!python
class SiteNewsItemBuilder(NewsItemBuilder):
    published = reducers.Reducer(extract, remove_tags(), unquote(), strip, to_date('%d.%m.%Y'))
}}}

== Extending default !ItemBuilder using static methods ==

{{{
#!python
class SiteNewsItemBuilder(NewsItemBuilder):
    published = reducers.Reducer(NewsItemBuilder.default_builder, to_date('%d.%m.%Y'))
}}}
Something went wrong with that request. Please try again.