larpon / minicoro

V wrapper of Edubart's minicoro - A cross-platform coroutine library

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

minicoro.v

minicoro.v icon

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

About

V wrapper of Edubart's minicoro - A cross-platform coroutine library


Languages

Language:C 90.4%Language:V 9.6%