Experiment utils

experiment.utils

consent_upload_path(instance, filename)

Generate path to save consent file based on experiment.slug and language

Parameters:

Name	Type	Description	Default
instance	Experiment	Experiment instance to determine folder name	required
filename	str	Name of the consent file to be uploaded	required

Returns:

Name	Type	Description
upload_to	str	Path for uploading the consent file

Note

Used by the Block model for uploading consent file

Source code in experiment/utils.py

def consent_upload_path(instance: Experiment, filename: str) -> str:
    """Generate path to save consent file based on experiment.slug and language

    Args:
        instance: Experiment instance to determine folder name
        filename: Name of the consent file to be uploaded

    Returns:
        upload_to: Path for uploading the consent file

    Note:
        Used by the Block model for uploading consent file
    """
    experiment = instance.experiment
    folder_name = experiment.slug
    language = instance.language

    join("consent", folder_name, f"{language}-{filename}")

create_player_labels(num_labels, label_style='number')

Create player labels

Parameters:

Name	Type	Description	Default
num_labels	int	Number of labels	required
label_style	str	‘number’, ‘alphabetic’, ‘roman’	'number'

Returns:

Type	Description
list[str]	Player label

Source code in experiment/utils.py

def create_player_labels(num_labels: int, label_style: str = "number") -> list[str]:
    """Create player labels

    Args:
        num_labels: Number of labels
        label_style: 'number', 'alphabetic', 'roman'

    Returns:
        Player label
    """

    return [format_label(i, label_style) for i in range(num_labels)]

external_url(text, url)

Create a HTML element for an external url

Parameters:

Name	Type	Description	Default
text	str	Text	required
url		Url	required

Returns:

Type	Description
str	HTML element

Source code in experiment/utils.py

def external_url(text: str, url) -> str:
    """Create a HTML element for an external url

    Args:
        text: Text
        url: Url

    Returns:
        HTML element
    """

    return '<a href="{}" target="_blank" rel="noopener noreferrer" >{}</a>'.format(url, text)

format_label(number, label_style)

Generate player_label for create_player_label()

Parameters:

Name	Type	Description	Default
number	int	index	required
label_style	str	‘number’, ‘alphabetic’, ‘roman’	required

Returns:

Type	Description
str	Player label

Source code in experiment/utils.py

def format_label(number: int, label_style: str) -> str:
    """Generate player_label for create_player_label()

    Args:
        number: index
        label_style: 'number', 'alphabetic', 'roman'

    Returns:
        Player label
    """

    if label_style == "alphabetic":
        return chr(number + 65)
    elif label_style == "roman":
        return roman.toRoman(number + 1)
    else:
        return str(number + 1)

non_breaking_spaces(input_string)

Convert regular spaces to non breaking spacing on the given string Args: input_string: Input string

Returns:

Type	Description
str	String with non breaking spaces

Source code in experiment/utils.py

def non_breaking_spaces(input_string: str) -> str:
    """Convert regular spaces to non breaking spacing on the given string
    Args:
        input_string: Input string

    Returns:
        String with non breaking spaces
    """

    non_breaking_space = chr(160)
    return input_string.replace(" ", non_breaking_space)

slugify(text)

Create a slug from given string

Parameters:

Name	Type	Description	Default
text	str	Input text (str)	required

Returns:

Type	Description
str	slug

Source code in experiment/utils.py

def slugify(text: str) -> str:
    """Create a slug from given string

    Args:
        text: Input text (str)

    Returns:
        slug
    """

    non_url_safe = [
        '"',
        "#",
        "$",
        "%",
        "&",
        "+",
        ",",
        "/",
        ":",
        ";",
        "=",
        "?",
        "@",
        "[",
        "\\",
        "]",
        "^",
        "`",
        "{",
        "|",
        "}",
        "~",
        "'",
    ]
    translate_table = {ord(char): "" for char in non_url_safe}
    text = text.translate(translate_table)
    text = "_".join(text.split())
    return text.lower()