CHANGELOG

create a release branch
update the changelog below
update version and copyright-years in ./LICENSE and ./src/copas/async.lua (in doc-comments header)
create a new rockspec and update the version inside the new rockspec:
cp copas-async-scm-1.rockspec ./rockspecs/copas-async-X.Y.Z-1.rockspec
test: run make test and make lint
clean and render the docs: run make clean and make docs
commit the changes as release X.Y.Z
push the commit, and create a release PR
after merging tag the release commit with vX.Y.Z
upload to LuaRocks:
luarocks upload ./rockspecs/copas-async-X.Y.Z-1.rockspec --api-key=ABCDEFGH
test the newly created rock:
luarocks install copas-async

Breaking: The future interface now matches the Copas future interface.
Breaking: future:get() now returns pcall-style: true + results on success, false + errmsg on failure. Previously it returned the results directly and raised on error.
Deps: bump Copas to 4.10
Added: task errors are now captured and returned via get()/try() instead of being silently lost.
Added: future:try() now returns a 3-state status constant instead of a plain boolean. Returns async.PENDING (false) when still running, async.SUCCESS (true) + results on success, or async.ERROR ("error") + errmsg on failure.
Added: future:cancel() to cancel a pending task. The Copas side is cancelled immediately; any coroutines blocked in get() are released with false + "cancelled". The underlying Lanes thread is soft-cancelled and force-killed after async.cancel_timeout seconds (default 5) if it has not yet stopped (e.g. when blocked in a C call).
Added: async.cancel_timeout field to control the force-kill delay.
Added: multiple coroutines may now call future:get() concurrently; all are released when the result arrives (previously concurrent access raised an error).

Breaking: the os_execute return codes are no longer normalized to Lua 5.3 output since that didn't work due to platform and version differences. Now it just returns the same results as the regular os.execute for the current platform/Lua version.
Fix: io_popen; the default mode should be "r"
Fix: io_popen; the default read pattern should be "*l" and nil should not be passed.
Fix: only initialize LuaLanes if not initialized already
Added: io_popen now also has the lines iterator (except for Puc Rio Lua 5.1 where it will not work due to c-boundary issues)
Added: run method, to simply run and wait for an async result while not blocking (this also is the default action when calling on the module table).

copas-async