LibSoup

O LibSoup é uma biblioteca cliente e de servidor HTTP (Hypertext Transfer Protocol) completamente livre, fácil de usar e de código aberto usada em uma ampla variedade de aplicativos projetados para o ambiente gráfico GNOME, rodando sob sistemas operacionais baseados em kernel Linux.

O projeto LibSoup usa a poderosa biblioteca GLib como um loop principal e o software GObjects para integrar com a maioria dos aplicativos GNOME. Suporta proxy, incluindo autenticação e tunelamento SSL.

A biblioteca armazena automaticamente as conexões em cache, contém APIs assíncronas (baseadas no GMainLoop e chamadas de retorno) e síncronas (Interfaces de Programação de Aplicativos) e suporta SSL (Secure Sockets Layer) através do GnuTLS.

Entre outros recursos interessantes, podemos mencionar o suporte ao cliente para Digest, autenticação básica e NTLM, suporte a cliente e servidor para XML-RPC, suporte a proxy, incluindo autenticação e encapsulamento SSL, além de suporte a servidor para autenticação Basic e Digest .

Primeiros passos com o LibSoup

Para instalar a biblioteca LibSoup no seu sistema operacional GNU / Linux, você terá que baixar a versão mais recente do software da Softoware, salvá-la em um local de sua escolha e descompactá-la no diretório atual.

Abra um aplicativo Terminal, navegue até o local onde você extraiu o arquivo (por exemplo cd /home/softoware/libsoup-2.49.1), execute o & lsquo; ./ configure && make & rsquo; comando para configurar e compilar o programa, depois execute o & lsquo; ./configure && make & rsquo; comando para configurar o programa.

Após uma operação de compilação bem-sucedida, execute um dos comandos & lsquo; make install & rsquo; ou & sudo make install & rsquo; comandos, dependendo se você estiver root ou um usuário com privilégios, para instalar o sistema LibSoup em todo o sistema e começar a usá-lo em seus projetos.

O que há de novo nesta versão:

• Simplifique o soup_hosts_matches_host () [Claudio Saavedra]
• Adicione novos testes para pontos finais em nomes de domínio [Claudio Saavedra]
• Tradução em turco atualizada

O que há de novo na versão 2.63.2:

