Summary  
This chapter explains how to assign labels (names) to elements in a list, both during its creation using the name = value syntax and afterward by setting the names() of an existing list.

General domain of usage  
Data analysis

Les éléments d'une liste peuvent recevoir des **étiquettes** afin de les rendre plus faciles à identifier et à manipuler.

## Attribution d'étiquettes lors de la création d'une liste
Pour attribuer des étiquettes lors de la création d'une liste, utilisez la syntaxe `name = value` (sans guillemets autour du nom) dans la fonction `list()`.

test <- list(text = "Text", number = 42, logical = TRUE)
test

## Attribution de labels à une liste existante
Si la liste est déjà créée, il est possible d’ajouter des labels ultérieurement en assignant un vecteur de labels à `names(list)`.

test <- list("Text", 42, TRUE)
names(test) <- c('text', 'number', 'logical')
test

# =====================================================================
# СКРЫТЫЕ ТЕСТЫ ДЛЯ user_code.R
#
# КАК МЫ РАБОТАЕМ:
#  1) Виконуємо user_code.R і перевіряємо об'єкт та консольний вивід
# =====================================================================

library(testthat)
source(testthat::test_path("helper-run_user_code.R"), local = TRUE)

# Знаходимо user_code.R
candidates <- c(
  testthat::test_path("..", "..", "user_code.R"),
  testthat::test_path("user_code.R")
)
user_file <- candidates[file.exists(candidates)][1]
if (is.na(user_file)) stop("user_code.R not found")

# Виконуємо код користувача
res <- run_user_code(
  file       = user_file,
  capture    = c("info"),
  echo       = FALSE,
  print.eval = TRUE
)

# ---------- CASE 1 ----------
{
  ok <- !is.null(res$values$info) && is.list(res$values$info)

  dynamic_test(
    ok,
    "Variable 'info' is declared and is a list",
    "Expected 'info' to exist and be a list."
  )
}

# ---------- CASE 2 ----------
{
  expected_names <- c('Course name', 'Section', 'Chapter', 'Chapter overall')
  ok <- identical(names(res$values$info), expected_names)

  dynamic_test(
    ok,
    "List 'info' has correct element names",
    sprintf("Expected names: %s. Got: %s",
            paste(expected_names, collapse = ", "),
            paste(names(res$values$info), collapse = ", "))
  )
}

# ---------- CASE 3 ----------
{
  expected_values <- list("R Introduction", 6, 1, 41)
  ok <- identical(unname(res$values$info), expected_values)

  dynamic_test(
    ok,
    "List 'info' contains correct values",
    sprintf("Expected values: %s. Got: %s",
            paste(expected_values, collapse = ", "),
            paste(unname(res$values$info), collapse = ", "))
  )
}

# ---------- CASE 4 ----------
{
  out <- trimws(paste(res$logs, collapse = " "))

  ok <- grepl("Course name", out, fixed = TRUE) &&
        grepl("R Introduction", out, fixed = TRUE) &&
        grepl("Section", out, fixed = TRUE) &&
        grepl("6", out, fixed = TRUE) &&
        grepl("Chapter", out, fixed = TRUE) &&
        grepl("1", out, fixed = TRUE) &&
        grepl("Chapter overall", out, fixed = TRUE) &&
        grepl("41", out, fixed = TRUE)

  dynamic_test(
    ok,
    "Console output contains all named elements and values of list 'info'",
    sprintf("Expected output to include Course name, Section, Chapter, Chapter overall. Actual (first 300 chars): %s",
            substr(out, 1, 300))
  )
}


test_hidden.R

# =====================================================================
# ВСПОМОГАТЕЛЬНЫЕ ХЕЛПЕРЫ ДЛЯ ТЕСТОВ
#
# Файл называется helper-*.R: testthat автоматически подхватывает такие
# файлы перед выполнением любых тестов в каталоге tests/testthat.
# =====================================================================

