Browse Source

DOC: eventfilters examples

boyska 6 years ago
parent
commit
0dba0b7b1f
1 changed files with 27 additions and 0 deletions
  1. 27 0
      doc/source/eventfilters.rst

+ 27 - 0
doc/source/eventfilters.rst

@@ -23,9 +23,36 @@ to 15min. If you have this solution, maybe *percentwait* will better suit your n
 a jingle can wait up to twice its own duration. This is like setting maxtime=4hours for the long shows, but
 maxtime=1minute for jingles. Nice!
 
+Examples
+----------
+
+Fixed wait
+~~~~~~~~~~~~~~~
+
+This snippet will configure larigira to wait a maximum of 5 minutes::
+
+    LARIGIRA_EVENT_FILTERS='["maxwait"]'
+    LARIGIRA_EF_MAXWAIT_SEC=300
+
+(60*5 = 300seconds). This will basically cancel any event that finds a currently playing audio not at its end.
+It can be recommended if you have very accurate timing or don't care about "losing" shows because the one
+preceding it lasted for too long.
+
+Relative wait
+~~~~~~~~~~~~~~~~
+
+This will configure larigira so that a 1-minute jingle can wait for a maximum of 4minutes, while a 20minutes
+event can wait up to 1h20min::
+    
+    LARIGIRA_EVENT_FILTERS='["percentwait"]'
+    LARIGIRA_EF_MAXWAIT_PERC=400
+
+In fact, ``400`` means 400%, that is 4 times the lenght of what we're adding
+
 Write your own
 ----------------
 
 You probably have some very strange usecase here. Things to decide based on your custom naming convention,
 time of the day, moon phase, whatever. So you can and should write your own eventfilter. It often boils down
 to very simple python functions and configuration of an entrypoint for the `larigira.eventfilter` entrypoint.
+