Skip to content

List member attendance

In this example, it will be demonstrated how to count how many times each member attended a specific activity since a given date.

The following logical steps are performed:

  • Define the team_id, activity_name, and since_date date.
  • Retrieve the team members.
  • Retrieve activities from the since_date date and count members marked as Attending for matching activities.
  • Print each member with their attendance count.
 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
from collections import Counter
from datetime import date, datetime

from pyholdsport import (
    Holdsport,
    HoldsportActivitiesUser,
    HoldsportActivity,
    HoldsportActivityUserStatus,
    HoldsportMember,
)

with Holdsport(
    holdsport_username="username",
    holdsport_password="password",
) as holdsport:
    team_id = 123
    activity_name = "Activity Name"
    since_date = date(2026, 1, 1)

    members: list[HoldsportMember] = holdsport.get_members(team_id=team_id)
    member_ids: set[int] = {member.id for member in members}

    attendance_counts: Counter[int] = Counter()
    page = 1
    while True:
        reached_future_activity = False
        activities: list[HoldsportActivity] = holdsport.get_activities(
            team_id=team_id,
            date=since_date.isoformat(),
            page=page,
            per_page=20,
        )
        if not activities:
            break

        for activity in activities:
            activity_time = datetime.strptime(
                activity.starttime, "%Y-%m-%dT%H:%M:%S%z"
            )
            if activity_time > datetime.now(activity_time.tzinfo):
                # Assume that once a future activity is reached, all subsequent
                # activities are also in the future.
                reached_future_activity = True
                break

            if activity.name != activity_name:
                continue

            activities_users: list[HoldsportActivitiesUser] = (
                holdsport.get_activities_users(
                    activity.id,
                )
            )
            for user in activities_users:
                if (
                    user.status_code is HoldsportActivityUserStatus.ATTENDING
                    and user.user_id in member_ids
                ):
                    attendance_counts[user.user_id] += 1

        if reached_future_activity:
            break

        page += 1

    print(
        f"Player attendance for '{activity_name}' "
        f"since {since_date.isoformat()}:"
    )
    sorted_members = sorted(
        members,
        key=lambda member: (
            -attendance_counts[member.id],
            member.lastname,
            member.firstname,
        ),
    )
    for sorted_member in sorted_members:
        print(
            f"{sorted_member.firstname} {sorted_member.lastname}: "
            f"{attendance_counts[sorted_member.id]}"
        )