clox 1.1__py3-none-any.whl → 1.2__py3-none-any.whl

clox/functions.py

@@ -14,7 +14,7 @@ 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 TIMEZONE_DIFFERENCE_FORMAT
+from .params import TIMEZONE_DIFFERENCE_FORMAT, OFFSET_FORMAT
 from .params import CLOX_VERSION
 from .params import TIMEZONES_LIST, COUNTRIES_LIST, WEEKDAYS_LIST
 from .params import ADDITIONAL_INFO, EXIT_MESSAGE
@@ -24,8 +24,8 @@ from .params import CLOX_OVERVIEW, CLOX_REPO
 from .params import DATE_FORMATS_MAP, DATE_FORMATS_LIST
 
 
-def clox_info() -> None:
-    """Print clox details."""
+def print_clox_info() -> None:
+    """Print clox info."""
     tprint("Clox")
     tprint("V:" + CLOX_VERSION)
     print(CLOX_OVERVIEW)
@@ -51,16 +51,18 @@ def get_face(index: int) -> str:
     return FACES_MAP[index]
 
 
-def get_timezone_difference(timezone: str) -> str:
+def get_timezone_difference(timezone: str, offset_local: float, offset_timezone: float) -> str:
     """
     Return timezone difference.
 
     :param timezone: timezone
+    :param offset_local: manual offset for the local time
+    :param offset_timezone: manual offset for the timezone
     """
     direction = "ahead"
     tz = pytz.timezone(timezone)
-    datetime_timezone = datetime.datetime.now(tz=tz)
-    datetime_local = datetime.datetime.now()
+    datetime_timezone = datetime.datetime.now(tz=tz) + datetime.timedelta(hours=offset_timezone)
+    datetime_local = datetime.datetime.now() + datetime.timedelta(hours=offset_local)
     difference = datetime_timezone - tz.localize(datetime_local)
     total_minutes = difference.total_seconds() // 60
     if total_minutes < 0:
@@ -144,7 +146,7 @@ def show_date_formats_list(date_system: str = "GREGORIAN") -> None:
                                                                            date_format_code=date_format, date_format_example=example_date.strftime(DATE_FORMATS_MAP[date_format])))
 
 
-def _get_weekday_id(first_weekday: str, date_system: str = "GREGORIAN") -> int:
+def get_weekday_id(first_weekday: str, date_system: str = "GREGORIAN") -> int:
     """
     Get weekday id.
 
@@ -168,7 +170,9 @@ def print_calendar(
         h_shift: int = 0,
         date_system: str = "GREGORIAN",
         date_format: str = "FULL",
-        first_weekday: str = "MONDAY") -> None:
+        first_weekday: str = "MONDAY",
+        offset_local: float = 0,
+        offset_timezone: float = 0) -> None:
     """
     Print calendar.
 
