window-time 0.1.0__tar.gz

window_time-0.1.0/PKG-INFO

@@ -0,0 +1,32 @@
+Metadata-Version: 2.4
+Name: window-time
+Version: 0.1.0
+Summary: A daemon that monitors indoor/outdoor temperatures and notifies when to open or close windows
+Project-URL: Homepage, https://github.com/gene1wood/window-time
+Project-URL: Repository, https://github.com/gene1wood/window-time
+Project-URL: Issues, https://github.com/gene1wood/window-time/issues
+Author: Gene Wood
+License-Expression: MIT
+Keywords: home-automation,influxdb,notifications,temperature
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Home Automation
+Requires-Python: >=3.10
+Requires-Dist: influxdb-client>=1.36.0
+Requires-Dist: numpy>=1.24.0
+Requires-Dist: platformdirs>=4.0.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: requests>=2.28.0
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'

window_time-0.1.0/pyproject.toml

@@ -0,0 +1,68 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "window-time"
+version = "0.1.0"
+description = "A daemon that monitors indoor/outdoor temperatures and notifies when to open or close windows"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [
+    { name = "Gene Wood" }
+]
+keywords = ["temperature", "home-automation", "influxdb", "notifications"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Home Automation",
+]
+dependencies = [
+    "influxdb-client>=1.36.0",
+    "platformdirs>=4.0.0",
+    "pyyaml>=6.0",
+    "requests>=2.28.0",
+    "numpy>=1.24.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+    "black>=23.0.0",
+    "ruff>=0.1.0",
+]
+
+[project.scripts]
+window-time = "window_time.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/gene1wood/window-time"
+Repository = "https://github.com/gene1wood/window-time"
+Issues = "https://github.com/gene1wood/window-time/issues"
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/window_time"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "W"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

window_time-0.1.0/src/window_time/__init__.py

@@ -0,0 +1,3 @@
+"""Window Time - Temperature-based window management notifications."""
+
+__version__ = "0.1.0"

window_time-0.1.0/src/window_time/__main__.py

@@ -0,0 +1,8 @@
+"""Allow running as python -m window_time."""
+
+import sys
+
+from .cli import main
+
+if __name__ == "__main__":
+    sys.exit(main())

window_time-0.1.0/src/window_time/cli.py

