g.messagegrass - Online na nuvem

PROGRAMA:

NOME

g.mensagem - Imprime uma mensagem, aviso, informação de progresso ou erro fatal no modo GRASS.
Este módulo deve ser usado em scripts para mensagens servidas ao usuário.

CHAVES

geral, suporte, scripts

SINOPSE

g.mensagem
g.mensagem --Socorro
g.mensagem [-casamento] mensagem=corda [depurar=número inteiro] [-ajudar] [-detalhado] [-calma]
[-ui]

Sinalizadores:
-w
Imprimir mensagem como aviso

-e
Imprimir mensagem como erro fatal

-d
Imprimir mensagem como mensagem de depuração

-p
Imprimir mensagem como informação de progresso

-i
Imprimir mensagem em todos os modos, exceto no modo silencioso
A mensagem é impressa em GRASS_VERBOSE> = 1

-v
Imprimir mensagem apenas no modo detalhado
A mensagem é impressa apenas em GRASS_VERBOSE> = 3

--Socorro
Imprimir resumo de uso

--verbose
Saída detalhada do módulo

--quieto
Saída silenciosa do módulo

--ui
Forçar o lançamento da caixa de diálogo da GUI

parâmetros:
mensagem=corda [obrigatório]
Texto da mensagem a ser impressa
A mensagem é impressa em GRASS_VERBOSE> = 2

depurar=número inteiro
Nível a ser usado para mensagens de depuração
opções: 0-5
Padrão: 1

DESCRIÇÃO

Este programa deve ser usado em scripts Shell / Perl / Python, então o autor não precisa
use o programa de eco. A vantagem de g.mensagem é que formata mensagens exatamente como
outros módulos GRASS fazem e que sua funcionalidade é influenciada pelo GRASS_VERBOSE e
Variáveis ​​de ambiente GRASS_MESSAGE_FORMAT.

O programa pode ser usado para mensagens informativas padrão, bem como avisos (-w bandeira)
e erros fatais (-e bandeira). Para fins de depuração, o -d bandeira vai causar g.mensagem para
imprimir uma mensagem de depuração no nível fornecido.

NOTAS

Mensagens contendo "=" devem usar o completo mensagem = sintaxe para que o analisador não obtenha
confuso.

Se você quiser que uma mensagem longa (várias linhas) seja tratada como um único parágrafo, use um
uma única chamada para g.mensagem com o texto dividido no script usando a barra invertida como o último
personagem. (Em scripts de shell, não feche a "citação")

Uma linha em branco pode ser obtida com
g.message message = ""

Os espaços em branco redundantes serão eliminados.

É aconselhável fazer aspas simples nas mensagens que devem ser impressas literalmente. Previne
vários caracteres (principalmente, espaço e o cifrão '$') de serem tratados
especificamente pelo shell.

Quando é necessário incluir, por exemplo, o valor de uma variável como parte da mensagem,
as aspas duplas podem ser usadas, o que não priva o cifrão de seu
poderes de expansão variável.

Embora seja sabido que as instâncias interativas do Bash podem tratar o ponto de exclamação '!'
caractere especificamente (tornando necessária a citação única), não deveria ser o caso
para as instâncias não interativas do Bash. No entanto, para evitar confusão baseada no contexto
mais tarde, você será incentivado a enviar mensagens de aspas simples que não requeiram $ VARIABLE
expansão.

Uso in Python Scripts
GRASS Python Scripting Library define wrappers especiais para g.mensagem.

· Debug () para g.message -d

· Error () para g.message -e

· Fatal () para g.message -e + exit ()

· Info () para g.message -i

· Mensagem () para g.message

· Verbose () para g.message -v

· Aviso () para g.message -w

Nota: o shell Python no wxGUI pode ser usado para inserir o seguinte código de amostra:

importar grass.script como gcore
gcore.warning ("Este é um aviso")
é idêntico a
g.message -w message = "Este é um aviso"

VERBOSIDADE NÍVEIS
Controlado pela variável de ambiente "GRASS_VERBOSE". Normalmente, isso é definido usando o
--quieto or --verbose opções de linha de comando.

· 0 - apenas erros e avisos são impressos

· 1 - as mensagens de progresso são impressas

· 2 - todas as mensagens do módulo são impressas

· 3 - mensagens detalhadas adicionais são impressas

DEBUG NÍVEIS
Controlado pela GRAMA "DEBUG" gisenv variável (definida com g.gisenv).
Níveis recomendados:

· 1 - a mensagem é impressa uma ou poucas vezes por módulo

· 3 - cada linha (raster) ou linha (vetor)

· 5 - cada célula (raster) ou ponto (vetor)

Use g.messagegrass online usando serviços onworks.net