Class Sink

Attributes:
  bnd -- 2-tuple -- binding address for socket, in socket library format
  rate -- integer -- maximal number of events processed each time-slice
  sock -- socket / None -- socket only exists while plan is running
  convert -- callable -- convert incoming event dictionaries.
    Allows remote joysticks/keys to be remapped. Returns None if
    event should be ignored
    By default, only KEYUP and KEYDOWN events are allowed
  allowMisc -- float / None -- number of seconds of "misc" packets 
    to store in self.queue or None to disallow non-event packets

Overrides: object.__init__

(default)

Override this method to perform operations when Plan starts but before the first events are processed.

Overrides: plans.Plan.onStart

(inherited documentation)

(default)

Override this method to perform operations when Plan terminates.

Overrides: plans.Plan.onStop

(inherited documentation)

Set the socket binding address.

Will take effect next time the plan is started

(default)
Event handler. Override this method to handle all events that 
were push()-ed to this Plan.

The sequential behavior() in this plan only runs if onEvent
returned True.

All Plan-s recieve a copy of all TIMEREVENT events. If your
sequential code does not need any other events, and just wants
to execute in parallel with other Plan-s, it is safe to leave
the default onEvent method, which always returns True 

NOTE: 
  onEvent MUST return True or False. Other values raise an 
  exception at runtime. 

Overrides: plans.Plan.onEvent

(inherited documentation)

Iterate over the custom packets in the queue
Yields pairs (ts, pkt)
  ts -- float -- arrival time
  pkt -- dictionary -- packet contents