debian/control: Add Build-Depends for `dh-python'.
[mLib-python] / crc32.pyx
index f76ef5e..f4072a0 100644 (file)
--- a/crc32.pyx
+++ b/crc32.pyx
@@ -1,51 +1,53 @@
-# -*-pyrex-*-
-#
-# $Id$
-#
-# Cyclic redundancy checker
-#
-# (c) 2005 Straylight/Edgeware
-#
+### -*-pyrex-*-
+###
+### Cyclic redundancy checker
+###
+### (c) 2005 Straylight/Edgeware
+###
 
-#----- Licensing notice -----------------------------------------------------
-#
-# This file is part of the Python interface to mLib.
-#
-# mLib/Python is free software; you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation; either version 2 of the License, or
-# (at your option) any later version.
-#
-# mLib/Python is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with mLib/Python; if not, write to the Free Software Foundation,
-# Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
+###----- Licensing notice ---------------------------------------------------
+###
+### This file is part of the Python interface to mLib.
+###
+### mLib/Python is free software; you can redistribute it and/or modify
+### it under the terms of the GNU General Public License as published by
+### the Free Software Foundation; either version 2 of the License, or
+### (at your option) any later version.
+###
+### mLib/Python is distributed in the hope that it will be useful,
+### but WITHOUT ANY WARRANTY; without even the implied warranty of
+### MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+### GNU General Public License for more details.
+###
+### You should have received a copy of the GNU General Public License
+### along with mLib/Python; if not, write to the Free Software Foundation,
+### Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
 
 cdef class CRC32:
+  """CRC32(): calculate CRC32 of a stream"""
   cdef uint32 _a
-  def __new__(me, *hunoz, **hukairz):
+  def __cinit__(me, *hunoz, **hukairz):
     me._a = 0
   def __init__(me):
     pass
   def chunk(me, data):
+    """C.chunk(STR): process another chunk of input"""
     cdef void *p
-    cdef int n
-    PyObject_AsReadBuffer(data, &p, &n)
+    cdef Py_ssize_t n
+    PyObject_AsReadBuffer(data, <cvp *>&p, &n)
     me._a = c_crc32(me._a, p, n)
     return me
   def done(me):
+    """C.done() -> INT: return CRC of data"""
     return _u32(me._a)
 
 def crc32(data):
+  """crc32(STR) -> INT"""
   cdef void *p
-  cdef int n
+  cdef Py_ssize_t n
   cdef uint32 c
-  PyObject_AsReadBuffer(data, &p, &n)
+  PyObject_AsReadBuffer(data, <cvp *>&p, &n)
   c = c_crc32(0, p, n)
   return _u32(c)
 
-#----- That's all, folks ----------------------------------------------------
+###----- That's all, folks --------------------------------------------------