Skip to content

Blocks

hypha.apply.funds.blocks

REQUIRED_BLOCK_NAMES module-attribute 

REQUIRED_BLOCK_NAMES = [block.name for block in ApplicationMustIncludeFieldBlock.__subclasses__()]

SINGLE_BLOCK_NAMES module-attribute 

SINGLE_BLOCK_NAMES = [block.name for block in ApplicationSingleIncludeFieldBlock.__subclasses__()]

NAMED_BLOCKS module-attribute 

NAMED_BLOCKS = REQUIRED_BLOCK_NAMES + SINGLE_BLOCK_NAMES

LocalizedFloatField

Bases: FloatField

FloatField that accepts locale-formatted numbers without relying on the active locale. Assumes at most two decimal places (no cents sub-divisions), which makes the separator role unambiguous:

  • Both . and , present: whichever comes last is the decimal separator.
  • Single separator with exactly 3 digits after it: thousands separator.
  • Single separator with 1 or 2 digits after it: decimal separator.
  • Multiple identical separators: all are thousands separators.

to_python 

to_python(value)
Source code in hypha/apply/funds/blocks.py 
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
def to_python(self, value):
    if value not in self.empty_values:
        # Remove all spaces.
        value = str(value).strip().replace(" ", "")
        has_dot = "." in value
        has_comma = "," in value

        if has_dot and has_comma:
            # Both present — whichever appears last is the decimal.
            if value.rfind(".") > value.rfind(","):
                value = value.replace(",", "")  # e.g. "1,000.50" (comma-thousands)
            else:
                value = value.replace(".", "").replace(
                    ",", "."
                )  # e.g. "1.000,50" (dot-thousands)
        elif has_comma:
            parts = value.split(",")
            if len(parts) > 2 or len(parts[1]) == 3:
                value = value.replace(
                    ",", ""
                )  # e.g. "10,000" or "1,000,000" (comma-thousands)
            else:
                value = value.replace(
                    ",", "."
                )  # e.g. "10000,00" or "1,5" (comma-decimal)
        elif has_dot:
            parts = value.split(".")
            if len(parts) > 2 or len(parts[1]) == 3:
                value = value.replace(
                    ".", ""
                )  # e.g. "10.000" or "1.000.000" (dot-thousands)
            # else: already a valid decimal, e.g. "10.5" or "10.00" (dot-decimal)

    result = super().to_python(value)
    if result is not None and result == int(result):
        return int(result)
    return result

prepare_value 

prepare_value(value)
Source code in hypha/apply/funds/blocks.py 
73
74
75
76
77
78
79
80
81
def prepare_value(self, value):
    # Format a stored numeric value using the active locale's decimal
    # separator so the widget displays e.g. "10000,5" in comma-decimal
    # locales rather than the Python default "10000.5". String values
    # (mid-form re-display after a validation error) are returned unchanged.
    if isinstance(value, float):
        decimal_sep = get_format("DECIMAL_SEPARATOR")
        return str(value).replace(".", decimal_sep)
    return value

ApplicationSingleIncludeFieldBlock 

ApplicationSingleIncludeFieldBlock(*args, **kwargs)

Bases: SingleIncludeBlock

Source code in hypha/apply/utils/blocks.py 
214
215
216
217
218
219
220
221
def __init__(self, *args, **kwargs):
    info_name = _("{} Field").format(
        self._meta_class.label if self._meta_class.label else self.name.title()
    )
    child_blocks = [
        ("info", SingleIncludeStatic(label=info_name, description=self.description))
    ]
    super().__init__(child_blocks, *args, **kwargs)

field_label class-attribute instance-attribute 

field_label = CharBlock(label=_('Label'))

help_text class-attribute instance-attribute 

help_text = RichTextBlock(required=False, label=_('Help text'))

field_class class-attribute instance-attribute 

field_class = forms.CharField

widget class-attribute instance-attribute 

widget = None

required class-attribute instance-attribute 

required = BooleanBlock(label=_('Required'), required=False)

Meta

template class-attribute instance-attribute 
template = 'stream_forms/render_field.html'

get_slug 

