_sync.pxd 2.43 KB
Newer Older
1
# cython: language_level=2
2 3
# Copyright (C) 2019-2020  Nexedi SA and Contributors.
#                          Kirill Smelkov <kirr@nexedi.com>
4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
#
# This program is free software: you can Use, Study, Modify and Redistribute
# it under the terms of the GNU General Public License version 3, or (at your
# option) any later version, as published by the Free Software Foundation.
#
# You can also Link and Combine this program with other software covered by
# the terms of any of the Free Software licenses or any of the Open Source
# Initiative approved licenses and Convey the resulting work. Corresponding
# source of such a combination shall include the source code for all other
# software used.
#
# This program is distributed WITHOUT ANY WARRANTY; without even the implied
# warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
#
# See COPYING file for full licensing terms.
# See https://www.nexedi.com/licensing for rationale and options.
20
"""Package sync mirrors and amends Go package sync.
21

22
 - `WorkGroup` allows to spawn group of goroutines working on a common task(*).
23 24
 - `Once` allows to execute an action only once.
 - `WaitGroup` allows to wait for a collection of tasks to finish.
Kirill Smelkov's avatar
Kirill Smelkov committed
25
 - `Sema`(*), `Mutex` and `RWMutex` provide low-level synchronization.
26

27
See also https://golang.org/pkg/sync for Go sync package documentation.
28

29 30 31
(*) not provided in Go standard library, but package
    https://godoc.org/lab.nexedi.com/kirr/go123/xsync
    provides corresponding Go equivalents.
32 33
"""

34 35 36
from golang cimport error, refptr
from golang cimport context

37
cdef extern from "golang/sync.h" namespace "golang::sync" nogil:
38 39 40 41 42 43 44 45
    cppclass Sema:
        Sema()
        void acquire()
        void release()

    cppclass Mutex:
        void lock()
        void unlock()
46

Kirill Smelkov's avatar
Kirill Smelkov committed
47 48 49 50 51
    cppclass RWMutex:
        void Lock()
        void Unlock()
        void RLock()
        void RUnlock()
52
        void UnlockToRLock()
Kirill Smelkov's avatar
Kirill Smelkov committed
53

54
    cppclass Once:
55
        void do "do_" (...)     # ... = func<void()>
56 57 58 59 60

    cppclass WaitGroup:
        void done()
        void add(int delta)
        void wait()
61 62 63 64 65 66 67 68 69 70 71 72

    # WorkGroup
    cppclass _WorkGroup:
        void  go(...)                       # ... = func<error(context::Context)>
        error wait()

    cppclass WorkGroup (refptr[_WorkGroup]):
        # WorkGroup.X = WorkGroup->X in C++.
        void  go    "_ptr()->go"    (...)   # ... = func<error(context::Context)>
        error wait  "_ptr()->wait"  ()

    WorkGroup NewWorkGroup(context.Context ctx)