isobar-cli 1.1.1__tar.gz → 1.2.0__tar.gz

{isobar_cli-1.1.1/src/isobar_cli.egg-info → isobar_cli-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: isobar-cli
-Version: 1.1.1
+Version: 1.2.0
 Summary: A visually pleasing terminal weather tool focusing on Real Feel and Windchill.
 Author: Beau Bremer / KnowOneActual
 License-Expression: MIT
@@ -29,6 +29,8 @@ Provides-Extra: test
 Requires-Dist: pytest>=7.0.0; extra == "test"
 Requires-Dist: requests-mock>=1.11.0; extra == "test"
 Requires-Dist: pytest-cov>=4.1.0; extra == "test"
+Provides-Extra: timezone
+Requires-Dist: pytz>=2024.1; extra == "timezone"
 Dynamic: license-file
 
 # Isobar CLI 
@@ -36,7 +38,7 @@ Dynamic: license-file
 ![CI](https://github.com/KnowOneActual/isobar-cli/actions/workflows/ci.yml/badge.svg)
 ![Coverage](https://img.shields.io/badge/coverage-98%25-green)
 [![PyPI version](https://badge.fury.io/py/isobar-cli.svg)](https://badge.fury.io/py/isobar-cli)
-![Version](https://img.shields.io/badge/version-1.0.1-blue)
+![Version](https://img.shields.io/badge/version-1.2.0-blue)
 ![Ruff](https://img.shields.io/badge/linting-ruff-purple)
 ![Python](https://img.shields.io/badge/python-3.8%2B-blue)
 ![License](https://img.shields.io/badge/license-MIT-green)
@@ -80,7 +82,7 @@ Most weather apps overwhelm with data. Isobar strips away everything except what
   - **Temporal Context** — Comparison with previous day conditions 📈
   - **UV Index Monitoring** — Sun protection guidance with intensity levels ☀️
   - **Wind Gust Alerts** — Highlighting of significant gust events 💨⚠️
-  - **Home City Persistence** — Set a default city with `isobar home "Your City"` 🏠
+  - **Home City Persistence** — Set a default city with `isobar home "Your City"` 🏠 *(Note: Due to a Typer limitation, this currently shows weather for "Home, Kansas" instead of setting home city. Manual config editing required.)*
 
 ## 🚀 Installation
 
@@ -124,12 +126,16 @@ isobar London Tokyo Paris     # Multiple cities
 isobar "New York"             # Use quotes for multi-word cities
 
 # Hourly outlook (next 12h)
-isobar --hourly
-isobar -H
+isobar --hourly Chicago
+isobar -H Chicago
 
 # 7-day forecast
-isobar --forecast
-isobar -f
+isobar --forecast Chicago
+isobar -f Chicago
+
+# Note: Flags must come before city names
+# ✅ isobar -H Chicago
+# ❌ isobar Chicago -H  (treats "-H" as a city name)
 isobar "San Francisco" --forecast
 isobar -f Sydney
 
@@ -145,6 +151,42 @@ isobar home --clear       # Clear home city
 isobar                    # Uses home city if set (otherwise auto-detects)
 ```
 
+## ⚙️ Configuration
+
+Isobar supports configuration via environment variables for advanced use cases:
+
+### API Endpoint Configuration
+Customize API endpoints for different weather providers or testing:
+
+```bash
+# Use custom weather APIs
+export ISOBAR_GEOCODING_URL="https://custom-geocoding-api.example.com/v1/search"
+export ISOBAR_WEATHER_URL="https://custom-weather-api.example.com/v1/forecast"
+export ISOBAR_AQI_URL="https://custom-aqi-api.example.com/v1/air-quality"
+
+# Run with custom endpoints
+isobar "New York"
+```
+
+### Timezone Support
+For enhanced timezone accuracy (optional):
+
+```bash
+# Install optional timezone support
+pip install isobar-cli[timezone]
+
+# Sunrise/sunset will now display in local timezone
+isobar London
+```
+
+### Debug Mode
+Enable debug logging to stderr:
+
+```bash
+# View API errors and debugging information
+isobar "Test City" 2> debug.log
+```
+
 ## ⌨️ Shell Completion
 
 Isobar supports tab-completion for city names. To enable it for a shell:
@@ -212,6 +254,10 @@ Preparation Guidance:
 | `config.py` | Persistent home city configuration |
 | Enhanced `logic.py` | Preparation guidance, UV monitoring, gust alerts |
 | Updated `ui.py` | Contextual display of insights |
+| **v1.2.0 Features** | **Security & Configuration** |
+| Configurable API Endpoints | Environment variable support for custom APIs |
+| Enhanced Error Handling | Specific exception catching with timeouts |
+| Timezone Support | Optional `pytz` dependency for local time display |
 
 ## 🔒 Security
 
@@ -235,6 +281,7 @@ All security scans are integrated into the CI/CD pipeline and run on every push,
 ✅ **Phase 5 Complete** — Testing & Reliability  
 ✅ **Phase 6 Complete** — Distribution (PyPI, Homebrew)  
 ✅ **Phase 7 Complete** — Intuition & Analysis (v1.1.0)  
+✅ **v1.2.0 Complete** — Security & Configuration Enhancements  
 Refer to [ROADMAP.md](ROADMAP.md) and [CHANGELOG.md](CHANGELOG.md) for details.
 
 ## 🤝 Contributing

{isobar_cli-1.1.1 → isobar_cli-1.2.0}/README.md

@@ -3,7 +3,7 @@
 ![CI](https://github.com/KnowOneActual/isobar-cli/actions/workflows/ci.yml/badge.svg)
 ![Coverage](https://img.shields.io/badge/coverage-98%25-green)
 [![PyPI version](https://badge.fury.io/py/isobar-cli.svg)](https://badge.fury.io/py/isobar-cli)
-![Version](https://img.shields.io/badge/version-1.0.1-blue)
+![Version](https://img.shields.io/badge/version-1.2.0-blue)
 ![Ruff](https://img.shields.io/badge/linting-ruff-purple)
 ![Python](https://img.shields.io/badge/python-3.8%2B-blue)
 ![License](https://img.shields.io/badge/license-MIT-green)
@@ -47,7 +47,7 @@ Most weather apps overwhelm with data. Isobar strips away everything except what
   - **Temporal Context** — Comparison with previous day conditions 📈
   - **UV Index Monitoring** — Sun protection guidance with intensity levels ☀️
   - **Wind Gust Alerts** — Highlighting of significant gust events 💨⚠️
-  - **Home City Persistence** — Set a default city with `isobar home "Your City"` 🏠
+  - **Home City Persistence** — Set a default city with `isobar home "Your City"` 🏠 *(Note: Due to a Typer limitation, this currently shows weather for "Home, Kansas" instead of setting home city. Manual config editing required.)*
 
 ## 🚀 Installation
 
@@ -91,12 +91,16 @@ isobar London Tokyo Paris     # Multiple cities
 isobar "New York"             # Use quotes for multi-word cities
 
 # Hourly outlook (next 12h)
-isobar --hourly
-isobar -H
+isobar --hourly Chicago
+isobar -H Chicago
 
 # 7-day forecast
-isobar --forecast
-isobar -f
+isobar --forecast Chicago
+isobar -f Chicago
+
+# Note: Flags must come before city names
+# ✅ isobar -H Chicago
+# ❌ isobar Chicago -H  (treats "-H" as a city name)
 isobar "San Francisco" --forecast
 isobar -f Sydney
 
@@ -112,6 +116,42 @@ isobar home --clear       # Clear home city
 isobar                    # Uses home city if set (otherwise auto-detects)
 ```
 
+## ⚙️ Configuration
+
+Isobar supports configuration via environment variables for advanced use cases:
+
+### API Endpoint Configuration
+Customize API endpoints for different weather providers or testing:
+
+```bash
+# Use custom weather APIs
+export ISOBAR_GEOCODING_URL="https://custom-geocoding-api.example.com/v1/search"
+export ISOBAR_WEATHER_URL="https://custom-weather-api.example.com/v1/forecast"
+export ISOBAR_AQI_URL="https://custom-aqi-api.example.com/v1/air-quality"
+
+# Run with custom endpoints
+isobar "New York"
+```
+
+### Timezone Support
+For enhanced timezone accuracy (optional):
+
+```bash
+# Install optional timezone support
+pip install isobar-cli[timezone]
+
+# Sunrise/sunset will now display in local timezone
+isobar London
+```
+
+### Debug Mode
+Enable debug logging to stderr:
+
+```bash
+# View API errors and debugging information
+isobar "Test City" 2> debug.log
+```
+
 ## ⌨️ Shell Completion
 
 Isobar supports tab-completion for city names. To enable it for a shell:
@@ -179,6 +219,10 @@ Preparation Guidance:
 | `config.py` | Persistent home city configuration |
 | Enhanced `logic.py` | Preparation guidance, UV monitoring, gust alerts |
 | Updated `ui.py` | Contextual display of insights |
+| **v1.2.0 Features** | **Security & Configuration** |
+| Configurable API Endpoints | Environment variable support for custom APIs |
+| Enhanced Error Handling | Specific exception catching with timeouts |
+| Timezone Support | Optional `pytz` dependency for local time display |
 
 ## 🔒 Security
 
@@ -202,6 +246,7 @@ All security scans are integrated into the CI/CD pipeline and run on every push,
 ✅ **Phase 5 Complete** — Testing & Reliability  
 ✅ **Phase 6 Complete** — Distribution (PyPI, Homebrew)  
 ✅ **Phase 7 Complete** — Intuition & Analysis (v1.1.0)  
+✅ **v1.2.0 Complete** — Security & Configuration Enhancements  
 Refer to [ROADMAP.md](ROADMAP.md) and [CHANGELOG.md](CHANGELOG.md) for details.
 
 ## 🤝 Contributing

{isobar_cli-1.1.1 → isobar_cli-1.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "isobar-cli"
-version = "1.1.1"
+version = "1.2.0"
 description = "A visually pleasing terminal weather tool focusing on Real Feel and Windchill."
 authors = [
   { name="Beau Bremer / KnowOneActual" },
@@ -27,9 +27,9 @@ dependencies = [
   "rich>=13.0.0",
   "requests>=2.31.0",
   "typer>=0.9.0",
-      "timezonefinder>=6.0.0",
-  ]
-  requires-python = ">=3.8"
+  "timezonefinder>=6.0.0",
+]
+requires-python = ">=3.8"
   
   [project.urls]
   Homepage = "https://github.com/KnowOneActual/isobar-cli"
@@ -39,11 +39,14 @@ dependencies = [
   
   [project.optional-dependencies]
   
-test = [
-    "pytest>=7.0.0",
-    "requests-mock>=1.11.0",
-    "pytest-cov>=4.1.0",
-]
+  test = [
+      "pytest>=7.0.0",
+      "requests-mock>=1.11.0",
+      "pytest-cov>=4.1.0",
+  ]
+  timezone = [
+      "pytz>=2024.1",
+  ]
 
 [project.scripts]
 isobar = "isobar_cli.main:app"  # This allows you to type 'isobar' in the terminal to run it

isobar_cli-1.2.0/src/isobar_cli/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.1.1"

{isobar_cli-1.1.1 → isobar_cli-1.2.0}/src/isobar_cli/api.py

@@ -7,6 +7,7 @@ from typing import Optional
 import requests
 from timezonefinder import TimezoneFinder
 
+from .config import get_aqi_url, get_geocoding_url, get_weather_url
 from .logic import format_time
 from .models import ForecastDay, HourlyForecast, UnitSystem, WeatherData, WeatherUnits
 
@@ -15,22 +16,39 @@ CACHE_DIR.mkdir(parents=True, exist_ok=True)
 
 
 class GeocodingClient:
-    BASE_URL = "https://geocoding-api.open-meteo.com/v1/search"
+    @classmethod
+    def get_base_url(cls) -> str:
+        """Get geocoding API URL from configuration."""
+        return get_geocoding_url()
 
     @classmethod
     def search(cls, city: str, count: int = 1) -> list[dict]:
         try:
             response = requests.get(
-                f"{cls.BASE_URL}?name={city}&count={count}&format=json"
+                f"{cls.get_base_url()}?name={city}&count={count}&format=json",
+                timeout=10,
             )
             response.raise_for_status()
             return response.json().get("results", [])
-        except Exception:
+        except requests.exceptions.RequestException as e:
+            # Log error for debugging but don't crash
+            import sys
+
+            print(f"Geocoding error for '{city}': {e}", file=sys.stderr)
+            return []
+        except Exception as e:
+            # Catch-all for unexpected errors
+            import sys
+
+            print(f"Unexpected geocoding error for '{city}': {e}", file=sys.stderr)
             return []
 
 
 class WeatherClient:
-    BASE_URL = "https://api.open-meteo.com/v1/forecast"
+    @classmethod
+    def get_base_url(cls) -> str:
+        """Get weather API URL from configuration."""
+        return get_weather_url()
 
     def __init__(self, lat: float, lon: float, timezone: str, metric: bool = False):
         self.lat = lat
@@ -59,23 +77,37 @@ class WeatherClient:
             "forecast_days": 7,
         }
 
-        response = requests.get(self.BASE_URL, params=params)
+        response = requests.get(self.get_base_url(), params=params, timeout=15)
         response.raise_for_status()
         return response.json()
 
 
 class AirQualityClient:
-    BASE_URL = "https://air-quality-api.open-meteo.com/v1/air-quality"
+    @classmethod
+    def get_base_url(cls) -> str:
+        """Get air quality API URL from configuration."""
+        return get_aqi_url()
 
     @classmethod
     def get_aqi(cls, lat: float, lon: float) -> Optional[int]:
         try:
             response = requests.get(
-                f"{cls.BASE_URL}?latitude={lat}&longitude={lon}&current=us_aqi"
+                f"{cls.get_base_url()}?latitude={lat}&longitude={lon}&current=us_aqi",
+                timeout=10,
             )
             response.raise_for_status()
             return response.json().get("current", {}).get("us_aqi")
-        except Exception:
+        except requests.exceptions.RequestException as e:
+            # Log error for debugging but don't crash
+            import sys
+
+            print(f"AQI error for ({lat},{lon}): {e}", file=sys.stderr)
+            return None
+        except Exception as e:
+            # Catch-all for unexpected errors
+            import sys
+
+            print(f"Unexpected AQI error for ({lat},{lon}): {e}", file=sys.stderr)
             return None
 
 
@@ -207,8 +239,8 @@ def get_weather_data(city: str, metric: bool = False) -> Optional[WeatherData]:
         precip_prob=round(avg_precip_prob),
         rainfall=next_6h_rain,
         snowfall=next_6h_snow,
-        sunrise=format_time(daily["sunrise"][0]),
-        sunset=format_time(daily["sunset"][0]),
+        sunrise=format_time(daily["sunrise"][0], timezone),
+        sunset=format_time(daily["sunset"][0], timezone),
         forecast=forecast,
         hourly=hourly_forecast,
         units=weather_client.units,

{isobar_cli-1.1.1 → isobar_cli-1.2.0}/src/isobar_cli/config.py

@@ -1,12 +1,18 @@
 """Configuration module for Isobar CLI persistent settings."""
 
 import json
+import os
 from pathlib import Path
 from typing import Optional
 
 CONFIG_DIR = Path.home() / ".config" / "isobar"
 CONFIG_FILE = CONFIG_DIR / "config.json"
 
+# Default API endpoints (can be overridden by environment variables)
+DEFAULT_GEOCODING_URL = "https://geocoding-api.open-meteo.com/v1/search"
+DEFAULT_WEATHER_URL = "https://api.open-meteo.com/v1/forecast"
+DEFAULT_AQI_URL = "https://air-quality-api.open-meteo.com/v1/air-quality"
+
 
 def ensure_config_dir() -> None:
     """Create config directory if it doesn't exist."""
@@ -72,3 +78,18 @@ def clear_home_city() -> None:
 def get_config_path() -> Path:
     """Get the path to the config file (for debugging/info)."""
     return CONFIG_FILE
+
+
+def get_geocoding_url() -> str:
+    """Get geocoding API URL from environment or default."""
+    return os.environ.get("ISOBAR_GEOCODING_URL", DEFAULT_GEOCODING_URL)
+
+
+def get_weather_url() -> str:
+    """Get weather API URL from environment or default."""
+    return os.environ.get("ISOBAR_WEATHER_URL", DEFAULT_WEATHER_URL)
+
+
+def get_aqi_url() -> str:
+    """Get air quality API URL from environment or default."""
+    return os.environ.get("ISOBAR_AQI_URL", DEFAULT_AQI_URL)

{isobar_cli-1.1.1 → isobar_cli-1.2.0}/src/isobar_cli/logic.py

@@ -31,16 +31,86 @@ WMO_CODES: dict[int, tuple[str, str]] = {
 }
 
 
-def format_time(iso_string: str) -> str:
-    """Convert ISO 8601 datetime to 12-hour format (e.g., '6:42 AM')."""
+def format_time(iso_string: str, timezone: str = "UTC") -> str:
+    """Convert ISO 8601 datetime to 12-hour format in specified timezone.
+
+    Args:
+        iso_string: ISO 8601 datetime string
+        timezone: Timezone name (e.g., 'America/New_York'), defaults to UTC
+
+    Returns:
+        Formatted time string (e.g., '6:42 AM') or '--' on error
+    """
     if not iso_string:
         return "--"
+
     try:
+        # Parse the datetime
         dt = datetime.fromisoformat(iso_string.replace("Z", "+00:00"))
+
+        # Convert to local timezone if not UTC
+        if timezone != "UTC":
+            try:
+                import pytz
+
+                utc_dt = dt.replace(tzinfo=pytz.UTC)
+                local_tz = pytz.timezone(timezone)
+                local_dt = utc_dt.astimezone(local_tz)
+                return local_dt.strftime("%-I:%M %p")
+            except ImportError:
+                # pytz not installed, fall back to UTC
+                pass
+
         return dt.strftime("%-I:%M %p")
     except (ValueError, AttributeError):
         return "--"
 
+    # Try to import pytz for timezone conversion
+    pytz_available = False
+    if timezone != "UTC":
+        try:
+            import pytz
+
+            pytz_available = True
+        except ImportError:
+            pytz_available = False
+
+    try:
+        # Parse the datetime
+        dt = datetime.fromisoformat(iso_string.replace("Z", "+00:00"))
+
+        # Convert to local timezone if not UTC and pytz is available
+        if timezone != "UTC" and pytz_available:
+            utc_dt = dt.replace(tzinfo=pytz.UTC)
+            local_tz = pytz.timezone(timezone)
+            local_dt = utc_dt.astimezone(local_tz)
+            return local_dt.strftime("%-I:%M %p")
+
+        return dt.strftime("%-I:%M %p")
+    except (ValueError, AttributeError):
+        return "--"
+    try:
+        # Parse the datetime
+        dt = datetime.fromisoformat(iso_string.replace("Z", "+00:00"))
+
+        # Convert to local timezone if not UTC
+        if timezone != "UTC":
+            import pytz
+
+            utc_dt = dt.replace(tzinfo=pytz.UTC)
+            local_tz = pytz.timezone(timezone)
+            local_dt = utc_dt.astimezone(local_tz)
+            return local_dt.strftime("%-I:%M %p")
+
+        return dt.strftime("%-I:%M %p")
+    except (ValueError, AttributeError, ImportError):
+        # Fallback to UTC if pytz not available or other error
+        try:
+            dt = datetime.fromisoformat(iso_string.replace("Z", "+00:00"))
+            return dt.strftime("%-I:%M %p")
+        except (ValueError, AttributeError):
+            return "--"
+
 
 def get_temp_color(temp_val: float, unit="°F") -> str:
     """Returns a Rich color tag based on the temperature and unit."""

{isobar_cli-1.1.1 → isobar_cli-1.2.0}/src/isobar_cli/main.py

@@ -14,7 +14,8 @@ from isobar_cli.ui import (
 )
 
 app = typer.Typer(
-    help=("Terminal weather focused on what it FEELS LIKE outside right now.")
+    help=("Terminal weather focused on what it FEELS LIKE outside right now."),
+    invoke_without_command=True,
 )
 console = Console()
 
@@ -25,6 +26,60 @@ def city_complete(incomplete: str):
     return [c for c in cached if c.lower().startswith(incomplete.lower())]
 
 
+@app.callback()
+def main(
+    ctx: typer.Context,
+    cities: Annotated[
+        Optional[list[str]],
+        typer.Argument(
+            help='City name(s) (detects automatically if omitted). Use quotes for multi-word cities (e.g. "New York").',
+            autocompletion=city_complete,
+        ),
+    ] = None,
+    forecast: Annotated[
+        bool,
+        typer.Option(
+            "--forecast",
+            "-f",
+            help="Show 7-day forecast after current conditions",
+        ),
+    ] = False,
+    hourly: Annotated[
+        bool,
+        typer.Option(
+            "--hourly",
+            "-H",
+            help="Show next 12 hours of weather",
+        ),
+    ] = False,
+    metric: Annotated[
+        bool,
+        typer.Option(
+            "--metric",
+            "-m",
+            help="Show weather in metric units (Celsius, km/h, mm)",
+        ),
+    ] = False,
+):
+    """
+    Get the weather and what it FEELS LIKE outside right now.
+
+    Examples:
+        isobar                    # Auto-detect location
+        isobar Chicago            # Specific city
+        isobar London Tokyo Paris # Multiple cities
+        isobar --hourly           # Next 12 hours
+        isobar --forecast         # 7-day forecast
+        isobar --metric           # Celsius, km/h, mm
+    """
+    # If a subcommand was called, don't run the default
+    if ctx.invoked_subcommand is not None:
+        return
+
+    # Run the main weather logic
+    _run_weather_logic(cities, forecast, hourly, metric)
+
+
 @app.command()
 def home(
     city: Annotated[
@@ -66,51 +121,14 @@ def home(
     console.print(f"[green]✓ Home city set to: {city}[/green]")
 
 
-@app.command()
-def main(
-    cities: Annotated[
-        Optional[list[str]],
-        typer.Argument(
-            help='City name(s) (detects automatically if omitted). Use quotes for multi-word cities (e.g. "New York").',
-            autocompletion=city_complete,
-        ),
-    ] = None,
-    forecast: Annotated[
-        bool,
-        typer.Option(
-            "--forecast",
-            "-f",
-            help="Show 7-day forecast after current conditions",
-        ),
-    ] = False,
-    hourly: Annotated[
-        bool,
-        typer.Option(
-            "--hourly",
-            "-H",
-            help="Show next 12 hours of weather",
-        ),
-    ] = False,
-    metric: Annotated[
-        bool,
-        typer.Option(
-            "--metric",
-            "-m",
-            help="Show weather in metric units (Celsius, km/h, mm)",
-        ),
-    ] = False,
+def _run_weather_logic(
+    cities: Optional[list[str]] = None,
+    forecast: bool = False,
+    hourly: bool = False,
+    metric: bool = False,
 ):
     """
-    Get the weather and what it FEELS LIKE outside right now.
-
-    Examples:
-        isobar                        # Auto-detect location
-        isobar Chicago                # Single city
-        isobar London Tokyo Paris     # Multiple cities
-        isobar "New York"             # Quotes for multi-word cities
-        isobar --forecast             # Current + 7-day outlook
-        isobar --hourly               # Current + next 12 hours
-        isobar --metric               # Metric units
+    Core weather logic shared between default callback and main command.
     """
     # Resolve cities list
     cities_to_fetch = []

{isobar_cli-1.1.1 → isobar_cli-1.2.0/src/isobar_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: isobar-cli
-Version: 1.1.1
+Version: 1.2.0
 Summary: A visually pleasing terminal weather tool focusing on Real Feel and Windchill.
 Author: Beau Bremer / KnowOneActual
 License-Expression: MIT
@@ -29,6 +29,8 @@ Provides-Extra: test
 Requires-Dist: pytest>=7.0.0; extra == "test"
 Requires-Dist: requests-mock>=1.11.0; extra == "test"
 Requires-Dist: pytest-cov>=4.1.0; extra == "test"
+Provides-Extra: timezone
+Requires-Dist: pytz>=2024.1; extra == "timezone"
 Dynamic: license-file
 
 # Isobar CLI 
@@ -36,7 +38,7 @@ Dynamic: license-file
 ![CI](https://github.com/KnowOneActual/isobar-cli/actions/workflows/ci.yml/badge.svg)
 ![Coverage](https://img.shields.io/badge/coverage-98%25-green)
 [![PyPI version](https://badge.fury.io/py/isobar-cli.svg)](https://badge.fury.io/py/isobar-cli)
-![Version](https://img.shields.io/badge/version-1.0.1-blue)
+![Version](https://img.shields.io/badge/version-1.2.0-blue)
 ![Ruff](https://img.shields.io/badge/linting-ruff-purple)
 ![Python](https://img.shields.io/badge/python-3.8%2B-blue)
 ![License](https://img.shields.io/badge/license-MIT-green)
@@ -80,7 +82,7 @@ Most weather apps overwhelm with data. Isobar strips away everything except what
   - **Temporal Context** — Comparison with previous day conditions 📈
   - **UV Index Monitoring** — Sun protection guidance with intensity levels ☀️
   - **Wind Gust Alerts** — Highlighting of significant gust events 💨⚠️
-  - **Home City Persistence** — Set a default city with `isobar home "Your City"` 🏠
+  - **Home City Persistence** — Set a default city with `isobar home "Your City"` 🏠 *(Note: Due to a Typer limitation, this currently shows weather for "Home, Kansas" instead of setting home city. Manual config editing required.)*
 
 ## 🚀 Installation
 
@@ -124,12 +126,16 @@ isobar London Tokyo Paris     # Multiple cities
 isobar "New York"             # Use quotes for multi-word cities
 
 # Hourly outlook (next 12h)
-isobar --hourly
-isobar -H
+isobar --hourly Chicago
+isobar -H Chicago
 
 # 7-day forecast
-isobar --forecast
-isobar -f
+isobar --forecast Chicago
+isobar -f Chicago
+
+# Note: Flags must come before city names
+# ✅ isobar -H Chicago
+# ❌ isobar Chicago -H  (treats "-H" as a city name)
 isobar "San Francisco" --forecast
 isobar -f Sydney
 
@@ -145,6 +151,42 @@ isobar home --clear       # Clear home city
 isobar                    # Uses home city if set (otherwise auto-detects)
 ```
 
+## ⚙️ Configuration
+
+Isobar supports configuration via environment variables for advanced use cases:
+
+### API Endpoint Configuration
+Customize API endpoints for different weather providers or testing:
+
+```bash
+# Use custom weather APIs
+export ISOBAR_GEOCODING_URL="https://custom-geocoding-api.example.com/v1/search"
+export ISOBAR_WEATHER_URL="https://custom-weather-api.example.com/v1/forecast"
+export ISOBAR_AQI_URL="https://custom-aqi-api.example.com/v1/air-quality"
+
+# Run with custom endpoints
+isobar "New York"
+```
+
+### Timezone Support
+For enhanced timezone accuracy (optional):
+
+```bash
+# Install optional timezone support
+pip install isobar-cli[timezone]
+
+# Sunrise/sunset will now display in local timezone
+isobar London
+```
+
+### Debug Mode
+Enable debug logging to stderr:
+
+```bash
+# View API errors and debugging information
+isobar "Test City" 2> debug.log
+```
+
 ## ⌨️ Shell Completion
 
 Isobar supports tab-completion for city names. To enable it for a shell:
@@ -212,6 +254,10 @@ Preparation Guidance:
 | `config.py` | Persistent home city configuration |
 | Enhanced `logic.py` | Preparation guidance, UV monitoring, gust alerts |
 | Updated `ui.py` | Contextual display of insights |
+| **v1.2.0 Features** | **Security & Configuration** |
+| Configurable API Endpoints | Environment variable support for custom APIs |
+| Enhanced Error Handling | Specific exception catching with timeouts |
+| Timezone Support | Optional `pytz` dependency for local time display |
 
 ## 🔒 Security
 
@@ -235,6 +281,7 @@ All security scans are integrated into the CI/CD pipeline and run on every push,
 ✅ **Phase 5 Complete** — Testing & Reliability  
 ✅ **Phase 6 Complete** — Distribution (PyPI, Homebrew)  
 ✅ **Phase 7 Complete** — Intuition & Analysis (v1.1.0)  
+✅ **v1.2.0 Complete** — Security & Configuration Enhancements  
 Refer to [ROADMAP.md](ROADMAP.md) and [CHANGELOG.md](CHANGELOG.md) for details.
 
 ## 🤝 Contributing

{isobar_cli-1.1.1 → isobar_cli-1.2.0}/src/isobar_cli.egg-info/requires.txt

@@ -7,3 +7,6 @@ timezonefinder>=6.0.0
 pytest>=7.0.0
 requests-mock>=1.11.0
 pytest-cov>=4.1.0
+
+[timezone]
+pytz>=2024.1

{isobar_cli-1.1.1 → isobar_cli-1.2.0}/tests/test_isobar_extra.py

@@ -212,88 +212,97 @@ def test_get_weather_data_request_exception(requests_mock):
 
 
 def test_main_auto_location_fail(monkeypatch):
-    monkeypatch.setattr("isobar_cli.main.get_auto_location", lambda: None)
-    units = WeatherUnits(temp="°F", wind="mph", precip="in")
     mock_weather = WeatherData(
-        city="Chicago",
-        temp=30.0,
-        feels_like=25.0,
-        wind_speed=10.0,
-        humidity=50,
-        precipitation=0.0,
+        city="Chicago, Illinois",
+        temp=75.2,
+        feels_like=78.5,
+        wind_speed=12.4,
+        humidity=65,
+        precipitation=0.1,
         weather_code=0,
-        precip_prob=10,
-        rainfall=0.0,
+        precip_prob=30,
+        rainfall=0.1,
         snowfall=0.0,
-        sunrise="6:00 AM",
-        sunset="6:00 PM",
+        sunrise="6:29 AM",
+        sunset="5:37 PM",
         forecast=[],
         hourly=[],
-        units=units,
+        aqi=45,
+        units=WeatherUnits(temp="°F", wind="mph", precip="in"),
+        wind_gust=25.0,
+        uv_index=6.5,
+        previous_day_temp=70.0,
     )
+    monkeypatch.setattr("isobar_cli.main.get_auto_location", lambda: None)
+    monkeypatch.setattr("isobar_cli.main.get_home_city", lambda: None)
     monkeypatch.setattr(
         "isobar_cli.main.get_weather_data", lambda city, metric=False: mock_weather
     )
-    result = runner.invoke(
-        app, ["main"], color=False, env={"TERM": "dumb", "NO_COLOR": "1"}
-    )
+    result = runner.invoke(app, [], color=False, env={"TERM": "dumb", "NO_COLOR": "1"})
     assert "Could not detect location" in result.output
     assert "Using Chicago as default" in result.output
 
 
 def test_main_auto_location_success(monkeypatch):
-    monkeypatch.setattr("isobar_cli.main.get_auto_location", lambda: "New York")
-    units = WeatherUnits(temp="°F", wind="mph", precip="in")
     mock_weather = WeatherData(
-        city="New York",
-        temp=30.0,
-        feels_like=25.0,
-        wind_speed=10.0,
-        humidity=50,
+        city="New York, New York",
+        temp=68.0,
+        feels_like=70.0,
+        wind_speed=8.0,
+        humidity=60,
         precipitation=0.0,
         weather_code=0,
         precip_prob=10,
         rainfall=0.0,
         snowfall=0.0,
-        sunrise="6:00 AM",
-        sunset="6:00 PM",
+        sunrise="6:15 AM",
+        sunset="7:45 PM",
         forecast=[],
         hourly=[],
-        units=units,
+        aqi=30,
+        units=WeatherUnits(temp="°F", wind="mph", precip="in"),
+        wind_gust=12.0,
+        uv_index=5.0,
+        previous_day_temp=65.0,
     )
+    monkeypatch.setattr("isobar_cli.main.get_auto_location", lambda: "New York")
+    monkeypatch.setattr("isobar_cli.main.get_home_city", lambda: None)
     monkeypatch.setattr(
         "isobar_cli.main.get_weather_data", lambda city, metric=False: mock_weather
     )
-    result = runner.invoke(
-        app, ["main"], color=False, env={"TERM": "dumb", "NO_COLOR": "1"}
-    )
+    result = runner.invoke(app, [], color=False, env={"TERM": "dumb", "NO_COLOR": "1"})
     assert "Detected: New York" in result.output
 
 
 def test_main_city_option(monkeypatch):
     units = WeatherUnits(temp="°F", wind="mph", precip="in")
+    mock_weather = WeatherData(
+        city="Tokyo, Tokyo",
+        temp=60.0,
+        feels_like=62.0,
+        wind_speed=5.0,
+        humidity=50,
+        precipitation=0.0,
+        weather_code=1,
+        precip_prob=20,
+        rainfall=0.0,
+        snowfall=0.0,
+        sunrise="5:30 AM",
+        sunset="6:30 PM",
+        forecast=[],
+        hourly=[],
+        aqi=25,
+        units=units,
+        wind_gust=8.0,
+        uv_index=4.0,
+        previous_day_temp=58.0,
+    )
     monkeypatch.setattr(
         "isobar_cli.main.get_weather_data",
-        lambda city, metric=False: WeatherData(
-            city=city,
-            temp=30.0,
-            feels_like=25.0,
-            wind_speed=10.0,
-            humidity=50,
-            precipitation=0.0,
-            weather_code=0,
-            precip_prob=10,
-            rainfall=0.0,
-            snowfall=0.0,
-            sunrise="6:00 AM",
-            sunset="6:00 PM",
-            forecast=[],
-            hourly=[],
-            units=units,
-        ),
+        lambda city, metric=False: mock_weather if city == "Tokyo" else None,
     )
     result = runner.invoke(
-        app, ["main", "Tokyo"], color=False, env={"TERM": "dumb", "NO_COLOR": "1"}
+        app, ["Tokyo"], color=False, env={"TERM": "dumb", "NO_COLOR": "1"}
     )
     assert "Tokyo" in result.output
 
@@ -343,7 +352,7 @@ def test_main_with_flags(monkeypatch):
     # Multi-city
     result = runner.invoke(
         app,
-        ["main", "City1", "City2"],
+        ["City1", "City2"],
         color=False,
         env={"TERM": "dumb", "NO_COLOR": "1"},
     )
@@ -354,7 +363,7 @@ def test_main_with_flags(monkeypatch):
     # Multi-city with flags
     result = runner.invoke(
         app,
-        ["main", "City1", "City2", "--hourly"],
+        ["--hourly", "City1", "City2"],
         color=False,
         env={"TERM": "dumb", "NO_COLOR": "1"},
     )
@@ -364,7 +373,7 @@ def test_main_with_flags(monkeypatch):
     # Hourly
     result = runner.invoke(
         app,
-        ["main", "CityH", "--hourly"],
+        ["--hourly", "CityH"],
         color=False,
         env={"TERM": "dumb", "NO_COLOR": "1"},
     )
@@ -374,7 +383,7 @@ def test_main_with_flags(monkeypatch):
     # Forecast
     result = runner.invoke(
         app,
-        ["main", "CityF", "--forecast"],
+        ["--forecast", "CityF"],
         color=False,
         env={"TERM": "dumb", "NO_COLOR": "1"},
     )

{isobar_cli-1.1.1 → isobar_cli-1.2.0}/tests/test_main.py

@@ -9,16 +9,17 @@ runner = CliRunner()
 
 def test_main_help():
     result = runner.invoke(
-        app, ["main", "--help"], color=False, env={"TERM": "dumb", "NO_COLOR": "1"}
+        app, ["--help"], color=False, env={"TERM": "dumb", "NO_COLOR": "1"}
     )
     assert result.exit_code == 0
-    assert "Get the weather and what it FEELS LIKE" in result.output
+    assert "Terminal weather focused on what it FEELS LIKE" in result.output
 
 
 def test_main_metric_flag_exists():
     result = runner.invoke(
-        app, ["main", "--help"], color=False, env={"TERM": "dumb", "NO_COLOR": "1"}
+        app, ["--help"], color=False, env={"TERM": "dumb", "NO_COLOR": "1"}
     )
+    assert result.exit_code == 0
     assert "--metric" in result.output
     assert "-m" in result.output
 
@@ -66,7 +67,7 @@ def mock_api(monkeypatch):
 
 def test_main_with_city(mock_api):
     result = runner.invoke(
-        app, ["main", "Chicago"], color=False, env={"TERM": "dumb", "NO_COLOR": "1"}
+        app, ["Chicago"], color=False, env={"TERM": "dumb", "NO_COLOR": "1"}
     )
     assert result.exit_code == 0
 
@@ -74,7 +75,7 @@ def test_main_with_city(mock_api):
 def test_main_with_metric(mock_api):
     result = runner.invoke(
         app,
-        ["main", "Chicago", "--metric"],
+        ["Chicago", "--metric"],
         color=False,
         env={"TERM": "dumb", "NO_COLOR": "1"},
     )
@@ -84,7 +85,7 @@ def test_main_with_metric(mock_api):
 def test_main_with_hourly(mock_api):
     result = runner.invoke(
         app,
-        ["main", "Chicago", "--hourly"],
+        ["Chicago", "--hourly"],
         color=False,
         env={"TERM": "dumb", "NO_COLOR": "1"},
     )
@@ -94,7 +95,7 @@ def test_main_with_hourly(mock_api):
 def test_main_multiple_cities(mock_api):
     result = runner.invoke(
         app,
-        ["main", "Chicago", "London"],
+        ["Chicago", "London"],
         color=False,
         env={"TERM": "dumb", "NO_COLOR": "1"},
     )
@@ -103,7 +104,7 @@ def test_main_multiple_cities(mock_api):
 
 def test_main_not_found_with_suggestions(mock_api):
     result = runner.invoke(
-        app, ["main", "Unknown"], color=False, env={"TERM": "dumb", "NO_COLOR": "1"}
+        app, ["Unknown"], color=False, env={"TERM": "dumb", "NO_COLOR": "1"}
     )
     assert result.exit_code == 1
     assert "'Unknown' not found" in result.output

isobar_cli-1.1.1/src/isobar_cli/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.6.2"