from dataclasses import dataclass
import logging
import platform
-from typing import Optional
+from typing import Callable
+# Note: this module is fairly early loaded. Be aware of dependencies.
import config
+from type.locations import Location
logger = logging.getLogger(__name__)
+
args = config.add_commandline_args(
- f'({__file__})',
- 'Args related to __file__'
+ f'Global Site Config ({__file__})',
+ 'Args related to global site-specific configuration',
)
-
args.add_argument(
- '--site_config_location',
- default='AUTO',
- const='AUTO',
+ '--site_config_override_location',
+ default='NONE',
+ const='NONE',
nargs='?',
- choices=('HOUSE', 'CABIN', 'AUTO'),
- help='Where are we, HOUSE or CABIN?'
+ choices=['HOUSE', 'CABIN', 'NONE'],
+ help='Where are we, HOUSE, CABIN? Overrides standard detection code.',
)
@dataclass
class SiteConfig(object):
+ location_name: str
+ location: Location
network: str
network_netmask: str
network_router_ip: str
+ presence_location: Location
+ is_anyone_present: Callable
+ arper_minimum_device_count: int
+
+
+def get_location_name():
+ """
+ Where are we?
+
+ >>> location = get_location_name()
+ >>> location == 'HOUSE' or location == 'CABIN'
+ True
+
+ """
+ return get_config().location_name
def get_location():
- location = config.config['site_config_location']
- if location == 'AUTO':
- hostname = platform.node()
+ """
+ Returns location as an enum instead of a string.
+
+ >>> from type.locations import Location
+ >>> location = get_location()
+ >>> location == Location.HOUSE or location == Location.CABIN
+ True
+
+ """
+ return get_config().location
+
+
+def is_anyone_present_wrapper(location: Location):
+ import base_presence
+
+ p = base_presence.PresenceDetection()
+ return p.is_anyone_in_location_now(location)
+
+
+def get_config():
+ """
+ Get a configuration dataclass with information that is
+ site-specific including the current running location.
+
+ >>> cfg = get_config()
+ >>> cfg.location_name == 'HOUSE' or cfg.location_name == 'CABIN'
+ True
+
+ """
+ hostname = platform.node()
+ try:
+ location_override = config.config['site_config_override_location']
+ except KeyError:
+ location_override = 'NONE'
+ if location_override == 'NONE':
if '.house' in hostname:
location = 'HOUSE'
elif '.cabin' in hostname:
location = 'CABIN'
- else:
- raise Exception(f'Unknown hostname {hostname}, help.')
- return location
-
-
-def get_config():
- location = get_location()
if location == 'HOUSE':
return SiteConfig(
- network = '10.0.0.0/24',
- network_netmask = '255.255.255.0',
- network_router_ip = '10.0.0.1',
+ location_name='HOUSE',
+ location=Location.HOUSE,
+ network='10.0.0.0/24',
+ network_netmask='255.255.255.0',
+ network_router_ip='10.0.0.1',
+ presence_location=Location.HOUSE,
+ is_anyone_present=lambda x=Location.HOUSE: is_anyone_present_wrapper(
+ x
+ ),
+ arper_minimum_device_count=50,
)
elif location == 'CABIN':
return SiteConfig(
- network = '192.168.0.0/24',
- network_netmask = '255.255.255.0',
- network_router_ip = '192.168.0.1',
+ location_name='CABIN',
+ location=Location.CABIN,
+ network='192.168.0.0/24',
+ network_netmask='255.255.255.0',
+ network_router_ip='192.168.0.1',
+ presence_location=Location.CABIN,
+ is_anyone_present=lambda x=Location.CABIN: is_anyone_present_wrapper(
+ x
+ ),
+ arper_minimum_device_count=15,
)
else:
- raise Exception('Unknown site location')
+ raise Exception(f'Unknown site location: {location}')
+
+
+if __name__ == '__main__':
+ import doctest
+
+ doctest.testmod()