in2lambda.api.set.Set

class in2lambda.api.set.Set(_name: str = 'set', _description: str = '', _finalAnswerVisibility: ~in2lambda.api.visibility_status.VisibilityController = <factory>, _workedSolutionVisibility: ~in2lambda.api.visibility_status.VisibilityController = <factory>, _structuredTutorialVisibility: ~in2lambda.api.visibility_status.VisibilityController = <factory>, questions: list[~in2lambda.api.question.Question] = <factory>)

Bases: object

Represents a list of questions.

__init__(_name: str = 'set', _description: str = '', _finalAnswerVisibility: ~in2lambda.api.visibility_status.VisibilityController = <factory>, _workedSolutionVisibility: ~in2lambda.api.visibility_status.VisibilityController = <factory>, _structuredTutorialVisibility: ~in2lambda.api.visibility_status.VisibilityController = <factory>, questions: list[~in2lambda.api.question.Question] = <factory>) → None

Methods

__init__([_name, _description, ...])
add_question([title, main_text])	Inserts a new question into the set.
increment_current_question()	Manually overrides the current question being modified.
set_description(description)	Sets the description of the set.
set_name(name)	Sets the name of the set.
to_json(output_dir)	Turns this set into Lambda Feedback JSON/ZIP files.

Attributes

current_question	The current question being modified, or Question("INVALID") if there are no questions.
questions

add_question(title: str = '', main_text: Element | str = Str()) → None

Inserts a new question into the set.

Parameters:

• title – An optional string for the title of the question. If no title is provided, the question title auto-increments i.e. Question 1, 2, etc.

• main_text – An optional string or panflute element for the main question text.

Examples

>>> from in2lambda.api.set import Set
>>> import panflute as pf
>>> s = Set()
>>> s.add_question("Some title", pf.Para(pf.Str("hello"), pf.Space, pf.Str("there")))
>>> s.questions
[Question(title='Some title', parts=[], images=[], main_text='hello there')]
>>> s.add_question(main_text="Normal string text")
>>> s.questions[1].main_text
'Normal string text'

property current_question: Question

The current question being modified, or Question(“INVALID”) if there are no questions.

The reasoning behind returning Question(“INVALID”) is in case filter logic is being applied on text before the first question (e.g. intro paragraphs). In that case, there is no effect.

Returns:

The current question or Question(“INVALID”) if there are no questions.

Examples

>>> from in2lambda.api.set import Set
>>> Set().current_question
Question(title='INVALID', parts=[], images=[], main_text='')
>>> s = Set()
>>> s.add_question()
>>> s.current_question
Question(title='', parts=[], images=[], main_text='')

increment_current_question() → None

Manually overrides the current question being modified.

The default (-1) indicates the last question added. Incrementing for the first time sets to 0 i.e. the first question.

The is useful if adding question text first and answers later.

Examples

>>> from in2lambda.api.set import Set
>>> s = Set()
>>> # Imagine adding the questions from a question file first...
>>> s.add_question("Question 1")
>>> s.add_question("Question 2")
>>> # ...and then adding solutions from an answer file later
>>> s.increment_current_question()  # Loop back to question 1
>>> s.current_question.add_solution("Question 1 answer")
>>> s.increment_current_question()
>>> s.current_question.add_solution("Question 2 answer")
>>> s.questions
[Question(title='Question 1', parts=[Part(text='', worked_solution='Question 1 answer')], images=[], main_text=''), Question(title='Question 2', parts=[Part(text='', worked_solution='Question 2 answer')], images=[], main_text='')]

set_description(description: str) → None

Sets the description of the set.

Parameters:

description – The description to set for the set.

Examples

>>> from in2lambda.api.set import Set
>>> s = Set()
>>> s.set_description("This is my question set.")
>>> s._description
'This is my question set.'

set_name(name: str) → None

Sets the name of the set.

Parameters:

name – The name to set for the set.

Examples

>>> from in2lambda.api.set import Set
>>> s = Set()
>>> s.set_name("My Question Set")
>>> s._name
'My Question Set'

to_json(output_dir: str) → None

Turns this set into Lambda Feedback JSON/ZIP files.

WARNING: This will overwrite any existing files in the directory.

Parameters:

output_dir – Where to output the final Lambda Feedback JSON/ZIP files.

Examples

>>> import tempfile
>>> import os
>>> import json
>>> # Create a set with two questions
>>> s = Set()
>>> s.add_question("Question 1")
>>> s.add_question("Question 2")
>>> with tempfile.TemporaryDirectory() as temp_dir:
...     # Write the JSON files to the temporary directory
...     s.to_json(temp_dir)
...     # Check the contents of the directory
...     sorted(os.listdir(temp_dir))
...     # Check the contents of the set directory
...     sorted(os.listdir(f"{temp_dir}/set"))
...     # Check the title of the first question
...     with open(f"{temp_dir}/set/question_000_Question_1.json") as file:
...         print(f"Question 1's title: {json.load(file)['title']}")
['set', 'set.zip']
['question_000_Question_1.json', 'question_001_Question_2.json', 'set_set.json']
Question 1's title: Question 1