• Muitas correções para o suporte ao sistema de compilação do meson [# 795324, # 782410, Tomas Popela, Jan Alexander Steffens]
• Correções para o teste xmlrpc-server com PHP & gt; = 7.2 e relacionadas [# 795111, # 782410 Jan Alexander Steffens]
• Corrigir aviso crítico no SoupSocket [Carlos Garcia Campos]
• Traduções atualizadas: romeno, friulano, esloveno, tcheco, espanhol, indonésio, chinês (China).

O que há de novo na versão:

• tld-parser: use o Python 3 [# 785735, Ross Burton ]
• Corrigir estouro de buffer de heap em soup_ntlm_parse_challenge () [# 788037, Milan Crha]
• Corrija o valor possivelmente não inicializado no teste ssl. [Tomas Popela]
• SoupCache: corrija o timestamp das respostas [# 791031, Claudio Saavedra]

O que há de novo na versão 2.60.2:

• Corrigir erros de documentação [# 788920, Nirbheek Chauhan]

Aviso de
• format-zero-length disparado em soup-logger.c [# 789096, Tomas Popela]
• Avisos ao gerar arquivos de inespecificação [# 789099, Tomas Popela]
• Visual Studio cria: aprimora a segurança de binários x64 [Chun-wei Fan]
• Tradução atualizada: nepalês.

O que há de novo na versão 2.60.0:

• Traduções novas / atualizadas: catalão, dinamarquês, holandês, nepalês.

O que há de novo na versão 2.58.1:

• Reverte uma alteração no SoupSession para fechar todas as conexões abertas quando a propriedade: proxy-resolver for alterada [# 777326; essa mudança foi feita em 2.58.0, mas acidentalmente deixada de fora do NEWS para essa versão]; embora esse comportamento tenha feito: proxy-resolvedor mais consistente com: proxy-uri, acabou quebrando o Evolution EWS. [# 781590]
• Corrigido comportamento indefinido em testes / análise de cabeçalho que poderia fazer com que o teste falhasse falsamente. [# 777258]
• Atualizações para os testes de configuração do Apache para uso em testes /:
• Largou o suporte para o Apache 2.2
• Suporte PHP alterado do PHP 5 para o PHP 7
• o mod_unixd agora pode ser incorporado ou carregado dinamicamente [# 776478]
• Traduções atualizadas:
• Turco

O que há de novo na versão 2.57.1:

• Alterações no libsoup de 2.56.0 a 2.57.1:
• Adicionado SoupWebsocketConnection: keepalive-interval, para fazer uma conexão enviar pings regulares. [# 773253, Ignacio Casal Quinteiro]
• Adicionadas soup_auth_manager_clear_cached_credentials () e SOUP_MESSAGE_DO_NOT_USE_AUTH_CACHE, para permitir maior controle sobre o uso de credenciais de autenticação HTTP em cache. [# 774031, # 774033, Carlos Garcia Campos]
• Corrigido o uso de SoupSession: valores de proxy-uri contendo senhas. [# 772932, Jonathan Lebon]
• Várias correções menores do WebSocket [Ignacio Casal Quinteiro]:
• Evite enviar dados depois de começarmos a fechar a conexão [# 774957]
• Não registre um crítico se o par enviar um código de status de fechamento inválido
• Registrar uma mensagem de depuração quando um "pong" é recebido
• Introspecção fixa de soup_message_headers_get_content_range () [Jasper St. Pierre]
• Anotações de Vala [obsoletas] substituídas com [Versão] para evitar avisos de criação [# 773177, Evan Nemerson]
• Melhorias no build do MSVC (Chun-wei Fan)
• Sequências de mensagens / erros atualizadas para usar pontuação Unicode. [# 772217, Piotr Drag]
• Traduções atualizadas:
• Tcheco, friulano, alemão, hebraico, húngaro
• Norwegian bokmal, polonês, sueco

O que há de novo na versão 2.56.0:

• Adicionada a propriedade SoupWebsocketConnection: max-incoming-payload-size, para substituir o tamanho máximo de payload de entrada padrão. [# 770022, Ignacio Casal Quinteiro]
• Adicionados símbolos soup-version.h (em particular soup_check_version ()) à introspecção. [# 771439, Rico Tzschichholz]
• Atualização da cópia da lista de sufixos públicos usada pelo SoupTLD [# 769650, Michael Catanzaro]
• Traduções atualizadas:
• inglês britânico, grego, polonês

O que há de novo na versão 2.54.1 / 2.56.0 Beta:

• Suporte removido para fallback SSLv3; os sites que rejeitam handshakes TLS 1.x agora falharão com um erro. (Firefox e Chrome já mudaram para esse comportamento.) [# 765940, Dan Winship]
• Corrigida a análise de & lt; double & gt; s no novo código XMLRPC baseado em GVariant. [# 767707, Dan Winship]
• Fixed soup_server_set_ssl_cert_file (), que foi adicionado em 2.48 mas não funcionou ... [patch na libsoup-list de Sean DuBois]
• Adicionadas propriedades do GObject ao SoupLogger para torná-lo amigável aos bindings. [# 768053, Jonh Wendell]
• Corrigido erro de compilação no FreeBSD [# 765376, Ting-Wei Lan]
• Compilação corrigida com certas novas versões do glibc que definem "EOF" como uma macro. [# 768731, Philip Withnall]
• Atualizado m4 / ax_code_coverage.m4 com suporte para lcov 1.12 [Philip Withnall]
• Arquivos PO atualizados para futuras versões do gettext [Piotr Drag]
• Novas / atualizadas traduções:
• occitano, gaélico escocês

O que há de novo na versão 2.53.2:

• Corrigido manipulação de visibilidade de símbolos para o mingw, copiando o sistema da GLib [Ignacio Casal Quinteiro, # 757146]
• Finalmente marcou os métodos antigos SoupSessionAsync e SoupSessionSync como preteridos [Ignacio Casal Quinteiro, Dan Winship, # 757146]
• Adicionado libsoup-2.4.deps para valac [Rico Tzschichholz]
• Tornar possível construir a partir do git sem o gtk-doc sendo instalado [Ignacio Casal Quinteiro]
• Traduções atualizadas: bokmal norueguês, occitânico

O que há de novo na versão 2.51.3:

• Corrigido "fazer verificação" em idiomas não ingleses [rh # 1224989, # 749397]
• Corrigidos alguns avisos do compilador [# 748514, Philip Withnall]
• Novas / traduções atualizadas:
• aragonês, catalão, occitano, russo

O que há de novo na versão 2.50.0:

• Traduções atualizadas: Basco, Chinês (Formosa), Dinamarquês, Indonésio, Norueguês bokmal

O que há de novo na versão 2.49.1:

• Corrigido um erro no SoupMessage: sinal de evento que quebrou a capacidade da evolução de se conectar a hosts https com certificados "ruins". [# 739951, Dan Winship]
• Corrigido um caso em que os caminhos de códigos assíncronos poderiam potencialmente bloquear uma gravação síncrona [# 727138, Dan Winship]
• Corrigido o símbolo soup_server_set_ssl_cert_file () para ser exportado e adicionado soup_server_get_uris () à documentação. [Tristan Van Berkom]
• Aprimorou um monte de anotações de introspecção [# 729987, Evan Nemerson]
• Esclareceu alguma documentação. [Tristan Van Berkom, Dan Winship]
• Construção fixa do Windows, duas vezes [# 738003, Kouhei Sutou e # 738551, Kalev Lember].
• Traduções atualizadas: bengali (indiano), chinês (tradicional), italiano, letão, sérvio, télugo, ucraniano

O que há de novo na versão 2.48.1:

• Corrigido um erro no SoupMessage: sinal de evento que quebrou a capacidade da evolução de se conectar a hosts https com certificados "ruins". [# 739951, Dan Winship]
• Corrigido um caso em que os caminhos de códigos assíncronos poderiam potencialmente bloquear uma gravação síncrona [# 727138, Dan Winship]
• Corrigido o símbolo soup_server_set_ssl_cert_file () para ser exportado e adicionado soup_server_get_uris () à documentação. [Tristan Van Berkom]
• Aprimorou um monte de anotações de introspecção [# 729987, Evan Nemerson]
• Esclareceu alguma documentação. [Tristan Van Berkom, Dan Winship]
• Construção fixa do Windows, duas vezes [# 738003, Kouhei Sutou e # 738551, Kalev Lember].
• Traduções atualizadas: bengali (indiano), chinês (tradicional), italiano, letão, sérvio, télugo, ucraniano

O que há de novo na versão 2.45.3:

• A documentação foi finalmente atualizada para refletir as novas APIs adicionadas em 2.42.
• Adicionadas as propriedades GBYtes-value: request-body-data e: response-body-data ao SoupMessage, o que deve ajudar algumas ligações.
• Agora configuramos o TCP_NODELAY nos soquetes, melhorando um pouco o throughput. Em particular, isso evita uma viagem extra desnecessária no handshake TLS.
• As APIs do SoupSession que retornam GErrors agora retornam os erros de gio subjacentes reais no caso de falhas de conexão e afins.
• Atualizou a cópia da lista Public Suffix usada pelo soup-tld.

O que há de novo na versão 2.42.3:

• Corrigido um erro de autenticação ao usar o NTLM ao se conectar a um site https em um proxy; o código estava ficando confuso e achando que a resposta 200 OK ao CONNECT significava que a autenticação NTLM havia sido bem-sucedida. [# 698728, Dan]
• Corrigido um bug que poderia fazer com que as sessões síncronas ficassem presas em um estado em que nenhuma nova mensagem seria processada. [# 703463, Philip Withnall]
• Corrigido um bug no código do conjunto de conexões, que em certos casos, acidentalmente, continuaria usando uma conexão depois que uma mensagem fosse cancelada enquanto em andamento, fazendo com que a próxima solicitação nessa conexão obtivesse a resposta para a solicitação anterior, etc. [# 708006, David Woodhouse]
• Corrigido alguns problemas ao voltar do NTLM de samba com logon único para o NTLM comum de pedir por senha. [# 703186, David Woodhouse]
• Se você chamasse g_input_stream_close () em um GInputStream de SoupRequests antes de terminar de lê-lo, ele bloquearia até que o resto da resposta fosse lida (o que, por exemplo, um fluxo de áudio infinito significava que ele bloquearia para sempre). [# 695652, Dan]
• Traduções atualizadas: indonésio

O que há de novo na versão 2.44.2:

• Corrigido travar com streams de rádio da internet no Rhythmbox (e em alguns outros lugares).
• Corrigido vazamento de conexão ao cancelar o fechamento de uma mensagem GInputStream.
• Conectou alguns vazamentos de memória.
• Corrija a compilação com --without-ntlm.
• Corrigidos alguns avisos.
• Teste de conexão fixa para passar com glib atual.
• Os testes agora são mais detalhados por padrão em "make check", já que o automake atual apenas redireciona toda a saída para um arquivo de log de qualquer maneira.

O que há de novo na versão 2.44.1:

• Se você chamasse g_input_stream_close () em SoupMessage ou GInputStream de SoupRequests antes de terminar de lê-lo, ele bloquearia até que o resto da resposta fosse lida (o que, por exemplo, um fluxo de áudio infinito, significava que bloquear para sempre). Esta foi uma mudança não intencional de 2,42 e agora está corrigida. [# 695652, Dan]
• soup_session_queue_message () em uma SoupSession simples (não SoupSessionAsync) estava operando de forma síncrona em vez de assíncrona como deveria. [# 707711, Dan]

Agora, os métodos
• soup-form usam as regras HTML5 x-www-form-urlencoded, em vez das HTML4. (Em particular, eles saem
• "-", "_" e "." não codificado.) [# 708621, Alban Browaeys]
• Os programas de teste agora solicitam explicitamente o backend GSettings de "memória", o que significa que não imprimirão um aviso se o conseguirem acidentalmente e não usarão acidentalmente as configurações de proxy do dconf se o backend do dconf estiver disponível. [Dan]
• Corrija a SoupSession para que, se você substituir a configuração do proxy no tempo de construção, não tente resolver o GProxyResolver padrão. (Isto é importante, em particular, para programas que esperam rodar fora de uma sessão de usuário, o que, de outra forma, enviaria erros do backend GSettings do dconf sobre não conseguir se conectar ao dconf.) Da mesma forma com as configurações TLS e o backend TLS. [# 708696, Dan]
• Corrigir a propriedade SoupServer: tls-certificate; soup_server_is_https () não tinha sido atualizado para reconhecê-lo e, portanto, retornaria FALSE, o que, por sua vez, significava que o servidor retornaria 400 Bad Request em resposta a solicitações https. [# 709647, Fabiano FidA & ord.; Ncio]
• Corrigida uma falha esporádica nos testes / teste de conexão. [Dan]
• Traduções atualizadas:
• Tadjique

O que há de novo na versão 2.44.0:

• Traduções novas / atualizadas: holandês, indonésio.

O que há de novo na versão 2.44 Beta 1:

• Corrigido o tratamento de solicitações de intervalo insatisfeitas no SoupServer [apontado na lista de discussão, Dan]. Além disso, adicionamos mais documentação, esclarecendo que você não precisa lidar com as solicitações de intervalo em muitos casos.
• Corrigido o tratamento de literais de endereço IPv6 com IDs de escopo. (Requer o mais recente glib, bem como para a correção completa.) [# 669724, Dan]

O que há de novo na versão 2.43.5:

O
• SoupProxyURIResolver agora está obsoleto em favor da propriedade SoupSession: proxy-resolver (que usa um GProxyResolver). [# 680273, Dan]
• A enumeração SoupKnownStatusCode agora é chamada de SoupStatus. O nome antigo continua existindo como um alias, mas está obsoleto. (Esta alteração não tem efeito visível no C;. É principalmente para ajudar ligações de linguagem, de modo que, por exemplo, SOUP_STATUS_NOT_FOUND mapas para "Soup.Status.NOT_FOUND" em vez de "Soup.KnownStatusCode.NOT_FOUND") [# 684409, Dan]
• Corrigida a análise de esquemas de URI em SoupURI (em particular, para permitir nomes de esquema com dígitos neles). [# 703776, Dan]
• Corrigido o SoupLogger para imprimir os cabeçalhos de resposta de uma mensagem, mesmo que a mensagem seja cancelada antes que o corpo da resposta completa seja recebido. [# 703200, Andres Gomez]
• Corrigido um problema de compilação em locais não UTF-8 [# 702534, Ross Lagerwall]
• SoupSession agora avisa se você usa soup_session_pause_message () ou soup_session_unpause_message () em uma mensagem síncrona (que nunca funcionou, embora esse fato não tenha sido documentado). [# 703461, Philip Withnall]

O que há de novo na versão 2.43.4:

• Corrigido um bug que poderia fazer com que as sessões síncronas ficassem presas em um estado em que nenhuma nova mensagem seria processada. [# 703463, Philip Withnall]
• Corrigido outro vazamento de memória no SoupSocket (encontrado ao adicionar um caso de teste para # 700472)
• Comutado para usar g_cclosure_marshal_generic () em vez de usar glib-genmarshal. [# 686042, Olivier Blin]
• Changed SoupServer para chamar unref () na tabela de hash de consulta após chamar o manipulador, em vez de destroy (), para que o manipulador possa manter uma cópia dos dados da consulta, se desejar. [# 702793, Bernhard Schuster]
• Corrigidas algumas anotações de introspecção
• Exemplos atualizados / use o SoupLogger e permita redirecionar a saída para um arquivo [# 703231, # 703229, Andres Gomez]

O que há de novo na versão 2.43.2:

• Corrigido um erro de autenticação ao usar o NTLM ao se conectar a um site https em um proxy; o código estava ficando confuso e achando que a resposta 200 OK ao CONNECT significava que a autenticação NTLM havia sido bem-sucedida. [# 698728, Dan]
• Corrigido vazamento de memória no SoupSocket. [# 700472, Richard RA & par; jfors]
• Corrigido um erro de inclusão ausente em algumas plataformas [# 700003, Erik van Pienbroek]
• Corrigidos avisos ao executar o backend TLS "fictício". [# 700518, Dan]

O que há de novo na versão 2.43.1:

• A inclusão não puxa mais os cabeçalhos de rede do sistema. Isso pode fazer com que alguns pacotes não sejam mais compilados, se eles estiverem dependendo acidentalmente disso. Adicionar "#include" irá consertá-los no unix e no Windows. (Isso foi feito como parte da correção da compilação no Windows.) [# 692134, Dan]

O que há de novo na versão 2.42.2:

• SoupSession corrigida: proxy-resolver [# 698163, Dan]
• Outras correções de build do win32 [# 692134, Dan]
• Corrigidos vários programas de teste para ainda funcionar se o glib-networking não estiver instalado [Dan] e consertado outro para continuar funcionando se o kernel não tiver suporte a IPv6. [# 698220, Dan]

O que há de novo na versão 2.42.0:

• Corrigido um aviso do compilador em 32 bits em um programa de teste. [Kalev Lember]
• Traduções novas / atualizadas: hindi, kannada, coreano, malaiala, marata, odia, persa, tadjique, tâmil, telugu.

O que há de novo na versão 2.41.92:

• Corrigido um bug que fazia com que o libsoup tentasse novamente uma senha incorreta repetidamente, para sempre, em um determinado caso que afetou os calendários do Google em evolução em particular. [Red Hat bug # 916224, Dan]
• Também foi adicionado código para tornar esses loops de repetição infinitos impossíveis no futuro. [Dan]
• Corrigido o tratamento de URIs por SoupRequestData com "" neles. [# 695246, A & frac12; um DoberAek]
• Adicionada a propriedade SoupSession: proxy-resolver, para substituir o GProxyResolver usado por uma sessão. (Isso significa que agora existem três maneiras diferentes de controlar a resolução de proxy no SoupSession ... isso será limpo um pouco depois de 2.42.) [# 680273, Dan]
• Adicionou G_BEGIN_DECLS / G_END_DECLS em falta a soup-message-headers.h, para que as suas funções possam ser chamadas a partir do C ++. [Carlos Garcia Campos]
• Traduções atualizadas: Assamês, bielorrusso, português do Brasil, catalão (valenciano), catalão, dinamarquês, estoniano, francês, grego, gujarati, húngaro, italiano, letão, português, russo, esloveno, tailandês

O que há de novo na versão 2.41.91:

• Corrigido uma falha que apareceu com solicitações XMLRPC no WebKitGTK. [# 694920, Sergio]
• Consertou o SoupCache para atualizar os cabeçalhos em cache quando recebeu uma resposta não modificada e adicionou um teste para isso. [# 695121, Sergio]
• o libsoup agora é construído sob o automake 1.13 (e "make check" funciona sob o harness de teste paralelo, que é o padrão em 1.13) [# 694135]
• O diretório tests / agora contém apenas programas de teste reais que são executados por "make check", e os programas que se destinam mais como código de exemplo estão sob os exemplos /.
• Traduções novas / atualizadas: aragonês, chinês (tradicional), tcheco, galego, hebraico, lituano, norueguês bokmA & yen; l, punjabi, espanhol, uigur, vietnamita

O que há de novo na versão 2.41.90:

• Adicionada a SoupSession: propriedade de endereço local, que permite forçar conexões a serem vinculadas a um determinado endereço local (por exemplo, para controlar a interface usada). [# 693215, Jonh Wendell]
• Corrigido o SoupCache para manipular corretamente as mensagens canceladas e adicionar testes para isso. [# 692310, Sergio]
• Corrigido um vazamento de referência no SoupCache que resultou em epifania interrompida por vários segundos na saída e, em seguida, acabou imprimindo "Acabamento de cache concluído apesar de X solicitações pendentes". E acrescentou mais testes. [# 682527, Sergio]
• Fixed SoupAuthNTLM para que SoupSession: authenticate seja emitido com repetição = TRUE se a primeira tentativa falhar (ou seja, faça funcionar da mesma forma que SoupAuthBasic e SoupAuthDigest). [# 693222, Dan]
• Corrigida a propriedade SoupSession: add-feature-by-type para aceitar recursos que não são do SoupSessionFeature (por exemplo, tipos de autenticação) [Dan]
• Corrigido um bug de compilação que quebrava todos os testes baseados em apache se você não tivesse o PHP instalado. [# 693311, Dan]
• Traduções atualizadas: malaiala, polonês, sérvio, eslovaco

O que há de novo na versão 2.41.5:

• Revertida a mudança para o tratamento de senhas do SoupURI a partir de 2.41.4, uma vez que ela quebrou algumas coisas. [# 692149, Dan]
• Evite um g_return_if_fail () ao carregar o SoupSession: o arquivo ssl-ca falha. [# 691930, Guillaume Desmottes]
• Corrigido um bug no SoupBodyInputStream que fazia com que os redirecionamentos no WebKitGTK fossem interrompidos. [# 692026, Sergio]
• Traduções atualizadas: bielorrusso, chinês (tradicional), alemão, italiano, norueguês bokmA & yen; l, sérvio, uigur