src/README.md

In websocket: 'WebSocket' Client Library

Notes about compiled sources

websocketpp

This package makes use of the websocketpp C++ library. It can conflict with another copy of websocketpp that is used in the RStudio IDE, leading to a crash (#7 and rstudio/rstudio#2838). To avoid the crash, the websocketpp namespace has been renamed to ws_websocketpp in our copy of it.

The stock version of websocketpp does not compile in minGW on Windows, because the version of libstdc++ does not define std::errc::error_canceled. This is apparently due to a bug in GNU libstdc++ which is fixed in later versions of minGW. To make it compile, we used a workaround borrowed from this pull request on websocketpp which has not been merged because the project seems to be no longer maintained.

To update websocketpp:

• Update the script at src/lib/update.sh to get the specified version, and then run the script. It will download the files and perform the namespace renaming.
• Re-apply the std::errc::error_canceled patch by running git cherry-pick 8167dac.

websocket documentation built on April 12, 2025, 1:11 a.m.