@@ -0,0 +1,361 @@
+"""Command-line interface for window-time."""
+
+import argparse
+import logging
+import sys
+from datetime import date
+from pathlib import Path
+
+from . import __version__
+from .config import (
+    Config,
+    get_config_path,
+    get_state_path,
+    load_config,
+    save_default_config,
+)
+from .daemon import WindowTimeDaemon, run_daemon
+from .season import get_season
+
+
+def setup_logging(verbose: bool = False, debug: bool = False) -> None:
+    """Configure logging for the application.
+
+    Args:
+        verbose: Enable verbose output.
+        debug: Enable debug output.
+    """
+    if debug:
+        level = logging.DEBUG
+    elif verbose:
+        level = logging.INFO
+    else:
+        level = logging.WARNING
+
+    logging.basicConfig(
+        level=level,
+        format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
+        datefmt="%Y-%m-%d %H:%M:%S",
+    )
+
+
+def cmd_run(args: argparse.Namespace, config: Config) -> int:
+    """Run the daemon.
+
+    Args:
+        args: Parsed command-line arguments.
+        config: Application configuration.
+
+    Returns:
+        Exit code.
+    """
+    run_daemon(config)
+    return 0
+
+
+def cmd_once(args: argparse.Namespace, config: Config) -> int:
+    """Run a single temperature check.
+
+    Args:
+        args: Parsed command-line arguments.
+        config: Application configuration.
+
+    Returns:
+        Exit code.
+    """
+    daemon = WindowTimeDaemon(config)
+    daemon.run_once()
+    return 0
+
+
+def cmd_status(args: argparse.Namespace, config: Config) -> int:
+    """Show current status and temperatures.
+
+    Args:
+        args: Parsed command-line arguments.
+        config: Application configuration.
+
+    Returns:
+        Exit code.
+    """
+    from .influxdb_client import TemperatureClient
+    from .temperature_analysis import analyze_temperatures
+    from .window_state import load_state
+
+    print("Window Time Status")
+    print("==================")
+    print()
+
+    # Show season
+    today = date.today()
+    season = get_season(today, config.season)
+    print(f"Date: {today.isoformat()}")
+    print(f"Season: {season.value.capitalize()}")
+    print()
+
+    # Show current state
+    state = load_state()
+    print("Window State")
+    print("------------")
+    print(f"Last known state: {state.last_known_state.value}")
+    print(f"Windows opened for warmth today: {state.windows_opened_for_warmth}")
+    if state.last_outdoor_warmer is not None:
+        outdoor_status = "warmer" if state.last_outdoor_warmer else "cooler"
+        print(f"Last check: Outdoor was {outdoor_status} than indoor")
+    print()
+
+    # Fetch and show temperatures
+    print("Current Temperatures")
+    print("--------------------")
+    try:
+        with TemperatureClient(config) as client:
+            temp_data = client.fetch_temperature_data(lookback_hours=config.daemon.lookback_hours)
+
+        if not temp_data.has_data:
+            print("No temperature data available")
+            return 1
+
+        analysis = analyze_temperatures(temp_data)
+
+        if analysis.current_indoor_temp is not None:
+            print(f"Indoor: {analysis.current_indoor_temp:.1f}°")
+        if analysis.current_outdoor_temp is not None:
+            print(f"Outdoor: {analysis.current_outdoor_temp:.1f}°")
+
+        if analysis.outdoor_warmer:
+            print("Outdoor is currently WARMER than indoor")
+        else:
+            print("Outdoor is currently COOLER than indoor")
+
+        print()
+        print("Temperature Trends")
+        print("------------------")
+        if analysis.indoor_trend:
+            print(
+                f"Indoor: {analysis.indoor_trend.direction.value} "
+                f"({analysis.indoor_trend.rate_per_hour:+.2f}°/hr)"
+            )
+        if analysis.outdoor_trend:
+            print(
+                f"Outdoor: {analysis.outdoor_trend.direction.value} "
+                f"({analysis.outdoor_trend.rate_per_hour:+.2f}°/hr)"
+            )
+
+        if analysis.crossing_prediction and analysis.crossing_prediction.will_cross:
+            print()
+            print("Crossing Prediction")
+            print("-------------------")
+            print(
+                f"Temperatures will cross in "
+                f"{analysis.crossing_prediction.minutes_until_crossing:.0f} minutes"
+            )
+            print(f"Crossing temperature: {analysis.crossing_prediction.crossing_temp:.1f}°")
+            if analysis.crossing_prediction.crossing_time:
+                print(
+                    f"Crossing time: {analysis.crossing_prediction.crossing_time.strftime('%H:%M')}"
+                )
+
+    except Exception as e:
+        print(f"Error fetching temperature data: {e}")
+        return 1
+
+    return 0
+
+
+def cmd_init(args: argparse.Namespace, config: Config) -> int:
+    """Initialize configuration file.
+
+    Args:
+        args: Parsed command-line arguments.
+        config: Application configuration.
+
+    Returns:
+        Exit code.
+    """
+    config_path = Path(args.config) if args.config else None
+
+    if config_path and config_path.exists():
+        print(f"Configuration file already exists at {config_path}")
+        if not args.force:
+            print("Use --force to overwrite")
+            return 1
+
+    saved_path = save_default_config(config_path)
+    print(f"Configuration file created at {saved_path}")
+    print()
+    print("Please edit the configuration file to add your:")
+    print("  - InfluxDB token")
+    print("  - ntfy.sh topic ID")
+    print("  - Any other custom settings")
+    return 0
+
+
+def cmd_config(args: argparse.Namespace, config: Config) -> int:
+    """Show configuration paths and current settings.
+
+    Args:
+        args: Parsed command-line arguments.
+        config: Application configuration.
+
+    Returns:
+        Exit code.
+    """
+    print("Configuration Paths")
+    print("===================")
+    print(f"Config file: {get_config_path()}")
+    print(f"State file: {get_state_path()}")
+    print()
+
+    if args.show_values:
+        print("Current Configuration")
+        print("=====================")
+        print()
+        print("InfluxDB:")
+        print(f"  URL: {config.influxdb.url}")
+        print(f"  Organization: {config.influxdb.org}")
+        print(f"  Bucket: {config.influxdb.bucket}")
+        print(f"  Measurement: {config.influxdb.measurement}")
+        print(f"  Token: {'[set]' if config.influxdb.token else '[not set]'}")
+        print()
+        print("Notification:")
+        print(f"  Server: {config.notification.ntfy_server}")
+        print(f"  Topic: {config.notification.ntfy_topic or '[not set]'}")
+        print()
+        print("Season Boundaries:")
+        print(
+            f"  Summer: {config.season.summer_start_month}/{config.season.summer_start_day} "
+            f"to {config.season.summer_end_month}/{config.season.summer_end_day}"
+        )
+        print()
+        print("Daemon:")
+        print(f"  Interval: {config.daemon.interval_minutes} minutes")
+        print(f"  Lookback: {config.daemon.lookback_hours} hour(s)")
+
+    return 0
+
+
+def create_parser() -> argparse.ArgumentParser:
+    """Create the argument parser.
+
+    Returns:
+        Configured ArgumentParser.
+    """
+    parser = argparse.ArgumentParser(
+        prog="window-time",
+        description="Monitor indoor/outdoor temperatures and notify when to open or close windows",
+    )
+
+    parser.add_argument(
+        "-V",
+        "--version",
+        action="version",
+        version=f"%(prog)s {__version__}",
+    )
+
+    parser.add_argument(
+        "-c",
+        "--config",
+        metavar="PATH",
+        help="Path to configuration file (default: XDG config location)",
+    )
+
+    parser.add_argument(
+        "-v",
+        "--verbose",
+        action="store_true",
+        help="Enable verbose output",
+    )
+
+    parser.add_argument(
+        "--debug",
+        action="store_true",
+        help="Enable debug output",
+    )
+
+    subparsers = parser.add_subparsers(
+        title="commands",
+        dest="command",
+        metavar="COMMAND",
+    )
+
+    # run command (default)
+    run_parser = subparsers.add_parser(
+        "run",
+        help="Run the daemon (default command)",
+    )
+    run_parser.set_defaults(func=cmd_run)
+
+    # once command
+    once_parser = subparsers.add_parser(
+        "once",
+        help="Run a single temperature check and exit",
+    )
+    once_parser.set_defaults(func=cmd_once)
+
+    # status command
+    status_parser = subparsers.add_parser(
+        "status",
+        help="Show current status and temperatures",
+    )
+    status_parser.set_defaults(func=cmd_status)
+
+    # init command
+    init_parser = subparsers.add_parser(
+        "init",
+        help="Initialize configuration file",
+    )
+    init_parser.add_argument(
+        "-f",
+        "--force",
+        action="store_true",
+        help="Overwrite existing configuration file",
+    )
+    init_parser.set_defaults(func=cmd_init)
+
+    # config command
+    config_parser = subparsers.add_parser(
+        "config",
+        help="Show configuration paths and settings",
+    )
+    config_parser.add_argument(
+        "-s",
+        "--show-values",
+        action="store_true",
+        help="Show current configuration values",
+    )
+    config_parser.set_defaults(func=cmd_config)
+
+    return parser
+
+
+def main(argv: list[str] | None = None) -> int:
+    """Main entry point.
+
+    Args:
+        argv: Command-line arguments. If None, uses sys.argv.
+
+    Returns:
+        Exit code.
+    """
+    parser = create_parser()
+    args = parser.parse_args(argv)
+
+    setup_logging(verbose=args.verbose, debug=args.debug)
+
+    # Load configuration
+    config_path = Path(args.config) if args.config else None
+    try:
+        config = load_config(config_path)
+    except Exception as e:
+        print(f"Error loading configuration: {e}", file=sys.stderr)
+        return 1
+
+    # Default to 'run' command if no command specified
+    if args.command is None:
+        args.func = cmd_run
+
+    return args.func(args, config)
+
+
+if __name__ == "__main__":
+    sys.exit(main())