Changelogs
Versão 0.1.25 (2026-10-29)
INFRAESTRUTURA
- Remova limite de versão do python utilizada de 3.14 para sem limites, para evitar incompatibilidade com novos projetos.
Versão 0.1.24 (2026-09-17)
NOVAS FUNCIONALIDADES
- Adicione suporte a macOS (Apple Silicon e Intel). Binários universais
s3270ec3270(suíte x3270 4.5ga6, TLS via Secure Transport nativo, sem dependência de OpenSSL/Homebrew) passam a vir empyx3270/bin/macos/.X3270(visible=False)usa os3270via pipes (como no Linux) eX3270(visible=True)abre oc3270em uma janela nova do Terminal.app, controlado por socket local (-scriptport), como owc3270no Windows. Antes, qualquer uso no macOS falhava comUnsupportedDistroErrorao tentar ler/etc/os-release.
Versão 0.1.23 (2026-07-23)
CORREÇÕES
- Corrija
X3270.reconnect_hostpara não deixar processos do emulador órfãos: umreturndentro do blocofinallyfazia o código sempre criar uma instância/processo novo, mesmo quando oreconnect()nativo já tinha funcionado na instância atual — e ainda engolia silenciosamente qualquer erro ao tentar encerrar a instância antiga. Agora uma instância nova só é criada quando o reconnect nativo realmente falha, e a instância antiga é sempre encerrada antes (em melhor esforço) para não vazar processos. - Corrija
X3270.terminatepara sempre fechar o app do emulador (self.app.close()), mesmo quando a tentativa de encerrar com educação (Quit/Ignore) falha por completo — cenário real quando o processo já morreu por fora (ex.: usuário fechou a janela do emulador manualmente): oquit()falhava comBrokenPipeError, a tentativa de recuperação viaignore()falhava com o mesmo erro (pipe já quebrado) e, por não estar tratada, abortavaterminate()antes de chegar emself.app.close(). Isso fazia o fechamento dos pipes do processo antigo ficar pendente até o coletor de lixo descartar oPopen, gerando o "Exception ignored in:" visto ao reconectar via pyx3270 record. - Corrija
get_screen_logpara aplicar a cor base do 3270 (verde/vermelho para campos editáveis, azul/branco para campos protegidos, conforme protegido × intensificado do atributo básicoc0) quando o campo não defineSF/SA42=fXexplícito. Antes, campos sem cor estendida (comum em aplicações mais antigas) saíam sem nenhuma cor no dump, mesmo tendo cor na tela real do emulador e no export deprinttext html. - Corrija condição de corrida em
X3270._exec_command: chamadas concorrentes de múltiplas threads sobre a mesma instância (ex.:pyx3270 recordaceitando mais de uma conexão de cliente ao mesmo tempo, como acontece ao reconectar manualmente no emulador) podiam entrelaçar escrita/leitura no pipe do processo do emulador, corrompendo o protocolo de scripting e derrubando a thread comCommandError(resposta toda zerada). Agora o acesso ao processo do emulador é serializado por um lock por instância. - Corrija uma paralisação (starvation) introduzida pelo lock de
_exec_command: o polling depyx3270 record(emu.readbuffer('ebcdic'), chamado a cada iteração do laço de repasse de bytes do proxy) disputava o mesmo lock usado porconnect_host. Enquanto uma conexão estava em negociação, o laço de repasse ficava bloqueado esperando o lock antes de voltar para oselect, parando de repassar os bytes de que a própria negociação precisava para terminar — o que fazia a conexão travar por dezenas de segundos até o timeout interno do emulador ("Host disconnected"), exigindo desconectar/reconectar manualmente. Agora essa leitura usaX3270.try_read_screen_buffer_ebcdic(), uma tentativa não bloqueante (RLock.acquire(blocking=False)) que simplesmente pula a iteração se o pipe do emulador estiver ocupado, em vez de travar o repasse. - Corrija uma race condition em
X3270.reconnect_host: entre oterminate()da instância antiga e a troca para a instância nova (__dict__.update), o objetoemucompartilhado fica comis_terminated=Truepor um instante. Se outra thread (ex.:record_handlerde uma conexão nova aceita nesse meio-tempo pelopyx3270 record) tentar ler o buffer de tela nesse momento, o_exec_commandestouravaTerminatedErrore derrubava a thread. Agorareconnect_hostsegura o lock do emulador durante toda a operação de troca, etry_read_screen_buffer_ebcdictambém trataTerminatedErrorcomo "pular esta iteração", igual já fazia com o pipe ocupado. - Faça
pyx3270 recordcair automaticamente para uma porta local livre quando a porta herdada de--addressestiver bloqueada por permissão (comum no Linux para portas < 1024, ex.: 992), sem exigirsetcap/root. O fallback só entra em ação quando--local-portnão foi informado explicitamente — se o usuário escolher a porta local manualmente e ela estiver bloqueada, o comando continua falhando com a mensagem explicativa, respeitando a escolha explícita. - Faça
pyx3270 recordesperar a negociação 3270 real terminar (mode_3270=True) antes de devolver o controle ao usuário, em vez de assumir "conectado" assim que o comando de conexão é aceito. Sem isso, o terminal podia abrir com a tela em branco (a negociação via proxy até o host de origem ainda não tinha terminado), exigindo desconectar e reconectar manualmente no emulador. - Feche explicitamente stdin/stdout/stderr do processo do emulador em
ExecutableApp.close(), engolindo erro de pipe já quebrado. Antes, se o processo morresse por fora (ex.: usuário fechando a janela do emulador), o fechamento dos pipes ficava pendente até o coletor de lixo descartar oPopen, e o flush de um pipe já quebrado nesse momento aparecia como um "Exception ignored in:" barulhento e fora do nosso controle (visto ao reconectar via pyx3270 recorddepois de fechar a janela do emulador). - Feche o socket/thread de escuta anterior antes de abrir um novo a cada reinício do loop de
pyx3270 record/pyx3270 replay(usuário digitando "S" para continuar). Antes, cada reconexão criava um novo listener na mesma porta (viaSO_REUSEPORT) sem nunca fechar o anterior, deixando sockets e threads de aceitação órfãos acumulando indefinidamente — possível causa de comportamento inconsistente (ex.: "Not Connected") ao reconectar várias vezes.start_server_threadagora também devolve o socket de escuta para o chamador poder fechá-lo, e a thread de aceitação trataOSError(socket fechado de propósito) sem crashar.
Versão 0.1.22 (2026-07-23)
CORREÇÕES
- Adicione suporte à distribuição Debian, usando os mesmos binários já validados para Ubuntu. Distribuições Linux não mapeadas explicitamente agora tentam usar os binários do Debian como fallback antes de falhar com
UnsupportedDistroError.
Versão 0.1.21 (2026-07-20)
NOVAS FUNCIONALIDADES
- Detecção automática da distribuição Linux (via
/etc/os-release) para selecionar o binário correto des3270/x3270(Ubuntu empyx3270/bin/linux/, Nobara empyx3270/bin/linux/nobara/). Distribuições não suportadas agora falham com uma mensagem clara (UnsupportedDistroError), listando as distros suportadas e orientando a abrir uma issue no GitHub solicitando suporte.
CORREÇÕES
- Adicione suporte a diferentes distribuições Linux, atualmente somente ubunto e nobara.
- Adicione tratativa para envio de caracteres inválidos no método send_string.
send_stringagora remove caracteres de controle (ex:\x1a) além dos caracteres especiais já tratados, evitando falhas na interface de scripting do emulador, e registra um aviso (warning) no log quando isso ocorre.
Versão 0.1.20 (2026-07-13)
NOVAS FUNCIONALIDADES
- Adicione
get_screen_logemX3270Cmd, que retorna o dump completo da tela (com quebras de linha reais) convertendo cores e destaques de campo do 3270 em sequências ANSI (SGR), formato renderizado nativamente por painéis de logs como o do Grafana/Loki. Campos non-display (ex.: senha) são mascarados por padrão (mask_hidden=True). - Inclua metodo para log de campos com cor e ajuste demais logs.
Versão 0.1.19 (2026-06-19)
CORREÇÕES
- Adicione pausa de 0.1 após segundo pf1 de _exec e após mudança de diretório de reprodução de telas em modulo offline.
- Adicione raise para casos onde KeyboardStateError permanece consecutivamente.
Versão 0.1.17 (2026-05-16)
CORREÇÕES
- Ajuste interface de AbstractEmulatorCmd e adicione *args e **kwargs para comandos next e prev de PyX3270Manager (Offline).
Versão 0.1.16 (2026-05-16)
CORREÇÕES
- Inclua a opção de wait_input_field em send_enter para evitar bugs de time e adicione padrão wait_unlock para aguardar host após 0.03s em todos os métodos que utilizam.
Versão 0.1.15 (2026-05-13)
CORREÇÕES
- Troque Wait(0.03, 'seconds') por sleep(0.03) em clear_screen.
Versão 0.1.13 (2026-05-04)
CORREÇÕES
- Corrija conta para captura de strings da tela na função _get_ypos_and_xpos_from_index.
Versão 0.1.10 (2026-03-12)
CORREÇÕES
- Adicione variável run_raise para validação de comandos que não podem ser tratados com KeyboardStateError.
Versão 0.1.10 (2026-03-06)
CORREÇÕES
- Ajuste log de send_string incluindo a devida f-string para apresentar o dado nos logs.
TESTES
- Arrume os testes para validação de limpeza de tela e de troca de diretório em reprodução.
Versão 0.1.10 (2026-02-26)
INFRAESTRUTURA
- Ajuste versão de dependencias do typer.
Versão 0.1.9 (2026-02-23)
CORREÇÕES
- Adicione 0.03s após clear de tela, para garantir a limpeza.
Versão 0.1.8 (2026-02-06)
CORREÇÕES
- Ajuste nivel dos logs para limpeza de tela e envio de string None para debug, para não subir warnings desnecessarios.
Versão 0.1.7 (2025-12-23)
CORREÇÕES
- Corrija fechamento seguro em caso de KeyboardInterrupt.
- Corrija reinicialização em caso de reinicializar record.
- Corrija set para troca de telas.
Versão 0.1.4 (2025-09-18)
CORREÇÕES
- Corrija caminho completo de WS3270.exe
Versão 0.1.3 (2025-09-18)
NOVAS FUNCIONALIDADES
- Inclua hook para passar pasta com emulador ao gerar executável com pyinstaller.
Versão 0.1.2 (2025-09-17)
CORREÇÕES
- Corrija gravação de tela com TLS ativa.
Versão 0.1.1 (2025-08-25)
CORREÇÕES
- Inclua join por espaço em get_full_string para adequação com versão anterior a LIB.
OBSOLETOS
- Inclua comandos depreciados da versão antiga utilizada antes da criação da LIB.
DOCUMENTAÇÃO
- Inclua titulos para os comandos builtins do x3270.
TESTES
- Ajuste os testes para comportar alteração de join com espaço.
INFRAESTRUTURA
- Altere versão limite do python para <3.14.
Versão 0.1.0 (2025-08-24)
NOVAS FUNCIONALIDADES
- Adicione classe PyX3270Manager base para herança na criação de classes de sistemas offline.
- Adicione comandos para utilização de todos os métodos originais disponíveis no terminal.
- Adicione erros customizados herdados de Exception para cada tipo de exceção do terminal.
- Adicione funcionalidade set_screen e add para server record.
- Adicione server para gravação e reprodução de telas em modo offline.
CORREÇÕES
- Adicione server.replay_handler leitura de teclas não é feita quando servidor de aplicações abre em modo sem emulador.
- Aumente de tempo limite para aguardo de desbloqueio padrão (time_unlock) de 30 para 60 segundos.
- Corrija captura em função get_string_area para pegar até a ultima linha passada no parametro.
TESTES
- Adicione maior cobertura de testes para os módulos cli, exceptions offline.
- Adicione testes para emulador e para server.