codingame_tools.client.common.protocol.codingamer_puzzle_topic¶
JSON-serializable dataclasses for the CodingamerPuzzleTopic service's findTopicsByCodingamerId and selectTopicsByCodingamerIdAndPuzzleId Codingame API methods.
module-attribute
¶
CgPuzzleTopicCategory = str
The difficulty category a puzzle topic belongs to, e.g. "FUNDAMENTALS", "INTERMEDIATE", "ADVANCED".
dataclass
¶
CgCodingamerPuzzleTopic(category, handle, label, puzzle_count, _last_progress_time=Alias('lastProgressTime'), extra_data=dict())
Bases: JSONWizardX
A codingamer's progress on a single puzzle topic (e.g. "Arrays", "BFS"), as returned by findTopicsByCodingamerId. Only topics the codingamer has made some progress on are returned (100 topics observed for a codingamer active since ~2018).
instance-attribute
¶
handle
Opaque (but human-readable) slug for the topic, e.g. "2d-array", "bfs".
instance-attribute
¶
puzzle_count
Number of puzzles tagged with this topic that the codingamer has solved/attempted.
property
writable
¶
last_progress_time
See the field docstring for _last_progress_time. Always UTC.
dataclass
¶
CgCodingamerTopicNode(id, handle, value, learned, extra_data=dict(), children=list(), category=None)
Bases: JSONWizardX
A single node in a puzzle's topic tree, personalized for a specific codingamer, as
returned (in a bare JSON array) by selectTopicsByCodingamerIdAndPuzzleId. Similar to
CgPuzzleTopicNode (last_activities.py, used by other puzzle-related endpoints),
but adds id/learned for per-codingamer topic mastery tracking; category was not
observed in the single example seen so far, so it's modeled as optional here (as it is
on CgPuzzleTopicNode).
instance-attribute
¶
handle
Opaque (but human-readable) slug for the topic, e.g. "constraint-propagation".
class-attribute
instance-attribute
¶
children = field(default_factory=list)
Child topics nested under this one. Often empty.
class-attribute
instance-attribute
¶
category = None
The topic's difficulty category; see CgPuzzleTopicCategory. Not observed in the single
example seen so far.