76 lines
3.1 KiB
Markdown
76 lines
3.1 KiB
Markdown
EventCore
|
|
=========
|
|
|
|
This is a high-performance native event loop abstraction for D, focused on asynchronous I/O and GUI message integration. The API is callback (delegate) based. For a higher level fiber based abstraction, take a look at [vibe.d](https://vibed.org/).
|
|
|
|
The API documentation is part of vibe.d:
|
|
- [`EventDriver`](https://vibed.org/api/eventcore.driver/EventDriver)
|
|
- [`eventDriver`](https://vibed.org/api/eventcore.core/eventDriver)
|
|
- [Experimental `eventcore.socket`](https://vibed.org/api/eventcore.socket/)
|
|
|
|
[](https://code.dlang.org/packages/eventcore)
|
|
[](https://travis-ci.com/github/vibe-d/eventcore)
|
|
[](https://ci.appveyor.com/project/s-ludwig/eventcore)
|
|
|
|
|
|
Supported drivers and operating systems
|
|
---------------------------------------
|
|
|
|
Driver | Linux | Windows | macOS | FreeBSD | Android | iOS
|
|
---------------------|---------|---------|---------|---------|---------|---------
|
|
SelectEventDriver | yes | yes | yes | yes¹ | — | —
|
|
EpollEventDriver | yes | — | — | — | — | —
|
|
WinAPIEventDriver | — | yes | — | — | — | —
|
|
KqueueEventDriver | — | — | yes | yes¹ | — | —
|
|
LibasyncEventDriver | —¹| —¹| —¹| —¹| — | —
|
|
|
|
¹ planned, but not currenly implemented
|
|
|
|
|
|
Supported compilers
|
|
-------------------
|
|
|
|
The following compilers are tested and supported:
|
|
|
|
- DMD 2.087.1
|
|
- DMD 2.086.1
|
|
- DMD 2.085.1
|
|
- DMD 2.084.1
|
|
- DMD 2.079.0
|
|
- LDC 1.17.0
|
|
- LDC 1.16.0
|
|
- LDC 1.15.0
|
|
- LDC 1.14.0
|
|
- LDC 1.13.0
|
|
- LDC 1.9.0
|
|
|
|
|
|
Driver development status
|
|
-------------------------
|
|
|
|
Feature \ EventDriver | Select | Epoll | WinAPI | Kqueue | Libasync
|
|
----------------------|--------|-------|---------|---------|----------
|
|
TCP Sockets | yes | yes | yes | yes | —
|
|
UDP Sockets | yes | yes | yes | yes | —
|
|
USDS | yes | yes | — | yes | —
|
|
DNS | yes | yes | yes | yes | —
|
|
Timers | yes | yes | yes | yes | —
|
|
Events | yes | yes | yes | yes | —
|
|
Unix Signals | yes² | yes | — | — | —
|
|
Files | yes | yes | yes | yes | —
|
|
UI Integration | yes¹ | yes¹ | yes | yes¹ | —
|
|
File watcher | yes² | yes | yes | yes² | —
|
|
Pipes | yes | yes | — | yes | —
|
|
Processes | yes | yes | — | yes | —
|
|
|
|
¹ Manually, by adopting the X11 display connection socket
|
|
|
|
² Systems other than Linux use a polling implementation
|
|
|
|
|
|
### Open questions
|
|
|
|
- Error code reporting
|
|
- Enqueued writes
|
|
- Use the type system to prohibit passing thread-local handles to foreign threads
|