DOP-2319 - Add new quiz directives to snooty-parser (#333)

* DOP-2319 Add new quiz directives to snooty-parser

Author: carooobregon

snooty/rstspec.toml

@@ -707,6 +707,26 @@ example = """.. procedure::
 ${0: Steps content}"""
 content_type = "block"
 
+[directive."mongodb:quiz"]
+content_type = "block"
+help = "Embed a quiz with a question argument, using the quizchoice directive to construct answer options."
+example = """.. quiz:: 
+  :quiz-id: ${1:string}
+   
+   ${2:string}"""
+argument_type = "string"
+options.quiz-id = {type = "string", required = true}
+
+[directive."mongodb:quizchoice"]
+content_type = "block"
+help = "A possible quiz answer and an explanation to be displayed after submission"
+example = """ .. quizchoice:: ${1:string}
+   :is-true:
+
+   ${3:string}"""
+argument_type = "string"
+options.is-true = "flag"
+
 [directive."mongodb:step"]
 help = "Make a single, numbered step."
 example = """.. step:: ${0: Step's headline string}

snooty/test_parser.py

@@ -29,6 +29,34 @@
 # does NOT include postprocessing artifacts such as nonlocal link titles and intersphinx lookups.
 
 
+def test_quiz() -> None:
+    tabs_path = ROOT_PATH.joinpath(Path("test_quiz.rst"))
+    project_config = ProjectConfig(ROOT_PATH, "", source="./")
+    parser = rstparser.Parser(project_config, JSONVisitor)
+    page, diagnostics = parse_rst(parser, tabs_path, None)
+    page.finish(diagnostics)
+    check_ast_testing_string(
+        page.ast,
+        """<root fileid="test_quiz.rst">
+        <directive name="quiz" domain="mongodb" quiz-id="mongoacc1">
+            <paragraph><text>With my MongoDB account, I can now access?</text></paragraph>
+            <directive name="quizchoice" domain="mongodb">
+                <text>MongoDB Atlas</text>
+                <paragraph><text>Up to 2 lines of copy here explaining why MongoDB Atlas isn’t the right answer choice</text></paragraph>
+            </directive>
+            <directive name="quizchoice" domain="mongodb">
+                <text>MongoDB University</text>
+                <paragraph><text>Up to 2 lines of copy here explaining why MongoDB University isn’t the right answer choice</text></paragraph>
+            </directive>
+            <directive name="quizchoice" domain="mongodb" is-true="True">
+                <text>All of the Above</text>
+                <paragraph><text>Your MongoDB account gives you access to all of the above: Atlas, University, Cloud Manager, etc.</text></paragraph>
+            </directive>
+        </directive>
+        </root>""",
+    )
+
+
 def test_tabs() -> None:
     tabs_path = ROOT_PATH.joinpath(Path("test_tabs.rst"))
     project_config = ProjectConfig(ROOT_PATH, "", source="./")

test_data/test_quiz.rst

@@ -0,0 +1,17 @@
+.. quiz::
+   :quiz-id: mongoacc1
+
+   With my MongoDB account, I can now access?
+   
+   .. quizchoice:: MongoDB Atlas
+
+      Up to 2 lines of copy here explaining why MongoDB Atlas isn’t the right answer choice
+ 
+   .. quizchoice:: MongoDB University
+
+      Up to 2 lines of copy here explaining why MongoDB University isn’t the right answer choice
+
+   .. quizchoice:: All of the Above
+      :is-true:
+
+      Your MongoDB account gives you access to all of the above: Atlas, University, Cloud Manager, etc.