# -----------------------------------------------------------------------------
# run_user_code(...)
#  - безопасно запускает user_code.R в отдельном окружении (env)
#  - перехватывает ВЕСЬ вывод (stdout): как результаты выражений, так и print()/cat()
#  - возвращает:
#       values  — список запрошенных переменных (по именам из аргумента capture)
#       logs    — вектор строк перехваченного вывода
#       env     — окружение, где выполнялся user_code (можно исследовать при необходимости)
#
# ПАРАМЕТРЫ:
#   file        — путь к user_code.R
#   capture     — character-вектор имён переменных, которые нужно извлечь после выполнения
#   inject      — список объектов/функций, которые нужно «подложить» в среду исполнения
#                 (можно использовать для моков/маскировки опасных функций: system, file.remove и т.д.)
#   echo        — печатать код при исполнении (обычно FALSE)
#   print.eval  — ПЕЧАТАТЬ РЕЗУЛЬТАТЫ ВЫРАЖЕНИЙ. Ключевая опция, чтобы строки вида
#                 `prices['Armchair']` попадали в stdout без явного print().
#
# БЕЗОПАСНОСТЬ:
#   - В базовом R нет полноценной «песочницы». Мы изолируем код в новом env,
#     но ОС-доступ не блокируется магически.
#   - Для задач онлайн-платформы можно частично «глушить» опасные вызовы через inject,
#     например:
#       inject = list(
#         system      = function(...) stop("system disabled"),
#         file.remove = function(...) stop("file.remove disabled")
#       )
# -----------------------------------------------------------------------------
run_user_code <- function(
  file = "user_code.R",
  capture = character(0),
  inject = list(),
  echo = FALSE,
  print.eval = TRUE
) {
  # Бросаем явную ошибку, если файла нет (проще диагностировать)
  stopifnot(file.exists(file))

  # Изолированное окружение: parent=baseenv() (без лишних пользовательских объектов сверху)
  env <- new.env(parent = baseenv())

  # Подмешиваем моки/данные в окружение (при необходимости)
  if (length(inject)) list2env(inject, envir = env)

  # ВАЖНО: перехватываем весь вывод выполнения файла.
  # source(..., local=env, echo, print.eval) исполняет код ВНУТРИ env.
  # print.eval=TRUE заставляет R печатать результаты выражений (как в консоли),
  # что позволяет проверять «голые» выражения без print().
  logs <- utils::capture.output(
    base::source(file, local = env, echo = echo, print.eval = print.eval)
  )

  # Собираем запрошенные значения переменных
  values <- setNames(vector("list", length(capture)), capture)
  for (nm in capture) {
    if (exists(nm, envir = env, inherits = FALSE)) {
      values[[nm]] <- get(nm, envir = env, inherits = FALSE)
    } else {
      values[[nm]] <- NULL
    }
  }

  list(values = values, logs = logs, env = env)
}

# -----------------------------------------------------------------------------
# dynamic_test(condition, success, failure)
#  - Создаёт ОДИН тест с «динамическим» названием.
#  - Если condition=TRUE → тест называется success.
#  - Если condition=FALSE → тест называется failure, и тест проваливается.
#  - Используем настоящую expectation (expect_true(TRUE)), чтобы репортёры всегда
#    печатали имя успеха (TAP, progress и т.д.).
# -----------------------------------------------------------------------------
dynamic_test <- function(condition, success, failure) {
  if (isTRUE(condition)) {
    testthat::test_that(success, {
      testthat::expect_true(TRUE)
    })
  } else {
    testthat::test_that(failure, {
      testthat::fail(failure)
    })
  }
}
# =====================================================================

helper-run_user_code.R

Acquérir une compréhension solide de R, l’un des langages les plus utilisés pour l’analyse de données. Explorer les types de données fondamentaux et les valeurs unidimensionnelles, puis progresser vers des structures multidimensionnelles, y compris les matrices, les data frames et les listes. Développer les compétences nécessaires pour appliquer R efficacement dans l’analyse statistique et la prise de décision basée sur les données.

Découvrez les éléments essentiels de la syntaxe R, tels que l'arithmétique, les variables, les fonctions d'affichage et les commentaires. Renforcez votre compréhension de la logique computationnelle grâce à des exercices.

Découvrez les types de données en R et comprenez leur rôle dans la gestion des données. Développez des compétences dans l'utilisation des vecteurs en tant que structures essentielles pour organiser et analyser l'information.

Développer la capacité à gérer efficacement les données catégorielles. Découvrir comment structurer, regrouper et interpréter les valeurs en convertissant des données brutes en catégories claires.

Comprendre comment représenter et manipuler des données structurées bidimensionnelles. Acquérir de l'assurance dans la transformation, l'étiquetage et l'application d'opérations sur des matrices pour des tâches analytiques.

Maîtriser la structure de données la plus utilisée dans R pour les informations tabulaires. Apprendre à organiser, transformer et extraire des informations à partir de jeux de données pour soutenir les décisions basées sur les données.

Découvrez comment les listes vont au-delà des vecteurs en stockant des éléments de types et de longueurs différents. Acquisition des compétences pour créer, accéder et modifier des listes afin d'organiser des structures de données complexes.

Étiquetage des éléments de liste

Attribution d'étiquettes lors de la création d'une liste

Exemple

Attribution de labels à une liste existante

Exemple

Solution

Étiquetage des éléments de liste

Attribution d'étiquettes lors de la création d'une liste

Exemple

Attribution de labels à une liste existante

Exemple

Solution