edsl 0.1.39.dev1__py3-none-any.whl → 0.1.39.dev3__py3-none-any.whl

edsl/questions/question_registry.py

@@ -1,177 +1,177 @@
-"""This module provides a factory class for creating question objects."""
-
-import textwrap
-from uuid import UUID
-from typing import Any, Optional, Union
-
-
-from edsl.questions.QuestionBase import RegisterQuestionsMeta
-
-
-class Meta(type):
-    """Metaclass for QuestionBase that provides a __repr__ method that lists all available questions."""
-
-    def __repr__(cls):
-        """Return a string that lists all available questions."""
-
-        s = textwrap.dedent(
-            """
-        You can use the Question class to create objects by name. 
-        For example, to create a multiple choice question, you can do:
-
-        >>> from edsl import Question
-        >>> q = Question('multiple_choice', question_text='What is your favorite color?', question_name='color')
-        
-        Question Types:\n"""
-        )
-        for question_type, question_class in cls.available(
-            show_class_names=True
-        ).items():
-            line_info = (
-                f"{question_type} ({question_class.__name__}): {question_class.__doc__}"
-            )
-            s += line_info + "\n"
-        return s
-
-
-class Question(metaclass=Meta):
-    """Factory class for creating question objects."""
-
-    def __new__(cls, question_type, *args, **kwargs):
-        """Create a new question object."""
-        get_question_classes = RegisterQuestionsMeta.question_types_to_classes()
-
-        subclass = get_question_classes.get(question_type, None)
-        if subclass is None:
-            raise ValueError(
-                f"No question registered with question_type {question_type}"
-            )
-
-        # Create an instance of the selected subclass
-        instance = object.__new__(subclass)
-        instance.__init__(*args, **kwargs)
-        return instance
-
-    @classmethod
-    def example(cls, question_type: str):
-        """Return an example question of the given type."""
-        get_question_classes = RegisterQuestionsMeta.question_types_to_classes()
-        q = get_question_classes.get(question_type, None)
-        return q.example()
-
-    @classmethod
-    def pull(cls, uuid: Optional[Union[str, UUID]] = None, url: Optional[str] = None):
-        """Pull the object from coop."""
-        from edsl.coop import Coop
-
-        coop = Coop()
-        return coop.get(uuid, url, "question")
-
-    @classmethod
-    def delete(cls, uuid: Optional[Union[str, UUID]] = None, url: Optional[str] = None):
-        """Delete the object from coop."""
-        from edsl.coop import Coop
-
-        coop = Coop()
-        return coop.delete(uuid, url)
-
-    @classmethod
-    def patch(
-        cls,
-        uuid: Optional[Union[str, UUID]] = None,
-        url: Optional[str] = None,
-        description: Optional[str] = None,
-        value: Optional[Any] = None,
-        visibility: Optional[str] = None,
-    ):
-        """Patch the object on coop."""
-        from edsl.coop import Coop
-
-        coop = Coop()
-        return coop.patch(uuid, url, description, value, visibility)
-
-    @classmethod
-    def list_question_types(cls):
-        """Return a list of available question types.
-
-        >>> from edsl import Question
-        >>> Question.list_question_types()
-        ['checkbox', 'extract', 'free_text', 'functional', 'likert_five', 'linear_scale', 'list', 'multiple_choice', 'numerical', 'rank', 'top_k', 'yes_no']
-        """
-        return [
-            q
-            for q in sorted(
-                list(RegisterQuestionsMeta.question_types_to_classes().keys())
-            )
-            if q not in ["budget"]
-        ]
-
-    @classmethod
-    def available(cls, show_class_names: bool = False) -> Union[list, dict]:
-        """Return a list of available question types.
-
-        :param show_class_names: If True, return a dictionary of question types to class names. If False, return a set of question types.
-
-        Example usage:
-
-        """
-        from edsl.results.Dataset import Dataset
-
-        exclude = ["budget"]
-        if show_class_names:
-            return RegisterQuestionsMeta.question_types_to_classes()
-        else:
-            question_list = [
-                q
-                for q in sorted(
-                    set(RegisterQuestionsMeta.question_types_to_classes().keys())
-                )
-                if q not in exclude
-            ]
-            d = RegisterQuestionsMeta.question_types_to_classes()
-            question_classes = [d[q] for q in question_list]
-            example_questions = [repr(q.example()) for q in question_classes]
-
-            return Dataset(
-                [
-                    {"question_type": [q for q in question_list]},
-                    {"question_class": [q.__name__ for q in question_classes]},
-                    {"example_question": example_questions},
-                ],
-                print_parameters={"containerHeight": "auto"},
-            )
-
-
-def get_question_class(question_type):
-    """Return the class for the given question type."""
-    q2c = RegisterQuestionsMeta.question_types_to_classes()
-    if question_type not in q2c:
-        raise ValueError(
-            f"The question type, {question_type}, is not recognized. Recognied types are: {q2c.keys()}"
-        )
-    return q2c.get(question_type)
-
-
-question_purpose = {
-    "multiple_choice": "When options are known and limited",
-    "free_text": "When options are unknown or unlimited",
-    "checkbox": "When multiple options can be selected",
-    "numerical": "When the answer is a single numerical value e.g., a float",
-    "linear_scale": "When options are text, but can be ordered, e.g., daily, weekly, monthly, etc.",
-    "yes_no": "When the question can be fully answered with either a yes or a no",
-    "list": "When the answer should be a list of items",
-    "rank": "When the answer should be a ranked list of items",
-    "budget": "When the answer should be an amount allocated among a set of options",
-    "top_k": "When the answer should be a list of the top k items",
-    "likert_five": "When the answer should be a value on the Likert scale from 1 to 5",
-    "extract": "When the answer should be information extracted or extrapolated from a text in a given format",
-}
-
-
-if __name__ == "__main__":
-    print(Question.available())
-
-    # q = Question("free_text", question_text="How are you doing?", question_name="test")
-    # results = q.run()
-
-    q = Question.pull(id=76)
+"""This module provides a factory class for creating question objects."""
+
+import textwrap
+from uuid import UUID
+from typing import Any, Optional, Union
+
+
+from edsl.questions.QuestionBase import RegisterQuestionsMeta
+
+
+class Meta(type):
+    """Metaclass for QuestionBase that provides a __repr__ method that lists all available questions."""
+
+    def __repr__(cls):
+        """Return a string that lists all available questions."""
+
+        s = textwrap.dedent(
+            """
+        You can use the Question class to create objects by name. 
+        For example, to create a multiple choice question, you can do:
+
+        >>> from edsl import Question
+        >>> q = Question('multiple_choice', question_text='What is your favorite color?', question_name='color')
+        
+        Question Types:\n"""
+        )
+        for question_type, question_class in cls.available(
+            show_class_names=True
+        ).items():
+            line_info = (
+                f"{question_type} ({question_class.__name__}): {question_class.__doc__}"
+            )
+            s += line_info + "\n"
+        return s
+
+
+class Question(metaclass=Meta):
+    """Factory class for creating question objects."""
+
+    def __new__(cls, question_type, *args, **kwargs):
+        """Create a new question object."""
+        get_question_classes = RegisterQuestionsMeta.question_types_to_classes()
+
+        subclass = get_question_classes.get(question_type, None)
+        if subclass is None:
+            raise ValueError(
+                f"No question registered with question_type {question_type}"
+            )
+
+        # Create an instance of the selected subclass
+        instance = object.__new__(subclass)
+        instance.__init__(*args, **kwargs)
+        return instance
+
+    @classmethod
+    def example(cls, question_type: str):
+        """Return an example question of the given type."""
+        get_question_classes = RegisterQuestionsMeta.question_types_to_classes()
+        q = get_question_classes.get(question_type, None)
+        return q.example()
+
+    @classmethod
+    def pull(cls, uuid: Optional[Union[str, UUID]] = None, url: Optional[str] = None):
+        """Pull the object from coop."""
+        from edsl.coop import Coop
+
+        coop = Coop()
+        return coop.get(uuid, url, "question")
+
+    @classmethod
+    def delete(cls, uuid: Optional[Union[str, UUID]] = None, url: Optional[str] = None):
+        """Delete the object from coop."""
+        from edsl.coop import Coop
+
+        coop = Coop()
+        return coop.delete(uuid, url)
+
+    @classmethod
+    def patch(
+        cls,
+        uuid: Optional[Union[str, UUID]] = None,
+        url: Optional[str] = None,
+        description: Optional[str] = None,
+        value: Optional[Any] = None,
+        visibility: Optional[str] = None,
+    ):
+        """Patch the object on coop."""
+        from edsl.coop import Coop
+
+        coop = Coop()
+        return coop.patch(uuid, url, description, value, visibility)
+
+    @classmethod
+    def list_question_types(cls):
+        """Return a list of available question types.
+
+        >>> from edsl import Question
+        >>> Question.list_question_types()
+        ['checkbox', 'extract', 'free_text', 'functional', 'likert_five', 'linear_scale', 'list', 'multiple_choice', 'numerical', 'rank', 'top_k', 'yes_no']
+        """
+        return [
+            q
+            for q in sorted(
+                list(RegisterQuestionsMeta.question_types_to_classes().keys())
+            )
+            if q not in ["budget"]
+        ]
+
+    @classmethod
+    def available(cls, show_class_names: bool = False) -> Union[list, dict]:
+        """Return a list of available question types.
+
+        :param show_class_names: If True, return a dictionary of question types to class names. If False, return a set of question types.
+
+        Example usage:
+
+        """
+        from edsl.results.Dataset import Dataset
+
+        exclude = ["budget"]
+        if show_class_names:
+            return RegisterQuestionsMeta.question_types_to_classes()
+        else:
+            question_list = [
+                q
+                for q in sorted(
+                    set(RegisterQuestionsMeta.question_types_to_classes().keys())
+                )
+                if q not in exclude
+            ]
+            d = RegisterQuestionsMeta.question_types_to_classes()
+            question_classes = [d[q] for q in question_list]
+            example_questions = [repr(q.example()) for q in question_classes]
+
+            return Dataset(
+                [
+                    {"question_type": [q for q in question_list]},
+                    {"question_class": [q.__name__ for q in question_classes]},
+                    {"example_question": example_questions},
+                ],
+                print_parameters={"containerHeight": "auto"},
+            )
+
+
+def get_question_class(question_type):
+    """Return the class for the given question type."""
+    q2c = RegisterQuestionsMeta.question_types_to_classes()
+    if question_type not in q2c:
+        raise ValueError(
+            f"The question type, {question_type}, is not recognized. Recognied types are: {q2c.keys()}"
+        )
+    return q2c.get(question_type)
+
+
+question_purpose = {
+    "multiple_choice": "When options are known and limited",
+    "free_text": "When options are unknown or unlimited",
+    "checkbox": "When multiple options can be selected",
+    "numerical": "When the answer is a single numerical value e.g., a float",
+    "linear_scale": "When options are text, but can be ordered, e.g., daily, weekly, monthly, etc.",
+    "yes_no": "When the question can be fully answered with either a yes or a no",
+    "list": "When the answer should be a list of items",
+    "rank": "When the answer should be a ranked list of items",
+    "budget": "When the answer should be an amount allocated among a set of options",
+    "top_k": "When the answer should be a list of the top k items",
+    "likert_five": "When the answer should be a value on the Likert scale from 1 to 5",
+    "extract": "When the answer should be information extracted or extrapolated from a text in a given format",
+}
+
+
+if __name__ == "__main__":
+    print(Question.available())
+
+    # q = Question("free_text", question_text="How are you doing?", question_name="test")
+    # results = q.run()
+
+    q = Question.pull(id=76)

