Function build_tallies

src/summarycode/copyright_tallies.py:82–152

Update the ``resource`` Resource with a tally of scan fields from itself and its ``children``. Resources and this for the `attributes_list` values list key (such as copyrights, etc) and the ``attribute_value`` details key (such as copyright). - `attributes_list` is the name o

(
    resource,
    children,
    attributes_list,
    attribute_value,
    tallier,
    keep_details=False,
)

def build_tallies(
    resource,
    children,
    attributes_list,
    attribute_value,
    tallier,
    keep_details=False,
):
    """
    Update the ``resource`` Resource with a tally of scan fields from itself and its
    ``children``.

    Resources and this for the `attributes_list` values list key (such as
    copyrights, etc) and the ``attribute_value`` details key (such as copyright).

     - `attributes_list` is the name of the attribute values list
       ('copyrights', 'holders' etc.)

     - `attribute_value` is the name of the attribute value  key in this list
       ('copyright', 'holder' etc.)

     - `tallier` is a function that takes a list of texts and returns
        texts with counts
     """
    # Collect current data
    values = getattr(resource, attributes_list, [])

    no_detection_counter = 0

    if values:
        # keep current data as plain strings
        candidate_texts = [entry.get(attribute_value) for entry in values]
    else:
        candidate_texts = []
        if resource.is_file:
            no_detection_counter += 1

    # Collect direct children existing summaries
    for child in children:
        child_summaries = get_resource_tallies(
            child,
            key=attributes_list,
            as_attribute=keep_details
        ) or []

        for child_summary in child_summaries:
            count = child_summary['count']
            value = child_summary['value']
            if value:
                candidate_texts.append(Text(value, value, count))
            else:
                no_detection_counter += count

    # summarize proper using the provided function
    tallied = tallier(candidate_texts)

    # add back the counter of things without detection
    if no_detection_counter: