3 ### Selecting packet-buffer
5 ### (c) 2005 Straylight/Edgeware
8 ###----- Licensing notice ---------------------------------------------------
10 ### This file is part of the Python interface to mLib.
12 ### mLib/Python is free software; you can redistribute it and/or modify
13 ### it under the terms of the GNU General Public License as published by
14 ### the Free Software Foundation; either version 2 of the License, or
15 ### (at your option) any later version.
17 ### mLib/Python is distributed in the hope that it will be useful,
18 ### but WITHOUT ANY WARRANTY; without even the implied warranty of
19 ### MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 ### GNU General Public License for more details.
22 ### You should have received a copy of the GNU General Public License
23 ### along with mLib/Python; if not, write to the Free Software Foundation,
24 ### Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
26 cdef class SelPacketBuffer:
28 SelPacketBuffer(FILE, [packetproc = None], [eofproc = None])
30 Split an incoming stream into packets.
35 def __cinit__(me, fd, packetproc = None, eofproc = None, *hunoz, **hukairz):
36 selpk_init(&me.p, &_sel, _getfd(fd), _selpkfunc, <void *>me)
38 me._packet = _checkcallable(packetproc, 'packet proc')
39 me._eof = _checkcallable(eofproc, 'eof proc')
43 """SPK.activep -> BOOL: is the buffer still active?"""
45 return _to_bool(me.p.pk.f & PKBUF_ENABLE)
47 """SPK.fd -> INT: the file descriptor"""
51 """SPK.want -> INT: size of next packet to return"""
56 raise TypeError, 'size must be positive'
59 """SPK.packetproc -> FUNC: call FUNC(PACKET) on each packet"""
62 def __set__(me, proc):
63 me._packet = _checkcallable(proc, 'packet proc')
67 """SPK.eofproc -> FUNC: call FUNC() at end-of-file"""
70 def __set__(me, proc):
71 me._eof = _checkcallable(proc, 'eof proc')
75 """SPK.enable(): enable the buffer, allowing packets to be emitted"""
76 if me.p.pk.f & PKBUF_ENABLE:
77 raise ValueError, 'already enabled'
82 """SPK.disable(): disable the buffer, suspending packet emission"""
83 if not (me.p.pk.f & PKBUF_ENABLE):
84 raise ValueError, 'already disabled'
89 """SPK.enabled(): called when buffer is enabled"""
92 """SPK.disabled(): called when buffer is disabled"""
95 """SPK.packet(PACKET): called for each completed packet"""
96 return _maybecall(me._packet, (pk,))
98 """SPK.eof(): called at end-of-file"""
99 return _maybecall(me._eof, ())
101 cdef void _selpkfunc(unsigned char *p, size_t n, pkbuf *pk,
102 size_t *keep, void *arg):
103 cdef SelPacketBuffer pb
106 pb = <SelPacketBuffer>arg
110 r = pb.packet(PyString_FromStringAndSize(<char *>p, n))
112 PyObject_AsReadBuffer(r, <cvp *>&rp, &rn)
114 raise ValueError, 'remaining buffer too large'
116 memcpy(p + n - rn, rp, rn)
119 ###----- That's all, folks --------------------------------------------------