Skip to content

Invoice tools

hypha.apply.projects.templatetags.invoice_tools

register module-attribute 

register = Library()

can_change_status 

can_change_status(invoice, user)
Source code in hypha/apply/projects/templatetags/invoice_tools.py 
26
27
28
@register.simple_tag
def can_change_status(invoice, user):
    return invoice.can_user_change_status(user)

can_show_paid_date 

can_show_paid_date(invoice)
Source code in hypha/apply/projects/templatetags/invoice_tools.py 
31
32
33
34
35
@register.simple_tag
def can_show_paid_date(invoice):
    if invoice.status == PAID and invoice.paid_date:
        return True
    return False

can_delete 

can_delete(invoice, user)
Source code in hypha/apply/projects/templatetags/invoice_tools.py 
38
39
40
@register.simple_tag
def can_delete(invoice, user):
    return invoice.can_user_delete(user)

can_edit 

can_edit(invoice, user)
Source code in hypha/apply/projects/templatetags/invoice_tools.py 
43
44
45
@register.simple_tag
def can_edit(invoice, user):
    return invoice.can_user_edit(user)

percentage 

percentage(value, total)
Source code in hypha/apply/projects/templatetags/invoice_tools.py 
48
49
50
51
52
53
54
55
56
57
58
59
60
61
@register.simple_tag
def percentage(value, total):
    if not total:
        return decimal.Decimal(0)

    unrounded_total = (value / total) * 100

    # round using Decimal since we're dealing with currency
    rounded_total = unrounded_total.quantize(
        decimal.Decimal("0.0"),
        rounding=decimal.ROUND_DOWN,
    )

    return rounded_total

project_can_have_invoices 

project_can_have_invoices(project)
Source code in hypha/apply/projects/templatetags/invoice_tools.py 
64
65
66
67
68
@register.simple_tag
def project_can_have_invoices(project):
    if project.status in [INVOICING_AND_REPORTING, CLOSING, COMPLETE]:
        return True
    return False

get_invoice_form 

get_invoice_form(invoice, user)
Source code in hypha/apply/projects/templatetags/invoice_tools.py 
71
72
73
74
75
76
77
78
79
@register.simple_tag
def get_invoice_form(invoice, user):
    from hypha.apply.projects.views.payment import ChangeInvoiceStatusForm

    form = ChangeInvoiceStatusForm(instance=invoice, user=user)
    if form:
        form.name = "change_invoice_status"
        return form
    return None

get_invoice_form_id 

get_invoice_form_id(form, invoice)
Source code in hypha/apply/projects/templatetags/invoice_tools.py 
82
83
84
@register.simple_tag
def get_invoice_form_id(form, invoice):
    return f"{form.name}-{invoice.id}"

extract_status 

extract_status(activity, user)
Source code in hypha/apply/projects/templatetags/invoice_tools.py 
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
@register.simple_tag
def extract_status(activity, user):
    if activity and user:
        invoice_activity_message = display_for(activity, user)
        invoice_status = invoice_activity_message.replace(
            "Updated Invoice status to: ", ""
        ).replace(".", "")
        if " by " not in str(invoice_status) and not user.is_applicant:
            if activity.user.is_apply_staff:
                user_role = "staff"
            elif activity.user.is_finance:
                user_role = "finance"
            else:
                user_role = "vendor"
            return _("{status} by {user_role}").format(
                status=invoice_status, user_role=user_role
            )
        return invoice_status
    return ""

display_invoice_status_for_user 

display_invoice_status_for_user(user, invoice)
Source code in hypha/apply/projects/templatetags/invoice_tools.py 
108
109
110
111
112
@register.simple_tag
def display_invoice_status_for_user(user, invoice):
    if user.is_apply_staff or user.is_contracting or user.is_finance:
        return invoice.status_display
    return get_invoice_public_status(invoice_status=invoice.status)

get_comment_for_invoice_action 

get_comment_for_invoice_action(invoice, action)
Source code in hypha/apply/projects/templatetags/invoice_tools.py 
115
116
117
118
119
120
121
122
123
124
125
@register.simple_tag
def get_comment_for_invoice_action(invoice, action):
    if action and invoice:
        return Activity.comments.filter(
            timestamp__range=(
                action.timestamp - timedelta(minutes=1),
                action.timestamp + timedelta(minutes=1),
            ),
            related_content_type__model="invoice",
            related_object_id=invoice.id,
        ).first()

invoice_status_to_classname 

invoice_status_to_classname(invoice_status)
Source code in hypha/apply/projects/templatetags/invoice_tools.py 
128
129
130
@register.filter
def invoice_status_to_classname(invoice_status):
    return INVOICE_STATUS_CLASSNAME_MAP.get(invoice_status, "badge")

display_invoice_table_status_for_user 

display_invoice_table_status_for_user(status, user)
Source code in hypha/apply/projects/templatetags/invoice_tools.py 
133
134
135
@register.simple_tag
def display_invoice_table_status_for_user(status, user):
    return get_invoice_table_status(status, is_applicant=user.is_applicant)