edsl/questions/settings.py

@@ -1,12 +1,12 @@
-"""Settings for the questions module."""
-
-
-class Settings:
-    """Settings for the questions module."""
-
-    MAX_ANSWER_LENGTH = 2000
-    MAX_EXPRESSION_CONSTRAINT_LENGTH = 1000
-    MAX_NUM_OPTIONS = 200
-    MIN_NUM_OPTIONS = 2
-    MAX_OPTION_LENGTH = 10000
-    MAX_QUESTION_LENGTH = 100000
+"""Settings for the questions module."""
+
+
+class Settings:
+    """Settings for the questions module."""
+
+    MAX_ANSWER_LENGTH = 2000
+    MAX_EXPRESSION_CONSTRAINT_LENGTH = 1000
+    MAX_NUM_OPTIONS = 200
+    MIN_NUM_OPTIONS = 2
+    MAX_OPTION_LENGTH = 10000
+    MAX_QUESTION_LENGTH = 100000

edsl/questions/templates/budget/answering_instructions.jinja

@@ -1,7 +1,7 @@
-Return only a comma-separated list the values in the same order as the options, with 0s included, on one line, in square braces.
-
-Example: if there are 4 options, the response should be "[25,25,25,25]" to allocate 25 to each option.
-
-{% if include_comment %}
-After the answer, you can put a comment explaining your choice on the next line.
-{% endif %}
+Return only a comma-separated list the values in the same order as the options, with 0s included, on one line, in square braces.
+
+Example: if there are 4 options, the response should be "[25,25,25,25]" to allocate 25 to each option.
+
+{% if include_comment %}
+After the answer, you can put a comment explaining your choice on the next line.
+{% endif %}

