klockslag 1.1__tar.gz

klockslag-1.1/PKG-INFO

@@ -0,0 +1,53 @@
+Metadata-Version: 2.4
+Name: klockslag
+Version: 1.1
+Summary: A tool for showing times in different timezones
+Author-email: Lars Arvestad <arve@math.su.se>
+Maintainer-email: Lars Arvestad <arve@math.su.se>
+License-Expression: GPL-3.0-or-later
+Project-URL: homepage, https://github.com/arvestad/klockslag
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+Requires-Dist: geonamescache
+
+# Klockslag
+
+Find out what a time is in some other timezones.
+
+Example: I am planning an online meeting with participants on the east coast of USA,
+Paris, Tokyo, and Seoul. The plan is at 16:00 my time (in Stockholm), but what time is that
+for the others?
+
+```
+$ klockslag 16:00 seoul paris eastern
+US/Eastern	10:00:00
+Canada/Eastern	10:00:00
+Europe/Paris	16:00:00
+Asia/Seoul	23:00:00
+Asia/Tokyo	23:00:00
+```
+
+You may need to disambiguate sometimes. For example:
+
+```
+$ klockslag 16:00 stockholm springfield paris
+Oregon/Springfield	07:00:00
+Illinois/Springfield	09:00:00
+Missouri/Springfield	09:00:00
+Tennessee/Springfield	09:00:00
+Ohio/Springfield	10:00:00
+Pennsylvania/Springfield	10:00:00
+Virginia/Springfield	10:00:00
+Massachusetts/Springfield	10:00:00
+Europe/Stockholm	16:00:00
+Europe/Paris	16:00:00
+```
+There are too many matching Springfields, and I wanted Paris, TX, so I add qualifiers for a better presentation:
+```
+$ klockslag 16:00 stockholm pennsylvania/springfield texas/paris
+Texas/Paris	09:00:00
+Pennsylvania/Springfield	10:00:00
+Europe/Stockholm	16:00:00
+```

klockslag-1.1/README.md

@@ -0,0 +1,39 @@
+# Klockslag
+
+Find out what a time is in some other timezones.
+
+Example: I am planning an online meeting with participants on the east coast of USA,
+Paris, Tokyo, and Seoul. The plan is at 16:00 my time (in Stockholm), but what time is that
+for the others?
+
+```
+$ klockslag 16:00 seoul paris eastern
+US/Eastern	10:00:00
+Canada/Eastern	10:00:00
+Europe/Paris	16:00:00
+Asia/Seoul	23:00:00
+Asia/Tokyo	23:00:00
+```
+
+You may need to disambiguate sometimes. For example:
+
+```
+$ klockslag 16:00 stockholm springfield paris
+Oregon/Springfield	07:00:00
+Illinois/Springfield	09:00:00
+Missouri/Springfield	09:00:00
+Tennessee/Springfield	09:00:00
+Ohio/Springfield	10:00:00
+Pennsylvania/Springfield	10:00:00
+Virginia/Springfield	10:00:00
+Massachusetts/Springfield	10:00:00
+Europe/Stockholm	16:00:00
+Europe/Paris	16:00:00
+```
+There are too many matching Springfields, and I wanted Paris, TX, so I add qualifiers for a better presentation:
+```
+$ klockslag 16:00 stockholm pennsylvania/springfield texas/paris
+Texas/Paris	09:00:00
+Pennsylvania/Springfield	10:00:00
+Europe/Stockholm	16:00:00
+```

klockslag-1.1/pyproject.toml

@@ -0,0 +1,35 @@
+[project]
+name = "klockslag"
+authors = [
+    {name = "Lars Arvestad", email = "arve@math.su.se"}
+]
+maintainers = [
+    {name = "Lars Arvestad", email = "arve@math.su.se"},
+]
+description = "A tool for showing times in different timezones"
+readme = "README.md"
+license = "GPL-3.0-or-later"
+classifiers = [
+        "Programming Language :: Python :: 3",
+        "Operating System :: OS Independent",
+]
+dynamic = ["version"]
+
+dependencies = ["geonamescache"]
+requires-python = ">= 3.6"
+
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"
+
+
+[project.scripts]
+klockslag = "klockslag:main"
+
+
+[project.urls]
+homepage = "https://github.com/arvestad/klockslag"
+
+
+[tool.setuptools.dynamic]
+version = {attr = "version.__version__"}