get_slug(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
45
46
def get_slug(self, struct_value):
    return force_str(slugify(anyascii(struct_value["field_label"])))

get_field_class 

get_field_class(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
48
49
def get_field_class(self, struct_value):
    return self.field_class

get_widget 

get_widget(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
51
52
def get_widget(self, struct_value):
    return self.widget

get_field_kwargs 

get_field_kwargs(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
54
55
56
57
58
59
60
61
62
63
64
65
def get_field_kwargs(self, struct_value):
    kwargs = {
        "label": struct_value["field_label"],
        "help_text": conditional_escape(struct_value["help_text"]),
        "required": struct_value.get("required", False),
    }
    if "default_value" in struct_value:
        kwargs["initial"] = struct_value["default_value"]
    form_widget = self.get_widget(struct_value)
    if form_widget is not None:
        kwargs["widget"] = form_widget
    return kwargs

get_field 

get_field(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
67
68
69
def get_field(self, struct_value):
    field_kwargs = self.get_field_kwargs(struct_value)
    return self.get_field_class(struct_value)(**field_kwargs)

decode 

decode(value)

Convert JSON representation into actual python objects

Source code in hypha/apply/stream_forms/blocks.py 
71
72
73
def decode(self, value):
    """Convert JSON representation into actual python objects"""
    return value

serialize 

serialize(value, context)
Source code in hypha/apply/stream_forms/blocks.py 
75
76
77
78
79
80
81
def serialize(self, value, context):
    field_kwargs = self.get_field_kwargs(value)
    return {
        "question": field_kwargs["label"],
        "answer": context.get("data"),
        "type": self.name,
    }

serialize_no_response 

serialize_no_response(value, context)
Source code in hypha/apply/stream_forms/blocks.py 
83
84
85
86
87
88
def serialize_no_response(self, value, context):
    return {
        "question": value["field_label"],
        "answer": "-",
        "type": "no_response",
    }

prepare_data 

prepare_data(value, data, serialize=False)
Source code in hypha/apply/stream_forms/blocks.py 
90
91
def prepare_data(self, value, data, serialize=False):
    return nh3_value(str(data))

render 

render(value, context)
Source code in hypha/apply/stream_forms/blocks.py 
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
def render(self, value, context):
    data = context.get("data")
    data = self.prepare_data(value, data, context.get("serialize", False))

    context.update(data=data or self.no_response())

    if context.get("serialize"):
        if not data:
            return self.serialize_no_response(value, context)
        return self.serialize(value, context)

    return super().render(value, context)

get_searchable_content 

get_searchable_content(value, data)
Source code in hypha/apply/stream_forms/blocks.py 
106
107
def get_searchable_content(self, value, data):
    return str(data)

no_response 

no_response()
Source code in hypha/apply/stream_forms/blocks.py 
109
110
def no_response(self):
    return "-"

ApplicationMustIncludeFieldBlock 

ApplicationMustIncludeFieldBlock(*args, **kwargs)

Bases: MustIncludeFieldBlock

Source code in hypha/apply/utils/blocks.py 
214
215
216
217
218
219
220
221
def __init__(self, *args, **kwargs):
    info_name = _("{} Field").format(
        self._meta_class.label if self._meta_class.label else self.name.title()
    )
    child_blocks = [
        ("info", SingleIncludeStatic(label=info_name, description=self.description))
    ]
    super().__init__(child_blocks, *args, **kwargs)

field_label class-attribute instance-attribute 

field_label = CharBlock(label=_('Label'))

help_text class-attribute instance-attribute 

help_text = RichTextBlock(required=False, label=_('Help text'))

field_class class-attribute instance-attribute 

field_class = forms.CharField

widget class-attribute instance-attribute 

widget = None

Meta

template class-attribute instance-attribute 
template = 'stream_forms/render_field.html'

get_slug 

get_slug(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
45
46
def get_slug(self, struct_value):
    return force_str(slugify(anyascii(struct_value["field_label"])))

get_field_class 

get_field_class(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
48
49
def get_field_class(self, struct_value):
    return self.field_class

get_widget 

get_widget(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
51
52
def get_widget(self, struct_value):
    return self.widget

get_field_kwargs 

get_field_kwargs(struct_value)
Source code in hypha/apply/utils/blocks.py 
233
234
235
236
def get_field_kwargs(self, struct_value):
    kwargs = super().get_field_kwargs(struct_value)
    kwargs["required"] = True
    return kwargs

get_field 

get_field(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
67
68
69
def get_field(self, struct_value):
    field_kwargs = self.get_field_kwargs(struct_value)
    return self.get_field_class(struct_value)(**field_kwargs)

decode 

decode(value)

Convert JSON representation into actual python objects

Source code in hypha/apply/stream_forms/blocks.py 
71
72
73
def decode(self, value):
    """Convert JSON representation into actual python objects"""
    return value

serialize 

serialize(value, context)
Source code in hypha/apply/stream_forms/blocks.py 
75
76
77
78
79
80
81
def serialize(self, value, context):
    field_kwargs = self.get_field_kwargs(value)
    return {
        "question": field_kwargs["label"],
        "answer": context.get("data"),
        "type": self.name,
    }

serialize_no_response 

serialize_no_response(value, context)
Source code in hypha/apply/stream_forms/blocks.py 
83
84
85
86
87
88
def serialize_no_response(self, value, context):
    return {
        "question": value["field_label"],
        "answer": "-",
        "type": "no_response",
    }

prepare_data 

prepare_data(value, data, serialize=False)
Source code in hypha/apply/stream_forms/blocks.py 
90
91
def prepare_data(self, value, data, serialize=False):
    return nh3_value(str(data))

render 

render(value, context)
Source code in hypha/apply/stream_forms/blocks.py 
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
def render(self, value, context):
    data = context.get("data")
    data = self.prepare_data(value, data, context.get("serialize", False))

    context.update(data=data or self.no_response())

    if context.get("serialize"):
        if not data:
            return self.serialize_no_response(value, context)
        return self.serialize(value, context)

    return super().render(value, context)

get_searchable_content 

get_searchable_content(value, data)
Source code in hypha/apply/stream_forms/blocks.py 
106
107
def get_searchable_content(self, value, data):
    return str(data)

no_response 

no_response()
Source code in hypha/apply/stream_forms/blocks.py 
109
110
def no_response(self):
    return "-"

TitleBlock 

TitleBlock(*args, **kwargs)

Bases: ApplicationMustIncludeFieldBlock

Source code in hypha/apply/utils/blocks.py 
214
215
216
217
218
219
220
221
def __init__(self, *args, **kwargs):
    info_name = _("{} Field").format(
        self._meta_class.label if self._meta_class.label else self.name.title()
    )
    child_blocks = [
        ("info", SingleIncludeStatic(label=info_name, description=self.description))
    ]
    super().__init__(child_blocks, *args, **kwargs)

name class-attribute instance-attribute 

name = 'title'

description class-attribute instance-attribute 

description = _('The title of the project')

field_label class-attribute instance-attribute 

field_label = blocks.CharBlock(label=_('Label'), default=_('What is the title of your application?'))

help_text class-attribute instance-attribute 

help_text = blocks.RichTextBlock(required=False, label=_('Help text'), default=_('This project name can be changed if a full proposal is requested.'))

max_length class-attribute instance-attribute 

max_length = blocks.IntegerBlock(required=False, label=_('Max length'))

field_class class-attribute instance-attribute 

field_class = forms.CharField

widget class-attribute instance-attribute 

widget = None

Meta

label class-attribute instance-attribute 
label = _('Application title')
icon class-attribute instance-attribute 
icon = 'tag'

get_field_kwargs 

get_field_kwargs(struct_value)
Source code in hypha/apply/funds/blocks.py 
109
110
111
112
def get_field_kwargs(self, struct_value):
    kwargs = super().get_field_kwargs(struct_value)
    kwargs["max_length"] = struct_value["max_length"]
    return kwargs

get_slug 

get_slug(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
45
46
def get_slug(self, struct_value):
    return force_str(slugify(anyascii(struct_value["field_label"])))

get_field_class 

get_field_class(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
48
49
def get_field_class(self, struct_value):
    return self.field_class

get_widget 

get_widget(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
51
52
def get_widget(self, struct_value):
    return self.widget

get_field 

get_field(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
67
68
69
def get_field(self, struct_value):
    field_kwargs = self.get_field_kwargs(struct_value)
    return self.get_field_class(struct_value)(**field_kwargs)

decode 

decode(value)

Convert JSON representation into actual python objects

Source code in hypha/apply/stream_forms/blocks.py 
71
72
73
def decode(self, value):
    """Convert JSON representation into actual python objects"""
    return value

serialize 

serialize(value, context)
Source code in hypha/apply/stream_forms/blocks.py 
75
76
77
78
79
80
81
def serialize(self, value, context):
    field_kwargs = self.get_field_kwargs(value)
    return {
        "question": field_kwargs["label"],
        "answer": context.get("data"),
        "type": self.name,
    }

serialize_no_response 

serialize_no_response(value, context)
Source code in hypha/apply/stream_forms/blocks.py 
83
84
85
86
87
88
def serialize_no_response(self, value, context):
    return {
        "question": value["field_label"],
        "answer": "-",
        "type": "no_response",
    }

prepare_data 

prepare_data(value, data, serialize=False)
Source code in hypha/apply/stream_forms/blocks.py 
90
91
def prepare_data(self, value, data, serialize=False):
    return nh3_value(str(data))

render 

render(value, context)
Source code in hypha/apply/stream_forms/blocks.py 
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
def render(self, value, context):
    data = context.get("data")
    data = self.prepare_data(value, data, context.get("serialize", False))

    context.update(data=data or self.no_response())

    if context.get("serialize"):
        if not data:
            return self.serialize_no_response(value, context)
        return self.serialize(value, context)

    return super().render(value, context)

get_searchable_content 

get_searchable_content(value, data)
Source code in hypha/apply/stream_forms/blocks.py 
106
107
def get_searchable_content(self, value, data):
    return str(data)

no_response 

no_response()
Source code in hypha/apply/stream_forms/blocks.py 
109
110
def no_response(self):
    return "-"

ValueBlock 

ValueBlock(*args, **kwargs)

Bases: ApplicationSingleIncludeFieldBlock

Source code in hypha/apply/utils/blocks.py 
214
215
216
217
218
219
220
221
def __init__(self, *args, **kwargs):
    info_name = _("{} Field").format(
        self._meta_class.label if self._meta_class.label else self.name.title()
    )
    child_blocks = [
        ("info", SingleIncludeStatic(label=info_name, description=self.description))
    ]
    super().__init__(child_blocks, *args, **kwargs)

name class-attribute instance-attribute 

name = 'value'

description class-attribute instance-attribute 

description = _('The value of the project')

widget class-attribute instance-attribute 

widget = forms.TextInput(attrs={'inputmode': 'decimal'})

field_class class-attribute instance-attribute 

field_class = LocalizedFloatField

field_label class-attribute instance-attribute 

field_label = CharBlock(label=_('Label'))

help_text class-attribute instance-attribute 

help_text = RichTextBlock(required=False, label=_('Help text'))

required class-attribute instance-attribute 

required = BooleanBlock(label=_('Required'), required=False)

Meta

label class-attribute instance-attribute 
label = _('Requested amount')
icon class-attribute instance-attribute 
icon = 'decimal'

get_field_kwargs 

get_field_kwargs(struct_value)
Source code in hypha/apply/funds/blocks.py 
129
130
131
132
def get_field_kwargs(self, struct_value):
    kwargs = super().get_field_kwargs(struct_value)
    kwargs["min_value"] = 0
    return kwargs

prepare_data 

prepare_data(value, data, serialize)
Source code in hypha/apply/funds/blocks.py 
134
135
136
137
def prepare_data(self, value, data, serialize):
    if not data:
        return data
    return format_number_as_currency(str(data))

get_slug 

get_slug(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
45
46
def get_slug(self, struct_value):
    return force_str(slugify(anyascii(struct_value["field_label"])))

get_field_class 

get_field_class(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
48
49
def get_field_class(self, struct_value):
    return self.field_class

get_widget 

get_widget(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
51
52
def get_widget(self, struct_value):
    return self.widget

get_field 

get_field(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
67
68
69
def get_field(self, struct_value):
    field_kwargs = self.get_field_kwargs(struct_value)
    return self.get_field_class(struct_value)(**field_kwargs)

decode 

decode(value)

Convert JSON representation into actual python objects

Source code in hypha/apply/stream_forms/blocks.py 
71
72
73
def decode(self, value):
    """Convert JSON representation into actual python objects"""
    return value

serialize 

serialize(value, context)
Source code in hypha/apply/stream_forms/blocks.py 
75
76
77
78
79
80
81
def serialize(self, value, context):
    field_kwargs = self.get_field_kwargs(value)
    return {
        "question": field_kwargs["label"],
        "answer": context.get("data"),
        "type": self.name,
    }

serialize_no_response 

serialize_no_response(value, context)
Source code in hypha/apply/stream_forms/blocks.py 
83
84
85
86
87
88
def serialize_no_response(self, value, context):
    return {
        "question": value["field_label"],
        "answer": "-",
        "type": "no_response",
    }

render 

render(value, context)
Source code in hypha/apply/stream_forms/blocks.py 
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
def render(self, value, context):
    data = context.get("data")
    data = self.prepare_data(value, data, context.get("serialize", False))

    context.update(data=data or self.no_response())

    if context.get("serialize"):
        if not data:
            return self.serialize_no_response(value, context)
        return self.serialize(value, context)

    return super().render(value, context)

get_searchable_content 

get_searchable_content(value, data)
Source code in hypha/apply/stream_forms/blocks.py 
106
107
def get_searchable_content(self, value, data):
    return str(data)

no_response 

no_response()
Source code in hypha/apply/stream_forms/blocks.py 
109
110
def no_response(self):
    return "-"

OrganizationNameBlock 

OrganizationNameBlock(*args, **kwargs)

Bases: ApplicationSingleIncludeFieldBlock

Source code in hypha/apply/utils/blocks.py 
214
215
216
217
218
219
220
221
def __init__(self, *args, **kwargs):
    info_name = _("{} Field").format(
        self._meta_class.label if self._meta_class.label else self.name.title()
    )
    child_blocks = [
        ("info", SingleIncludeStatic(label=info_name, description=self.description))
    ]
    super().__init__(child_blocks, *args, **kwargs)

name class-attribute instance-attribute 

name = 'organization_name'

description class-attribute instance-attribute 

description = _('The name of the organization')

widget class-attribute instance-attribute 

widget = forms.TextInput()

field_label class-attribute instance-attribute 

field_label = CharBlock(label=_('Label'))

help_text class-attribute instance-attribute 

help_text = RichTextBlock(required=False, label=_('Help text'))

field_class class-attribute instance-attribute 

field_class = forms.CharField

required class-attribute instance-attribute 

required = BooleanBlock(label=_('Required'), required=False)

Meta

label class-attribute instance-attribute 
label = _('Organization name')

get_slug 

get_slug(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
45
46
def get_slug(self, struct_value):
    return force_str(slugify(anyascii(struct_value["field_label"])))

get_field_class 

get_field_class(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
48
49
def get_field_class(self, struct_value):
    return self.field_class

get_widget 

get_widget(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
51
52
def get_widget(self, struct_value):
    return self.widget

get_field_kwargs 

get_field_kwargs(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
54
55
56
57
58
59
60
61
62
63
64
65
def get_field_kwargs(self, struct_value):
    kwargs = {
        "label": struct_value["field_label"],
        "help_text": conditional_escape(struct_value["help_text"]),
        "required": struct_value.get("required", False),
    }
    if "default_value" in struct_value:
        kwargs["initial"] = struct_value["default_value"]
    form_widget = self.get_widget(struct_value)
    if form_widget is not None:
        kwargs["widget"] = form_widget
    return kwargs

get_field 

get_field(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
67
68
69
def get_field(self, struct_value):
    field_kwargs = self.get_field_kwargs(struct_value)
    return self.get_field_class(struct_value)(**field_kwargs)

decode 

decode(value)

Convert JSON representation into actual python objects

Source code in hypha/apply/stream_forms/blocks.py 
71
72
73
def decode(self, value):
    """Convert JSON representation into actual python objects"""
    return value

serialize 

serialize(value, context)
Source code in hypha/apply/stream_forms/blocks.py 
75
76
77
78
79
80
81
def serialize(self, value, context):
    field_kwargs = self.get_field_kwargs(value)
    return {
        "question": field_kwargs["label"],
        "answer": context.get("data"),
        "type": self.name,
    }

serialize_no_response 

serialize_no_response(value, context)
Source code in hypha/apply/stream_forms/blocks.py 
83
84
85
86
87
88
def serialize_no_response(self, value, context):
    return {
        "question": value["field_label"],
        "answer": "-",
        "type": "no_response",
    }

prepare_data 

prepare_data(value, data, serialize=False)
Source code in hypha/apply/stream_forms/blocks.py 
90
91
def prepare_data(self, value, data, serialize=False):
    return nh3_value(str(data))

render 

render(value, context)
Source code in hypha/apply/stream_forms/blocks.py 
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
def render(self, value, context):
    data = context.get("data")
    data = self.prepare_data(value, data, context.get("serialize", False))

    context.update(data=data or self.no_response())

    if context.get("serialize"):
        if not data:
            return self.serialize_no_response(value, context)
        return self.serialize(value, context)

    return super().render(value, context)

get_searchable_content 

get_searchable_content(value, data)
Source code in hypha/apply/stream_forms/blocks.py 
106
107
def get_searchable_content(self, value, data):
    return str(data)

no_response 

no_response()
Source code in hypha/apply/stream_forms/blocks.py 
109
110
def no_response(self):
    return "-"

EmailBlock 

EmailBlock(*args, **kwargs)

Bases: ApplicationMustIncludeFieldBlock

Source code in hypha/apply/utils/blocks.py 
214
215
216
217
218
219
220
221
def __init__(self, *args, **kwargs):
    info_name = _("{} Field").format(
        self._meta_class.label if self._meta_class.label else self.name.title()
    )
    child_blocks = [
        ("info", SingleIncludeStatic(label=info_name, description=self.description))
    ]
    super().__init__(child_blocks, *args, **kwargs)

name class-attribute instance-attribute 

name = 'email'

description class-attribute instance-attribute 

description = _('The applicant email address')

field_label class-attribute instance-attribute 

field_label = blocks.CharBlock(label=_('Label'), default=_('What email address should we use to contact you?'))

help_text class-attribute instance-attribute 

help_text = blocks.RichTextBlock(required=False, label=_('Help text'), default=_('We will use this email address to communicate with you about your proposal.'))

widget class-attribute instance-attribute 

widget = forms.EmailInput

field_class class-attribute instance-attribute 

field_class = forms.EmailField

Meta

icon class-attribute instance-attribute 
icon = 'mail'

get_slug 

get_slug(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
45
46
def get_slug(self, struct_value):
    return force_str(slugify(anyascii(struct_value["field_label"])))

get_field_class 

get_field_class(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
48
49
def get_field_class(self, struct_value):
    return self.field_class

get_widget 

get_widget(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
51
52
def get_widget(self, struct_value):
    return self.widget

get_field_kwargs 

get_field_kwargs(struct_value)
Source code in hypha/apply/utils/blocks.py 
233
234
235
236
def get_field_kwargs(self, struct_value):
    kwargs = super().get_field_kwargs(struct_value)
    kwargs["required"] = True
    return kwargs

get_field 

get_field(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
67
68
69
def get_field(self, struct_value):
    field_kwargs = self.get_field_kwargs(struct_value)
    return self.get_field_class(struct_value)(**field_kwargs)

decode 

decode(value)

Convert JSON representation into actual python objects

Source code in hypha/apply/stream_forms/blocks.py 
71
72
73
def decode(self, value):
    """Convert JSON representation into actual python objects"""
    return value

serialize 

serialize(value, context)
Source code in hypha/apply/stream_forms/blocks.py 
75
76
77
78
79
80
81
def serialize(self, value, context):
    field_kwargs = self.get_field_kwargs(value)
    return {
        "question": field_kwargs["label"],
        "answer": context.get("data"),
        "type": self.name,
    }

serialize_no_response 

serialize_no_response(value, context)
Source code in hypha/apply/stream_forms/blocks.py 
83
84
85
86
87
88
def serialize_no_response(self, value, context):
    return {
        "question": value["field_label"],
        "answer": "-",
        "type": "no_response",
    }

prepare_data 

prepare_data(value, data, serialize=False)
Source code in hypha/apply/stream_forms/blocks.py 
90
91
def prepare_data(self, value, data, serialize=False):
    return nh3_value(str(data))

render 

render(value, context)
Source code in hypha/apply/stream_forms/blocks.py 
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
def render(self, value, context):
    data = context.get("data")
    data = self.prepare_data(value, data, context.get("serialize", False))

    context.update(data=data or self.no_response())

    if context.get("serialize"):
        if not data:
            return self.serialize_no_response(value, context)
        return self.serialize(value, context)

    return super().render(value, context)

get_searchable_content 

get_searchable_content(value, data)
Source code in hypha/apply/stream_forms/blocks.py 
106
107
def get_searchable_content(self, value, data):
    return str(data)

no_response 

no_response()
Source code in hypha/apply/stream_forms/blocks.py 
109
110
def no_response(self):
    return "-"

AddressFieldBlock 

AddressFieldBlock(*args, **kwargs)

Bases: ApplicationSingleIncludeFieldBlock

Source code in hypha/apply/utils/blocks.py 
214
215
216
217
218
219
220
221
def __init__(self, *args, **kwargs):
    info_name = _("{} Field").format(
        self._meta_class.label if self._meta_class.label else self.name.title()
    )
    child_blocks = [
        ("info", SingleIncludeStatic(label=info_name, description=self.description))
    ]
    super().__init__(child_blocks, *args, **kwargs)

name class-attribute instance-attribute 

name = 'address'

description class-attribute instance-attribute 

description = _('The postal address of the user')

field_class class-attribute instance-attribute 

field_class = AddressField

field_label class-attribute instance-attribute 

field_label = CharBlock(label=_('Label'))

help_text class-attribute instance-attribute 

help_text = RichTextBlock(required=False, label=_('Help text'))

widget class-attribute instance-attribute 

widget = None

required class-attribute instance-attribute 

required = BooleanBlock(label=_('Required'), required=False)

Meta

label class-attribute instance-attribute 
label = _('Address')
icon class-attribute instance-attribute 
icon = 'home'

format_data 

format_data(data)
Source code in hypha/apply/funds/blocks.py 
180
181
182
def format_data(self, data):
    # Based on the fields listed in addressfields/widgets.py
    return ", ".join(data[field] for field in ADDRESS_FIELDS_ORDER if data[field])

prepare_data 

prepare_data(value, data, serialize)
Source code in hypha/apply/funds/blocks.py 
184
185
186
187
188
189
190
191
192
193
def prepare_data(self, value, data, serialize):
    if not data:
        return data
    data = json.loads(data)
    data = {field: data[field] for field in ADDRESS_FIELDS_ORDER}

    if serialize:
        return data

    return ", ".join(value for value in data.values() if value)

get_slug 

get_slug(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
45
46
def get_slug(self, struct_value):
    return force_str(slugify(anyascii(struct_value["field_label"])))

get_field_class 

get_field_class(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
48
49
def get_field_class(self, struct_value):
    return self.field_class

get_widget 

get_widget(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
51
52
def get_widget(self, struct_value):
    return self.widget

get_field_kwargs 

get_field_kwargs(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
54
55
56
57
58
59
60
61
62
63
64
65
def get_field_kwargs(self, struct_value):
    kwargs = {
        "label": struct_value["field_label"],
        "help_text": conditional_escape(struct_value["help_text"]),
        "required": struct_value.get("required", False),
    }
    if "default_value" in struct_value:
        kwargs["initial"] = struct_value["default_value"]
    form_widget = self.get_widget(struct_value)
    if form_widget is not None:
        kwargs["widget"] = form_widget
    return kwargs

get_field 

get_field(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
67
68
69
def get_field(self, struct_value):
    field_kwargs = self.get_field_kwargs(struct_value)
    return self.get_field_class(struct_value)(**field_kwargs)

decode 

decode(value)

Convert JSON representation into actual python objects

Source code in hypha/apply/stream_forms/blocks.py 
71
72
73
def decode(self, value):
    """Convert JSON representation into actual python objects"""
    return value

serialize 

serialize(value, context)
Source code in hypha/apply/stream_forms/blocks.py 
75
76
77
78
79
80
81
def serialize(self, value, context):
    field_kwargs = self.get_field_kwargs(value)
    return {
        "question": field_kwargs["label"],
        "answer": context.get("data"),
        "type": self.name,
    }

serialize_no_response 

serialize_no_response(value, context)
Source code in hypha/apply/stream_forms/blocks.py 
83
84
85
86
87
88
def serialize_no_response(self, value, context):
    return {
        "question": value["field_label"],
        "answer": "-",
        "type": "no_response",
    }

render 

render(value, context)
Source code in hypha/apply/stream_forms/blocks.py 
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
def render(self, value, context):
    data = context.get("data")
    data = self.prepare_data(value, data, context.get("serialize", False))

    context.update(data=data or self.no_response())

    if context.get("serialize"):
        if not data:
            return self.serialize_no_response(value, context)
        return self.serialize(value, context)

    return super().render(value, context)

get_searchable_content 

get_searchable_content(value, data)
Source code in hypha/apply/stream_forms/blocks.py 
106
107
def get_searchable_content(self, value, data):
    return str(data)

no_response 

no_response()
Source code in hypha/apply/stream_forms/blocks.py 
109
110
def no_response(self):
    return "-"

FullNameBlock 

FullNameBlock(*args, **kwargs)

Bases: ApplicationMustIncludeFieldBlock

Source code in hypha/apply/utils/blocks.py 
214
215
216
217
218
219
220
221
def __init__(self, *args, **kwargs):
    info_name = _("{} Field").format(
        self._meta_class.label if self._meta_class.label else self.name.title()
    )
    child_blocks = [
        ("info", SingleIncludeStatic(label=info_name, description=self.description))
    ]
    super().__init__(child_blocks, *args, **kwargs)

name class-attribute instance-attribute 

name = 'full_name'

description class-attribute instance-attribute 

description = _('Full name')

field_label class-attribute instance-attribute 

field_label = blocks.CharBlock(label=_('Label'), default=_('What is your name?'))

help_text class-attribute instance-attribute 

help_text = blocks.RichTextBlock(required=False, label=_('Help text'), default=_('We will use this name when we communicate with you about your proposal.'))

field_class class-attribute instance-attribute 

field_class = forms.CharField

widget class-attribute instance-attribute 

widget = None

Meta

label class-attribute instance-attribute 
label = _('Full name')
icon class-attribute instance-attribute 
icon = 'user'

get_field_kwargs 

get_field_kwargs(struct_value)
Source code in hypha/apply/funds/blocks.py 
208
209
210
211
212
def get_field_kwargs(self, struct_value):
    kwargs = super().get_field_kwargs(struct_value)
    # Pull the max length from the full_name db field
    kwargs["max_length"] = User._meta.get_field("full_name").max_length
    return kwargs

get_slug 

get_slug(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
45
46
def get_slug(self, struct_value):
    return force_str(slugify(anyascii(struct_value["field_label"])))

get_field_class 

get_field_class(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
48
49
def get_field_class(self, struct_value):
    return self.field_class

get_widget 

get_widget(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
51
52
def get_widget(self, struct_value):
    return self.widget

get_field 

get_field(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
67
68
69
def get_field(self, struct_value):
    field_kwargs = self.get_field_kwargs(struct_value)
    return self.get_field_class(struct_value)(**field_kwargs)

decode 

decode(value)

Convert JSON representation into actual python objects

Source code in hypha/apply/stream_forms/blocks.py 
71
72
73
def decode(self, value):
    """Convert JSON representation into actual python objects"""
    return value

serialize 

serialize(value, context)
Source code in hypha/apply/stream_forms/blocks.py 
75
76
77
78
79
80
81
def serialize(self, value, context):
    field_kwargs = self.get_field_kwargs(value)
    return {
        "question": field_kwargs["label"],
        "answer": context.get("data"),
        "type": self.name,
    }

serialize_no_response 

serialize_no_response(value, context)
Source code in hypha/apply/stream_forms/blocks.py 
83
84
85
86
87
88
def serialize_no_response(self, value, context):
    return {
        "question": value["field_label"],
        "answer": "-",
        "type": "no_response",
    }

prepare_data 

prepare_data(value, data, serialize=False)
Source code in hypha/apply/stream_forms/blocks.py 
90
91
def prepare_data(self, value, data, serialize=False):
    return nh3_value(str(data))

render 

render(value, context)
Source code in hypha/apply/stream_forms/blocks.py 
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
def render(self, value, context):
    data = context.get("data")
    data = self.prepare_data(value, data, context.get("serialize", False))

    context.update(data=data or self.no_response())

    if context.get("serialize"):
        if not data:
            return self.serialize_no_response(value, context)
        return self.serialize(value, context)

    return super().render(value, context)

get_searchable_content 

get_searchable_content(value, data)
Source code in hypha/apply/stream_forms/blocks.py 
106
107
def get_searchable_content(self, value, data):
    return str(data)

no_response 

no_response()
Source code in hypha/apply/stream_forms/blocks.py 
109
110
def no_response(self):
    return "-"

DurationBlock 

DurationBlock(*args, **kwargs)

Bases: ApplicationSingleIncludeFieldBlock

Source code in hypha/apply/utils/blocks.py 
214
215
216
217
218
219
220
221
def __init__(self, *args, **kwargs):
    info_name = _("{} Field").format(
        self._meta_class.label if self._meta_class.label else self.name.title()
    )
    child_blocks = [
        ("info", SingleIncludeStatic(label=info_name, description=self.description))
    ]
    super().__init__(child_blocks, *args, **kwargs)

name class-attribute instance-attribute 

name = 'duration'

description class-attribute instance-attribute 

description = _('Duration')

DAYS class-attribute instance-attribute 

DAYS = 'days'

WEEKS class-attribute instance-attribute 

WEEKS = 'weeks'

MONTHS class-attribute instance-attribute 

MONTHS = 'months'

DURATION_TYPE_CHOICES class-attribute instance-attribute 

DURATION_TYPE_CHOICES = ((DAYS, _('Days')), (WEEKS, _('Weeks')), (MONTHS, _('Months')))

DURATION_DAY_OPTIONS class-attribute instance-attribute 

DURATION_DAY_OPTIONS = {i: format_lazy(ngettext_lazy('{} day', '{} days', i), i) for i in range(1, 8)}

DURATION_WEEK_OPTIONS class-attribute instance-attribute 

DURATION_WEEK_OPTIONS = {i: format_lazy(ngettext_lazy('{} week', '{} weeks', i), i) for i in range(1, 13)}

DURATION_MONTH_OPTIONS class-attribute instance-attribute 

DURATION_MONTH_OPTIONS = {i: format_lazy(ngettext_lazy('{} month', '{} months', i), i) for i in [*range(1, 13), 18, 24, 36]}

field_class class-attribute instance-attribute 

field_class = forms.ChoiceField

duration_type class-attribute instance-attribute 

duration_type = blocks.ChoiceBlock(help_text=_('Duration type is used to display duration choices in Days, Weeks or Months in application forms. Be careful, changing the duration type in the active round can result in data inconsistency.'), choices=DURATION_TYPE_CHOICES, default=MONTHS)

field_label class-attribute instance-attribute 

field_label = CharBlock(label=_('Label'))

help_text class-attribute instance-attribute 

help_text = RichTextBlock(required=False, label=_('Help text'))

widget class-attribute instance-attribute 

widget = None

required class-attribute instance-attribute 

required = BooleanBlock(label=_('Required'), required=False)

Meta

icon class-attribute instance-attribute 
icon = 'date'

get_field_kwargs 

get_field_kwargs(struct_value, *args, **kwargs)
Source code in hypha/apply/funds/blocks.py 
251
252
253
254
255
256
257
258
259
def get_field_kwargs(self, struct_value, *args, **kwargs):
    field_kwargs = super().get_field_kwargs(struct_value, *args, **kwargs)
    if struct_value["duration_type"] == self.DAYS:
        field_kwargs["choices"] = self.DURATION_DAY_OPTIONS.items()
    elif struct_value["duration_type"] == self.WEEKS:
        field_kwargs["choices"] = self.DURATION_WEEK_OPTIONS.items()
    else:
        field_kwargs["choices"] = self.DURATION_MONTH_OPTIONS.items()
    return field_kwargs

prepare_data 

prepare_data(value, data, serialize)
Source code in hypha/apply/funds/blocks.py 
261
262
263
264
265
266
267
268
def prepare_data(self, value, data, serialize):
    if not data:
        return data
    if value["duration_type"] == self.DAYS:
        return self.DURATION_DAY_OPTIONS[int(data)]
    if value["duration_type"] == self.WEEKS:
        return self.DURATION_WEEK_OPTIONS[int(data)]
    return self.DURATION_MONTH_OPTIONS[int(data)]

get_slug 

get_slug(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
45
46
def get_slug(self, struct_value):
    return force_str(slugify(anyascii(struct_value["field_label"])))

get_field_class 

get_field_class(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
48
49
def get_field_class(self, struct_value):
    return self.field_class

get_widget 

get_widget(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
51
52
def get_widget(self, struct_value):
    return self.widget

get_field 

get_field(struct_value)
Source code in hypha/apply/stream_forms/blocks.py 
67
68
69
def get_field(self, struct_value):
    field_kwargs = self.get_field_kwargs(struct_value)
    return self.get_field_class(struct_value)(**field_kwargs)

decode 

decode(value)

Convert JSON representation into actual python objects

Source code in hypha/apply/stream_forms/blocks.py 
71
72
73
def decode(self, value):
    """Convert JSON representation into actual python objects"""
    return value

serialize 

serialize(value, context)
Source code in hypha/apply/stream_forms/blocks.py 
75
76
77
78
79
80
81
def serialize(self, value, context):
    field_kwargs = self.get_field_kwargs(value)
    return {
        "question": field_kwargs["label"],
        "answer": context.get("data"),
        "type": self.name,
    }

serialize_no_response 

serialize_no_response(value, context)
Source code in hypha/apply/stream_forms/blocks.py 
83
84
85
86
87
88
def serialize_no_response(self, value, context):
    return {
        "question": value["field_label"],
        "answer": "-",
        "type": "no_response",
    }

render 

render(value, context)
Source code in hypha/apply/stream_forms/blocks.py 
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
def render(self, value, context):
    data = context.get("data")
    data = self.prepare_data(value, data, context.get("serialize", False))

    context.update(data=data or self.no_response())

    if context.get("serialize"):
        if not data:
            return self.serialize_no_response(value, context)
        return self.serialize(value, context)

    return super().render(value, context)

get_searchable_content 

get_searchable_content(value, data)
Source code in hypha/apply/stream_forms/blocks.py 
106
107
def get_searchable_content(self, value, data):
    return str(data)

no_response 

no_response()
Source code in hypha/apply/stream_forms/blocks.py 
109
110
def no_response(self):
    return "-"

ApplicationCustomFormFieldsBlock 

ApplicationCustomFormFieldsBlock(*args, **kwargs)

Bases: CustomFormFieldsBlock, FormFieldsBlock

Source code in hypha/apply/utils/blocks.py 
79
80
81
82
83
84
85
86
87
88
89
90
91
92
def __init__(self, *args, **kwargs):
    # The space before " Required" is to make the group sort first. Ugly but easy, and it works.
    child_blocks = [
        (block.name, block(group=_(" Required"))) for block in self.required_blocks
    ]
    child_blocks += [
        (block.name, block(group=_("Custom"))) for block in self.single_blocks
    ]
    self.required_block_names = [block.name for block in self.required_blocks]
    self.single_block_names = [
        block.name for block in self.single_blocks
    ] + self.required_block_names

    super().__init__(child_blocks, *args, **kwargs)

category class-attribute instance-attribute 

category = CategoryQuestionBlock(group=_('Custom'))

rich_text class-attribute instance-attribute 

rich_text = RichTextFieldBlock(group=_('Fields'))

required_blocks class-attribute instance-attribute 

required_blocks = ApplicationMustIncludeFieldBlock.__subclasses__()

single_blocks class-attribute instance-attribute 

single_blocks = ApplicationSingleIncludeFieldBlock.__subclasses__()

text_markup class-attribute instance-attribute 

text_markup = RichTextBlock(group=_('Custom'), label=_('Paragraph'))

header_markup class-attribute instance-attribute 

header_markup = HeadingBlock(group=_('Custom'), label=_('Section header'))

char class-attribute instance-attribute 

char = CharFieldBlock(group=_('Fields'))

multi_inputs_char class-attribute instance-attribute 

multi_inputs_char = MultiInputCharFieldBlock(group=_('Fields'))

text class-attribute instance-attribute 

text = TextFieldBlock(group=_('Fields'))

number class-attribute instance-attribute 

number = NumberFieldBlock(group=_('Fields'))

checkbox class-attribute instance-attribute 

checkbox = CheckboxFieldBlock(group=_('Fields'))

radios class-attribute instance-attribute 

radios = RadioButtonsFieldBlock(group=_('Fields'))

dropdown class-attribute instance-attribute 

dropdown = DropdownFieldBlock(group=_('Fields'))

checkboxes class-attribute instance-attribute 

checkboxes = CheckboxesFieldBlock(group=_('Fields'))

date class-attribute instance-attribute 

date = DateFieldBlock(group=_('Fields'))

time class-attribute instance-attribute 

time = TimeFieldBlock(group=_('Fields'))

datetime class-attribute instance-attribute 

datetime = DateTimeFieldBlock(group=_('Fields'))

image class-attribute instance-attribute 

image = ImageFieldBlock(group=_('Fields'))

file class-attribute instance-attribute 

file = FileFieldBlock(group=_('Fields'))

multi_file class-attribute instance-attribute 

multi_file = MultiFileFieldBlock(group=_('Fields'))

group_toggle class-attribute instance-attribute 

group_toggle = GroupToggleBlock(group=_('Custom'))

group_toggle_end class-attribute instance-attribute 

group_toggle_end = GroupToggleEndBlock(group=_('Custom'))

markdown_text class-attribute instance-attribute 

markdown_text = MarkdownTextFieldBlock(group=_('Fields'))

required_block_names instance-attribute 

required_block_names = [block.name for block in self.required_blocks]

single_block_names instance-attribute 

single_block_names = [block.name for block in self.single_blocks] + self.required_block_names

Meta

label class-attribute instance-attribute 
label = _('Form fields')

clean 

clean(value, ignore_required_constraints=False)
Source code in hypha/apply/utils/blocks.py 
 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
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
def clean(self, value, ignore_required_constraints=False):
    try:
        value = super().clean(value, ignore_required_constraints)
    except ValidationError as e:
        error_dict = e.params or {}
    else:
        error_dict = {}

    block_types = [block.block_type for block in value]
    missing = set(self.required_block_names) - set(block_types)

    duplicates = [
        name
        for name in find_duplicates(block_types)
        if name in self.single_block_names
    ]

    all_errors = []
    if missing:
        all_errors.append(
            _("You are missing the following required fields: {}").format(
                ", ".join(prettify_names(missing))
            )
        )

    if duplicates:
        all_errors.append(
            _("The following fields must be included only once: {}").format(
                ", ".join(prettify_names(duplicates))
            )
        )
        for i, block_name in enumerate(block_types):
            if block_name in duplicates:
                self.add_error_to_child(error_dict, i, "info", _("Duplicate field"))

    for block in value:
        if hasattr(block.block, "child_blocks"):
            for child_block_name, child_block in block.block.child_blocks.items():
                if child_block.required and not block.value[child_block_name]:
                    all_errors.append(
                        _("{child} cannot be empty for {parent}").format(
                            child=child_block.label, parent=block.block.label
                        )
                    )
                if (
                    isinstance(child_block, ListBlock)
                    and child_block.child_block.required
                ):
                    for child_value in block.value[child_block_name]:
                        if not child_value:
                            all_errors.append(
                                _("{child} cannot be empty for {parent}").format(
                                    child=child_block.label,
                                    parent=block.block.label,
                                )
                            )

    if all_errors or error_dict:
        error_dict["__all__"] = all_errors
        raise ValidationError(all_errors, params=error_dict)

    return value

add_error_to_child 

add_error_to_child(errors, child_number, field, message)
Source code in hypha/apply/utils/blocks.py 
157
158
159
160
161
162
163
164
def add_error_to_child(self, errors, child_number, field, message):
    new_error = ErrorList([message])
    try:
        errors[child_number].data[0].params[field] = new_error
    except KeyError:
        errors[child_number] = ErrorList(
            [ValidationError("Error", params={field: new_error})]
        )