mirror of
https://github.com/weewx/weewx.git
synced 2026-04-19 17:16:56 -04:00
87 lines
3.4 KiB
Python
87 lines
3.4 KiB
Python
#
|
|
# Copyright (c) 2009, 2010, 2013 Tom Keffer <tkeffer@gmail.com>
|
|
#
|
|
# See the file LICENSE.txt for your full rights.
|
|
#
|
|
# $Revision$
|
|
# $Author$
|
|
# $Date$
|
|
#
|
|
|
|
"""Example of how to extend the search list used by the Cheetah generator.
|
|
|
|
This search list extension offers two extra tags:
|
|
|
|
'alltime': All time statistics.
|
|
For example, "what is the all time high temperature?"
|
|
|
|
'seven_day': Statistics for the last seven days.
|
|
That is, since midnight seven days ago.
|
|
|
|
To use it, modify the option search_list in your skin.conf configuration file,
|
|
adding the name of this extension. For this example, the name of the extension
|
|
is examples.xsearch.MyXSearch. So, when you're done, it will look something
|
|
like this:
|
|
|
|
[CheetahGenerator]
|
|
search_list_extensions = examples.xsearch.MyXSearch
|
|
|
|
Note that if your file skin.conf is from an older version of Weewx, this
|
|
section may be named [FileGenerator]. It will work just fine.
|
|
|
|
You can then use tags such as $alltime.outTemp.max for the all-time max
|
|
temperature, or $seven_day.rain.sum for the total rainfall in the last
|
|
seven days.
|
|
"""
|
|
import datetime
|
|
import time
|
|
|
|
from weewx.cheetahgenerator import SearchList
|
|
from weewx.stats import TimeSpanStats
|
|
from weeutil.weeutil import TimeSpan
|
|
|
|
class MyXSearch(SearchList): # 1
|
|
|
|
def __init__(self, generator): # 2
|
|
SearchList.__init__(self, generator)
|
|
|
|
def get_extension(self, valid_timespan, archivedb, statsdb): # 3
|
|
"""Returns a search list extension with two additions.
|
|
|
|
Parameters:
|
|
valid_timespan: An instance of weeutil.weeutil.TimeSpan. This will
|
|
hold the start and stop times of the domain of
|
|
valid times.
|
|
|
|
archivedb: An instance of weewx.archive.Archive
|
|
|
|
statsdb: An instance of weewx.stats.StatsDb
|
|
"""
|
|
|
|
# First, get a TimeSpanStats object for all time. This one is easy
|
|
# because the object valid_timespan already holds all valid times to be
|
|
# used in the report.
|
|
all_stats = TimeSpanStats(valid_timespan,
|
|
statsdb,
|
|
formatter=self.generator.formatter,
|
|
converter=self.generator.converter) # 4
|
|
|
|
# Now get a TimeSpanStats object for the last seven days. This one we
|
|
# will have to calculate. First, calculate the time at midnight, seven
|
|
# days ago. The variable week_dt will be an instance of datetime.date.
|
|
week_dt = datetime.date.fromtimestamp(valid_timespan.stop) - datetime.timedelta(weeks=1) # 5
|
|
# Now convert it to unix epoch time:
|
|
week_ts = time.mktime(week_dt.timetuple()) # 6
|
|
# Now form a TimeSpanStats object, using the time span we just
|
|
# calculated:
|
|
seven_day_stats = TimeSpanStats(TimeSpan(week_ts, valid_timespan.stop),
|
|
statsdb,
|
|
formatter=self.generator.formatter,
|
|
converter=self.generator.converter) # 7
|
|
|
|
# Now create a small dictionary with keys 'alltime' and 'seven_day':
|
|
search_list_extension = {'alltime' : all_stats,
|
|
'seven_day' : seven_day_stats} # 8
|
|
|
|
return search_list_extension
|