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
• Add CI tests