Changes to be able to build to webassembly with emscripten.

[bruno-j-nicoletti]

The main changes to get it to build with emscripten were...

• copy the single tl::expected header into the repository to avoid transient build issues with catch2,
• use std::threads as opposed to std::jthreads when building with em++ as it does not yet support jthreads,
• tweaked CMakelists to disable LIBCORO_FEATURE_PLATFORM if building with emscripten and to set appropriate em++ flags.

To build it you need to download the emsdk and set it up you shell's paths appropriately. Then go...

mkdir build-emscripten-release
cd build-emscripten-release
emcmake cmake -GNinja -DCMAKE_BUILD_TYPE=Release ..
ninja

[jbaldwin]

I've ignored the file in codacy:
include/coro/detail/tl_expected.hpp

[jbaldwin]

git clone https://github.com/emscripten-core/emsdk.git
cd emsdk
./emsdk install latest
./emsdk activate latest
source ./emsdk_env.sh

build per bruno's steps and then run tests via:
node ./test/libcoro_test.js

[jbaldwin]

@bruno-j-nicoletti can you add one more item to this PR which is adding a CI run to build and compile with emscripten and run the tests please? I was able to get it to work locally so it shouldn't be too difficult to automate it.

[bruno-j-nicoletti]

I've added a CI pass for webassmbly and I've had to tweak test_task.cpp as em++ seems to be adding padding to std::detail::promise

[jbaldwin]

I'll rebase once it completes and run the test suite one more time. This is an awesome change :)

[jbaldwin]

There seems to be a new flaky test thats been introduced, doesn't really seem to be anything related to your change osit... but clang-16 just doesn't want to finish it seems.

[bruno-j-nicoletti]

The only change I could have made that might have done this is the flip to use std::thread over std::jthread. I could put the compile time switch back in to see if that works.

[jbaldwin]

Yeah, I really don't see why your change is causing this. I'm going to try and replicate locally...

[jbaldwin]

running ubuntu 22.04 with g++-12 dosen't hang like it is here, I might try in a docker container with more constrained resourcecs... but its weird too because other PRs based off main are passing just fine

[jbaldwin]

TEST_CASE("ring_buffer many elements many producers many consumers", "[ring_buffer]")
This is most likely the test case failing, its using a ring_buffer with a thread_pool and has a high level of concurrency.

[jbaldwin]

I'll try running CI on main and see if it replicates but so far I haven't seen this on anything merged recently which makes me think it's something with the std::thread change.

[jbaldwin]

main ci has passed twice no problems, going to run it a 3rd time.

fedora 36 has a dnf package manager problem atm, so until they fix that it will fail everytime.

I've looked over the new failing ones and they've failed on a new spot... I'll try and take a deeper look soon.

[jbaldwin]

3rd time also passed, just weird package manager problems 🙄

[jbaldwin]

So I had a bunch of fun with this today and I think I found the bug. It was what I originally thought but acquire and release don't quite work how I thought they did 😦. If you switch to seq_cst I believe your PR should start passing, but there are two other places that need it as well, in the io_scheduler.shutdown() when it exchanges the m_shutdown_requested and the same place in the thread_pool::shutdown() with the same variable name. So those two and the the two I already had you change in the executor function. I can push a mirrored PR of your branch with the changes if that is easier.

I believe the jthread stop_token was issuing a memory barrier and updating all the local variables across threads that we just couldn't see until now.. when it wasn't happening.

[bruno-j-nicoletti]

I've just made the memory order changes you suggested and pushed it. Getting relaxed memory ordering right is hard, which is why most things I've read say stick to the default of seq_cst.

[bruno-j-nicoletti]

Almost there! There is still a SEGV failure in the coverage test on Fedora. This only appeared when I tweaked the unit test to output via an XML reporter. I could change the reporter back to 'console', but it really shouldn't be crashing if you change the reporter.

[jbaldwin]

The failed test on fedora 32 is the ssl/tls bug I'm working through, so I retriggered that run.

*edit: I just saw your message, we can remove the xml reporting, or make it an option.

[jbaldwin]

I also left just a few comments to really clean it up if you don't mind taking a look at them.

[bruno-j-nicoletti]

I've removed the XML reporter and fixed the bits you requested. I can't see for the life of me why the precommit keeps doing weird thing the to readme.

[jbaldwin]

Heck yeah its passing :D :D

[jbaldwin]

There are a couple more seq_cst changes still, can you undo those across all the files please?

[bruno-j-nicoletti]

Removed all the extraneous occurrences of seq_cst as requested.

Parallel programming is hard.

[jbaldwin]

apt failed on ubuntu 22.04, i'll re-run it

[bruno-j-nicoletti]

22.04 dies on installing requirements via apt.

[jbaldwin]

yeah, its a weird normal failure, I don't know why the package managers are so flaky but I see this all the time on lots of projects. Only way to really get around it is either self hosting or baking the installs into a docker file (which I don't really want to maintain)

[bruno-j-nicoletti]

Looks likes its done then. Thanks for all the effort you put into figuring it out, and for the library in the first place.

[jbaldwin]

And we're merged! Nice job, its a great addition to support this.

[bruno-j-nicoletti]

Hurrah!