types-check

Validate function inputs in R using a standalone file of check_* functions. Use when writing exported R functions that need input validation, reviewing existing validation code, or when creating new input validation helpers.

1. Uruchom w swoim projekcie R polecenie usethis::use_standalone("r-lib/rlang", "types-check"), aby zainstalować skill jako plik standalone z funkcjami check_*. Upewnij się, że rlang jest już importowany w twoim pakiecie.

2. W funkcji, którą chcesz zabezpieczyć, dodaj wywołania checkerów na początku ciała funkcji. Na przykład, jeśli funkcja przyjmuje argument name (ciąg znaków), dodaj check_string(name) lub check_name(name) dla nazw zmiennych.

3. Wybierz odpowiedni checker w zależności od typu argumentu: check_bool() dla flag logicznych (TRUE/FALSE), check_string() dla tekstu, check_number_whole() dla liczb całkowitych, check_number_decimal() dla liczb zmiennoprzecinkowych, check_logical() dla wektorów logicznych, check_character() dla wektorów znakowych, check_data_frame() dla ramek danych.

4. Dostosuj zachowanie checkera za pomocą argumentów opcjonalnych: allow_na = TRUE, jeśli funkcja powinna akceptować wartości NA, min i max dla checkerów liczb (check_number_whole, check_number_decimal) aby ograniczyć zakres, allow_infinite = TRUE/FALSE dla kontroli nieskończoności w liczbach.

5. Przetestuj funkcję z nieprawidłowymi danymi wejściowymi — checker automatycznie wyrzuci błąd z jasnym komunikatem wskazującym, co jest nie tak (np. "123 musi być ciągiem znaków, a nie liczbą 123").

6. Jeśli tworzysz własne funkcje walidacyjne, możesz je dodać do pliku standalone obok istniejących checkerów, zachowując ten sam styl komunikatów błędów.