clox 0.7__py3-none-any.whl → 0.8__py3-none-any.whl

clox/functions.py

@@ -13,9 +13,10 @@ from art import tprint
 from .jcalendar import TextCalendar as JalaliCalendar
 from .params import HORIZONTAL_TIME_24H_FORMATS, VERTICAL_TIME_24H_FORMATS
 from .params import HORIZONTAL_TIME_12H_FORMATS, VERTICAL_TIME_12H_FORMATS
-from .params import TIMEZONES_LIST, CLOX_VERSION, DATE_FORMAT
+from .params import CLOX_VERSION, DATE_FORMAT
+from .params import TIMEZONES_LIST, COUNTRIES_LIST
 from .params import ADDITIONAL_INFO, EXIT_MESSAGE
-from .params import FACES_MAP, FACES_LIST, CALENDAR_LIST, DATE_SYSTEMS_LIST
+from .params import FACES_MAP, FACES_LIST, CALENDARS_LIST, DATE_SYSTEMS_LIST
 from .params import HORIZONTAL_FACES_LIST_EXAMPLE, VERTICAL_FACES_LIST_EXAMPLE
 from .params import CLOX_OVERVIEW, CLOX_REPO
 
@@ -77,18 +78,45 @@ def show_faces_list(vertical=False):
         print('=' * 80)
 
 
-def show_timezones_list():
+def show_timezones_list(country=None):
     """
     Show timezones list.
 
+    :param country: country iso3166 code
+    :type country: str
     :return: None
     """
-    print("Timezones list:\n")
-    for index, timezone in enumerate(TIMEZONES_LIST, 1):
+    timezones_list = TIMEZONES_LIST
+    country_name = "All"
+    if country is not None:
+        timezones_list = list(map(lambda x: x.upper(), pytz.country_timezones(country)))
+        country_name = pytz.country_names[country]
+    try:
+        print("Timezones list ({country_name}):\n".format(country_name=country_name))
+    except Exception:
+        print("Timezones list ({country_name}):\n".format(country_name=country.upper()))
+    for index, timezone in enumerate(sorted(timezones_list), 1):
         print("{index}. {timezone}".format(index=index, timezone=timezone))
 
 
-def print_calendar(mode="month", timezone=None, v_shift=0, h_shift=0, date_system="gregorian"):
+def show_countries_list():
+    """
+    Show countries list.
+
+    :return: None
+    """
+    print("Countries list:\n")
+    for index, country_code in enumerate(sorted(COUNTRIES_LIST), 1):
+        country_name = pytz.country_names[country_code]
+        try:
+            print("{index}. {country_code} - {country_name}".format(index=index,
+                                                                    country_code=country_code, country_name=country_name))
+        except Exception:
+            print("{index}. {country_code} - {country_name}".format(index=index,
+                                                                    country_code=country_code, country_name=country_code))
+
+
+def print_calendar(mode="month", timezone=None, country=None, v_shift=0, h_shift=0, date_system="gregorian"):
     """
     Print calendar.
 
@@ -96,6 +124,8 @@ def print_calendar(mode="month", timezone=None, v_shift=0, h_shift=0, date_syste
     :type mode: str
     :param timezone: timezone
     :type timezone: str
+    :param country: country iso3166 code
+    :type country: str
     :param v_shift: vertical shift
     :type v_shift: int
     :param h_shift: horizontal shift
@@ -111,6 +141,8 @@ def print_calendar(mode="month", timezone=None, v_shift=0, h_shift=0, date_syste
         calendar_obj = JalaliCalendar()
     tz = None
     timezone_str = "Local"
+    if country is not None:
+        timezone = pytz.country_timezones(country)[0].upper()
     if timezone is not None:
         timezone_str = timezone
         tz = pytz.timezone(timezone)
@@ -131,6 +163,7 @@ def print_calendar(mode="month", timezone=None, v_shift=0, h_shift=0, date_syste
 
 def run_clock(
         timezone=None,
+        country=None,
         v_shift=0,
         h_shift=0,
         face=1,
@@ -145,6 +178,8 @@ def run_clock(
 
     :param timezone: timezone
     :type timezone: str
+    :param country: country iso3166 code
+    :type country: str
     :param v_shift: vertical shift
     :type v_shift: int
     :param h_shift: horizontal shift
@@ -174,6 +209,8 @@ def run_clock(
         time_formats = VERTICAL_TIME_12H_FORMATS if am_pm else VERTICAL_TIME_24H_FORMATS
     tz = None
     timezone_str = "Local"
+    if country is not None:
+        timezone = pytz.country_timezones(country)[0].upper()
     if timezone is not None:
         timezone_str = timezone
         tz = pytz.timezone(timezone)
@@ -207,7 +244,8 @@ def main():
     """
     parser = argparse.ArgumentParser()
     parser.epilog = ADDITIONAL_INFO