klockslag-1.1/setup.cfg

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

klockslag-1.1/src/klockslag.egg-info/PKG-INFO

@@ -0,0 +1,53 @@
+Metadata-Version: 2.4
+Name: klockslag
+Version: 1.1
+Summary: A tool for showing times in different timezones
+Author-email: Lars Arvestad <arve@math.su.se>
+Maintainer-email: Lars Arvestad <arve@math.su.se>
+License-Expression: GPL-3.0-or-later
+Project-URL: homepage, https://github.com/arvestad/klockslag
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+Requires-Dist: geonamescache
+
+# Klockslag
+
+Find out what a time is in some other timezones.
+
+Example: I am planning an online meeting with participants on the east coast of USA,
+Paris, Tokyo, and Seoul. The plan is at 16:00 my time (in Stockholm), but what time is that
+for the others?
+
+```
+$ klockslag 16:00 seoul paris eastern
+US/Eastern	10:00:00
+Canada/Eastern	10:00:00
+Europe/Paris	16:00:00
+Asia/Seoul	23:00:00
+Asia/Tokyo	23:00:00
+```
+
+You may need to disambiguate sometimes. For example:
+
+```
+$ klockslag 16:00 stockholm springfield paris
+Oregon/Springfield	07:00:00
+Illinois/Springfield	09:00:00
+Missouri/Springfield	09:00:00
+Tennessee/Springfield	09:00:00
+Ohio/Springfield	10:00:00
+Pennsylvania/Springfield	10:00:00
+Virginia/Springfield	10:00:00
+Massachusetts/Springfield	10:00:00
+Europe/Stockholm	16:00:00
+Europe/Paris	16:00:00
+```
+There are too many matching Springfields, and I wanted Paris, TX, so I add qualifiers for a better presentation:
+```
+$ klockslag 16:00 stockholm pennsylvania/springfield texas/paris
+Texas/Paris	09:00:00
+Pennsylvania/Springfield	10:00:00
+Europe/Stockholm	16:00:00
+```

klockslag-1.1/src/klockslag.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+src/__init__.py
+src/klockslag.py
+src/version.py
+src/klockslag.egg-info/PKG-INFO
+src/klockslag.egg-info/SOURCES.txt
+src/klockslag.egg-info/dependency_links.txt
+src/klockslag.egg-info/entry_points.txt
+src/klockslag.egg-info/requires.txt
+src/klockslag.egg-info/top_level.txt

klockslag-1.1/src/klockslag.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

klockslag-1.1/src/klockslag.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+klockslag = klockslag:main

klockslag-1.1/src/klockslag.egg-info/requires.txt

@@ -0,0 +1 @@
+geonamescache

klockslag-1.1/src/klockslag.egg-info/top_level.txt

@@ -0,0 +1,3 @@
+__init__
+klockslag
+version

klockslag-1.1/src/klockslag.py

