XAsyncSockets

KO | EN

gitlite — search

#php #javascript #hacktoberfest #unmaintained #python #abandoned #dotfiles #theme #erlang #java #objective-c #css

★ 42 Open GitHub ↗

XAsyncSockets is an efficient Python/MicroPython library of managed asynchronous sockets.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

## XAsyncSockets is an efficient Python/MicroPython library of managed asynchronous sockets.

![HC²](https://raw.githubusercontent.com/jczic/XAsyncSockets/master/hc2.png "HC²")

#### Very easy to integrate and very light with one file only :
- `"XAsyncSockets.py"`

#### XAsyncSockets features :
- Managed asynchronous sockets in a pool (up to thousands!)
- Works directly with I/O to receive and send very quickly
- Supports very large number of simultaneous TCP connections
- Supports concurrent synchronous processing operations if necessary (threaded)
- Implementation of TCP servers
- Implementation of TCP clients
- Implementation of UDP datagrams (sender and/or receiver)
- TCP client can event after a specified size of data or a text line received
- Each connections and receivings can waiting during a specified time
- The reasons of TCP client closures are returned
- Really robust, very fast and easy to use
- Compatible with MicroPython implementation (sockets layer, FiFo queue, perf counter)

### *XAsyncSockets* classes :

### *XAsyncSockets* exceptions :

### *XAsyncSocketsPool* class details :

( Do not call directly the methods `AddAsyncSocket`, `RemoveAsyncSocket`, `NotifyNextReadyForReading` and `NotifyNextReadyForWriting` )

### *XClosedReason* class details :

| Static variable | Value |
| - | - |
| Error | 0x00 |
| ClosedByHost | 0x01 |
| ClosedByPeer | 0x02 |
| Timeout | 0x03 |

### *XAsyncSocket* class details :

### *XAsyncTCPServer* class details :

### *XAsyncTCPClient* class details :

| Method | Arguments |
| - | - |
| Create (static) | `asyncSocketsPool`, `srvAddr` (tuple of ip and port), `connectTimeout=5` (int), `recvBufLen=4096` (int), `sendBufLen=4096`(int), `connectAsync=True` (bool) |
| AsyncRecvLine | `lineEncoding='UTF-8'`, `onLineRecv=None` (function), `onLineRecvArg=None` (object)`, timeoutSec=None` (int) |
| AsyncRecvData | `size=None` (int), `onDataRecv=None` (function), `onDataRecvArg=None` (object), `timeoutSec=None` (int) |
| AsyncSendData | `data` (bytes or buffer protocol), `onDataSent=None` (function), `onDataSentArg=None` (object) |
| AsyncSendSendingBuffer | `size=None` (int), `onDataSent=None` (function), `onDataSentArg=None` (object) |
| StartSSL | `keyfile=None`, `certfile=None`, `server_side=False`, `cert_reqs=ssl.CERT_NONE`, `ca_certs=None` |
| StartSSLContext | `sslContext`, `serverSide=False` |
- `onLineRecv` is a callback event of type f(xAsyncTCPClient, line, arg)
- `onDataRecv` is a callback event of type f(xAsyncTCPClient, data, arg)
- `onDataSent` is a callback event of type f(xAsyncTCPClient, arg)
- `StartSSL` and `StartSSLContext` doesn't works on MicroPython (in asynchronous non-blocking sockets mode)
- It is widely recommended to use `StartSSLContext` rather than `StartSSL` (old version)

### *XAsyncUDPDatagram* class details :

### *XBufferSlot* class details :

### *XBufferSlots* class details :

### *XFiFo* class details :

### By JC`zic for [HC²](https://www.hc2.fr) ;')

*Keep it simple, stupid* :+1:

XAsyncSockets

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README