datasette-ports 0.4 mostra o PID das instâncias do Datasette em execução para o profiler do Python 3.15

Simon Willison, autor do Datasette, lançou a versão 0.4 do seu plugin datasette-ports. Ele detecta e lista todas as instâncias do Datasette em execução na máquina atual. A versão 0.4 funciona com a última versão do Datasette e passa a mostrar também o PID de cada processo encontrado. A mudança é pequena, mas tem um objetivo prático claro: facilitar a conexão do novo profiler do Python 3.15.

O que mudou na 0.4

O Datasette é uma ferramenta open source para explorar e publicar dados, principalmente de SQLite. Quem trabalha muito com ela costuma acumular vários servidores em portas diferentes: um para um experimento, outro para a base de trabalho, um terceiro esquecido desde a semana passada. O datasette-ports resolve esse problema cotidiano. Ele mostra quais instâncias estão ativas no momento e onde encontrá-las.

O lançamento 0.4 traz duas mudanças:

• o plugin voltou a funcionar com a última versão do Datasette;
• a lista de instâncias encontradas agora inclui o identificador do processo (PID).

O anúncio não traz detalhes sobre o funcionamento interno. O autor se limitou a duas frases e um link para o release no GitHub.

Por que o PID passou a ser necessário

O próprio Willison explica a motivação com um único link. Saber o PID facilita a conexão do novo profiler do Python 3.15. O link leva à seção "sampling profiler" da sua nota sobre o Python 3.15. Pelo que ela indica, o profiler foi pensado para atuar sobre um processo que já está em execução: é preciso informar a qual deles se conectar, e o PID é o identificador mais direto para isso.

Um profiler por amostragem não rastreia cada chamada de função. Em uma frequência definida, ele captura "instantâneos" da pilha de execução e, a partir deles, mostra onde o programa gasta tempo. Essa abordagem costuma gerar menos overhead em um serviço em produção do que o rastreamento completo. Por isso, é conveniente apontá-lo para um Datasette em funcionamento, sem pará-lo nem reiniciá-lo.

O fluxo fica simples. O plugin encontra todos os Datasette na máquina e exibe o PID. O profiler se conecta ao processo desejado. Antes, entre essas duas etapas, era preciso procurar o PID manualmente com ps, lsof ou o gerenciador de tarefas.

Conclusão prática

Para a maioria dos usuários do Datasette, o lançamento não muda nada. Ele é voltado a quem mantém vários servidores ao mesmo tempo e quer entender por que um deles responde devagar. Os cenários típicos são uma consulta SQL pesada, um plugin lento ou uma configuração ruim. Nesses casos, dá para abrir a lista do datasette-ports, pegar o PID da instância em questão e passá-lo ao profiler do Python 3.15.

Quem já usa o plugin deve atualizar para a 0.4, nem que seja pela compatibilidade com o Datasette atual. Quem não usa e costuma ter um único servidor ganha pouco: o PID é fácil de descobrir mesmo sem o plugin.

Para a indústria, o lançamento é mais um indicativo. As novas ferramentas de diagnóstico do próprio Python começam a ganhar pequenos utilitários ao redor no ecossistema. O autor de um projeto popular ajusta suas ferramentas a elas no dia do lançamento, e essa costuma ser a melhor forma de testar um recurso novo em carga real. O anúncio não traz resultados dessas medições, mas Willison provavelmente publicará separadamente suas conclusões sobre a utilidade do profiler para o Datasette.