minicoro.v
WIP. See issues.
Not a fork! This isn't a fork of edubart's minicoro [https://github.com/edubart/minicoro] but a wrapper built from the ground up with cross compatibility in mind. minocoro.v is a binding for minicoro in V with an aim for 100% parity with the C library.
Installation
Just do v install lazalong.minicoro
Example Program main.v:
/********************************************************\
Example minicoro program.
\********************************************************/
module main
import lazalong.minicoro
[callconv: "fastcall"]
pub fn coro_entry(co &C.mco_coro) {
println(" Coroutine 1")
C.mco_yield(co)
println(" Coroutine 2")
}
[console]
fn main () {
println('Simple Minicoro Test')
// First initialize a `desc` object through `mco_desc_init`.
fct := voidptr(&coro_entry)
mut desc := C.mco_desc_init(fct, 0)
// Configure `desc` fields when needed (e.g. customize user_data or allocation functions).
desc.user_data = voidptr(0)
mut co := &minicoro.Coro{}
// Call `mco_create` with the output coroutine pointer and `desc` pointer.
mut res := C.mco_create(&co, &desc)
assert res == minicoro.Result.success
// println(res)
// The coroutine should be now in suspended state.
assert C.mco_status(co) == minicoro.State.suspended
// Call `mco_resume` to start for the first time, switching to its context.
res = C.mco_resume(co) // Should print "coroutine 1".
assert res == minicoro.Result.success
// We get back from coroutine context in suspended state
// because the coro_entry method yields after the first print
assert C.mco_status(co) == minicoro.State.suspended
// Call `mco_resume` to resume for a second time.
res = C.mco_resume(co) // Should print "coroutine 2".
assert res == minicoro.Result.success
// The coroutine finished and should be now dead.
assert C.mco_status(co) == minicoro.State.dead
// Call `mco_destroy` to destroy the coroutine.
res = C.mco_destroy(co)
assert res == minicoro.Result.success
}
Roadmap
- Support most common minicoro.h functions
- Support all minicoro.h functions
- Support all minicoro.h types
- Support all minicoro.h enums
- Add in #defines
- Fully complete minicoro.h wrapper
- minicoro.c.v documentation
- Simple Examples
- Other examples
- Windows support
- iOS support
- Android support
- Linux support
- Mac OS X support
- WebAssembly support
- Raspberry Pi support
- RISC-V support