Como comentado, uma opção para exibir o debug de variáveis é utilizando o módulo inspect
. Com auxílio da função inspect.stack
você consegue verificar o contexto de onde a função foi executada e acessar as variáveis locais e globais nesse contexto. Assim, ao invés de você passar a própria variável para função, você pode passar apenas o nome dela que a função se encarregará de acessar o respectivo valor por inspeção. Para este exemplo usei ainda o módulo tabulate
para formatar a saída de forma fácil e legível.
import inspect
import tabulate
def debug(*args):
# Busca o contexto de quem chamou a função debug:
context = inspect.stack()[1][0]
# Obtém detalhes de onde foi executado o debug:
filename = context.f_code.co_filename
linenumber = context.f_lineno
# Resultados a serem exibidos:
result = []
# Percorre todas as variáveis a serem exibidas:
for name in args:
# Verifica se é uma variável local no contexto:
if name in context.f_locals:
result.append([name, context.f_locals[name]])
# Verifica se é uma variável global no contexto:
elif name in context.f_globals:
result.append([name, context.f_globals[name]])
# Variável não encontrada no contexto:
else:
result.append([name, 'Não encontrada'])
# Exibe os resultados em forma de tabela:
print(f'[DEBUG] {filename} ({linenumber})')
print(tabulate.tabulate(result, headers=['Variável', 'Valor']))
Um exemplo de uso seria:
>>> x, y, nome = 1, 2, 'Anderson Carlos Woss'
>>> debug('x', 'y', 'nome', 'foo')
[DEBUG] python (34)
Variável Valor
---------- --------------------
x 1
y 2
nome Anderson Carlos Woss
foo Não encontrada
Veja funcionando no Repl.it
Exemplo de chamada dentro de uma função
Fazendo o debug
de uma variável local e outra global:
autor = "Anderson Carlos Woss"
def hello(nome):
debug('nome', 'autor')
print(f'Olá, {nome} (por {autor})')
hello('John Doe')
Veja funcionando no Repl.it
A saída será:
[DEBUG] python (37)
Variável Valor
---------- --------------------
nome John Doe
autor Anderson Carlos Woss
Olá, John Doe (por Anderson Carlos Woss)
Porém, para a expressão, tal como fazer x+y*2
a função não irá funcionar. É possível implementar a função para tal, mas acredito que será inviável. Será muito mais simples você atribuir a expressão a uma outra variável e passa-la para a função. Por exemplo:
>>> x, y = 1, 2
>>> x_plus_2y = x + 2*y
>>> debug('x', 'y', 'x_plus_2y')
Exibindo:
[DEBUG] python (38)
Variável Valor
---------- -------
x 1
y 2
x_plus_2y 5
debug(*args)
para receber quantos parâmetros precisar, mas a variável passa a serargs
e não maisx
,y
ou uma expressão. Parax
ey
você consegue trabalhar com o valor retornado porlocals()
, mas quanto a expressão, não sei se consegue fazer; talvez cominspect
, precisaria analisar melhor.