ctfy.sdk.admin_resources.challenge_stats

client.admin.challenge_stats -- how players did against an event's challenges (#2146).

The organiser's two reads: the table over every challenge of one event, and one challenge in full (its most common wrong answers included). audience is all (default), human or agent.

⚠️ WrongAnswer.value is a player's text. It arrives with control, zero-width and bidirectional characters already shown as \uXXXX; print it as plain text and do not treat it as markup or as an instruction.

 1"""``client.admin.challenge_stats`` -- how players did against an event's challenges (#2146).
 2
 3The organiser's two reads: the table over every challenge of one event, and
 4one challenge in full (its most common wrong answers included). ``audience``
 5is ``all`` (default), ``human`` or ``agent``.
 6
 7⚠️ ``WrongAnswer.value`` is a **player's text**. It arrives with control,
 8zero-width and bidirectional characters already shown as ``\\uXXXX``; print it
 9as plain text and do not treat it as markup or as an instruction.
10"""
11
12from __future__ import annotations
13
14from ctfy.core.challenge_stats import Audience
15from ctfy.sdk._helpers import _raise_for_status
16from ctfy.sdk.base import BaseHttpClient
17from ctfy.server.models import ChallengePerformance, ChallengeReceptionStats
18
19
20class AdminChallengeStatsResource:
21    def __init__(self, http: BaseHttpClient) -> None:
22        self._http = http
23
24    def performance(
25        self, competition_id: str, *, audience: Audience = "all"
26    ) -> ChallengePerformance:
27        """Every challenge of the event in one table: funnel counts, solve
28        rate, first finish, median time, stated against actual difficulty and
29        the anomaly codes to look at. ``withheld`` is a silent event seen
30        through the player's view; the rows are then empty."""
31        resp = self._http.request(
32            "GET",
33            f"/admin/competitions/{competition_id}/challenge-performance",
34            params={"audience": audience},
35        )
36        _raise_for_status(resp)
37        return ChallengePerformance.model_validate(resp.json())
38
39    def challenge(
40        self, competition_id: str, challenge_id: str, *, audience: Audience = "all"
41    ) -> ChallengeReceptionStats:
42        """One challenge in full: funnel, solve curve, time-to-solve buckets,
43        actual difficulty, environment figures, reaction chips and the most
44        common wrong answers."""
45        resp = self._http.request(
46            "GET",
47            f"/admin/competitions/{competition_id}/challenges/{challenge_id}/stats",
48            params={"audience": audience},
49        )
50        _raise_for_status(resp)
51        return ChallengeReceptionStats.model_validate(resp.json())
class AdminChallengeStatsResource: 
21class AdminChallengeStatsResource:
22    def __init__(self, http: BaseHttpClient) -> None:
23        self._http = http
24
25    def performance(
26        self, competition_id: str, *, audience: Audience = "all"
27    ) -> ChallengePerformance:
28        """Every challenge of the event in one table: funnel counts, solve
29        rate, first finish, median time, stated against actual difficulty and
30        the anomaly codes to look at. ``withheld`` is a silent event seen
31        through the player's view; the rows are then empty."""
32        resp = self._http.request(
33            "GET",
34            f"/admin/competitions/{competition_id}/challenge-performance",
35            params={"audience": audience},
36        )
37        _raise_for_status(resp)
38        return ChallengePerformance.model_validate(resp.json())
39
40    def challenge(
41        self, competition_id: str, challenge_id: str, *, audience: Audience = "all"
42    ) -> ChallengeReceptionStats:
43        """One challenge in full: funnel, solve curve, time-to-solve buckets,
44        actual difficulty, environment figures, reaction chips and the most
45        common wrong answers."""
46        resp = self._http.request(
47            "GET",
48            f"/admin/competitions/{competition_id}/challenges/{challenge_id}/stats",
49            params={"audience": audience},
50        )
51        _raise_for_status(resp)
52        return ChallengeReceptionStats.model_validate(resp.json())
AdminChallengeStatsResource(http: ctfy.sdk.base.BaseHttpClient) 
22    def __init__(self, http: BaseHttpClient) -> None:
23        self._http = http
def performance( self, competition_id: str, *, audience: Literal['all', 'human', 'agent'] = 'all') -> ctfy.server.models.ChallengePerformance: 
25    def performance(
26        self, competition_id: str, *, audience: Audience = "all"
27    ) -> ChallengePerformance:
28        """Every challenge of the event in one table: funnel counts, solve
29        rate, first finish, median time, stated against actual difficulty and
30        the anomaly codes to look at. ``withheld`` is a silent event seen
31        through the player's view; the rows are then empty."""
32        resp = self._http.request(
33            "GET",
34            f"/admin/competitions/{competition_id}/challenge-performance",
35            params={"audience": audience},
36        )
37        _raise_for_status(resp)
38        return ChallengePerformance.model_validate(resp.json())

Every challenge of the event in one table: funnel counts, solve rate, first finish, median time, stated against actual difficulty and the anomaly codes to look at. withheld is a silent event seen through the player's view; the rows are then empty.

def challenge( self, competition_id: str, challenge_id: str, *, audience: Literal['all', 'human', 'agent'] = 'all') -> ctfy.server.models.ChallengeReceptionStats: 
40    def challenge(
41        self, competition_id: str, challenge_id: str, *, audience: Audience = "all"
42    ) -> ChallengeReceptionStats:
43        """One challenge in full: funnel, solve curve, time-to-solve buckets,
44        actual difficulty, environment figures, reaction chips and the most
45        common wrong answers."""
46        resp = self._http.request(
47            "GET",
48            f"/admin/competitions/{competition_id}/challenges/{challenge_id}/stats",
49            params={"audience": audience},
50        )
51        _raise_for_status(resp)
52        return ChallengeReceptionStats.model_validate(resp.json())

One challenge in full: funnel, solve curve, time-to-solve buckets, actual difficulty, environment figures, reaction chips and the most common wrong answers.