Reiniciar o script (os.restart)

Declaração

sucesso_da_operacao, mensagem_de_erro = os.restart([ caminho_do_arquivo_do_script ])

Parâmetro

• caminho do arquivo do script
  Texto, parâmetro opcional. Quando um caminho válido de arquivo de script é fornecido, o script é reiniciado no arquivo de destino; o padrão é "".

Valores de retorno

• sucesso da operação
  Booleano; retorna false quando a operação falha. A falha só é possível quando o parâmetro caminho do arquivo do script é fornecido; quando a operação é bem-sucedida, a função não retorna (o processo foi reiniciado).
• mensagem de erro
  Texto; quando a operação falha, retorna a mensagem de erro correspondente.

Descrição

Sem caminho do arquivo do script, a função reinicia diretamente o processo do script atual, que é encerrado imediatamente.
Quando um caminho do arquivo do script válido é fornecido, o script atual é encerrado e o arquivo de script de destino é iniciado novamente.
Quando a operação falha, a função retorna false com uma mensagem de erro; normalmente, a falha é causada por parâmetros inválidos.

Observações importantes

Script atual refere-se ao script carregado na inicialização; depois que o arquivo do script é modificado, os.restart() não carrega o arquivo modificado.
Não use esta função em um ambiente com várias threads, a menos que seja necessário.
Reinícios sem atraso podem causar outros problemas lógicos, que devem ser evitados pelo autor do script.

Exemplo 1

os.restart() -- reinicia o “script atual” (não o “arquivo do script atual”)

Exemplo 2

os.restart(utils.launch_args().path) -- reinicia o “arquivo do script atual”

Nota: o código acima usa a função utils.launch_args, que não pertence a este capítulo.