gtime 0.3.0__tar.gz

gtime-0.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Savitoj Singh
+
+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.

gtime-0.3.0/PKG-INFO

@@ -0,0 +1,81 @@
+Metadata-Version: 2.4
+Name: gtime
+Version: 0.3.0
+Summary: Global Time Utility (gtime) - A modern, colorful Python CLI utility for global time zone lookup, comparison, and management. It supports fuzzy search, favorites, city comparison, meeting time conversion, and a live/watch mode
+Author-email: Savitoj Singh <savv@duck.com>
+License: MIT
+Project-URL: Homepage, https://github.com/savitojs/gtime
+Project-URL: Repository, https://github.com/savitojs/gtime
+Project-URL: Bug Tracker, https://github.com/savitojs/gtime/issues
+Project-URL: Documentation, https://github.com/savitojs/gtime#readme
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rich
+Requires-Dist: python-dateutil
+Requires-Dist: thefuzz
+Requires-Dist: pytz; python_version < "3.9"
+Dynamic: license-file
+
+# gtime 🌐
+
+gtime (Global Time) is a modern, colorful Python CLI utility for global time zone lookup, comparison, and management. It supports fuzzy search, favorites, city comparison, meeting time conversion, and a live/watch mode
+
+## Features
+- Fast city lookup with fuzzy search and suggestions
+- Add/remove/list favorite cities
+- Compare times for multiple cities
+- Meeting time conversion across favorites
+- Live/watch mode for real-time updates
+- Colorful, user-friendly output (using Rich)
+- Comprehensive test suite (pytest)
+- Performance-optimized for large city databases
+
+## Installation (from source)
+Clone the repo and install locally:
+
+```sh
+pip install .
+```
+
+Or, install from PyPI:
+
+```sh
+pip install gtime
+```
+## Demo
+
+**Note:** Some command output may appear broken in the demo, but it works correctly in real use
+
+![demo](./assets/demo.gif)
+
+## Usage
+After installation, run the CLI:
+
+```sh
+gtime [command] [arguments]
+```
+
+Or as a module:
+
+```sh
+python -m gtime.cli [command] [arguments]
+```
+
+Example commands:
+- `gtime London` — Show time for London
+- `gtime add Tokyo` — Add Tokyo to favorites
+- `gtime list` — List favorite cities
+- `gtime compare London Tokyo` — Compare cities
+- `gtime meeting at 10:00 AM` — Meeting time conversion
+- `gtime watch` — Live mode
+
+## Development & Publishing
+
+### GitHub Actions
+This project includes automated workflows:
+- **Tests**: Runs on every push/PR across Python 3.8-3.12
+- **Publish**: Automatically publishes to PyPI upon new GitHub release
+
+## License
+MIT

gtime-0.3.0/README.md

@@ -0,0 +1,62 @@
+# gtime 🌐
+
+gtime (Global Time) is a modern, colorful Python CLI utility for global time zone lookup, comparison, and management. It supports fuzzy search, favorites, city comparison, meeting time conversion, and a live/watch mode
+
+## Features
+- Fast city lookup with fuzzy search and suggestions
+- Add/remove/list favorite cities
+- Compare times for multiple cities
+- Meeting time conversion across favorites
+- Live/watch mode for real-time updates
+- Colorful, user-friendly output (using Rich)
+- Comprehensive test suite (pytest)
+- Performance-optimized for large city databases
+
+## Installation (from source)
+Clone the repo and install locally:
+
+```sh
+pip install .
+```
+
+Or, install from PyPI:
+
+```sh
+pip install gtime
+```
+## Demo
+
+**Note:** Some command output may appear broken in the demo, but it works correctly in real use
+
+![demo](./assets/demo.gif)
+
+## Usage
+After installation, run the CLI:
+
+```sh
+gtime [command] [arguments]
+```
+
+Or as a module:
+
+```sh
+python -m gtime.cli [command] [arguments]
+```
+
+Example commands:
+- `gtime London` — Show time for London
+- `gtime add Tokyo` — Add Tokyo to favorites
+- `gtime list` — List favorite cities
+- `gtime compare London Tokyo` — Compare cities
+- `gtime meeting at 10:00 AM` — Meeting time conversion
+- `gtime watch` — Live mode
+
+## Development & Publishing
+
+### GitHub Actions
+This project includes automated workflows:
+- **Tests**: Runs on every push/PR across Python 3.8-3.12
+- **Publish**: Automatically publishes to PyPI upon new GitHub release
+
+## License
+MIT

gtime-0.3.0/gtime/__init__.py

@@ -0,0 +1 @@
+# Global Time Utility (gtime) package

gtime-0.3.0/gtime/cli.py

