isobar-cli 1.0.0__tar.gz

isobar_cli-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Beau Bremer / KnowOneActual
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

isobar_cli-1.0.0/PKG-INFO

@@ -0,0 +1,180 @@
+Metadata-Version: 2.4
+Name: isobar-cli
+Version: 1.0.0
+Summary: A visually pleasing terminal weather tool focusing on Real Feel and Windchill.
+Author: Beau Bremer / KnowOneActual
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/KnowOneActual/isobar-cli
+Project-URL: Repository, https://github.com/KnowOneActual/isobar-cli
+Project-URL: Issues, https://github.com/KnowOneActual/isobar-cli/issues
+Project-URL: Changelog, https://github.com/KnowOneActual/isobar-cli/blob/main/CHANGELOG.md
+Keywords: weather,cli,terminal,meteo,forecast
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rich>=13.0.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: typer>=0.9.0
+Requires-Dist: timezonefinder>=6.0.0
+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"
+Dynamic: license-file
+
+# Isobar CLI
+
+![CI](https://github.com/KnowOneActual/isobar-cli/actions/workflows/ci.yml/badge.svg)
+![Coverage](https://img.shields.io/badge/coverage-98%25-green)
+![Version](https://img.shields.io/badge/version-0.6.3-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)
+
+A terminal weather tool designed to give you a fast, clean sense of what the weather **feels like** outside; right now and for the week ahead. Built with Python and Rich.
+
+## Philosophy
+
+Isobar CLI answers a simple question: **"What does it feel like outside right now, and how do I prepare to be outside?"**
+
+Most weather apps overwhelm you with data. Isobar strips away everything except what matters when you're deciding whether to grab a jacket.
+
+### Design Principles
+- **Essential over comprehensive** — Show Real Feel, not 47 data points
+- **Terminal-native** — Built for quick checks in your workflow
+- **Zero friction** — No API keys, no config files
+- **Information density** — Clean, borderless UI
+- **Intentional features** — Each must answer: *"Does this help understand what it feels like outside?"*
+
+## ✨ Features
+
+- **Auto-Location** — `isobar` detects your city automatically 🌍
+- **Weather Condition Icons** — WMO-standard emoji + plain-English description (☀️ Clear sky, 🌨️ Moderate snow, ⛈️ Thunderstorm)
+- **Real Feel** — Apparent temperature (what it *feels* like)
+- **Air Quality Index** — US AQI with health classifications 😷
+- **7-Day Forecast** — Full week outlook with color-coded highs/lows and daily rain %
+- **Hourly Outlook** — Next 12 hours of temp and rain chance (`--hourly`)
+- **Multiple Cities** — Compare weather across several cities at once (side-by-side)
+- **Smart Suggestions** — Fuzzy city name matching if you make a typo
+- **Shell Completion** — Tab-complete city names from your search history
+- **Dynamic Timezone** — Sunrise/sunset always shown in the city's local time, not yours
+- **Precipitation Forecast** — Next 6h rain/snow chance + totals
+- **Smart Caching** — 15-min cache per city (`~/.cache/isobar/`)
+- **Color-Coded Temps** — Cyan → Blue → Green → Yellow → Red
+- **Metric Support** — `--metric` or `-m` for Celsius, km/h, and mm
+- **No API Keys** — Free Open-Meteo + ip-api.com
+- **Zero Config** — Works instantly after `pip install .`
+
+## 🚀 Installation
+
+```bash
+git clone https://github.com/KnowOneActual/isobar-cli.git
+cd isobar-cli
+pip install .
+```
+
+## 📱 Usage
+
+```bash
+# Auto-detect your location
+isobar
+
+# Specify a city
+isobar Chicago
+isobar London Tokyo Paris     # Multiple cities
+isobar "New York"             # Use quotes for multi-word cities
+
+# Hourly outlook (next 12h)
+isobar --hourly
+isobar -H
+
+# 7-day forecast
+isobar --forecast
+isobar -f
+isobar "San Francisco" --forecast
+isobar -f Sydney
+
+# Metric units (Celsius, km/h, mm)
+isobar --metric
+isobar -m
+isobar Tokyo -m
+```
+
+## ⌨️ Shell Completion
+
+Isobar supports tab-completion for city names based on your search history. To enable it for your shell:
+
+**Zsh:**
+```bash
+isobar --install-completion zsh
+```
+
+**Bash:**
+```bash
+isobar --install-completion bash
+```
+
+*(Note: You may need to restart your terminal after installing completion).*
+
+## 🖥️ Example Output
+
+```
+               Chicago, Illinois Weather
+ ☀️  Conditions:                        Mainly clear
+ 🌡️  Temperature:                             37.1°F
+ 🤔  Real Feel:                               30.4°F
+ 💨  Wind Speed:                             4.3 mph
+ 💧  Humidity:                                   58%
+ ☔  Precip Chance:  0% (6h) | Dry conditions expected
+ 🌅  Sunrise:                                6:29 AM
+ 🌇  Sunset:                                 5:37 PM
+
+           7-Day Forecast — Chicago, Illinois
+  Day            Conditions        High     Low   Rain%
+  Today      ☁️  Overcast         41.7°F  23.9°F    1%
+  Fri Feb 27 ⛅  Partly cloudy    66.4°F  32.4°F    2%
+  Sat Feb 28 🌨️  Moderate snow    44.0°F  26.5°F   38%
+  Sun Mar 1  ☁️  Overcast         29.0°F  26.6°F   36%
+  Mon Mar 2  ☁️  Overcast         33.6°F  27.1°F   36%
+  Tue Mar 3  🌦️  Light drizzle    36.8°F  30.9°F   27%
+  Wed Mar 4  🌦️  Moderate drizzle 41.3°F  33.5°F   46%
+```
+
+## 🛠 Tech Stack
+
+| Tool | Purpose |
+|---|---|
+| [Typer](https://typer.tiangolo.com/) | CLI framework |
+| [Rich](https://github.com/Textualize/rich) | Terminal UI |
+| [Open-Meteo](https://open-meteo.com/) | Weather + forecast data (free, no key) |
+| [ip-api.com](http://ip-api.com/) | Auto-location detection (free) |
+| [timezonefinder](https://github.com/jannikmi/timezonefinder) | Dynamic timezone from coordinates (offline) |
+| [pytest](https://docs.pytest.org/) | Unit testing framework |
+| [requests-mock](https://requests-mock.readthedocs.io/) | Mocking for API testing |
+| [Ruff](https://docs.astral.sh/ruff/) | Linting + formatting |
+| [pip-audit](https://github.com/pypa/pip-audit) | Dependency security scanning (CI) |
+
+## 📈 Project Status
+
+✅ **Phase 1 Complete** — Caching + Auto-Location  
+✅ **Phase 2 Complete** — Precipitation, Sunrise/Sunset, Condition Icons  
+✅ **Phase 3 Complete** — 7-Day Forecast, Dynamic Timezone, `--city` flag  
+✅ **CI/CD** — Ruff lint + security audit on every push and PR  
+See [ROADMAP.md](ROADMAP.md) and [CHANGELOG.md](CHANGELOG.md)
+
+## 🤝 Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md). New features must answer: **"Does this help understand what it feels like outside?"**
+
+## 📄 License
+
+MIT. See [LICENSE](LICENSE).

isobar_cli-1.0.0/README.md

@@ -0,0 +1,147 @@
+# Isobar CLI
+
+![CI](https://github.com/KnowOneActual/isobar-cli/actions/workflows/ci.yml/badge.svg)
+![Coverage](https://img.shields.io/badge/coverage-98%25-green)
+![Version](https://img.shields.io/badge/version-0.6.3-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)
+
+A terminal weather tool designed to give you a fast, clean sense of what the weather **feels like** outside; right now and for the week ahead. Built with Python and Rich.
+
+## Philosophy
+
+Isobar CLI answers a simple question: **"What does it feel like outside right now, and how do I prepare to be outside?"**
+
+Most weather apps overwhelm you with data. Isobar strips away everything except what matters when you're deciding whether to grab a jacket.
+
+### Design Principles
+- **Essential over comprehensive** — Show Real Feel, not 47 data points
+- **Terminal-native** — Built for quick checks in your workflow
+- **Zero friction** — No API keys, no config files
+- **Information density** — Clean, borderless UI
+- **Intentional features** — Each must answer: *"Does this help understand what it feels like outside?"*
+
+## ✨ Features
+
+- **Auto-Location** — `isobar` detects your city automatically 🌍
+- **Weather Condition Icons** — WMO-standard emoji + plain-English description (☀️ Clear sky, 🌨️ Moderate snow, ⛈️ Thunderstorm)
+- **Real Feel** — Apparent temperature (what it *feels* like)
+- **Air Quality Index** — US AQI with health classifications 😷
+- **7-Day Forecast** — Full week outlook with color-coded highs/lows and daily rain %
+- **Hourly Outlook** — Next 12 hours of temp and rain chance (`--hourly`)
+- **Multiple Cities** — Compare weather across several cities at once (side-by-side)
+- **Smart Suggestions** — Fuzzy city name matching if you make a typo
+- **Shell Completion** — Tab-complete city names from your search history
+- **Dynamic Timezone** — Sunrise/sunset always shown in the city's local time, not yours
+- **Precipitation Forecast** — Next 6h rain/snow chance + totals
+- **Smart Caching** — 15-min cache per city (`~/.cache/isobar/`)
+- **Color-Coded Temps** — Cyan → Blue → Green → Yellow → Red
+- **Metric Support** — `--metric` or `-m` for Celsius, km/h, and mm
+- **No API Keys** — Free Open-Meteo + ip-api.com
+- **Zero Config** — Works instantly after `pip install .`
+
+## 🚀 Installation
+
+```bash
+git clone https://github.com/KnowOneActual/isobar-cli.git
+cd isobar-cli
+pip install .
+```
+
+## 📱 Usage
+
+```bash
+# Auto-detect your location
+isobar
+
+# Specify a city
+isobar Chicago
+isobar London Tokyo Paris     # Multiple cities
+isobar "New York"             # Use quotes for multi-word cities
+
+# Hourly outlook (next 12h)
+isobar --hourly
+isobar -H
+
+# 7-day forecast
+isobar --forecast
+isobar -f
+isobar "San Francisco" --forecast
+isobar -f Sydney
+
+# Metric units (Celsius, km/h, mm)
+isobar --metric
+isobar -m
+isobar Tokyo -m
+```
+
+## ⌨️ Shell Completion
+
+Isobar supports tab-completion for city names based on your search history. To enable it for your shell:
+
+**Zsh:**
+```bash
+isobar --install-completion zsh
+```
+
+**Bash:**
+```bash
+isobar --install-completion bash
+```
+
+*(Note: You may need to restart your terminal after installing completion).*
+
+## 🖥️ Example Output
+
+```
+               Chicago, Illinois Weather
+ ☀️  Conditions:                        Mainly clear
+ 🌡️  Temperature:                             37.1°F
+ 🤔  Real Feel:                               30.4°F
+ 💨  Wind Speed:                             4.3 mph
+ 💧  Humidity:                                   58%
+ ☔  Precip Chance:  0% (6h) | Dry conditions expected
+ 🌅  Sunrise:                                6:29 AM
+ 🌇  Sunset:                                 5:37 PM
+
+           7-Day Forecast — Chicago, Illinois
+  Day            Conditions        High     Low   Rain%
+  Today      ☁️  Overcast         41.7°F  23.9°F    1%
+  Fri Feb 27 ⛅  Partly cloudy    66.4°F  32.4°F    2%
+  Sat Feb 28 🌨️  Moderate snow    44.0°F  26.5°F   38%
+  Sun Mar 1  ☁️  Overcast         29.0°F  26.6°F   36%
+  Mon Mar 2  ☁️  Overcast         33.6°F  27.1°F   36%
+  Tue Mar 3  🌦️  Light drizzle    36.8°F  30.9°F   27%
+  Wed Mar 4  🌦️  Moderate drizzle 41.3°F  33.5°F   46%
+```
+
+## 🛠 Tech Stack
+
+| Tool | Purpose |
+|---|---|
+| [Typer](https://typer.tiangolo.com/) | CLI framework |
+| [Rich](https://github.com/Textualize/rich) | Terminal UI |
+| [Open-Meteo](https://open-meteo.com/) | Weather + forecast data (free, no key) |
+| [ip-api.com](http://ip-api.com/) | Auto-location detection (free) |
+| [timezonefinder](https://github.com/jannikmi/timezonefinder) | Dynamic timezone from coordinates (offline) |
+| [pytest](https://docs.pytest.org/) | Unit testing framework |
+| [requests-mock](https://requests-mock.readthedocs.io/) | Mocking for API testing |
+| [Ruff](https://docs.astral.sh/ruff/) | Linting + formatting |
+| [pip-audit](https://github.com/pypa/pip-audit) | Dependency security scanning (CI) |
+
+## 📈 Project Status
+
+✅ **Phase 1 Complete** — Caching + Auto-Location  
+✅ **Phase 2 Complete** — Precipitation, Sunrise/Sunset, Condition Icons  
+✅ **Phase 3 Complete** — 7-Day Forecast, Dynamic Timezone, `--city` flag  
+✅ **CI/CD** — Ruff lint + security audit on every push and PR  
+See [ROADMAP.md](ROADMAP.md) and [CHANGELOG.md](CHANGELOG.md)
+
+## 🤝 Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md). New features must answer: **"Does this help understand what it feels like outside?"**
+
+## 📄 License
+
+MIT. See [LICENSE](LICENSE).

isobar_cli-1.0.0/pyproject.toml

@@ -0,0 +1,112 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "isobar-cli"
+version = "1.0.0"
+description = "A visually pleasing terminal weather tool focusing on Real Feel and Windchill."
+authors = [
+  { name="Beau Bremer / KnowOneActual" },
+]
+readme = "README.md"
+license = "MIT"
+keywords = ["weather", "cli", "terminal", "meteo", "forecast"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Topic :: Utilities",
+]
+dependencies = [
+  "rich>=13.0.0",
+  "requests>=2.31.0",
+  "typer>=0.9.0",
+      "timezonefinder>=6.0.0",
+  ]
+  requires-python = ">=3.8"
+  
+  [project.urls]
+  Homepage = "https://github.com/KnowOneActual/isobar-cli"
+  Repository = "https://github.com/KnowOneActual/isobar-cli"
+  Issues = "https://github.com/KnowOneActual/isobar-cli/issues"
+  Changelog = "https://github.com/KnowOneActual/isobar-cli/blob/main/CHANGELOG.md"
+  
+  [project.optional-dependencies]
+  
+test = [
+    "pytest>=7.0.0",
+    "requests-mock>=1.11.0",
+    "pytest-cov>=4.1.0",
+]
+
+[project.scripts]
+isobar = "isobar_cli.main:app"  # This allows you to type 'isobar' in the terminal to run it
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+packages = ["isobar_cli"]
+
+[tool.ruff]
+# Exclude a variety of commonly ignored directories.
+exclude = [
+    ".bzr",
+    ".direnv",
+    ".eggs",
+    ".git",
+    ".git-rewrite",
+    ".hg",
+    ".ipynb_checkpoints",
+    ".mypy_cache",
+    ".nox",
+    ".pants.d",
+    ".pyenv",
+    ".pytest_cache",
+    ".pytype",
+    ".ruff_cache",
+    ".svn",
+    ".tox",
+    ".venv",
+    ".vscode",
+    "__pypackages__",
+    "_build",
+    "buck-out",
+    "build",
+    "dist",
+    "node_modules",
+    "site-packages",
+    "venv",
+]
+
+line-length = 88
+indent-width = 4
+target-version = "py39"
+
+[tool.ruff.lint]
+select = [
+    "E",   # pycodestyle errors
+    "W",   # pycodestyle warnings
+    "F",   # pyflakes
+    "I",   # isort
+    "B",   # flake8-bugbear
+    "C4",  # flake8-comprehensions
+    "UP",  # pyupgrade
+]
+ignore = ["E501"]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+line-ending = "auto"
+docstring-code-format = false
+docstring-code-line-length = "dynamic"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "--cov=src/isobar_cli --cov-report=term-missing"

isobar_cli-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

isobar_cli-1.0.0/src/isobar_cli/__init__.py

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