Arrea.Validation.Rules (Arrea v1.0.0)

Validation rules for commands and worker specifications.

All functions return {:ok, value} on success or {:error, reason} on failure. Rules are composable using with chains.

Summary

Functions

allowed_shell(shell)

Valida que el shell este en la lista de shells permitidos.

allowed_shells()

Retorna la lista de nombres de shells permitidos.

dangerous_commands()

Retorna la lista de patrones de comandos peligrosos bloqueados por safe_command/1.

max_length(cmd, max)

Valida que un comando no exceda la longitud maxima permitida.

no_injection(cmd)

Valida que un comando no contenga patrones de inyeccion de shell.

not_empty(cmd)

Valida que una cadena de comando no este vacia.

safe_command(cmd)

Valida que un comando no coincida con ningun patron peligroso conocido.

valid_retry_count(count)

Validates that a retry count is non-negative and within limits.

valid_timeout(timeout)

Validates that a timeout value is positive and within reasonable limits.

validate_env_name(name)

Valida el nombre de una variable de entorno.

validate_path(path)

Validates that a string does not contain dangerous path patterns.

validate_url(url)

Valida una cadena URL.

Functions

allowed_shell(shell)

@spec allowed_shell(String.t()) ::
  {:ok, String.t()} | {:error, {:disallowed_shell, String.t()}}

Valida que el shell este en la lista de shells permitidos.

allowed_shells()

@spec allowed_shells() :: [String.t()]

Retorna la lista de nombres de shells permitidos.

dangerous_commands()

@spec dangerous_commands() :: [String.t()]

Retorna la lista de patrones de comandos peligrosos bloqueados por safe_command/1.

max_length(cmd, max)

@spec max_length(String.t(), pos_integer()) ::
  {:ok, String.t()} | {:error, :command_too_long}

Valida que un comando no exceda la longitud maxima permitida.

no_injection(cmd)

@spec no_injection(String.t()) :: {:ok, String.t()} | {:error, :possible_injection}

Valida que un comando no contenga patrones de inyeccion de shell.

Verifica vectores de inyeccion comunes: $(...), backticks, y null bytes.

not_empty(cmd)

@spec not_empty(String.t()) :: {:ok, String.t()} | {:error, :empty_command}

Valida que una cadena de comando no este vacia.

safe_command(cmd)

@spec safe_command(String.t()) ::
  {:ok, String.t()} | {:error, {:dangerous_command, String.t()}}

Valida que un comando no coincida con ningun patron peligroso conocido.

valid_retry_count(count)

@spec valid_retry_count(non_neg_integer()) ::
  {:ok, non_neg_integer()} | {:error, :invalid_retry_count}

Validates that a retry count is non-negative and within limits.

valid_timeout(timeout)

@spec valid_timeout(pos_integer()) ::
  {:ok, pos_integer()} | {:error, :invalid_timeout}

Validates that a timeout value is positive and within reasonable limits.

validate_env_name(name)

@spec validate_env_name(String.t()) :: {:ok, String.t()} | {:error, :invalid_env_name}

Valida el nombre de una variable de entorno.

validate_path(path)

@spec validate_path(String.t()) ::
  {:ok, String.t()} | {:error, :path_contains_dangerous_pattern}

Validates that a string does not contain dangerous path patterns.

validate_url(url)

@spec validate_url(String.t()) :: {:ok, String.t()} | {:error, :invalid_url}

Valida una cadena URL.