edsl/questions/templates/budget/question_presentation.jinja

@@ -1,7 +1,7 @@
-{{question_text}}
-The options are 
-{% for option in question_options %}
-{{ loop.index0 }}: {{option}}
-{% endfor %}                       
-Allocate your budget of {{budget_sum}} among the options. 
-
+{{question_text}}
+The options are 
+{% for option in question_options %}
+{{ loop.index0 }}: {{option}}
+{% endfor %}                       
+Allocate your budget of {{budget_sum}} among the options. 
+

edsl/questions/templates/checkbox/answering_instructions.jinja

@@ -1,10 +1,10 @@
-{# Answering Instructions #}
-{% if use_code %}
-Please respond only with a comma-separated list of the code of the options that apply, with square brackets. E.g., [0, 1, 3]
-{% else %}
-Please respond only with a comma-separated list of the options that apply, with square brackets. E.g., ['Good', 'Bad', 'Ugly']
-{% endif %}
-{% if include_comment %}
-After the answer, you can put a comment explaining your choice on the next line.
-{% endif %}
-
+{# Answering Instructions #}
+{% if use_code %}
+Please respond only with a comma-separated list of the code of the options that apply, with square brackets. E.g., [0, 1, 3]
+{% else %}
+Please respond only with a comma-separated list of the options that apply, with square brackets. E.g., ['Good', 'Bad', 'Ugly']
+{% endif %}
+{% if include_comment %}
+After the answer, you can put a comment explaining your choice on the next line.
+{% endif %}
+

edsl/questions/templates/checkbox/question_presentation.jinja

@@ -1,22 +1,22 @@
-{{question_text}}
-{% if use_code %}
-    {% for option in question_options %}
-{{ loop.index0 }}: {{option}}
-    {% endfor %}
-{% else %}
-    {% for option in question_options %}
-{{ option }}
-    {% endfor %}    
-{% endif %}
-
-{# Restrictions #}
-{% if min_selections != None and max_selections != None and min_selections == max_selections %}
-You must select exactly {{min_selections}} options.
-{% elif min_selections != None and max_selections != None %}
-Minimum number of options that must be selected: {{min_selections}}.
-Maximum number of options that must be selected: {{max_selections}}.
-{% elif min_selections != None %}
-Minimum number of options that must be selected: {{min_selections}}.
-{% elif max_selections != None %}
-Maximum number of options that must be selected: {{max_selections}}.
-{% endif %}
+{{question_text}}
+{% if use_code %}
+    {% for option in question_options %}
+{{ loop.index0 }}: {{option}}
+    {% endfor %}
+{% else %}
+    {% for option in question_options %}
+{{ option }}
+    {% endfor %}    
+{% endif %}
+
+{# Restrictions #}
+{% if min_selections != None and max_selections != None and min_selections == max_selections %}
+You must select exactly {{min_selections}} options.
+{% elif min_selections != None and max_selections != None %}
+Minimum number of options that must be selected: {{min_selections}}.
+Maximum number of options that must be selected: {{max_selections}}.
+{% elif min_selections != None %}
+Minimum number of options that must be selected: {{min_selections}}.
+{% elif max_selections != None %}
+Maximum number of options that must be selected: {{max_selections}}.
+{% endif %}

edsl/questions/templates/extract/answering_instructions.jinja

@@ -1,7 +1,7 @@
-An ANSWER should be formatted like this: 
-
-{{ answer_template }}
-
-It should have the same keys but values extracted from the input.
-If the value of a key is not present in the input, fill with "null".
-Put any comments in the next line after the answer.
+An ANSWER should be formatted like this: 
+
+{{ answer_template }}
+
+It should have the same keys but values extracted from the input.
+If the value of a key is not present in the input, fill with "null".
+Put any comments in the next line after the answer.

edsl/questions/templates/likert_five/answering_instructions.jinja

@@ -1,10 +1,10 @@
-{# Answering Instructions #}
-{% if use_code %}
-Respond only with the code corresponding to one of the options.
-{% else %}
-Respond only with a string corresponding to one of the options.
-{% endif %}
-{% if include_comment %}
-After the answer, you can put a comment explaining why you chose that option on the next line.
-{% endif %}
-
+{# Answering Instructions #}
+{% if use_code %}
+Respond only with the code corresponding to one of the options.
+{% else %}
+Respond only with a string corresponding to one of the options.
+{% endif %}
+{% if include_comment %}
+After the answer, you can put a comment explaining why you chose that option on the next line.
+{% endif %}
+

edsl/questions/templates/likert_five/question_presentation.jinja

@@ -1,12 +1,12 @@
-{# Question Presention #}
-{{question_text}}
-{% if use_code %}
-    {%- for option in question_options %}
-{{ loop.index0 }}: {{option}}
-    {% endfor %}
-{% else %}
-    {% for option in question_options %}
-{{option}}
-    {% endfor %}
-{% endif %}
+{# Question Presention #}
+{{question_text}}
+{% if use_code %}
+    {%- for option in question_options %}
+{{ loop.index0 }}: {{option}}
+    {% endfor %}
+{% else %}
+    {% for option in question_options %}
+{{option}}
+    {% endfor %}
+{% endif %}
 Only 1 option may be selected.

edsl/questions/templates/linear_scale/answering_instructions.jinja

@@ -1,5 +1,5 @@
-{# Answering Instructions #}
-Respond only with the code corresponding to one of the options. E.g., "1" or "5" by itself.
-{% if include_comment %}
-After the answer, you can put a comment explaining why you chose that option on the next line.
-{% endif %}
+{# Answering Instructions #}
+Respond only with the code corresponding to one of the options. E.g., "1" or "5" by itself.
+{% if include_comment %}
+After the answer, you can put a comment explaining why you chose that option on the next line.
+{% endif %}

edsl/questions/templates/linear_scale/question_presentation.jinja

@@ -1,5 +1,5 @@
-{{question_text}}
-{% for option in question_options %}
-{{option}} : {{ option_labels.get(option, "") }}
-{% endfor %}
-Only 1 option may be selected.
+{{question_text}}
+{% for option in question_options %}
+{{option}} : {{ option_labels.get(option, "") }}
+{% endfor %}
+Only 1 option may be selected.

edsl/questions/templates/list/answering_instructions.jinja

@@ -1,4 +1,4 @@
-Return your answers on one line, in a comma-separated list of your responses, with square brackets and each answer in quotes E.g., ["A", "B", "C"]
-{% if include_comment %}
-After the answers, you can put a comment explaining your choice on the next line.
+Return your answers on one line, in a comma-separated list of your responses, with square brackets and each answer in quotes E.g., ["A", "B", "C"]
+{% if include_comment %}
+After the answers, you can put a comment explaining your choice on the next line.
 {% endif %}

edsl/questions/templates/list/question_presentation.jinja

@@ -1,5 +1,5 @@
-{{question_text}}
-
-{% if max_list_items is not none %}
-The list must not contain more than {{ max_list_items }} items.
-{% endif %}
+{{question_text}}
+
+{% if max_list_items is not none %}
+The list must not contain more than {{ max_list_items }} items.
+{% endif %}

edsl/questions/templates/multiple_choice/answering_instructions.jinja

@@ -1,9 +1,9 @@
-{# Answering Instructions #}
-{% if use_code %}
-Respond only with the code corresponding to one of the options.
-{% else %}
-Respond only with a string corresponding to one of the options.
-{% endif %}
-{% if include_comment %}
-After the answer, you can put a comment explaining why you chose that option on the next line.
-{% endif %}
+{# Answering Instructions #}
+{% if use_code %}
+Respond only with the code corresponding to one of the options.
+{% else %}
+Respond only with a string corresponding to one of the options.
+{% endif %}
+{% if include_comment %}
+After the answer, you can put a comment explaining why you chose that option on the next line.
+{% endif %}

edsl/questions/templates/multiple_choice/question_presentation.jinja

@@ -1,12 +1,12 @@
-{# Question Presention #}
-{{question_text}}
-{% if use_code %}
-    {%- for option in question_options %}
-{{ loop.index0 }}: {{option}}
-    {% endfor %}
-{% else %}
-    {% for option in question_options %}
-{{option}}
-    {% endfor %}
-{% endif %}
+{# Question Presention #}
+{{question_text}}
+{% if use_code %}
+    {%- for option in question_options %}
+{{ loop.index0 }}: {{option}}
+    {% endfor %}
+{% else %}
+    {% for option in question_options %}
+{{option}}
+    {% endfor %}
+{% endif %}
 Only 1 option may be selected.

edsl/questions/templates/numerical/answering_instructions.jinja

@@ -1,7 +1,7 @@
-This question requires a numerical response in the form of an integer or decimal (e.g., -12, 0, 1, 2, 3.45, ...).
-Respond with just your number on a single line.
-If your response is equivalent to zero, report '0'
-
-{% if include_comment %}
-After the answer, put a comment explaining your choice on the next line.
+This question requires a numerical response in the form of an integer or decimal (e.g., -12, 0, 1, 2, 3.45, ...).
+Respond with just your number on a single line.
+If your response is equivalent to zero, report '0'
+
+{% if include_comment %}
+After the answer, put a comment explaining your choice on the next line.
 {% endif %}