@@ -180,31 +184,45 @@ def print_calendar(
     :param date_system: date system
     :param date_format: date format
     :param first_weekday: first weekday
+    :param offset_local: manual offset for the local time
+    :param offset_timezone: manual offset for the timezone
     """
-    first_weekday_id = _get_weekday_id(first_weekday, date_system)
+    first_weekday_id = get_weekday_id(first_weekday, date_system)
     datetime_lib = datetime
     calendar_obj = GregorianCalendar(first_weekday_id)
     if date_system == "JALALI":
         datetime_lib = jdatetime
         calendar_obj = JalaliCalendar(first_weekday_id)
+    offset_main_timedelta = datetime_lib.timedelta(hours=offset_local)
     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
-        timezone_diff = get_timezone_difference(timezone=timezone)
+        timezone_diff = get_timezone_difference(
+            timezone=timezone,
+            offset_local=offset_local,
+            offset_timezone=offset_timezone)
         timezone_str += " ({timezone_diff})".format(timezone_diff=timezone_diff)
         tz = pytz.timezone(timezone)
+        offset_main_timedelta = datetime_lib.timedelta(hours=offset_timezone)
     v_shift = max(0, v_shift)
     h_shift = max(0, h_shift)
-    datetime_timezone = datetime_lib.datetime.now(tz=tz)
+    datetime_timezone = datetime_lib.datetime.now(tz=tz) + offset_main_timedelta
     date_timezone_str = datetime_timezone.strftime(DATE_FORMATS_MAP[date_format])
     print('\n' * v_shift, end='')
     print(" " * h_shift, end='')
     print("Today: {date}".format(date=date_timezone_str))
     print(" " * h_shift, end='')
-    print("Timezone: {timezone}\n".format(timezone=timezone_str))
+    print("Timezone: {timezone}".format(timezone=timezone_str))
+    if offset_timezone != 0:
+        print(" " * h_shift, end='')
+        print(OFFSET_FORMAT.format(offset_type="Timezone", offset_value=offset_timezone))
+    if offset_local != 0:
+        print(" " * h_shift, end='')
+        print(OFFSET_FORMAT.format(offset_type="Local", offset_value=offset_local))
+    print("")
     calendar_str = calendar_obj.formatmonth(datetime_timezone.year, datetime_timezone.month)
     if mode == "YEAR":
         calendar_str = calendar_obj.formatyear(datetime_timezone.year)
@@ -223,7 +241,9 @@ def run_clock(
         hide_timezone: bool = False,
         am_pm: bool = False,
         date_system: str = "GREGORIAN",
-        date_format: str = "FULL") -> None:
+        date_format: str = "FULL",
+        offset_local: float = 0,
+        offset_timezone: float = 0) -> None:
     """
     Run clock.
 
@@ -239,6 +259,8 @@ def run_clock(
     :param am_pm: AM/PM mode flag
     :param date_system: date system
     :param date_format: date format
+    :param offset_local: manual offset for the local time
+    :param offset_timezone: manual offset for the timezone
     """
     datetime_lib = datetime
     if date_system == "JALALI":
@@ -250,13 +272,19 @@ def run_clock(
         time_formats = VERTICAL_TIME_12H_FORMATS if am_pm else VERTICAL_TIME_24H_FORMATS
     tz = None
     timezone_str = "Local"
+    offset_main_timedelta = datetime_lib.timedelta(hours=offset_local)
+    offset_local_timedelta = datetime.timedelta(hours=offset_local)
     if country is not None:
         timezone = pytz.country_timezones(country)[0].upper()
     if timezone is not None:
         timezone_str = timezone
-        timezone_diff = get_timezone_difference(timezone=timezone)
+        timezone_diff = get_timezone_difference(
+            timezone=timezone,
+            offset_local=offset_local,
+            offset_timezone=offset_timezone)
         timezone_str += " ({timezone_diff})".format(timezone_diff=timezone_diff)
         tz = pytz.timezone(timezone)
+        offset_main_timedelta = datetime_lib.timedelta(hours=offset_timezone)
     v_shift = max(0, v_shift)
     h_shift = max(0, h_shift)
     face = get_face(face)
@@ -264,7 +292,7 @@ def run_clock(
         clear_screen()
         print('\n' * v_shift, end='')
         print(" " * h_shift, end='')
-        datetime_timezone = datetime_lib.datetime.now(tz=tz)
+        datetime_timezone = datetime_lib.datetime.now(tz=tz) + offset_main_timedelta
         time_timezone_str = datetime_timezone.strftime(time_formats[format_index])
         date_timezone_str = datetime_timezone.strftime(DATE_FORMATS_MAP[date_format])
         tprint(time_timezone_str, font=face, sep="\n" + " " * h_shift)
@@ -274,11 +302,17 @@ def run_clock(
         if not hide_timezone:
             print(" " * h_shift, end='')
             print("Timezone: {timezone}".format(timezone=timezone_str))
+            if offset_timezone != 0:
+                print(" " * h_shift, end='')
+                print(OFFSET_FORMAT.format(offset_type="Timezone", offset_value=offset_timezone))
             if timezone is not None:
-                datetime_local = datetime.datetime.now()
+                datetime_local = datetime.datetime.now() + offset_local_timedelta
                 time_local_str = datetime_local.strftime(time_formats_local[format_index])
                 print(" " * h_shift, end='')
                 print("Local Time: {local_time}".format(local_time=time_local_str))
+            if offset_local != 0:
+                print(" " * h_shift, end='')
+                print(OFFSET_FORMAT.format(offset_type="Local", offset_value=offset_local))
         time.sleep(1)
         if not no_blink:
             format_index = int(not format_index)
@@ -314,11 +348,13 @@ def main() -> None:
         type=str.upper,
         choices=DATE_SYSTEMS_LIST,
         default="GREGORIAN")
+    parser.add_argument('--offset-local', help='manual offset for the local time (in hours)', type=float, default=0)
+    parser.add_argument('--offset-timezone', help='manual offset for the timezone (in hours)', type=float, default=0)
     args = parser.parse_args()
     if args.version:
         print(CLOX_VERSION)
     elif args.info:
-        clox_info()
+        print_clox_info()
     elif args.faces_list:
         show_faces_list(vertical=args.vertical)
     elif args.timezones_list:
@@ -336,7 +372,9 @@ def main() -> None:
             v_shift=args.v_shift,
             date_system=args.date_system,
             date_format=args.date_format,
-            first_weekday=args.first_weekday)
+            first_weekday=args.first_weekday,
+            offset_local=args.offset_local,
+            offset_timezone=args.offset_timezone)
     else:
         try:
             run_clock(
@@ -351,6 +389,8 @@ def main() -> None:
                 hide_timezone=args.hide_timezone,
                 am_pm=args.am_pm,
                 date_system=args.date_system,
-                date_format=args.date_format)
+                date_format=args.date_format,
+                offset_local=args.offset_local,
+                offset_timezone=args.offset_timezone)
         except (KeyboardInterrupt, EOFError):
             print(EXIT_MESSAGE)

clox/params.py

@@ -2,7 +2,7 @@
 """clox params."""
 import pytz
 
-CLOX_VERSION = "1.1"
+CLOX_VERSION = "1.2"
 
 CLOX_OVERVIEW = '''
 Clox is a terminal-based clock application designed for terminal enthusiasts who appreciate simplicity,
@@ -23,6 +23,7 @@ VERTICAL_TIME_24H_FORMATS = ['%H\n%M', '%H\n%M.']
 HORIZONTAL_TIME_12H_FORMATS = ['%I:%M %p', '%I:%M %p.']
 VERTICAL_TIME_12H_FORMATS = ['%I\n%M\n%p', '%I\n%M\n%p.']
 TIMEZONE_DIFFERENCE_FORMAT = "{hours:02}h{minutes:02}m {direction}"
+OFFSET_FORMAT = "{offset_type} Offset: {offset_value:g}h"
 
 WEEKDAYS_LIST = ["MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY", "SUNDAY"]
 TIMEZONES_LIST = list(map(lambda x: x.upper(), pytz.all_timezones))

{clox-1.1.dist-info → clox-1.2.dist-info}/METADATA

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: clox
-Version: 1.1
+Version: 1.2
 Summary: A Geeky Clock for Terminal Enthusiasts
 Home-page: https://github.com/sepandhaghighi/clox
-Download-URL: https://github.com/sepandhaghighi/clox/tarball/v1.1
+Download-URL: https://github.com/sepandhaghighi/clox/tarball/v1.2
 Author: Sepand Haghighi
 Author-email: me@sepand.tech
 License: MIT
@@ -96,7 +96,6 @@ Clox is a terminal-based clock application designed for terminal enthusiasts who
 		<td align="center">Code Quality</td>
 		<td align="center"><a href="https://www.codefactor.io/repository/github/sepandhaghighi/clox"><img src="https://www.codefactor.io/repository/github/sepandhaghighi/clox/badge" alt="CodeFactor"></a></td>
 		<td align="center"><a href="https://app.codacy.com/gh/sepandhaghighi/clox/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade"><img src="https://app.codacy.com/project/badge/Grade/4cd4cd3b20b1474fb674823b1b417b76"></a></td>
-		<td align="center"><a href="https://codebeat.co/projects/github-com-sepandhaghighi-clox-main"><img alt="codebeat badge" src="https://codebeat.co/badges/19394d3a-009b-401b-b376-24a325ef2fdf"></a></td>
 	</tr>
 </table>
 
@@ -104,13 +103,13 @@ Clox is a terminal-based clock application designed for terminal enthusiasts who
 ## Installation		
 
 ### Source Code
-- Download [Version 1.1](https://github.com/sepandhaghighi/clox/archive/v1.1.zip) or [Latest Source](https://github.com/sepandhaghighi/clox/archive/dev.zip)
+- Download [Version 1.2](https://github.com/sepandhaghighi/clox/archive/v1.2.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==1.1`						
+- `pip install clox==1.2`						
 
 
 ## Usage
@@ -154,6 +153,16 @@ clox --timezone="Etc/GMT+7"
 * [Timezones List](https://github.com/sepandhaghighi/clox/blob/main/TIMEZONES.md): `clox --timezones-list`
 
 
+### Manual Offset
+
+ℹ️ The local and timezone offset both have default values of `0`
+
+These arguments allow you to manually adjust the time by ±X hours. This is especially useful when daylight saving time (DST) is not correctly applied by the system or timezone database.
+
+```console
+clox --offset-local=1 --offset-timezone=-1
+```
+
 ### Country
 
 The `--country` argument allows you to specify a country using its **ISO 3166** code format
@@ -303,6 +312,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]
+## [1.2] - 2025-09-02
+### Added
+- `--offset-local` argument
+- `--offset-timezone` argument
+### Changed
+- `README.md` updated
+- Test system modified
+- `_get_weekday_id` function renamed to `get_weekday_id`
+- `clox_info` function renamed to `print_clox_info`
 ## [1.1] - 2025-05-23
 ### Added
 - `--first-weekday` argument
@@ -377,7 +395,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/v1.1...dev
+[Unreleased]: https://github.com/sepandhaghighi/clox/compare/v1.2...dev
+[1.2]: https://github.com/sepandhaghighi/clox/compare/v1.1...v1.2
 [1.1]: https://github.com/sepandhaghighi/clox/compare/v1.0...v1.1
 [1.0]: https://github.com/sepandhaghighi/clox/compare/v0.9...v1.0
 [0.9]: https://github.com/sepandhaghighi/clox/compare/v0.8...v0.9

clox-1.2.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=aSYoZdmM3TGX4nPVMnbH9RkrB0uql-MPNOaZmY4BgCo,15978
+clox/jcalendar.py,sha256=RvtTikECGI4LjDSi5qbJF9grz7to2__fgR98xnnvme8,13462
+clox/params.py,sha256=vBtlat47gc9C9M9RIwu8yugdCQ35ObBPdqwSTwDMp_A,2176
+clox-1.2.dist-info/licenses/AUTHORS.md,sha256=lmtnd18MnfgB57jdvfJbC0JHN3iARf2Ov4pY5kPGJC8,242
+clox-1.2.dist-info/licenses/LICENSE,sha256=WoAsqqZ_lNVBGdyxjwh7YnVNXKfOB-qYVrRhrn-e-_4,1072
+clox-1.2.dist-info/METADATA,sha256=_zZIpzNgZkRFqdDhjSEtonDORLGkuET9xkwNx_AWneU,10916
+clox-1.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+clox-1.2.dist-info/entry_points.txt,sha256=sP4Rmoe-DxYGjlF_Tld6nghbt_u-fK8h9ZUQFmO8TJs,45
+clox-1.2.dist-info/top_level.txt,sha256=5DxGH-4VNfYkM8vbfngObh6-jpFEoSW4M90EvDGfhSw,5
+clox-1.2.dist-info/RECORD,,

{clox-1.1.dist-info → clox-1.2.dist-info}/WHEEL

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

clox-1.1.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=-tJtvWZBtYmh2qlNe_Y7KYZJXwo3nUzgVYwHe_mnbmc,13607
-clox/jcalendar.py,sha256=RvtTikECGI4LjDSi5qbJF9grz7to2__fgR98xnnvme8,13462
-clox/params.py,sha256=JH8NEjXDUoHKCLCVtfjog5DR-iqVPxUsGJPZYcNeWL4,2118
-clox-1.1.dist-info/licenses/AUTHORS.md,sha256=lmtnd18MnfgB57jdvfJbC0JHN3iARf2Ov4pY5kPGJC8,242
-clox-1.1.dist-info/licenses/LICENSE,sha256=WoAsqqZ_lNVBGdyxjwh7YnVNXKfOB-qYVrRhrn-e-_4,1072
-clox-1.1.dist-info/METADATA,sha256=qmV3t6v2pJmTIUppwLi-XhVJud_bHvkgmjJL2H5pdsQ,10459
-clox-1.1.dist-info/WHEEL,sha256=zaaOINJESkSfm_4HQVc5ssNzHCPXhJm0kEUakpsEHaU,91
-clox-1.1.dist-info/entry_points.txt,sha256=sP4Rmoe-DxYGjlF_Tld6nghbt_u-fK8h9ZUQFmO8TJs,45
-clox-1.1.dist-info/top_level.txt,sha256=5DxGH-4VNfYkM8vbfngObh6-jpFEoSW4M90EvDGfhSw,5
-clox-1.1.dist-info/RECORD,,