edsl 0.1.38.dev3__py3-none-any.whl → 0.1.38.dev4__py3-none-any.whl

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 %}

edsl/questions/templates/numerical/question_presentation.jinja

@@ -1,7 +1,7 @@
-{{question_text}}
-{% if min_value is not none %}
-    Minimum answer value: {{min_value}}
-{% endif %}
-{% if max_value is not none %}
-    Maximum answer value: {{max_value}}
+{{question_text}}
+{% if min_value is not none %}
+    Minimum answer value: {{min_value}}
+{% endif %}
+{% if max_value is not none %}
+    Maximum answer value: {{max_value}}
 {% endif %}

edsl/questions/templates/rank/answering_instructions.jinja

@@ -1,11 +1,11 @@
-{# Answering Instructions #}
-{% if use_code %}
-Please respond only with a comma-separated list of the code of the raked options, with square brackets. E.g., [0, 1, 3]
-{% else %}
-Please respond only with a comma-separated list of the ranked options, 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 raked options, with square brackets. E.g., [0, 1, 3]
+{% else %}
+Please respond only with a comma-separated list of the ranked options, 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/rank/question_presentation.jinja

@@ -1,15 +1,15 @@
-{{question_text}}
-{% if use_code %}
-The options are
-{% for option in question_options %}
-{{ loop.index0 }}: {{option}}
-{% endfor %}
-{% else %}
-The options are:
-{% for option in question_options %}
-{{option}}
-{% endfor %}
-{% endif %}
-{% if num_selections %}
-You can inlcude up to {{num_selections}} options in your answer.
-{% endif %}
+{{question_text}}
+{% if use_code %}
+The options are
+{% for option in question_options %}
+{{ loop.index0 }}: {{option}}
+{% endfor %}
+{% else %}
+The options are:
+{% for option in question_options %}
+{{option}}
+{% endfor %}
+{% endif %}
+{% if num_selections %}
+You can inlcude up to {{num_selections}} options in your answer.
+{% endif %}

edsl/questions/templates/top_k/answering_instructions.jinja

@@ -1,8 +1,8 @@
-{# Answering Instructions #}
-Please respond with valid JSON, formatted like so:
-{% if include_comment %}
-    {"answer": [<put comma-separated list here>], "comment": "<put explanation here>"}
-{% else %}
-    {"answer": [<put comma-separated list here>]}
-{% endif %}
-
+{# Answering Instructions #}
+Please respond with valid JSON, formatted like so:
+{% if include_comment %}
+    {"answer": [<put comma-separated list here>], "comment": "<put explanation here>"}
+{% else %}
+    {"answer": [<put comma-separated list here>]}
+{% endif %}
+

edsl/questions/templates/top_k/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/yes_no/answering_instructions.jinja

@@ -1,6 +1,6 @@
-{# Answering Instructions #}
-Please respond with just your answer. 
-
-{% if include_comment %}
-After the answer, you can put a comment explaining your response.
-{% endif %}
+{# Answering Instructions #}
+Please respond with just your answer. 
+
+{% if include_comment %}
+After the answer, you can put a comment explaining your response.
+{% endif %}

edsl/questions/templates/yes_no/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/results/CSSParameterizer.py

@@ -0,0 +1,108 @@
+import re
+from typing import Dict, Set, Optional
+
+
+class CSSParameterizer:
+    """A utility class to parameterize CSS with custom properties (variables)."""
+
+    def __init__(self, css_content: str):
+        """
+        Initialize with CSS content to be parameterized.
+
+        Args:
+            css_content (str): The CSS content containing var() declarations
+        """
+        self.css_content = css_content
+        self._extract_variables()
+
+    def _extract_variables(self) -> None:
+        """Extract all CSS custom properties (variables) from the CSS content."""
+        # Find all var(...) declarations in the CSS
+        var_pattern = r"var\((--[a-zA-Z0-9-]+)\)"
+        self.variables = set(re.findall(var_pattern, self.css_content))
+
+    def _validate_parameters(self, parameters: Dict[str, str]) -> Set[str]:
+        """
+        Validate the provided parameters against the CSS variables.
+
+        Args:
+            parameters (Dict[str, str]): Dictionary of variable names and their values
+
+        Returns:
+            Set[str]: Set of missing variables
+        """
+        # Convert parameter keys to CSS variable format if they don't already have --
+        formatted_params = {
+            f"--{k}" if not k.startswith("--") else k for k in parameters.keys()
+        }
+
+        # print("Variables from CSS:", self.variables)
+        # print("Formatted parameters:", formatted_params)
+
+        # Find missing and extra variables
+        missing_vars = self.variables - formatted_params
+        extra_vars = formatted_params - self.variables
+
+        if extra_vars:
+            print(f"Warning: Found unused parameters: {extra_vars}")
+
+        return missing_vars
+
+    def generate_root(self, **parameters: str) -> Optional[str]:
+        """
+        Generate a :root block with the provided parameters.
+
+        Args:
+            **parameters: Keyword arguments where keys are variable names and values are their values
+
+        Returns:
+            str: Generated :root block with variables, or None if validation fails
+
+        Example:
+            >>> css = "body { height: var(--bodyHeight); }"
+            >>> parameterizer = CSSParameterizer(css)
+            >>> parameterizer.apply_parameters({'bodyHeight':"100vh"})
+            ':root {\\n  --bodyHeight: 100vh;\\n}\\n\\nbody { height: var(--bodyHeight); }'
+        """
+        missing_vars = self._validate_parameters(parameters)
+
+        if missing_vars:
+            print(f"Error: Missing required variables: {missing_vars}")
+            return None
+
+        # Format parameters with -- prefix if not present
+        formatted_params = {
+            f"--{k}" if not k.startswith("--") else k: v for k, v in parameters.items()
+        }
+
+        # Generate the :root block
+        root_block = [":root {"]
+        for var_name, value in sorted(formatted_params.items()):
+            if var_name in self.variables:
+                root_block.append(f"  {var_name}: {value};")
+        root_block.append("}")
+
+        return "\n".join(root_block)
+
+    def apply_parameters(self, parameters: dict) -> Optional[str]:
+        """
+        Generate the complete CSS with the :root block and original CSS content.
+
+        Args:
+            **parameters: Keyword arguments where keys are variable names and values are their values
+
+        Returns:
+            str: Complete CSS with :root block and original content, or None if validation fails
+        """
+        root_block = self.generate_root(**parameters)
+        if root_block is None:
+            return None
+
+        return f"{root_block}\n\n{self.css_content}"
+
+
+# Example usage
+if __name__ == "__main__":
+    import doctest
+
+    doctest.testmod()