-    parser.add_argument('--timezone', help='timezone', type=str, choices=TIMEZONES_LIST)
+    parser.add_argument('--timezone', help='timezone', type=str.upper, choices=TIMEZONES_LIST)
+    parser.add_argument('--country', help='country (iso3166 code)', type=str.upper, choices=COUNTRIES_LIST)
     parser.add_argument('--v-shift', help='vertical shift', type=int, default=0)
     parser.add_argument('--h-shift', help='horizontal shift', type=int, default=0)
     parser.add_argument('--version', help='version', nargs="?", const=1)
@@ -215,13 +253,19 @@ def main():
     parser.add_argument('--face', help='face', type=int, choices=FACES_LIST, default=1)
     parser.add_argument('--faces-list', help='faces list', nargs="?", const=1)
     parser.add_argument('--timezones-list', help='timezones list', nargs="?", const=1)
+    parser.add_argument('--countries-list', help='countries list', nargs="?", const=1)
     parser.add_argument('--no-blink', help='disable blinking mode', nargs="?", const=1)
     parser.add_argument('--vertical', help='vertical mode', nargs="?", const=1)
     parser.add_argument('--hide-date', help='hide date', nargs="?", const=1)
     parser.add_argument('--hide-timezone', help='hide timezone', nargs="?", const=1)
     parser.add_argument('--am-pm', help='AM/PM mode', nargs="?", const=1)
-    parser.add_argument('--calendar', help='calendar mode', type=str, choices=CALENDAR_LIST)
-    parser.add_argument('--date-system', help='date system', type=str, choices=DATE_SYSTEMS_LIST, default="gregorian")
+    parser.add_argument('--calendar', help='calendar mode', type=str.lower, choices=CALENDARS_LIST)
+    parser.add_argument(
+        '--date-system',
+        help='date system',
+        type=str.lower,
+        choices=DATE_SYSTEMS_LIST,
+        default="gregorian")
     args = parser.parse_args()
     if args.version:
         print(CLOX_VERSION)
@@ -230,11 +274,14 @@ def main():
     elif args.faces_list:
         show_faces_list(vertical=args.vertical)
     elif args.timezones_list:
-        show_timezones_list()
+        show_timezones_list(args.country)
+    elif args.countries_list:
+        show_countries_list()
     elif args.calendar:
         print_calendar(
             mode=args.calendar,
             timezone=args.timezone,
+            country=args.country,
             h_shift=args.h_shift,
             v_shift=args.v_shift,
             date_system=args.date_system)
