debian/control: Build-depend on `python-all-dev', not explicit versions.

[mLib-python] / selbuf.pyx

diff --git a/selbuf.pyx b/selbuf.pyx
index 35b7cf6f0cdaf9f92227bce5f5ab10d94dd48bee..53964c7942433b5590a133a01496ee54d6a13684 100644 (file)
--- a/selbuf.pyx
+++ b/selbuf.pyx
@@ -24,6 +24,11 @@
 ### Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
 
 cdef class SelLineBuffer:
 ### Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
 
 cdef class SelLineBuffer:

+  """
+  SelLineBuffer(FILE, [lineproc = None], [eofproc = None])
+
+  Split an asynchronous stream into lines.
+  """

   cdef selbuf b
   cdef _line
   cdef _eof
   cdef selbuf b
   cdef _line
   cdef _eof


@@ -35,12 +40,15 @@ cdef class SelLineBuffer:
   def __dealloc__(me):
     selbuf_destroy(&me.b)
   property activep:
   def __dealloc__(me):
     selbuf_destroy(&me.b)
   property activep:

+    """SLB.activep -> BOOL: is the buffer still active?"""

     def __get__(me):
       return _tobool(me.b.b.f & LBUF_ENABLE)
   property fd:
     def __get__(me):
       return _tobool(me.b.b.f & LBUF_ENABLE)
   property fd:

+    """SLB.fd -> INT: the file descriptor"""

     def __get__(me):
       return me.b.reader.fd
   property delim:
     def __get__(me):
       return me.b.reader.fd
   property delim:

+    """SLB.delim -> CHAR | LBUF_...: line-end delimiter"""

     def __get__(me):
       if me.b.b.delim == _LBUF_CRLF or me.b.b.delim == _LBUF_STRICTCRLF:
         return me.b.b.delim
     def __get__(me):
       if me.b.b.delim == _LBUF_CRLF or me.b.b.delim == _LBUF_STRICTCRLF:
         return me.b.b.delim


@@ -52,6 +60,7 @@ cdef class SelLineBuffer:
       else:
         me.b.b.delim = ord(d)
   property size:
       else:
         me.b.b.delim = ord(d)
   property size:

+    """SLB.size -> INT: buffer size limit"""

     def __get__(me):
       return me.b.b.sz
     def __set__(me, sz):
     def __get__(me):
       return me.b.b.sz
     def __set__(me, sz):


@@ -59,6 +68,7 @@ cdef class SelLineBuffer:
         raise TypeError, 'size must be positive'
       selbuf_setsize(&me.b, sz)
   property lineproc:
         raise TypeError, 'size must be positive'
       selbuf_setsize(&me.b, sz)
   property lineproc:

+    """SLB.lineproc -> FUNC: call FUNC(LINE) on each line"""

     def __get__(me):
       return me._line
     def __set__(me, proc):
     def __get__(me):
       return me._line
     def __set__(me, proc):


@@ -66,6 +76,7 @@ cdef class SelLineBuffer:
     def __del__(me):
       me._line = None
   property eofproc:
     def __del__(me):
       me._line = None
   property eofproc:

+    """SLB.eofproc -> FUNC: call FUNC() at end-of-file"""

     def __get__(me):
       return me._eof
     def __set__(me, proc):
     def __get__(me):
       return me._eof
     def __set__(me, proc):


@@ -73,24 +84,30 @@ cdef class SelLineBuffer:
     def __del__(me):
       me._eof = None
   def enable(me):
     def __del__(me):
       me._eof = None
   def enable(me):

+    """SLB.enable(): enable the buffer, allowing lines to be emitted"""

     if me.b.b.f & LBUF_ENABLE:
       raise ValueError, 'already enabled'
     selbuf_enable(&me.b)
     me.enabled()
     return me
   def disable(me):
     if me.b.b.f & LBUF_ENABLE:
       raise ValueError, 'already enabled'
     selbuf_enable(&me.b)
     me.enabled()
     return me
   def disable(me):

+    """SLB.disable(): disable the buffer, suspending line emission"""

     if not (me.b.b.f & LBUF_ENABLE):
       raise ValueError, 'already disabled'
     selbuf_disable(&me.b)
     me.disabled()
     return me
   def enabled(me):
     if not (me.b.b.f & LBUF_ENABLE):
       raise ValueError, 'already disabled'
     selbuf_disable(&me.b)
     me.disabled()
     return me
   def enabled(me):

+    """SLB.enabled(): called when buffer is enabled"""

     pass
   def disabled(me):
     pass
   def disabled(me):

+    """SLB.disabled(): called when buffer is disabled"""

     pass
   def line(me, line):
     pass
   def line(me, line):

+    """SLB.line(LINE): called for each completed line"""

     return _maybecall(me._line, (line,))
   def eof(me):
     return _maybecall(me._line, (line,))
   def eof(me):

+    """SLB.eof(): called at end-of-file"""

     return _maybecall(me._eof, ())
 
 cdef void _selbfunc(char *s, size_t n, void *arg):
     return _maybecall(me._eof, ())
 
 cdef void _selbfunc(char *s, size_t n, void *arg):