@@ -0,0 +1,322 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""
+CLI entry point for Global Time Utility (gtime)
+This module provides the command line interface for the Global Time Utility (gtime) application,
+allowing users to view current times in various cities, manage favorites, and more.
+"""
+
+import sys
+import os
+import json
+import datetime
+from pathlib import Path
+from typing import List, Tuple, Optional
+from rich.console import Console
+from rich.table import Table
+from rich.prompt import Prompt
+from rich.text import Text
+from rich.panel import Panel
+from rich.align import Align
+from rich.box import ROUNDED
+import random
+import time
+
+from .core import (
+    load_favorites, save_favorites, get_city_by_name, fuzzy_search_city, suggest_cities,
+    get_time_emoji, get_greeting, get_funny_footer
+)
+from .data import CITY_DB
+
+console = Console()
+FAV_FILE = Path.home() / ".gtime_favorites.json"
+
+def print_city_time(city, country, tz, emoji, meeting_time: Optional[datetime.datetime] = None):
+    from .core import ZoneInfo
+    now = datetime.datetime.now(ZoneInfo(tz))
+    dt = meeting_time.astimezone(ZoneInfo(tz)) if meeting_time else now
+    hour = dt.hour
+    emoji_time = get_time_emoji(hour)
+    greeting = get_greeting(hour)
+    footer = get_funny_footer(city, hour)
+    offset = dt.utcoffset()
+    if offset is not None:
+        total_minutes = offset.total_seconds() / 60
+        hours = int(total_minutes // 60)
+        minutes = int(abs(total_minutes) % 60)
+        sign = '+' if hours >= 0 else '-'
+        offset_str = f'UTC{sign}{abs(hours)}' + (f':{minutes:02}' if minutes else '')
+    else:
+        offset_str = 'UTC?'
+    table = Table(show_header=False, box=None)
+    table.add_row(f"[bold cyan]{emoji} {city}, {country}[/bold cyan]")
+    table.add_row(f"[green]{dt.strftime('%A, %B %d, %Y')}[/green]")
+    table.add_row(f"[yellow]{dt.strftime('%I:%M %p')} {emoji_time}  ([white]{offset_str}[/white])[/yellow]")
+    table.add_row("")
+    table.add_row(f"[italic magenta]{footer}[/italic magenta]")
+    console.print(Panel(table, title=f"{greeting}!", expand=False))
+
+def print_favorites(favs: List[str], meeting_time: Optional[datetime.datetime] = None):
+    from .core import ZoneInfo
+    if not favs:
+        console.print("[red]No favorite cities set. Use 'gtime add <city>' to add one.[/red]")
+        console.print("[yellow]Use 'gtime <city>' to search one and 'gtime --help' for more info[/yellow]")
+        return
+    banner = Text("🌍 GLOBAL TIME FAVORITES 🌍", style="bold magenta on cyan", justify="center")
+    console.print(Align.center(banner))
+    table = Table(title=None, show_lines=True, box=ROUNDED, expand=False)
+    table.add_column("Flag", style="bold", justify="center")
+    table.add_column("City", style="bold cyan")
+    table.add_column("Local Time", style="green")
+    table.add_column("Phase", style="magenta")
+    table.add_column("UTC Offset", style="yellow")
+    for fav in favs:
+        city_info = get_city_by_name(fav)
+        if not city_info:
+            continue
+        city, country, tz, emoji = city_info
+        now = datetime.datetime.now(ZoneInfo(tz))
+        dt = meeting_time.astimezone(ZoneInfo(tz)) if meeting_time else now
+        hour = dt.hour
+        emoji_time = get_time_emoji(hour)
+        phase = get_greeting(hour)
+        offset = dt.utcoffset()
+        if offset is not None:
+            total_minutes = offset.total_seconds() / 60
+            hours = int(total_minutes // 60)
+            minutes = int(abs(total_minutes) % 60)
+            sign = '+' if hours >= 0 else '-'
+            offset_str = f'UTC{sign}{abs(hours)}' + (f':{minutes:02}' if minutes else '')
+        else:
+            offset_str = 'UTC?'
+        clock_emoji = chr(0x1F550 + ((hour-1)%12)) if 1 <= hour <= 12 else '🕰️'
+        table.add_row(
+            emoji, f"{city}, {country}", f"{dt.strftime('%a, %b %d %I:%M %p')} {clock_emoji}", f"{emoji_time} {phase}", offset_str
+        )
+    fun_facts = [
+        "Did you know? There are 24 time zones in the world! 🌐",
+        "UTC stands for Universal Time Coordinated! 🕒",
+        "Some countries have 30 or 45 minute offsets! ⏰",
+        "The world is a beautiful place—enjoy every timezone! 🌏",
+        "Time flies like an arrow. Fruit flies like a banana! 🍌",
+        "It's always 5 o'clock somewhere! 🍹",
+        "China uses only one time zone despite spanning 5 geographical zones! 🇨🇳",
+        "Russia has 11 time zones - the most of any country! 🇷🇺",
+        "The International Date Line isn't straight - it zigzags! 📅",
+        "Some Pacific islands are a full day ahead of others! 🏝️",
+        "Nepal has a unique +5:45 UTC offset - not a round hour! 🏔️",
+        "Australia's Lord Howe Island has a 30-minute daylight saving! ⏰",
+        "The North and South Poles technically have all time zones! 🧭",
+        "France has the most time zones (12) due to overseas territories! 🇫🇷",
+        "Arizona (mostly) doesn't observe daylight saving time! 🌵",
+        "Time zones were invented by railway companies! 🚂",
+        "Before time zones, every city had its own local time! 🏙️",
+        "The first country to see the new year is Kiribati! 🎉",
+        "GMT and UTC are almost the same but not exactly! ⏱️",
+        "Some countries have changed time zones for political reasons! 🗳️",
+    ]
+    footer = random.choice(fun_facts)
+    panel = Panel(table, title="[bold magenta]Your Favorite Cities[/bold magenta]", subtitle=f"[italic cyan]{footer}", border_style="bright_magenta", box=ROUNDED)
+    console.print(panel)
+
+def print_compare(cities: List[str]):
+    from .core import ZoneInfo
+    found = []
+    for name in cities:
+        city_info = get_city_by_name(name)
+        if city_info:
+            found.append(city_info)
+        else:
+            console.print(f"[red]City not found:[/red] {name}")
+    if not found:
+        console.print("[red]No valid cities to compare.[/red]")
+        return
+    table = Table(title="[bold magenta]Global Time Compare[/bold magenta]", show_lines=True, box=ROUNDED, expand=False)
+    table.add_column("Flag", style="bold", justify="center")
+    table.add_column("City", style="bold cyan")
+    table.add_column("Local Time", style="green")
+    table.add_column("Phase", style="magenta")
+    table.add_column("UTC Offset", style="yellow")
+    for city, country, tz, emoji in found:
+        now = datetime.datetime.now(ZoneInfo(tz))
+        hour = now.hour
+        emoji_time = get_time_emoji(hour)
+        phase = get_greeting(hour)
+        offset = now.utcoffset()
+        if offset is not None:
+            total_minutes = offset.total_seconds() / 60
+            hours = int(total_minutes // 60)
+            minutes = int(abs(total_minutes) % 60)
+            sign = '+' if hours >= 0 else '-'
+            offset_str = f'UTC{sign}{abs(hours)}' + (f':{minutes:02}' if minutes else '')
+        else:
+            offset_str = 'UTC?'
+        clock_emoji = chr(0x1F550 + ((hour-1)%12)) if 1 <= hour <= 12 else '🕰️'
+        table.add_row(
+            emoji, f"{city}, {country}", f"{now.strftime('%a, %b %d %I:%M %p')} {clock_emoji}", f"{emoji_time} {phase}", offset_str
+        )
+    console.print(table)
+
+def watch_mode(func, *args, **kwargs):
+    try:
+        while True:
+            os.system('clear')
+            func(*args, **kwargs)
+
+            # Countdown timer for next refresh
+            for seconds_left in range(60, 0, -1):
+                console.print(f"[dim]Press Ctrl+C to exit watch mode. Next refresh in {seconds_left} seconds...[/dim]", end="\r")
+                time.sleep(1)
+
+    except KeyboardInterrupt:
+        console.print("\n[green]Exited watch mode.[/green]")
+
+def parse_meeting_time(args: List[str]) -> Optional[datetime.datetime]:
+    if "at" in args:
+        idx = args.index("at")
+    elif "on" in args:
+        idx = args.index("on")
+    else:
+        return None
+    time_str = " ".join(args[idx+1:])
+    try:
+        today = datetime.datetime.now()
+        dt = datetime.datetime.strptime(time_str, "%I:%M %p")
+        meeting_time = today.replace(hour=dt.hour, minute=dt.minute, second=0, microsecond=0)
+        return meeting_time
+    except Exception:
+        return None
+
+def print_help():
+    help_text = """
+[bold cyan]gtime - Global Time Utility[/bold cyan]
+
+[bold yellow]Usage:[/bold yellow]
+  gtime [command] [arguments]
+  gtime <city name>
+
+[bold yellow]Commands:[/bold yellow]
+  [green]add <city>[/green]         Add a city to your favorites
+  [green]remove <city>[/green]      Remove a city from your favorites
+  [green]list[/green]               List your favorite cities and their current times
+  [green]list --watch[/green]       Watch mode: continuously refresh your favorites list every 60 seconds
+  [green]meeting at / on <time>[/green]  Show favorite cities' times for a meeting (e.g. 'meeting at 10:00 AM' or 'meeting on 10:00 AM')
+  [green]compare <city1> <city2> ...[/green]  Compare times for multiple cities
+  [green]compare <city1> <city2> ... --watch[/green]  Watch mode: continuously refresh city comparison
+  [green]watch[/green]              Same as 'list --watch' - watch your favorites in real-time
+  [green]<city name>[/green]        Show the current time for any city (fuzzy search supported)
+  [green]-h, --help[/green]         Show this help message
+
+[bold yellow]Watch Mode:[/bold yellow]
+  Use [green]--watch[/green] with list or compare commands, or use [green]watch[/green] alone to continuously 
+  refresh the display every 60 seconds with a live countdown timer. Press Ctrl+C to exit.
+"""
+    console.print(help_text)
+
+def main():
+    args = sys.argv[1:]
+    if args and args[0] in ('-h', '--help'):
+        print_help()
+        return
+    favs = load_favorites()
+    local_hour = datetime.datetime.now().hour
+    greeting = get_greeting(local_hour)
+    try:
+        user = os.getlogin()
+    except Exception:
+        user = "user"
+    console.print(f"[bold blue]{greeting}, {user}! Welcome to Global Time Utility 🌐[/bold blue]")
+
+    if not args:
+        print_favorites(favs)
+        return
+
+    cmd = args[0].lower()
+
+    # Watch mode for list and compare
+    if cmd == "watch" or (cmd == "list" and len(args) > 1 and args[1] == "--watch"):
+        watch_mode(print_favorites, favs)
+        return
+    if cmd == "compare" and (len(args) > 2 and args[-1] == "--watch"):
+        watch_mode(print_compare, [c for c in args[1:-1]])
+        return
+
+    if cmd == "add" and len(args) > 1:
+        city_info = get_city_by_name(" ".join(args[1:]))
+        if city_info:
+            city, *_ = city_info
+            if city not in favs:
+                favs.append(city)
+                save_favorites(favs)
+                console.print(f"[green]Added {city} to favorites![/green]")
+            else:
+                console.print(f"[yellow]{city} is already in favorites.[/yellow]")
+        else:
+            console.print("[red]City not found.[/red]")
+            suggestions = suggest_cities(" ".join(args[1:]))
+            if suggestions:
+                console.print(f"[yellow]Did you mean:[/yellow] {', '.join(suggestions)}")
+        return
+
+    if cmd == "remove" and len(args) > 1:
+        city = " ".join(args[1:])
+        if city in favs:
+            favs.remove(city)
+            save_favorites(favs)
+            console.print(f"[green]Removed {city} from favorites.[/green]")
+        else:
+            console.print(f"[yellow]{city} is not in favorites.[/yellow]")
+        return
+
+    if cmd == "list":
+        print_favorites(favs)
+        return
+
+    if cmd == "meeting":
+        if len(args) == 1:
+            print_favorites(favs)
+            return
+        meeting_time = parse_meeting_time(args)
+        if meeting_time is None:
+            console.print("[red]Invalid meeting command. Use: 'meeting at/on <time>' (e.g. 'meeting at 10:00 AM' or 'meeting on 10:00 AM').[/red]")
+            console.print("[yellow]See 'gtime -h' for help.[/yellow]")
+            return
+        print_favorites(favs, meeting_time)
+        return
+
+    if cmd == "compare" and len(args) > 1:
+        not_found = []
+        found = []
+        for name in args[1:]:
+            if name == "--watch":
+                continue
+            city_info = get_city_by_name(name)
+            if city_info:
+                found.append(city_info)
+            else:
+                not_found.append(name)
+        if not_found:
+            for nf in not_found:
+                console.print(f"[red]City not found:[/red] {nf}")
+                suggestions = suggest_cities(nf)
+                if suggestions:
+                    console.print(f"[yellow]Did you mean:[/yellow] {', '.join(suggestions)}")
+        if found:
+            print_compare([c[0] for c in found])
+        else:
+            console.print("[red]No valid cities to compare.[/red]")
+        return
+
+    # If command is not recognized, try city lookup, else error
+    city_info = get_city_by_name(" ".join(args))
+    if city_info:
+        print_city_time(*city_info)
+    else:
+        console.print("[red]Invalid command or city not found. See 'gtime -h' for help.[/red]")
+        suggestions = suggest_cities(" ".join(args))
+        if suggestions:
+            console.print(f"[yellow]Did you mean:[/yellow] {', '.join(suggestions)}")
+
+if __name__ == "__main__":
+    main()

gtime-0.3.0/gtime/core.py

@@ -0,0 +1,224 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""
+Core logic for Global Time Utility (gtime) lookup, fuzzy search, helpers
+"""
+
+import datetime
+import json
+from pathlib import Path
+from typing import List, Tuple, Optional
+import random
+from functools import lru_cache
+
+try:
+    from zoneinfo import ZoneInfo
+except ImportError:
+    from pytz import timezone as ZoneInfo
+
+from .data import CITY_DB
+
+FAV_FILE = Path.home() / ".gtime_favorites.json"
+
+def load_favorites() -> List[str]:
+    if FAV_FILE.exists():
+        try:
+            with open(FAV_FILE, "r") as f:
+                return json.load(f)
+        except Exception:
+            return []
+    return []
+
+def save_favorites(favs: List[str]) -> None:
+    with open(FAV_FILE, "w") as f:
+        json.dump(favs, f)
+
+_city_names_cache = None
+_city_name_to_index = None
+
+def _get_city_names():
+    global _city_names_cache, _city_name_to_index
+    if _city_names_cache is None or len(_city_names_cache) != len(CITY_DB):
+        _city_names_cache = [f"{city} ({country})" for city, country, _, _ in CITY_DB]
+        _city_name_to_index = {name: idx for idx, name in enumerate(_city_names_cache)}
+    return _city_names_cache, _city_name_to_index
+
+@lru_cache(maxsize=256)
+def fuzzy_search_city(query: str) -> Optional[Tuple[str, str, str, str]]:
+    from thefuzz import process
+    names, name_to_idx = _get_city_names()
+    match, score = process.extractOne(query, names)
+    if score > 60:
+        idx = name_to_idx[match]
+        return CITY_DB[idx]
+    return None
+
+@lru_cache(maxsize=256)
+def get_city_by_name(city_name: str) -> Optional[Tuple[str, str, str, str]]:
+    for city, country, tz, emoji in CITY_DB:
+        if city.lower() == city_name.lower():
+            return (city, country, tz, emoji)
+    from thefuzz import process
+    names, name_to_idx = _get_city_names()
+    matches = process.extract(city_name, names, limit=3)
+    if matches and matches[0][1] > 60:
+        idx = name_to_idx[matches[0][0]]
+        return CITY_DB[idx]
+    return None
+
+def suggest_cities(city_name: str) -> List[str]:
+    from thefuzz import process
+    names, _ = _get_city_names()
+    matches = process.extract(city_name, names, limit=3)
+    suggestions = [m[0] for m in matches if m[1] > 40]
+    return suggestions
+
+def get_time_emoji(hour: int) -> str:
+    if 5 <= hour < 12:
+        return "🌅"
+    elif 12 <= hour < 17:
+        return "☀️"
+    elif 17 <= hour < 21:
+        return "🌆"
+    else:
+        return "🌙"
+
+def get_greeting(hour: int) -> str:
+    if 5 <= hour < 12:
+        return "Good morning"
+    elif 12 <= hour < 17:
+        return "Good afternoon"
+    elif 17 <= hour < 21:
+        return "Good evening"
+    else:
+        return "Good night"
+
+def get_funny_footer(city: str, hour: int) -> str:
+    night_jokes = [
+        f"It's late in {city}. Don't let the bed bugs bite! 🛌",
+        f"{city} is sleeping. Or are you a night owl? 🦉",
+        f"Shhh... {city} is dreaming. 😴",
+        f"The stars are shining bright over {city}! ✨",
+        f"Midnight snack time in {city}? 🍕",
+        f"The city that never sleeps? Not {city} right now! 💤",
+        f"Late night thoughts from {city}... 💭",
+        f"Even {city} needs beauty sleep! 💄",
+        f"Night shift workers in {city} are keeping busy! 🌃",
+        f"Sweet dreams from {city}! 🌙",
+        f"Time for some beauty sleep in {city}! 💤",
+        f"The moon is watching over {city} tonight! 🌛",
+        f"Counting sheep in {city}... 1, 2, 3... 🐑",
+        f"Pizza delivery is probably still open in {city}! 🍕",
+        f"Time to binge-watch something in {city}! 📺",
+        f"Late night coding session in {city}? 💻",
+        f"The night is young in {city}! 🌃",
+        f"Peaceful slumber awaits in {city}! 😴",
+        f"Night photography weather in {city}! 📸",
+        f"The city is tucked in for the night in {city}! 🛏️",
+        f"Insomniacs unite in {city}! 😵",
+        f"Time for a bedtime story in {city}! 📚",
+        f"The witching hour in {city}! 🧙‍♀️",
+        f"Dreaming of better days in {city}! 💭",
+        f"Silent streets in {city} tell stories! 🏙️",
+    ]
+    morning_jokes = [
+        f"Rise and shine, {city}! ☀️",
+        f"Coffee time in {city}? ☕",
+        f"Start your engines, {city}! 🚗",
+        f"The early bird catches the worm in {city}! 🐦",
+        f"Fresh morning air in {city}! 🌬️",
+        f"Time to seize the day in {city}! 💪",
+        f"Morning jog weather in {city}? 🏃",
+        f"Breakfast is the most important meal in {city}! 🥞",
+        f"The sun is greeting {city} with a smile! 😊",
+        f"New day, new possibilities in {city}! 🌈",
+        f"Rush hour is starting in {city}! 🚌",
+        f"Morning news is on in {city}! 📺",
+        f"Good morning sunshine from {city}! 🌞",
+        f"Fresh croissants and coffee in {city}? 🥐",
+        f"Morning yoga session in {city}? 🧘‍♀️",
+        f"Alarm clocks are ringing in {city}! ⏰",
+        f"Another beautiful morning in {city}! 🌸",
+        f"Time to make your bed in {city}! 🛏️",
+        f"Fresh start vibes in {city}! ✨",
+        f"Morning commute begins in {city}! 🚇",
+        f"Time to water the plants in {city}! 🪴",
+        f"Birds are chirping in {city}! 🐦",
+        f"Morning motivation mode in {city}! 💪",
+        f"The world is your oyster in {city}! 🦪",
+        f"Sunrise spectacular in {city}! 🌅",
+        f"Fresh as a daisy in {city}! 🌼",
+        f"Morning mindfulness in {city}! 🧠",
+        f"Early bird specials in {city}! 🍳",
+    ]
+    afternoon_jokes = [
+        f"Keep hustling, {city}! 💪",
+        f"Perfect time for a siesta in {city}. 😴",
+        f"Hope your day is going well in {city}! 🌞",
+        f"Lunch break time in {city}? 🍽️",
+        f"The sun is at its peak in {city}! ☀️",
+        f"Productivity mode activated in {city}! 📈",
+        f"Ice cream weather in {city}? 🍦",
+        f"Working hard or hardly working in {city}? 💼",
+        f"The afternoon hustle in {city} is real! 🏃‍♀️",
+        f"Time flies when you're having fun in {city}! ⏰",
+        f"Midday energy boost needed in {city}? ⚡",
+        f"The perfect time for outdoor activities in {city}! 🌳",
+        f"Sunshine and productivity in {city}! 🌻",
+        f"Time to stretch those legs in {city}! 🤸‍♂️",
+        f"Afternoon meeting marathon in {city}! 📊",
+        f"Time for a quick power walk in {city}! 🚶‍♀️",
+        f"Perfect weather for outdoor dining in {city}! 🍴",
+        f"Getting things done in {city}! ✅",
+        f"Halfway through the workday in {city}! 📈",
+        f"Afternoon delight in {city}! 🎵",
+        f"Keep calm and carry on in {city}! 🧘",
+        f"The grind never stops in {city}! ⚙️",
+        f"Peak performance hours in {city}! 🏆",
+        f"Time for a coffee break in {city}! ☕",
+        f"Afternoon adventures await in {city}! 🗺️",
+        f"Sunshine therapy in {city}! ☀️",
+        f"Power through the afternoon in {city}! 💪",
+        f"The day is in full swing in {city}! 🎯",
+    ]
+    evening_jokes = [
+        f"Time to relax in {city}. 🍷",
+        f"Sunset vibes in {city}. 🌇",
+        f"Netflix and chill in {city}? 🍿",
+        f"Happy hour somewhere in {city}! 🍻",
+        f"Dinner plans in {city}? 🍽️",
+        f"The golden hour in {city} looks magical! ✨",
+        f"Time to unwind in {city}! 🧘",
+        f"Evening stroll weather in {city}? 🚶",
+        f"The city lights are starting to twinkle in {city}! 💡",
+        f"Date night in {city}? 💕",
+        f"Rush hour traffic clearing up in {city}! 🚗",
+        f"The workday is winding down in {city}! 📝",
+        f"Time for some evening entertainment in {city}! 🎭",
+        f"Time to cook dinner in {city}! 👨‍🍳",
+        f"Golden hour photography in {city}! 📷",
+        f"Winding down in {city}... 🛋️",
+        f"Time for some evening exercise in {city}! 🏋️‍♀️",
+        f"The day is coming to an end in {city}! 🌆",
+        f"Perfect time for a walk in {city}! 🚶",
+        f"Time to catch up with friends in {city}! 👥",
+        f"Evening breeze in {city} feels nice! 🌬️",
+        f"Cozy evening vibes in {city}! 🕯️",
+        f"Time to unwind with a good book in {city}! 📚",
+        f"Twilight magic in {city}! ✨",
+        f"Time to reflect on the day in {city}! 💭",
+        f"Perfect time for a romantic dinner in {city}! 🥂",
+        f"Evening meditation time in {city}! 🧘‍♂️",
+        f"Time to call it a day in {city}! 📞",
+        f"The evening glow in {city} is stunning! 🌅",
+        f"Time for some self-care in {city}! 💆‍♀️",
+    ]
+    if 5 <= hour < 12:
+        return morning_jokes[hour % len(morning_jokes)]
+    elif 12 <= hour < 17:
+        return afternoon_jokes[hour % len(afternoon_jokes)]
+    elif 17 <= hour < 21:
+        return evening_jokes[hour % len(evening_jokes)]
+    else:
+        return night_jokes[hour % len(night_jokes)]