@@ -242,6 +289,7 @@ def main():
         try:
             run_clock(
                 timezone=args.timezone,
+                country=args.country,
                 h_shift=args.h_shift,
                 v_shift=args.v_shift,
                 face=args.face,

clox/params.py

@@ -2,7 +2,7 @@
 """clox params."""
 import pytz
 
-CLOX_VERSION = "0.7"
+CLOX_VERSION = "0.8"
 
 CLOX_OVERVIEW = '''
 Clox is a terminal-based clock application designed for terminal enthusiasts who appreciate simplicity,
@@ -24,7 +24,8 @@ HORIZONTAL_TIME_12H_FORMATS = ['%I:%M %p', '%I:%M %p.']
 VERTICAL_TIME_12H_FORMATS = ['%I\n%M\n%p', '%I\n%M\n%p.']
 DATE_FORMAT = "%A, %B %d, %Y"
 
-TIMEZONES_LIST = pytz.all_timezones
+TIMEZONES_LIST = list(map(lambda x: x.upper(), pytz.all_timezones))
+COUNTRIES_LIST = list(map(lambda x: x.upper(), pytz.country_timezones.keys()))
 
 
 FACES_MAP = {
@@ -57,6 +58,6 @@ FACES_MAP = {
 
 FACES_LIST = [-1] + sorted(FACES_MAP)
 
-CALENDAR_LIST = ["month", "year"]
+CALENDARS_LIST = ["month", "year"]
 
 DATE_SYSTEMS_LIST = ["gregorian", "jalali"]

{clox-0.7.dist-info → clox-0.8.dist-info}/METADATA

@@ -1,9 +1,9 @@
 Metadata-Version: 2.2
 Name: clox
-Version: 0.7
+Version: 0.8
 Summary: A Geeky Clock for Terminal Enthusiasts
 Home-page: https://github.com/sepandhaghighi/clox
-Download-URL: https://github.com/sepandhaghighi/clox/tarball/v0.7
+Download-URL: https://github.com/sepandhaghighi/clox/tarball/v0.8
 Author: Sepand Haghighi
 Author-email: me@sepand.tech
 License: MIT
@@ -104,13 +104,13 @@ Clox is a terminal-based clock application designed for terminal enthusiasts who
 ## Installation		
 
 ### Source Code
-- Download [Version 0.7](https://github.com/sepandhaghighi/clox/archive/v0.7.zip) or [Latest Source](https://github.com/sepandhaghighi/clox/archive/dev.zip)
+- Download [Version 0.8](https://github.com/sepandhaghighi/clox/archive/v0.8.zip) or [Latest Source](https://github.com/sepandhaghighi/clox/archive/dev.zip)
 - `pip install .`				
 
 ### PyPI
 
 - Check [Python Packaging User Guide](https://packaging.python.org/installing/)     
-- `pip install clox==0.7`						
+- `pip install clox==0.8`						
 
 
 ## Usage
@@ -143,16 +143,30 @@ clox
 clox --face=3
 ```
 * Use `--face=-1` for random mode
-* [Faces List](https://github.com/sepandhaghighi/clox/blob/main/FACES.md)
-* `clox --faces-list`
+* [Faces List](https://github.com/sepandhaghighi/clox/blob/main/FACES.md): `clox --faces-list`
+
 
 ### Timezone
 
 ```console
 clox --timezone="Etc/GMT+7"
 ```
-* [Timezones List](https://github.com/sepandhaghighi/clox/blob/main/TIMEZONES.md)
-* `clox --timezones-list`
+* [Timezones List](https://github.com/sepandhaghighi/clox/blob/main/TIMEZONES.md): `clox --timezones-list`
+
+
+### Country
+
+The `--country` argument allows you to specify a country using its **ISO 3166** code format
+
+ℹ️ When the `--country` argument is provided, the `--timezone` argument will be ignored
+
+ℹ️ If the specified country has multiple timezones, the first timezone will be selected automatically
+
+```console
+clox --country="DE"
+```
+* [Countries List](https://github.com/sepandhaghighi/clox/blob/main/COUNTRIES.md): `clox --countries-list`
+
 
 ### Vertical/Horizontal Shift
 
@@ -278,6 +292,15 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
+## [0.8] - 2025-03-16
+### Added
+- `--country` argument
+- `--countries-list` argument
+- `COUNTRIES.md`
+### Changed
+- Input case sensitivity bug fixed
+- Test system modified
+- `README.md` updated
 ## [0.7] - 2025-03-06
 ### Added
 - Jalali calendar
@@ -322,7 +345,8 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - `TIMEZONES.md`
 - `FACES.md`
 
-[Unreleased]: https://github.com/sepandhaghighi/clox/compare/v0.7...dev
+[Unreleased]: https://github.com/sepandhaghighi/clox/compare/v0.8...dev
+[0.8]: https://github.com/sepandhaghighi/clox/compare/v0.7...v0.8
 [0.7]: https://github.com/sepandhaghighi/clox/compare/v0.6...v0.7
 [0.6]: https://github.com/sepandhaghighi/clox/compare/v0.5...v0.6
 [0.5]: https://github.com/sepandhaghighi/clox/compare/v0.4...v0.5

clox-0.8.dist-info/RECORD

@@ -0,0 +1,12 @@
+clox/__init__.py,sha256=gErclFSjUDschQpngWqOBGkBKt1jwd-Ww8B9iJmlU5s,108
+clox/__main__.py,sha256=9oJYc1WXu4ZMrjKny_2-4Cgu46-VWHuE9xOqD1iJY0E,109
+clox/functions.py,sha256=rHrWxzW0NxARlaKaUlO-TXEPyhEG1MQ0jctDxBe192I,10008
+clox/jcalendar.py,sha256=yAzuyXq6h8D5aJG_He_WuPR8Xy411W_l7pl8mtPJa5U,12296
+clox/params.py,sha256=8rlLAfUv3nHNVh5cSsH_1O1aNQoDAgmyKxiTkqV8f54,1654
+clox-0.8.dist-info/AUTHORS.md,sha256=lmtnd18MnfgB57jdvfJbC0JHN3iARf2Ov4pY5kPGJC8,242
+clox-0.8.dist-info/LICENSE,sha256=WoAsqqZ_lNVBGdyxjwh7YnVNXKfOB-qYVrRhrn-e-_4,1072
+clox-0.8.dist-info/METADATA,sha256=-c6IkxbwAxVIm0VY_MU9GICTe9v6xrtErvXEMHOr0iw,9509
+clox-0.8.dist-info/WHEEL,sha256=52BFRY2Up02UkjOa29eZOS2VxUrpPORXg1pkohGGUS8,91
+clox-0.8.dist-info/entry_points.txt,sha256=sP4Rmoe-DxYGjlF_Tld6nghbt_u-fK8h9ZUQFmO8TJs,45
+clox-0.8.dist-info/top_level.txt,sha256=5DxGH-4VNfYkM8vbfngObh6-jpFEoSW4M90EvDGfhSw,5
+clox-0.8.dist-info/RECORD,,

{clox-0.7.dist-info → clox-0.8.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.8.2)
+Generator: setuptools (76.0.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

clox-0.7.dist-info/RECORD

@@ -1,12 +0,0 @@
-clox/__init__.py,sha256=gErclFSjUDschQpngWqOBGkBKt1jwd-Ww8B9iJmlU5s,108
-clox/__main__.py,sha256=9oJYc1WXu4ZMrjKny_2-4Cgu46-VWHuE9xOqD1iJY0E,109
-clox/functions.py,sha256=hOXLuSMljzOMaHXJtiyxGas6XkFE9lQ51TMSC56Yq2M,8049
-clox/jcalendar.py,sha256=yAzuyXq6h8D5aJG_He_WuPR8Xy411W_l7pl8mtPJa5U,12296
-clox/params.py,sha256=Zd4AO6ufxpJFnXnwW3_xwzusyU4WIKS-JS29CVh2KZo,1542
-clox-0.7.dist-info/AUTHORS.md,sha256=lmtnd18MnfgB57jdvfJbC0JHN3iARf2Ov4pY5kPGJC8,242
-clox-0.7.dist-info/LICENSE,sha256=WoAsqqZ_lNVBGdyxjwh7YnVNXKfOB-qYVrRhrn-e-_4,1072
-clox-0.7.dist-info/METADATA,sha256=yUonus_iE_mfLDldjTFwOSt19Fkk6Mseu6YMy9blUwk,8799
-clox-0.7.dist-info/WHEEL,sha256=jB7zZ3N9hIM9adW7qlTAyycLYW9npaWKLRzaoVcLKcM,91
-clox-0.7.dist-info/entry_points.txt,sha256=sP4Rmoe-DxYGjlF_Tld6nghbt_u-fK8h9ZUQFmO8TJs,45
-clox-0.7.dist-info/top_level.txt,sha256=5DxGH-4VNfYkM8vbfngObh6-jpFEoSW4M90EvDGfhSw,5
-clox-0.7.dist-info/RECORD,,