1 files changed, 34 insertions, 0 deletions

diff --git a/include/quiz.h b/include/quiz.h
new file mode 100644
index 0000000..db69367
--- /dev/null
+++ b/include/quiz.h
@@ -0,0 +1,34 @@
+//
+// Created by philw on 01/03/2026.
+//
+
+#pragma once
+
+#include "../include/questions.h"
+#include <stdbool.h>
+#include <stddef.h>
+#include <stdio.h>
+
+#define PERCENT_MULTIPLIER 100.0
+#define SCORE_FORMAT "Score: %zu/%zu (%.1f%%)\n"
+
+// ------------------------
+// Quiz state
+// ------------------------
+typedef struct {
+        QuestionSet questions;
+        FILE* csv;
+        unsigned int seed;
+        size_t total_answered;
+        size_t total_correct;
+        int time_limit;
+} QuizSession;
+
+// ------------------------
+// Quiz functions
+// ------------------------
+bool initialize_quiz_session(QuizSession* session);
+bool quiz_iteration(QuizSession* session);
+void print_score(size_t correct, size_t total);
+void print_final_score(const QuizSession* session);
+void cleanup_session(QuizSession* session);