Blocks

hypha.apply.projects.blocks

ProjectFormCustomFormFieldsBlock

ProjectFormCustomFormFieldsBlock(*args, **kwargs)

Bases: CustomFormFieldsBlock, FormFieldsBlock

A block that can be used for customizable Project-related forms: PAF, SOW, and Report.

Source code in hypha/apply/utils/blocks.py

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)

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'))

rich_text class-attribute instance-attribute

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

markdown_text class-attribute instance-attribute

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

required_blocks class-attribute instance-attribute

required_blocks = []

single_blocks class-attribute instance-attribute

single_blocks = []

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

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

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})]
        )