chore: adjusts instructions and adds another example.

Author: anthonydmays

lesson_03/README.md

@@ -40,19 +40,21 @@ npm start
 ```
 4. Make at least three questions for your quiz and _leave them unanswered_.
 5. To provide answers, you will need to update the [quiz.yaml][test-config-file] file in the test directory. You can copy the example in the file to get started, but you must provide your own answers. To generate an encrypted answer, use [bcrypt.online](https://bcrypt.online).
-6. Before attempting to submit your quiz, make sure to run the formatter on the code and run the tests to ensure that you've updated things correctly. These commands must be run from the [quiz][quiz-folder] sub-folder just like the previous assignment:
+6. Lastly, you'll need to modify the [quizzes.module.ts][quizzes-module] file to include your quiz.
+7. Before attempting to submit your quiz, make sure to run the formatter on the code and run the tests to ensure that you've updated things correctly. These commands must be run from the [quiz][quiz-folder] sub-folder just like the previous assignment:
 ```bash
 npm run lint
 npm run test
 ```
-7. Once everything passes, submit a PR.
+8. Once everything passes, submit a PR.
 
 **Note: If you want to check that you've encoded your answers correctly, you can update you quiz with the real answers and then run the tests using the command below. 
 ```bash
-RUN_SKIPPED=true npm run test
+PROVIDER_NAME=<Your provider name here> npm run test
 ```
 
 [quizzes-folder]: ./quiz/src/quizzes/
 [quiz-folder]: ./quiz/
 [quiz-example]: ./quiz/src/quizzes/anthony_mays_quiz.ts
-[test-config-file]: ./quiz/quiz.yaml
+[test-config-file]: ./quiz/quiz.yaml
+[quizzes-module]: ./quiz/src/quizzes/quizzes.module.ts

lesson_03/quiz/quiz.yaml

@@ -3,3 +3,6 @@ quiz:
     anthonymays:
       - $2y$10$8eHSzy3aCu4Ry3LzO9nWCeGpofSxsNVbnF.wCfn3ZADwQ6MEtN/KK
       - $2y$10$55EXRjF26JIgebtoH800ZOJecfefvMgHicuxf/rwTENuxiUaFQcNe
+    anotherone:
+      - $2y$10$8eHSzy3aCu4Ry3LzO9nWCeGpofSxsNVbnF.wCfn3ZADwQ6MEtN/KK
+      - $2y$10$dGB0CGv7.XQC5OqfyY6iXOiJsdVyxU3ve5YE0gt4m2I8P8H13lNXa

lesson_03/quiz/src/lesson3.test.ts

@@ -14,7 +14,6 @@ import { Quizzes } from './quizzes/quizzes.module.js';
 const __filename = fileURLToPath(import.meta.url); // get the resolved path to the file
 const __dirname = path.dirname(__filename); // get the name of the directory
 const softExpect = proxy(expect);
-const maybeIt = process.env.RUN_SKIPPED ? it : it.skip;
 
 describe('Lesson3Test', () => {
   let moduleFixture: TestingModule;
@@ -75,8 +74,20 @@ describe('Lesson3Test', () => {
     }
   });
 
+  const maybeIt = process.env.PROVIDER_NAME ? it : it.skip;
+
   maybeIt('checks for correct answers', async () => {
+    const targetProviderName =
+      process.env.PROVIDER_NAME?.toLowerCase().trim() || '';
+
+    if (!quizQuestionsByProvider.has(targetProviderName)) {
+      throw new Error(`Unknown provider name: ${targetProviderName}`);
+    }
+
     for (const [providerName, questions] of quizQuestionsByProvider) {
+      if (providerName !== process.env.PROVIDER_NAME?.toLowerCase().trim()) {
+        continue;
+      }
       for (const question of questions) {
         const actualAnswer = question.getAnswer();
         softExpect(actualAnswer).not.toBe(AnswerChoice.UNANSWERED);

lesson_03/quiz/src/quizzes/another_quiz.ts

@@ -0,0 +1,44 @@
+import {
+  AnswerChoice,
+  MultipleChoiceQuizQuestion,
+  QuizQuestion,
+  QuizQuestionProvider,
+} from 'codedifferently-instructional';
+
+export class AnotherQuiz implements QuizQuestionProvider {
+  getProviderName(): string {
+    return 'anotherone';
+  }
+
+  makeQuizQuestions(): QuizQuestion[] {
+    return [AnotherQuiz.makeQuestion0(), AnotherQuiz.makeQuestion1()];
+  }
+
+  private static makeQuestion0(): QuizQuestion {
+    return new MultipleChoiceQuizQuestion(
+      0,
+      'Where in the world is Carmen Sandiego?',
+      new Map<AnswerChoice, string>([
+        [AnswerChoice.A, 'Botzwana'],
+        [AnswerChoice.B, 'Nigeria'],
+        [AnswerChoice.C, 'Brazil'],
+        [AnswerChoice.D, 'France'],
+      ]),
+      AnswerChoice.UNANSWERED,
+    ); // Replace `UNANSWERED` with the correct answer.
+  }
+
+  private static makeQuestion1(): QuizQuestion {
+    return new MultipleChoiceQuizQuestion(
+      1,
+      'What is the capital of the United States?',
+      new Map<AnswerChoice, string>([
+        [AnswerChoice.A, 'Sacramento'],
+        [AnswerChoice.B, 'Washington D.C.'],
+        [AnswerChoice.C, 'Austin'],
+        [AnswerChoice.D, 'Saratoga'],
+      ]),
+      AnswerChoice.UNANSWERED,
+    ); // Replace `UNANSWERED` with the correct answer.
+  }
+}

lesson_03/quiz/src/quizzes/quizzes.module.ts

@@ -1,15 +1,19 @@
 import { Module } from '@nestjs/common';
+import { AnotherQuiz } from './another_quiz.js';
 import { AnthonyMaysQuiz } from './anthony_mays_quiz.js';
 
 export const Quizzes = Symbol.for('Quizzes');
 
+// Add your quiz provider here.
+const QUIZ_PROVIDERS = [AnthonyMaysQuiz, AnotherQuiz];
+
 @Module({
   providers: [
-    AnthonyMaysQuiz,
+    ...QUIZ_PROVIDERS,
     {
       provide: Quizzes,
       useFactory: (...args) => [...args],
-      inject: [AnthonyMaysQuiz],
+      inject: QUIZ_PROVIDERS,
     },
   ],
 })