@@ -0,0 +1,143 @@
+import argparse
+import datetime as dt
+import re
+import sys
+import zoneinfo
+
+import geonamescache
+
+def setup_args():
+    ap = argparse.ArgumentParser(description='What time is it in other timezones?')
+    ap.add_argument('time', nargs='?', default=None,
+                    help='List time in other timezones for this time in your current timezone.'),
+    ap.add_argument('timezones', nargs='*',
+                    help='Named timezones or city names, e.g. Europe/Oslo, "Tel Aviv", or '
+                         'Massachusetts/Springfield to disambiguate a common city name.')
+    ap.add_argument('-tz', '--list-time-zones', action='store_true',
+                    help='Provide a list of available timezones.')
+    return ap
+
+
+def show_timezones():
+    for tz in sorted(zoneinfo.available_timezones()):
+        print(tz)
+
+
+def iana_zone_matches(name):
+    pattern = re.compile(name, re.IGNORECASE)
+    return {tz for tz in zoneinfo.available_timezones() if pattern.search(tz)}
+
+
+def split_qualifier(term):
+    """Split "Qualifier/City" (e.g. "Massachusetts/Springfield") into
+    (qualifier, city). qualifier is None if `term` has no '/'."""
+    if '/' in term:
+        qualifier, _, city = term.rpartition('/')
+        return qualifier, city
+    return None, term
+
+
+def city_hints(city, countries, us_states):
+    """Strings that can be used as a qualifier to disambiguate this city."""
+    country = countries.get(city['countrycode'], {}).get('name', city['countrycode'])
+    hints = [country, city['countrycode']]
+    if city['countrycode'] == 'US' and city['admin1code'] in us_states:
+        state = us_states[city['admin1code']]
+        hints += [state['name'], state['code']]
+    return hints
+
+
+def city_label(city, countries, us_states):
+    """Render a city as "Qualifier/City", matching IANA's "Region/City" style."""
+    if city['countrycode'] == 'US' and city['admin1code'] in us_states:
+        qualifier = us_states[city['admin1code']]['name']
+    else:
+        qualifier = countries.get(city['countrycode'], {}).get('name', city['countrycode'])
+    return f"{qualifier}/{city['name']}"
+
+
+def city_matches(name, qualifier=None):
+    """Return a list of (place_label, iana_zone_name) for cities named `name`,
+    optionally narrowed to those matching `qualifier` (a state or country name/code)."""
+    gc = geonamescache.GeonamesCache()
+    countries = gc.get_countries()
+    us_states = gc.get_us_states()
+    candidates = [c for c in gc.get_cities().values() if c['name'].lower() == name.lower()]
+
+    if qualifier:
+        pattern = re.compile(qualifier, re.IGNORECASE)
+        narrowed = [c for c in candidates
+                    if any(pattern.search(hint) for hint in city_hints(c, countries, us_states))]
+        if narrowed:
+            candidates = narrowed
+        else:
+            print(f'warning: no location "{qualifier}" found among matches for "{name}"; showing all',
+                  file=sys.stderr)
+
+    return [(city_label(c, countries, us_states), c['timezone']) for c in candidates]
+
+
+def matching_timezones(str_list):
+    """Map each search term to timezone(s), preferring an IANA zone-name match
+    and falling back to a city-name lookup (which may yield several places,
+    e.g. "Springfield", unless narrowed with a "Qualifier/City" term such as
+    "Massachusetts/Springfield")."""
+    res = {}
+    for s in str_list:
+        zones = iana_zone_matches(s)
+        if zones:
+            for tz in zones:
+                res[tz] = zoneinfo.ZoneInfo(tz)
+            continue
+
+        qualifier, city_name = split_qualifier(s)
+        cities = city_matches(city_name, qualifier)
+        if cities:
+            for place, tz in cities:
+                res[place] = zoneinfo.ZoneInfo(tz)
+        else:
+            print(f'warning: no timezone or city found matching "{s}"', file=sys.stderr)
+    return res
+
+
+def combine_time_and_zone(t, z):
+    date = dt.date.today()
+    t = dt.time.fromisoformat(t)
+    d = dt.datetime.combine(date, t)
+    d2 = d.astimezone(z)
+    return d2
+
+
+def show_in_other_timezones(t, tz_dict):
+    entries = []
+    for label, tz in tz_dict.items():
+        d = combine_time_and_zone(t, tz)
+        entries.append((label, d.time()))
+    entries.sort(key=lambda e: e[1])
+    width = max((len(label) for label, _ in entries), default=0)
+    for label, time in entries:
+        print(f'{label.ljust(width)}  {time}')
+
+
+def main():
+    ap = setup_args()
+    args = ap.parse_args()
+
+    if args.list_time_zones:
+        show_timezones()
+        return
+
+    if not args.time or not args.timezones:
+        ap.error('time and at least one timezone are required unless -tz is given')
+
+    if args.time == 'now':
+        t = dt.datetime.now().time().isoformat()
+    else:
+        t = args.time
+
+    tz_list = matching_timezones(args.timezones)
+    show_in_other_timezones(t, tz_list)
+
+
+if __name__ == '__main__':
+    main()

klockslag-1.1/src/version.py

@@ -0,0 +1 @@
+__version__ = '1.1'