twisted.mail.mail.FileMonitoringService

class documentation

class twisted.mail.mail.FileMonitoringService(internet.TimerService): (source)

View In Hierarchy

A service for monitoring changes to files.

Instance Variable files Information about files to be monitored. Each list entry provides the following information for a file: interval in seconds between checks, filename, callback function, time of last modification to the file.
Instance Variable intervals Intervals between successive file checks.
Instance Variable index The index of the next file to be checked.
Method __init__ Initialize the file monitoring service.
Method startService Start the file monitoring service.
Method stopService Stop the file monitoring service.
Method monitorFile Start monitoring a file for changes.
Method unmonitorFile Stop monitoring a file.
Instance Variable _call The next scheduled call to check a file.
Method _setupMonitor Schedule the next monitoring call.
Method _monitor Monitor a file and make a callback if it has changed.

Inherited from TimerService:

Instance Variable clock Source of time. This defaults to None which is causes twisted.internet.reactor to be used. Feel free to set this to something else, but it probably ought to be set *before* calling startService.
Instance Variable call Function and arguments to call periodically.
Class Variable volatile Undocumented
Instance Variable step Undocumented
Instance Variable _loop Undocumented
Instance Variable _loopFinished Undocumented
Method _failed Undocumented

Inherited from _VolatileDataService (via TimerService):

Method __getstate__ Undocumented

Inherited from Service (via TimerService, _VolatileDataService):

Instance Variable running A boolean which indicates whether the service is running.
Instance Variable name A str which is the name of the service or None.
Instance Variable parent An IServiceCollection which is the parent or None.
Method setName Set the name of the service.
Method setServiceParent Set the parent of the service. This method is responsible for setting the parent attribute on this service (the child service).
Method disownServiceParent Use this API to remove an IService from an IServiceCollection.
Method privilegedStartService Do preparation work for starting the service.
files = (source)
Information about files to be monitored. Each list entry provides the following information for a file: interval in seconds between checks, filename, callback function, time of last modification to the file.
(type: list of list of (1) float, (2) bytes, (3) callable which takes a bytes argument, (4) float)
intervals = (source)
Intervals between successive file checks.
(type: _IntervalDifferentialIterator)
_call = (source)
The next scheduled call to check a file.
(type: IDelayedCall provider)
index = (source)
The index of the next file to be checked.
(type: int)
def __init__(self): (source)
overrides twisted.application.internet.TimerService.__init__

Initialize the file monitoring service.

def startService(self): (source)
from twisted.application.service.IService
overrides twisted.application.internet.TimerService.startService

Start the file monitoring service.

def _setupMonitor(self): (source)

Schedule the next monitoring call.

def stopService(self): (source)
from twisted.application.service.IService
overrides twisted.application.internet.TimerService.stopService

Stop the file monitoring service.

def monitorFile(self, name, callback, interval=10): (source)

Start monitoring a file for changes.

ParametersnameThe name of a file to monitor. (type: bytes)
callbackThe function to call when the file has changed. (type: callable which takes a bytes argument)
intervalThe interval in seconds between checks. (type: float)
def unmonitorFile(self, name): (source)

Stop monitoring a file.

ParametersnameA file name. (type: bytes)
def _monitor(self): (source)

Monitor a file and make a callback if it has changed.

API Documentation for Twisted, generated by pydoctor 20.12.1 at 2021-02-28 19:53:36.