gtime-0.3.0/gtime/data.py

@@ -0,0 +1,327 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""
+City database for Global Time Utility (gtime)
+"""
+
+CITY_DB = [
+    # North America
+    ("New York", "USA", "America/New_York", "🗽"),
+    ("Los Angeles", "USA", "America/Los_Angeles", "🌴"),
+    ("Chicago", "USA", "America/Chicago", "🌃"),
+    ("San Francisco", "USA", "America/Los_Angeles", "🌉"),
+    ("Seattle", "USA", "America/Los_Angeles", "🌲"),
+    ("Boston", "USA", "America/New_York", "🎓"),
+    ("Washington D.C.", "USA", "America/New_York", "🏛️"),
+    ("Miami", "USA", "America/New_York", "🌴"),
+    ("Salt Lake City", "USA", "America/Denver", "🏔️"),
+    ("Austin", "USA", "America/Chicago", "🎸"),
+    ("Dallas", "USA", "America/Chicago", "🤠"),
+    ("Phoenix", "USA", "America/Phoenix", "🌵"),
+    ("Denver", "USA", "America/Denver", "⛰️"),
+    ("Las Vegas", "USA", "America/Los_Angeles", "🎰"),
+    ("Toronto", "Canada", "America/Toronto", "🦫"),
+    ("Vancouver", "Canada", "America/Vancouver", "🌲"),
+    ("Montreal", "Canada", "America/Toronto", "🥯"),
+    ("Calgary", "Canada", "America/Edmonton", "🐎"),
+    ("Ottawa", "Canada", "America/Toronto", "🍁"),
+    ("Mexico City", "Mexico", "America/Mexico_City", "🌮"),
+    ("Guadalajara", "Mexico", "America/Mexico_City", "🎶"),
+    ("Monterrey", "Mexico", "America/Monterrey", "🏞️"),
+    ("Cancun", "Mexico", "America/Cancun", "🏖️"),
+    # South America
+    ("São Paulo", "Brazil", "America/Sao_Paulo", "🌆"),
+    ("Rio de Janeiro", "Brazil", "America/Sao_Paulo", "🗺️"),
+    ("Brasília", "Brazil", "America/Sao_Paulo", "🏛️"),
+    ("Buenos Aires", "Argentina", "America/Argentina/Buenos_Aires", "💃"),
+    ("Bogotá", "Colombia", "America/Bogota", "⛰️"),
+    ("Lima", "Peru", "America/Lima", "🦙"),
+    ("Santiago", "Chile", "America/Santiago", "⛰️"),
+    ("Montevideo", "Uruguay", "America/Montevideo", "🏖️"),
+    ("Caracas", "Venezuela", "America/Caracas", "🦜"),
+    ("Quito", "Ecuador", "America/Guayaquil", "🌋"),
+    ("Asunción", "Paraguay", "America/Asuncion", "🌳"),
+    ("La Paz", "Bolivia", "America/La_Paz", "🏔️"),
+    # Europe
+    ("London", "UK", "Europe/London", "🎡"),
+    ("Manchester", "UK", "Europe/London", "⚽"),
+    ("Edinburgh", "UK", "Europe/London", "🏰"),
+    ("Belfast", "UK", "Europe/London", "🧃"),
+    ("Berlin", "Germany", "Europe/Berlin", "🕍"),
+    ("Munich", "Germany", "Europe/Berlin", "🍺"),
+    ("Frankfurt", "Germany", "Europe/Berlin", "🏦"),
+    ("Hamburg", "Germany", "Europe/Berlin", "⚓"),
+    ("Paris", "France", "Europe/Paris", "🗼"),
+    ("Lyon", "France", "Europe/Paris", "🍷"),
+    ("Marseille", "France", "Europe/Paris", "⚓"),
+    ("Amsterdam", "Netherlands", "Europe/Amsterdam", "🚲"),
+    ("Rotterdam", "Netherlands", "Europe/Amsterdam", "🚢"),
+    ("Zurich", "Switzerland", "Europe/Zurich", "🏦"),
+    ("Geneva", "Switzerland", "Europe/Zurich", "🕊️"),
+    ("Stockholm", "Sweden", "Europe/Stockholm", "🚤"),
+    ("Gothenburg", "Sweden", "Europe/Stockholm", "⚓"),
+    ("Helsinki", "Finland", "Europe/Helsinki", "🦌"),
+    ("Dublin", "Ireland", "Europe/Dublin", "🍀"),
+    ("Rome", "Italy", "Europe/Rome", "🏛️"),
+    ("Milan", "Italy", "Europe/Rome", "👗"),
+    ("Madrid", "Spain", "Europe/Madrid", "💃"),
+    ("Barcelona", "Spain", "Europe/Madrid", "🏖️"),
+    ("Lisbon", "Portugal", "Europe/Lisbon", "🌉"),
+    ("Porto", "Portugal", "Europe/Lisbon", "🍷"),
+    ("Vienna", "Austria", "Europe/Vienna", "🎶"),
+    ("Warsaw", "Poland", "Europe/Warsaw", "🎩"),
+    ("Krakow", "Poland", "Europe/Warsaw", "🐉"),
+    ("Prague", "Czech Republic", "Europe/Prague", "🏰"),
+    ("Brno", "Czech Republic", "Europe/Prague", "🎓"),
+    ("Budapest", "Hungary", "Europe/Budapest", "🌉"),
+    ("Bucharest", "Romania", "Europe/Bucharest", "🏛️"),
+    ("Moscow", "Russia", "Europe/Moscow", "🎠"),
+    ("Saint Petersburg", "Russia", "Europe/Moscow", "🎨"),
+    ("Oslo", "Norway", "Europe/Oslo", "🛳️"),
+    ("Copenhagen", "Denmark", "Europe/Copenhagen", "🦢"),
+    ("Reykjavik", "Iceland", "Atlantic/Reykjavik", "🧊"),
+    ("Brussels", "Belgium", "Europe/Brussels", "🍫"),
+    ("Luxembourg", "Luxembourg", "Europe/Luxembourg", "🏰"),
+    ("Athens", "Greece", "Europe/Athens", "🏛️"),
+    ("Sofia", "Bulgaria", "Europe/Sofia", "🦁"),
+    ("Zagreb", "Croatia", "Europe/Zagreb", "🏟️"),
+    ("Belgrade", "Serbia", "Europe/Belgrade", "🏰"),
+    ("Kyiv", "Ukraine", "Europe/Kiev", "🌻"),
+    ("Tallinn", "Estonia", "Europe/Tallinn", "🦅"),
+    ("Riga", "Latvia", "Europe/Riga", "🌲"),
+    ("Vilnius", "Lithuania", "Europe/Vilnius", "🏰"),
+    ("Minsk", "Belarus", "Europe/Minsk", "🌲"),
+    ("Chișinău", "Moldova", "Europe/Chisinau", "🍇"),
+    # Asia
+    ("Tokyo", "Japan", "Asia/Tokyo", "🗼"),
+    ("Osaka", "Japan", "Asia/Tokyo", "🍜"),
+    ("Kyoto", "Japan", "Asia/Tokyo", "⛩️"),
+    ("Beijing", "China", "Asia/Shanghai", "🐉"),
+    ("Shanghai", "China", "Asia/Shanghai", "🌁"),
+    ("Guangzhou", "China", "Asia/Shanghai", "🌆"),
+    ("Shenzhen", "China", "Asia/Shanghai", "🏙️"),
+    ("Hong Kong", "China", "Asia/Hong_Kong", "🌃"),
+    ("Seoul", "South Korea", "Asia/Seoul", "🦀"),
+    ("Busan", "South Korea", "Asia/Seoul", "🏖️"),
+    ("Mumbai", "India", "Asia/Kolkata", "🌇"),
+    ("Delhi", "India", "Asia/Kolkata", "🕌"),
+    ("Bangalore", "India", "Asia/Kolkata", "🌳"),
+    ("Hyderabad", "India", "Asia/Kolkata", "🍛"),
+    ("Chennai", "India", "Asia/Kolkata", "🌊"),
+    ("Pune", "India", "Asia/Kolkata", "🏞️"),
+    ("Kolkata", "India", "Asia/Kolkata", "🌉"),
+    ("Singapore", "Singapore", "Asia/Singapore", "🦁"),
+    ("Kuala Lumpur", "Malaysia", "Asia/Kuala_Lumpur", "🌇"),
+    ("Bangkok", "Thailand", "Asia/Bangkok", "🛺"),
+    ("Manila", "Philippines", "Asia/Manila", "🏙️"),
+    ("Jakarta", "Indonesia", "Asia/Jakarta", "🌋"),
+    ("Ho Chi Minh City", "Vietnam", "Asia/Ho_Chi_Minh", "🏍️"),
+    ("Hanoi", "Vietnam", "Asia/Ho_Chi_Minh", "🌸"),
+    ("Phnom Penh", "Cambodia", "Asia/Phnom_Penh", "🛕"),
+    ("Vientiane", "Laos", "Asia/Vientiane", "🛕"),
+    ("Yangon", "Myanmar", "Asia/Yangon", "🛕"),
+    ("Colombo", "Sri Lanka", "Asia/Colombo", "🐘"),
+    ("Dhaka", "Bangladesh", "Asia/Dhaka", "🌾"),
+    ("Karachi", "Pakistan", "Asia/Karachi", "🌴"),
+    ("Lahore", "Pakistan", "Asia/Karachi", "🏰"),
+    ("Islamabad", "Pakistan", "Asia/Karachi", "🕌"),
+    ("Kabul", "Afghanistan", "Asia/Kabul", "🕌"),
+    ("Tehran", "Iran", "Asia/Tehran", "🕌"),
+    ("Baghdad", "Iraq", "Asia/Baghdad", "🏛️"),
+    ("Damascus", "Syria", "Asia/Damascus", "🏛️"),
+    ("Amman", "Jordan", "Asia/Amman", "🏜️"),
+    ("Tel Aviv", "Israel", "Asia/Jerusalem", "🏖️"),
+    ("Jerusalem", "Israel", "Asia/Jerusalem", "🕍"),
+    ("Beirut", "Lebanon", "Asia/Beirut", "🌊"),
+    ("Dubai", "UAE", "Asia/Dubai", "🏙️"),
+    ("Abu Dhabi", "UAE", "Asia/Dubai", "🏝️"),
+    ("Riyadh", "Saudi Arabia", "Asia/Riyadh", "🏜️"),
+    ("Jeddah", "Saudi Arabia", "Asia/Riyadh", "🌊"),
+    ("Kuwait City", "Kuwait", "Asia/Kuwait", "🏜️"),
+    ("Doha", "Qatar", "Asia/Qatar", "🏙️"),
+    ("Manama", "Bahrain", "Asia/Bahrain", "🏝️"),
+    ("Muscat", "Oman", "Asia/Muscat", "🏜️"),
+    ("Sana'a", "Yemen", "Asia/Aden", "🏜️"),
+    ("Tashkent", "Uzbekistan", "Asia/Tashkent", "🌳"),
+    ("Almaty", "Kazakhstan", "Asia/Almaty", "🏔️"),
+    ("Bishkek", "Kyrgyzstan", "Asia/Bishkek", "🏔️"),
+    ("Dushanbe", "Tajikistan", "Asia/Dushanbe", "🏔️"),
+    ("Ashgabat", "Turkmenistan", "Asia/Ashgabat", "🏜️"),
+    ("Baku", "Azerbaijan", "Asia/Baku", "🌊"),
+    ("Yerevan", "Armenia", "Asia/Yerevan", "⛰️"),
+    ("Tbilisi", "Georgia", "Asia/Tbilisi", "🏞️"),
+    ("Kathmandu", "Nepal", "Asia/Kathmandu", "🏔️"),
+    ("Thimphu", "Bhutan", "Asia/Thimphu", "⛰️"),
+    ("Ulaanbaatar", "Mongolia", "Asia/Ulaanbaatar", "🐎"),
+    ("Pyongyang", "North Korea", "Asia/Pyongyang", "🏛️"),
+    ("Taipei", "Taiwan", "Asia/Taipei", "🦋"),
+    ("Macau", "China", "Asia/Macau", "🎰"),
+    # Africa
+    ("Johannesburg", "South Africa", "Africa/Johannesburg", "🦁"),
+    ("Cape Town", "South Africa", "Africa/Johannesburg", "⛰️"),
+    ("Cairo", "Egypt", "Africa/Cairo", "🕌"),
+    ("Lagos", "Nigeria", "Africa/Lagos", "🎶"),
+    ("Abuja", "Nigeria", "Africa/Lagos", "🏛️"),
+    ("Nairobi", "Kenya", "Africa/Nairobi", "🦒"),
+    ("Addis Ababa", "Ethiopia", "Africa/Addis_Ababa", "☕"),
+    ("Casablanca", "Morocco", "Africa/Casablanca", "🌊"),
+    ("Rabat", "Morocco", "Africa/Casablanca", "🏰"),
+    ("Algiers", "Algeria", "Africa/Algiers", "🏛️"),
+    ("Tunis", "Tunisia", "Africa/Tunis", "🏖️"),
+    ("Tripoli", "Libya", "Africa/Tripoli", "🏜️"),
+    ("Khartoum", "Sudan", "Africa/Khartoum", "🌊"),
+    ("Accra", "Ghana", "Africa/Accra", "🎶"),
+    ("Dakar", "Senegal", "Africa/Dakar", "🦁"),
+    ("Abidjan", "Côte d'Ivoire", "Africa/Abidjan", "🌴"),
+    ("Douala", "Cameroon", "Africa/Douala", "🌴"),
+    ("Luanda", "Angola", "Africa/Luanda", "🦁"),
+    ("Harare", "Zimbabwe", "Africa/Harare", "🦓"),
+    ("Lusaka", "Zambia", "Africa/Lusaka", "🦏"),
+    ("Kampala", "Uganda", "Africa/Kampala", "🦍"),
+    ("Dar es Salaam", "Tanzania", "Africa/Dar_es_Salaam", "🏖️"),
+    ("Maputo", "Mozambique", "Africa/Maputo", "🦐"),
+    ("Gaborone", "Botswana", "Africa/Gaborone", "🦁"),
+    ("Windhoek", "Namibia", "Africa/Windhoek", "🦒"),
+    ("Antananarivo", "Madagascar", "Indian/Antananarivo", "🦎"),
+    ("Port Louis", "Mauritius", "Indian/Mauritius", "🏝️"),
+    # Oceania
+    ("Sydney", "Australia", "Australia/Sydney", "🦘"),
+    ("Melbourne", "Australia", "Australia/Melbourne", "🎡"),
+    ("Brisbane", "Australia", "Australia/Brisbane", "🌴"),
+    ("Perth", "Australia", "Australia/Perth", "🌅"),
+    ("Adelaide", "Australia", "Australia/Adelaide", "🍷"),
+    ("Canberra", "Australia", "Australia/Canberra", "🏛️"),
+    ("Darwin", "Australia", "Australia/Darwin", "🐊"),
+    ("Auckland", "New Zealand", "Pacific/Auckland", "🦤"),
+    ("Wellington", "New Zealand", "Pacific/Auckland", "🌬️"),
+    ("Christchurch", "New Zealand", "Pacific/Auckland", "🌸"),
+    ("Suva", "Fiji", "Pacific/Fiji", "🌺"),
+    ("Port Moresby", "Papua New Guinea", "Pacific/Port_Moresby", "🦜"),
+    ("Nouméa", "New Caledonia", "Pacific/Noumea", "🐚"),
+    ("Port Vila", "Vanuatu", "Pacific/Efate", "🌴"),
+    ("Honiara", "Solomon Islands", "Pacific/Guadalcanal", "🐟"),
+    ("Apia", "Samoa", "Pacific/Apia", "🏝️"),
+    ("Nuku'alofa", "Tonga", "Pacific/Tongatapu", "🌴"),
+    ("Ngerulmud", "Palau", "Pacific/Palau", "🐠"),
+    ("Majuro", "Marshall Islands", "Pacific/Majuro", "🏝️"),
+    ("Palikir", "Micronesia", "Pacific/Pohnpei", "🐟"),
+    ("Yaren", "Nauru", "Pacific/Nauru", "🏝️"),
+    ("Funafuti", "Tuvalu", "Pacific/Funafuti", "🏝️"),
+    ("Tarawa", "Kiribati", "Pacific/Tarawa", "🐢"),
+    ("Avarua", "Cook Islands", "Pacific/Rarotonga", "🌺"),
+    ("Papeete", "French Polynesia", "Pacific/Tahiti", "🌺"),
+    ("Hagåtña", "Guam", "Pacific/Guam", "🌴"),
+    # Additional Major Cities and Missing Countries
+    # More US Cities
+    ("Atlanta", "USA", "America/New_York", "🍑"),
+    ("Portland", "USA", "America/Los_Angeles", "🌲"),
+    ("Minneapolis", "USA", "America/Chicago", "❄️"),
+    ("Nashville", "USA", "America/Chicago", "🎵"),
+    ("San Diego", "USA", "America/Los_Angeles", "🏄"),
+    ("Philadelphia", "USA", "America/New_York", "🔔"),
+    ("Houston", "USA", "America/Chicago", "🚀"),
+    ("Detroit", "USA", "America/New_York", "🚗"),
+    ("Tampa", "USA", "America/New_York", "🌴"),
+    ("New Orleans", "USA", "America/Chicago", "🎺"),
+    # Caribbean
+    ("Havana", "Cuba", "America/Havana", "🏝️"),
+    ("Kingston", "Jamaica", "America/Jamaica", "🎶"),
+    ("Port of Spain", "Trinidad and Tobago", "America/Port_of_Spain", "🌺"),
+    ("Bridgetown", "Barbados", "America/Barbados", "🏖️"),
+    ("Santo Domingo", "Dominican Republic", "America/Santo_Domingo", "🌴"),
+    ("San Juan", "Puerto Rico", "America/Puerto_Rico", "🏰"),
+    ("Nassau", "Bahamas", "America/Nassau", "🏝️"),
+    ("Georgetown", "Guyana", "America/Guyana", "🌊"),
+    ("Paramaribo", "Suriname", "America/Paramaribo", "🌴"),
+    ("Cayenne", "French Guiana", "America/Cayenne", "🐸"),
+    # More European Cities
+    ("Nice", "France", "Europe/Paris", "🌊"),
+    ("Toulouse", "France", "Europe/Paris", "✈️"),
+    ("Naples", "Italy", "Europe/Rome", "🍕"),
+    ("Florence", "Italy", "Europe/Rome", "🎨"),
+    ("Venice", "Italy", "Europe/Rome", "🚤"),
+    ("Seville", "Spain", "Europe/Madrid", "💃"),
+    ("Valencia", "Spain", "Europe/Madrid", "🍊"),
+    ("Cologne", "Germany", "Europe/Berlin", "⛪"),
+    ("Dresden", "Germany", "Europe/Berlin", "🏰"),
+    ("Salzburg", "Austria", "Europe/Vienna", "🎼"),
+    ("Basel", "Switzerland", "Europe/Zurich", "🏦"),
+    ("Malmö", "Sweden", "Europe/Stockholm", "🌉"),
+    ("Bergen", "Norway", "Europe/Oslo", "🐟"),
+    ("Aarhus", "Denmark", "Europe/Copenhagen", "🏛️"),
+    ("Thessaloniki", "Greece", "Europe/Athens", "🏺"),
+    ("Porto", "Portugal", "Europe/Lisbon", "🍷"),
+    ("Krakow", "Poland", "Europe/Warsaw", "🐲"),
+    ("Split", "Croatia", "Europe/Zagreb", "⛵"),
+    ("Ljubljana", "Slovenia", "Europe/Ljubljana", "🏰"),
+    ("Bratislava", "Slovakia", "Europe/Bratislava", "🏰"),
+    # Missing Asian Countries
+    ("Vientiane", "Laos", "Asia/Vientiane", "🛕"),
+    ("Bandar Seri Begawan", "Brunei", "Asia/Brunei", "🕌"),
+    ("Dili", "East Timor", "Asia/Dili", "🌴"),
+    ("Male", "Maldives", "Indian/Maldives", "🏝️"),
+    # Central Asia
+    ("Nur-Sultan", "Kazakhstan", "Asia/Almaty", "🏙️"),
+    ("Astana", "Kazakhstan", "Asia/Almaty", "🌟"),
+    # More Middle East
+    ("Isfahan", "Iran", "Asia/Tehran", "🕌"),
+    ("Shiraz", "Iran", "Asia/Tehran", "🌹"),
+    ("Aleppo", "Syria", "Asia/Damascus", "🏛️"),
+    ("Basra", "Iraq", "Asia/Baghdad", "🌊"),
+    ("Erbil", "Iraq", "Asia/Baghdad", "🏛️"),
+    # More African Cities
+    ("Marrakech", "Morocco", "Africa/Casablanca", "🕌"),
+    ("Fez", "Morocco", "Africa/Casablanca", "🎨"),
+    ("Alexandria", "Egypt", "Africa/Cairo", "🏺"),
+    ("Luxor", "Egypt", "Africa/Cairo", "🏛️"),
+    ("Kano", "Nigeria", "Africa/Lagos", "🎭"),
+    ("Ibadan", "Nigeria", "Africa/Lagos", "🌆"),
+    ("Durban", "South Africa", "Africa/Johannesburg", "🏄"),
+    ("Pretoria", "South Africa", "Africa/Johannesburg", "🏛️"),
+    ("Port Elizabeth", "South Africa", "Africa/Johannesburg", "🌊"),
+    ("Mombasa", "Kenya", "Africa/Nairobi", "🏖️"),
+    ("Kisumu", "Kenya", "Africa/Nairobi", "🐟"),
+    ("Arusha", "Tanzania", "Africa/Dar_es_Salaam", "🦁"),
+    ("Zanzibar", "Tanzania", "Africa/Dar_es_Salaam", "🏝️"),
+    ("Entebbe", "Uganda", "Africa/Kampala", "✈️"),
+    ("Kigali", "Rwanda", "Africa/Kigali", "🦍"),
+    ("Bujumbura", "Burundi", "Africa/Bujumbura", "🌋"),
+    ("Djibouti", "Djibouti", "Africa/Djibouti", "🌊"),
+    ("Asmara", "Eritrea", "Africa/Asmara", "⛰️"),
+    ("Mogadishu", "Somalia", "Africa/Mogadishu", "🏖️"),
+    ("N'Djamena", "Chad", "Africa/Ndjamena", "🌵"),
+    ("Bangui", "Central African Republic", "Africa/Bangui", "🌳"),
+    ("Yaoundé", "Cameroon", "Africa/Douala", "🌳"),
+    ("Libreville", "Gabon", "Africa/Libreville", "🌳"),
+    ("Malabo", "Equatorial Guinea", "Africa/Malabo", "🏝️"),
+    ("São Tomé", "São Tomé and Príncipe", "Africa/Sao_Tome", "🌺"),
+    ("Kinshasa", "Democratic Republic of Congo", "Africa/Kinshasa", "🌊"),
+    ("Brazzaville", "Republic of Congo", "Africa/Brazzaville", "🌊"),
+    ("Bamako", "Mali", "Africa/Bamako", "🐪"),
+    ("Ouagadougou", "Burkina Faso", "Africa/Ouagadougou", "🌾"),
+    ("Niamey", "Niger", "Africa/Niamey", "🌵"),
+    ("Conakry", "Guinea", "Africa/Conakry", "🌊"),
+    ("Freetown", "Sierra Leone", "Africa/Freetown", "⛰️"),
+    ("Monrovia", "Liberia", "Africa/Monrovia", "🌊"),
+    ("Lomé", "Togo", "Africa/Lome", "🏖️"),
+    ("Porto-Novo", "Benin", "Africa/Porto-Novo", "🌴"),
+    ("Nouakchott", "Mauritania", "Africa/Nouakchott", "🐪"),
+    ("Bissau", "Guinea-Bissau", "Africa/Bissau", "🌊"),
+    ("Praia", "Cape Verde", "Atlantic/Cape_Verde", "🌊"),
+    ("Maseru", "Lesotho", "Africa/Maseru", "⛰️"),
+    ("Mbabane", "Eswatini", "Africa/Mbabane", "🏔️"),
+    ("Moroni", "Comoros", "Indian/Comoro", "🌺"),
+    ("Victoria", "Seychelles", "Indian/Mahe", "🏝️"),
+    # Pacific Islands and Oceania
+    ("Honolulu", "USA", "Pacific/Honolulu", "🌺"),
+    ("Anchorage", "USA", "America/Anchorage", "🐻"),
+    ("Fairbanks", "USA", "America/Anchorage", "❄️"),
+    ("Hobart", "Australia", "Australia/Hobart", "🌿"),
+    ("Gold Coast", "Australia", "Australia/Brisbane", "🏄"),
+    ("Newcastle", "Australia", "Australia/Sydney", "⚓"),
+    ("Wollongong", "Australia", "Australia/Sydney", "🌊"),
+    ("Dunedin", "New Zealand", "Pacific/Auckland", "🐧"),
+    ("Hamilton", "New Zealand", "Pacific/Auckland", "🐄"),
+    ("Tauranga", "New Zealand", "Pacific/Auckland", "🏖️"),
+]

gtime-0.3.0/gtime.egg-info/PKG-INFO

@@ -0,0 +1,81 @@
+Metadata-Version: 2.4
+Name: gtime
+Version: 0.3.0
+Summary: Global Time Utility (gtime) - A modern, colorful Python CLI utility for global time zone lookup, comparison, and management. It supports fuzzy search, favorites, city comparison, meeting time conversion, and a live/watch mode
+Author-email: Savitoj Singh <savv@duck.com>
+License: MIT
+Project-URL: Homepage, https://github.com/savitojs/gtime
+Project-URL: Repository, https://github.com/savitojs/gtime
+Project-URL: Bug Tracker, https://github.com/savitojs/gtime/issues
+Project-URL: Documentation, https://github.com/savitojs/gtime#readme
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rich
+Requires-Dist: python-dateutil
+Requires-Dist: thefuzz
+Requires-Dist: pytz; python_version < "3.9"
+Dynamic: license-file
+
+# gtime 🌐
+
+gtime (Global Time) is a modern, colorful Python CLI utility for global time zone lookup, comparison, and management. It supports fuzzy search, favorites, city comparison, meeting time conversion, and a live/watch mode
+
+## Features
+- Fast city lookup with fuzzy search and suggestions
+- Add/remove/list favorite cities
+- Compare times for multiple cities
+- Meeting time conversion across favorites
+- Live/watch mode for real-time updates
+- Colorful, user-friendly output (using Rich)
+- Comprehensive test suite (pytest)
+- Performance-optimized for large city databases
+
+## Installation (from source)
+Clone the repo and install locally:
+
+```sh
+pip install .
+```
+
+Or, install from PyPI:
+
+```sh
+pip install gtime
+```
+## Demo
+
+**Note:** Some command output may appear broken in the demo, but it works correctly in real use
+
+![demo](./assets/demo.gif)
+
+## Usage
+After installation, run the CLI:
+
+```sh
+gtime [command] [arguments]
+```
+
+Or as a module:
+
+```sh
+python -m gtime.cli [command] [arguments]
+```
+
+Example commands:
+- `gtime London` — Show time for London
+- `gtime add Tokyo` — Add Tokyo to favorites
+- `gtime list` — List favorite cities
+- `gtime compare London Tokyo` — Compare cities
+- `gtime meeting at 10:00 AM` — Meeting time conversion
+- `gtime watch` — Live mode
+
+## Development & Publishing
+
+### GitHub Actions
+This project includes automated workflows:
+- **Tests**: Runs on every push/PR across Python 3.8-3.12
+- **Publish**: Automatically publishes to PyPI upon new GitHub release
+
+## License
+MIT

gtime-0.3.0/gtime.egg-info/SOURCES.txt

@@ -0,0 +1,14 @@
+LICENSE
+README.md
+pyproject.toml
+gtime/__init__.py
+gtime/cli.py
+gtime/core.py
+gtime/data.py
+gtime.egg-info/PKG-INFO
+gtime.egg-info/SOURCES.txt
+gtime.egg-info/dependency_links.txt
+gtime.egg-info/entry_points.txt
+gtime.egg-info/requires.txt
+gtime.egg-info/top_level.txt
+tests/test_gtime.py

gtime-0.3.0/gtime.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

gtime-0.3.0/gtime.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+gtime = gtime.cli:main

gtime-0.3.0/gtime.egg-info/requires.txt

@@ -0,0 +1,6 @@
+rich
+python-dateutil
+thefuzz
+
+[:python_version < "3.9"]
+pytz

gtime-0.3.0/gtime.egg-info/top_level.txt

@@ -0,0 +1 @@
+gtime

gtime-0.3.0/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "gtime"
+version = "0.3.0"
+description = "Global Time Utility (gtime) - A modern, colorful Python CLI utility for global time zone lookup, comparison, and management. It supports fuzzy search, favorites, city comparison, meeting time conversion, and a live/watch mode"
+authors = [
+    { name = "Savitoj Singh", email = "savv@duck.com" }
+]
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.7"
+dependencies = [
+    "rich",
+    "python-dateutil",
+    "thefuzz",
+    "pytz; python_version < '3.9'"
+]
+
+[project.urls]
+Homepage = "https://github.com/savitojs/gtime"
+Repository = "https://github.com/savitojs/gtime"
+"Bug Tracker" = "https://github.com/savitojs/gtime/issues"
+Documentation = "https://github.com/savitojs/gtime#readme"
+
+[project.scripts]
+gtime = "gtime.cli:main"
+
+[tool.setuptools.packages.find]
+include = ["gtime*"]
+exclude = ["perf*", "assets*"]

gtime-0.3.0/setup.cfg

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

gtime-0.3.0/tests/test_gtime.py

@@ -0,0 +1,71 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+import subprocess
+import sys
+import os
+import json
+from pathlib import Path
+import pytest
+
+SCRIPT = "gtime" # Entry point for the CLI
+
+FAV_FILE = Path.home() / ".gtime_favorites.json"
+
+@pytest.fixture(autouse=True)
+def cleanup_favs():
+    # Remove favorites file before and after each test
+    if FAV_FILE.exists():
+        FAV_FILE.unlink()
+    yield
+    if FAV_FILE.exists():
+        FAV_FILE.unlink()
+
+def run_cli(*args):
+    env = os.environ.copy()
+    env["PYTHONIOENCODING"] = "utf-8"
+    env["PYTHONPATH"] = os.path.abspath(os.path.dirname(__file__))
+    # Always run in the workspace root so .gtime_favorites.json is consistent
+    result = subprocess.run([SCRIPT, *args], capture_output=True, text=True, cwd=os.path.dirname(__file__), env=env)
+    return result
+
+def test_help():
+    out = run_cli("-h")
+    assert "Global Time" in out.stdout
+    assert "Usage" in out.stdout
+
+def test_add_and_list_favorite():
+    run_cli("add", "London")
+    out = run_cli("list")
+    assert "London" in out.stdout
+    assert "UK" in out.stdout
+
+def test_remove_favorite():
+    run_cli("add", "London")
+    run_cli("remove", "London")
+    out = run_cli("list")
+    assert "London" not in out.stdout
+
+def test_city_lookup():
+    out = run_cli("Tokyo")
+    assert "Tokyo" in out.stdout
+    assert "Japan" in out.stdout
+
+def test_fuzzy_search():
+    out = run_cli("Londn")  # typo
+    assert "London" in out.stdout or "Did you mean" in out.stdout
+
+def test_compare():
+    out = run_cli("compare", "London", "Tokyo")
+    assert "London" in out.stdout and "Tokyo" in out.stdout
+
+def test_meeting_time():
+    out = run_cli("meeting", "at", "10:00", "AM")
+    assert "Favorite Cities" in out.stdout or "No favorite cities" in out.stdout
+
+def test_invalid_city():
+    out = run_cli("NotACity")
+    assert "Invalid command" in out.stdout or "Did you mean" in out.stdout
+
+def test_no_favorites():
+    out = run_cli("list")
+    assert "No favorite cities" in out.stdout