debian/control: Add Build-Depends for `dh-python'.
[mLib-python] / fwatch.pyx
1 ### -*-pyrex-*-
2 ###
3 ### Watching files for changes
4 ###
5 ### (c) 2007 Straylight/Edgeware
6 ###
7
8 ###----- Licensing notice ---------------------------------------------------
9 ###
10 ### This file is part of the Python interface to mLib.
11 ###
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.
16 ###
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.
21 ###
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.
25
26 cdef class FWatch:
27 """
28 FWatch(FILE): watch FILE for changes
29
30 FILE may be a string, file descriptor, or an object with a `fileno' method.
31 """
32 cdef fwatch fw
33 cdef public file
34 def __cinit__(me, file):
35 me._init(file)
36 def __init__(me, file):
37 me._init(file)
38 cdef _init(me, file):
39 if isinstance(file, str):
40 fwatch_init(&me.fw, file)
41 else:
42 fwatch_initfd(&me.fw, _getfd(file))
43 me.file = file
44 def update(me):
45 """FW.update() -> RC: nonzero if the file has changed state"""
46 cdef int rc
47 if isinstance(me.file, str):
48 rc = fwatch_update(&me.fw, me.file)
49 else:
50 rc = fwatch_updatefd(&me.fw, _getfd(me.file))
51 return rc
52
53 ###----- That's all, folks --------------------------------------------------