CLI

O Queue Lambda Debugger oferece o utilitário qldebugger para executar comandos na linha de comando. Exemplo:

qldebugger <comando>

Também é possível executá-lo como um módulo do Python. Exemplo:

python -m qldebugger <comando>

Comandos

Os comandos oferecidos por esse utilitário são:

init

Esse comando cria um exemplo do arquivo de configuração (qldebugger.toml) no diretório atual se ele não existir, caso ele já exista uma mensagem será mostrada, porém seu conteúdo não será alterado.

run <event_source_mapping_name>

Esse comando recebe o nome do um event_source_mapping configurado na seção de mesmo nome do arquivo de configuração, recebe mensagens da fila Amazon SQS configurada no parâmetro queue e executa o AWS Lambda nomeado no parâmetro function_name, exibindo sua saída no terminal.

infra create-secrets

Esse comando lê todas os segredos do SecretsManager presentes na seção secrets do arquivo de configuração e envia o comando para criá-los ou atualizá-los no serviço configurado da AWS.

infra create-topics

Esse comando lê todas os tópicos SNS presentes na seção topics do arquivo de configuração e envia o comando para criá-los no serviço configurado da AWS.

infra create-queues

Esse comando lê todas as filas Amazon SQS presentes na seção queues do arquivo de configuração e envia o comando para criá-las no serviço configurado da AWS.

infra create-all

Esse comando lê todos os segredos, tópicos, filas e inscrições do arquivo de configuração e envia o comando para criá-los ou atualizá-los no serviço configurado da AWS.

infra subscribe-topics

Esse comando remove todas as inscrições dos tópicos e as cria conforme definido no parâmetro subscribers dentro dos itens da seção topics do arquivo de configuração.

msg publish <topic_name> <message> [<attributes>]

Esse comando recebe o nome de um tópico SNS, uma mensagem e opcionalmente seus atributos, e executa o envio dessa mensagem para o tópico no serviço configurado da AWS. Exemplo de atributos: {"status":{"DataType":"String","StringValue":"success"}}.

msg send <queue_name> <message>

Esse comando recebe o nome de uma fila Amazon SQS e uma mensagem, e executa o envio dessa mensagem para a fila no serviço configurado da AWS.

msg receive [--batch-size=1] [--wait-seconds=0] <queue_name>

Esse comando recebe o nome de uma fila Amazon SQS, e recupera mensagens dela, removendo-as logo em seguinda. O parâmetro --batch-size define a quantidade máxima de mensagens que serão recuperadas, e o parâmetro --wait-seconds define a quantidade de tempo máximo que o cliente esperará por mensagens.

msg purge <queue_name>

Esse comando recebe o nome de uma fila Amazon SQS, e remove todas as mensagens presentes nela.