beast
1.0.0
| Filial | Linux / Windows | Cobertura | Documentação | Matriz |
|---|---|---|---|---|
| mestre | ||||
| desenvolver |
A BEAST é uma biblioteca somente para cabeçalho C ++ que serve como base para escrever bibliotecas de rede interoperáveis, fornecendo tipos e algoritmos de vocabulário de vocabulário HTTP/1 de baixo nível, e algoritmos usando o modelo assíncrono consistente do Boost.asio.
Esta biblioteca foi projetada para:
Simetria: os algoritmos são agnósticos de função; construir clientes, servidores ou ambos.
Facilidade de uso: os usuários do boost.asio entenderão imediatamente a besta.
Flexibilidade: os usuários tomam decisões importantes, como o buffer ou o gerenciamento de threads.
Desempenho: Crie aplicativos lidando com milhares de conexões ou mais.
Base para abstração adicional. Os componentes são adequados para edifícios.
| CPPCON 2018 | Bishop Fox 2018 |
|---|---|
| CPPCON 2017 | CPPCAST 2017 | CPPCON 2016 |
|---|---|---|
Este software está em seu primeiro lançamento oficial. As interfaces podem mudar em resposta ao feedback do usuário. Para mudanças recentes, consulte o Changelog.
Esta biblioteca é para programadores familiarizados com o boost.asio. Os usuários que desejam usar interfaces assíncronas já devem saber como criar programas de rede simultâneos usando retornos de chamada ou coroutinas.
Ao usar o Microsoft Visual C ++, é necessário o Visual Studio 2017 ou posterior.
Um desses componentes é necessário para criar os testes e exemplos:
Besta é apenas de cabeçalho. Para usá -lo, basta adicionar a linha #include necessária aos seus arquivos de origem, como este:
# include < boost/beast.hpp >Se você usar coroutines, precisará vincular -se à biblioteca Boost.Coroutine. Visite a documentação do Boost para obter instruções sobre como fazer isso para o seu sistema de construção específico.
Para usar o lançamento oficial mais recente da Beast, basta obter a mais recente distribuição do Boost e seguir as instruções para integrá -lo ao seu ambiente de desenvolvimento. Se você deseja criar os exemplos e testes, ou se deseja visualizar as próximas alterações e recursos, ele é sugerido para clonar o "Boost Superproject" e trabalhar com besta "na árvore" (ou seja, o subdiretório Libs/Beast do super-projeto).
O repositório oficial contém os seguintes ramos:
Master, isso contém o instantâneo mais recente com código que é conhecido por ser estável.
Desenvolva isso com o instantâneo mais recente. Pode conter código instável.
Cada um desses ramos requer uma filial de impulso correspondente e todos os seus subprojetos. Por exemplo, se você deseja usar a versão Master Branch da Beast, clone o Superproject de Boost, mude para a filial mestre no superprojeto e adquirir todas as bibliotecas de impulso correspondentes a essa filial, incluindo a besta.
Para clonar o superprojeto localmente e mudar para o uso de diretório do projeto principal:
git clone --recursive https://github.com/boostorg/boost.git
cd boost
"BJAM" é usado para construir besta e as bibliotecas de impulso. Em um sistema que não seja de Windows, use este comando para construir Bjam:
./bootstrap.sh
A partir de uma linha de comando do Windows, construa Bjam usando este comando:
.BOOTSTRAP.BAT
Os testes e exemplos de construção requer o OpenSSL instalado. Se o OpenSSL estiver instalado em um local não do sistema, você precisará copiar o arquivo de uso do usuário no diretório inicial e definir a variável de ambiente OPENSSL_ROOT para o caminho que contém uma instalação do OpenSSL.
Se instalado em um diretório do sistema, o OpenSSL será encontrado e usado automaticamente.
sudo apt install libssl-dev Substitua path nos seguintes trechos de código pelo caminho para o qual você instalou o vcpkg. Os exemplos assumem uma compilação de 32 bits, se você criar uma versão de 64 bits, substitua x32-windows por x64-windows no caminho.
vcpkg install openssl --triplet x32-windows
SET OPENSSL_ROOT = pathinstalledx32-windowsvcpkg install openssl -- triplet x32 - windows
$ env: OPENSSL_ROOT = " pathx32-windows "vcpkg.exe install openssl --triplet x32-windows
export OPENSSL_ROOT=path/x32-windowsUsando Brew:
brew install openssl
export OPENSSL_ROOT= $( brew --prefix openssl )
# install bjam tool user specific configuration file to read OPENSSL_ROOT
# see https://www.bfgroup.xyz/b2/manual/release/index.html
cp ./libs/beast/tools/user-config.jam $HOMEVerifique se a ferramenta Bjam (também chamada "B2") está disponível no caminho que seu shell usa para encontrar executáveis. O projeto Beast está localizado em "Libs/Beast" em relação ao diretório que contém o superprojeto de inicialização. Para construir os testes de besta, exemplos e documentação, use estes comandos:
export PATH=$PWD:$PATH
b2 -j2 libs/beast/test cxxstd=11 # bjam must be in your $PATH
b2 -j2 libs/beast/example cxxstd=11 # "-j2" means use two processors
b2 libs/beast/doc # Doxygen and Saxon are required for this
Instruções adicionais para configurar, usar e construir bibliotecas em superprojeto podem ser encontradas no Wiki do Boost.
O CMake pode ser usado para gerar uma solução muito boa do Visual Studio e um conjunto de arquivos de projeto do Visual Studio usando estes comandos:
cmake -G "Visual Studio 17 2022" -A win32 -B bin -DCMAKE_TOOLCHAIN_FILE="C:/vcpkg/scripts/buildsystems/vcpkg.cmake" -DVCPKG_CHAINLOAD_TOOLCHAIN_FILE="C:/boost/libs/beast/cmake/toolchains/msvc.cmake"
cmake -G "Visual Studio 17 2022" -A x64 -B bin64 -DCMAKE_TOOLCHAIN_FILE="C:/vcpkg/scripts/buildsystems/vcpkg.cmake" -DVCPKG_CHAINLOAD_TOOLCHAIN_FILE="C:/boost/libs/beast/cmake/toolchains/msvc.cmake"
Os arquivos no repositório são dispostos assim:
./
bin/ Create this to hold executables and project files
bin64/ Create this to hold 64-bit Windows executables and project files
doc/ Source code and scripts for the documentation
include/ Where the header files are located
example/ Self contained example programs
meta/ Metadata for Boost integration
test/ The unit tests for Beast
tools/ Scripts used for CI testing
Esses exemplos são programas completos e independentes que você pode construir e executar (eles estão no diretório de example ).
https://www.boost.org/doc/libs/devell/libs/beast/doc/html/beast/quick_start.html
Distribuído sob a licença de software Boost, versão 1.0. (Consulte Licença de arquivo que acompanha ou copia em https://www.boost.org/license_1_0.txt)
Por favor, relate questões ou perguntas aqui: https://github.com/boostorg/beast/issues
Se você deseja contribuir com a besta e nos ajudar a manter a alta qualidade, considere realizar análises de código sobre solicitações de puxar ativas. Qualquer feedback de usuários e partes interessadas, mesmo perguntas simples sobre como as coisas funcionam ou por que foram feitas de uma certa maneira, carregam valor e podem ser usadas para melhorar a biblioteca. A revisão de código fornece estes benefícios:
Você pode examinar as solicitações de tração fechada para ter uma idéia de como as revisões são executadas. Para fazer uma revisão de código, basta fazer login com sua conta do Github e adicione comentários a qualquer solicitação de tração aberta abaixo, não seja tímido!
https://github.com/boostorg/beast/pulls
Aqui estão alguns recursos para saber mais sobre as análises de código:
A Beast prospera em análises de código e qualquer tipo de feedback de usuários e partes interessadas sobre suas interfaces. Mesmo que você tenha apenas perguntas, perguntando -lhes na revisão do código ou em questões fornecem informações valiosas que podem ser usadas para melhorar a biblioteca - não hesite, nenhuma pergunta é insignificante ou sem importância!
