clox 0.4__py3-none-any.whl → 0.5__py3-none-any.whl

clox/functions.py

@@ -8,8 +8,9 @@ import datetime
 import argparse
 import pytz
 from art import tprint
-from .params import HORIZONTAL_TIME_FORMATS, VERTICAL_TIME_FORMATS, DATE_FORMAT
-from .params import TIMEZONES_LIST, CLOX_VERSION
+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 ADDITIONAL_INFO, EXIT_MESSAGE
 from .params import FACES_MAP, FACES_LIST
 from .params import HORIZONTAL_FACES_LIST_EXAMPLE, VERTICAL_FACES_LIST_EXAMPLE
@@ -84,7 +85,16 @@ def show_timezones_list():
         print("{0}. {1}".format(index, timezone))
 
 
-def run_clock(timezone=None, v_shift=0, h_shift=0, face=1, no_blink=False, vertical=False):
+def run_clock(
+        timezone=None,
+        v_shift=0,
+        h_shift=0,
+        face=1,
+        no_blink=False,
+        vertical=False,
+        hide_date=False,
+        hide_timezone=False,
+        am_pm=False):
     """
     Run clock.
 
@@ -100,13 +110,19 @@ def run_clock(timezone=None, v_shift=0, h_shift=0, face=1, no_blink=False, verti
     :type no_blink: bool
     :param vertical: vertical mode flag
     :type vertical: bool
+    :param hide_date: hide date flag
+    :type hide_date: bool
+    :param hide_timezone: hide timezone flag
+    :type hide_timezone: bool
+    :param am_pm: AM/PM mode flag
+    :type am_pm: bool
     :return: None
     """
     format_index = 0
     timezone_str = timezone
-    time_formats = HORIZONTAL_TIME_FORMATS
+    time_formats = HORIZONTAL_TIME_12H_FORMATS if am_pm else HORIZONTAL_TIME_24H_FORMATS
     if vertical:
-        time_formats = VERTICAL_TIME_FORMATS
+        time_formats = VERTICAL_TIME_12H_FORMATS if am_pm else VERTICAL_TIME_24H_FORMATS
     if timezone is None:
         tz = None
         timezone_str = "Local"
@@ -123,10 +139,12 @@ def run_clock(timezone=None, v_shift=0, h_shift=0, face=1, no_blink=False, verti
         current_time = datetime_now.strftime(time_formats[format_index])
         current_date = datetime_now.strftime(DATE_FORMAT)
         tprint(current_time, font=face, sep="\n" + " " * h_shift)
-        print(" " * h_shift, end='')
-        print(current_date)
-        print(" " * h_shift, end='')
-        print("Timezone: {0}".format(timezone_str))
+        if not hide_date:
+            print(" " * h_shift, end='')
+            print(current_date)
+        if not hide_timezone:
+            print(" " * h_shift, end='')
+            print("Timezone: {0}".format(timezone_str))
         time.sleep(1)
         if not no_blink:
             format_index = int(not format_index)
@@ -150,6 +168,9 @@ def main():
     parser.add_argument('--timezones-list', help='timezones 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)
     args = parser.parse_args()
     if args.version:
         print(CLOX_VERSION)
@@ -167,6 +188,9 @@ def main():
                 v_shift=args.v_shift,
                 face=args.face,
                 no_blink=args.no_blink,
-                vertical=args.vertical)
+                vertical=args.vertical,
+                hide_date=args.hide_date,
+                hide_timezone=args.hide_timezone,
+                am_pm=args.am_pm)
         except (KeyboardInterrupt, EOFError):
             print(EXIT_MESSAGE)

clox/params.py

@@ -2,7 +2,7 @@
 """clox params."""
 import pytz
 
-CLOX_VERSION = "0.4"
+CLOX_VERSION = "0.5"
 
 CLOX_OVERVIEW = '''
 Clox is a terminal-based clock application designed for terminal enthusiasts who appreciate simplicity,
@@ -18,8 +18,10 @@ EXIT_MESSAGE = "See you. Bye!"
 HORIZONTAL_FACES_LIST_EXAMPLE = "12:34"
 VERTICAL_FACES_LIST_EXAMPLE = "12\n34"
 
-HORIZONTAL_TIME_FORMATS = ['%H:%M', '%H:%M.']
-VERTICAL_TIME_FORMATS = ['%H\n%M', '%H\n%M.']
+HORIZONTAL_TIME_24H_FORMATS = ['%H:%M', '%H:%M.']
+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.']
 DATE_FORMAT = "%A, %B %d, %Y"
 
 TIMEZONES_LIST = pytz.all_timezones

{clox-0.4.dist-info → clox-0.5.dist-info}/METADATA

@@ -1,9 +1,9 @@
 Metadata-Version: 2.2
 Name: clox
-Version: 0.4
+Version: 0.5
 Summary: A Geeky Clock for Terminal Enthusiasts
 Home-page: https://github.com/sepandhaghighi/clox
-Download-URL: https://github.com/sepandhaghighi/clox/tarball/v0.4
+Download-URL: https://github.com/sepandhaghighi/clox/tarball/v0.5
 Author: Sepand Haghighi
 Author-email: me@sepand.tech
 License: MIT
@@ -103,13 +103,13 @@ Clox is a terminal-based clock application designed for terminal enthusiasts who
 ## Installation		
 
 ### Source Code
-- Download [Version 0.4](https://github.com/sepandhaghighi/clox/archive/v0.4.zip) or [Latest Source](https://github.com/sepandhaghighi/clox/archive/dev.zip)
+- Download [Version 0.5](https://github.com/sepandhaghighi/clox/archive/v0.5.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.4`						
+- `pip install clox==0.5`						
 
 
 ## Usage
@@ -169,12 +169,44 @@ Disable blinking mode
 clox --no-blink
 ```
 
+### Hide Date
+
+In this mode, the date will not be shown
+
+```console
+clox --hide-date
+```
+
+### Hide Timezone
+
+In this mode, the timezone will not be shown
+
+```console
+clox --hide-timezone
+```
+
+### AM/PM Mode
+
+In this mode, the clock will be displayed in 12-hour format
+
+```console
+clox --am-pm
+```
+
 ### Vertical Mode
 
 ```console
 clox --vertical
 ```
 
+## Screen Record
+
+<div align="center">
+
+<img src="https://github.com/sepandhaghighi/clox/raw/main/otherfiles/help.gif">
+
+</div>
+
 ## Issues & Bug Reports			
 
 Just fill an issue and describe it. We'll check it ASAP!
@@ -225,6 +257,13 @@ 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.5] - 2025-02-14
+### Added
+- `--hide-date` argument
+- `--hide-timezone` argument
+- `--am-pm` argument
+### Changed
+- `README.md` updated
 ## [0.4] - 2025-01-18
 ### Added
 - Date
@@ -251,7 +290,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.4...dev
+[Unreleased]: https://github.com/sepandhaghighi/clox/compare/v0.5...dev
+[0.5]: https://github.com/sepandhaghighi/clox/compare/v0.4...v0.5
 [0.4]: https://github.com/sepandhaghighi/clox/compare/v0.3...v0.4
 [0.3]: https://github.com/sepandhaghighi/clox/compare/v0.2...v0.3
 [0.2]: https://github.com/sepandhaghighi/clox/compare/v0.1...v0.2

clox-0.5.dist-info/RECORD

@@ -0,0 +1,11 @@
+clox/__init__.py,sha256=gErclFSjUDschQpngWqOBGkBKt1jwd-Ww8B9iJmlU5s,108
+clox/__main__.py,sha256=9oJYc1WXu4ZMrjKny_2-4Cgu46-VWHuE9xOqD1iJY0E,109
+clox/functions.py,sha256=xjDIgkdSchyTO3vXAdKQFebP_j4bRicJ0GQo_C23SUw,5778
+clox/params.py,sha256=CCeBPUq-Dou4gRB0uwIs-iD3zEyER1QtxvsHxvseARg,1462
+clox-0.5.dist-info/AUTHORS.md,sha256=lmtnd18MnfgB57jdvfJbC0JHN3iARf2Ov4pY5kPGJC8,242
+clox-0.5.dist-info/LICENSE,sha256=WoAsqqZ_lNVBGdyxjwh7YnVNXKfOB-qYVrRhrn-e-_4,1072
+clox-0.5.dist-info/METADATA,sha256=MfTIhRcWGGnMn-7nb2Z_VbO2xSGpttx3vT_Q4MFReLI,8138
+clox-0.5.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+clox-0.5.dist-info/entry_points.txt,sha256=sP4Rmoe-DxYGjlF_Tld6nghbt_u-fK8h9ZUQFmO8TJs,45
+clox-0.5.dist-info/top_level.txt,sha256=5DxGH-4VNfYkM8vbfngObh6-jpFEoSW4M90EvDGfhSw,5
+clox-0.5.dist-info/RECORD,,

clox-0.4.dist-info/RECORD

@@ -1,11 +0,0 @@
-clox/__init__.py,sha256=gErclFSjUDschQpngWqOBGkBKt1jwd-Ww8B9iJmlU5s,108
-clox/__main__.py,sha256=9oJYc1WXu4ZMrjKny_2-4Cgu46-VWHuE9xOqD1iJY0E,109
-clox/functions.py,sha256=M_nQUhDj15fQMDg8kk8D0qE3NBhEzmCqYQOT_KwHNuI,4853
-clox/params.py,sha256=4pJUD1ni02oNE_hxIMF7d-PeVvfFlsfKY1Z5HjXKq9E,1340
-clox-0.4.dist-info/AUTHORS.md,sha256=lmtnd18MnfgB57jdvfJbC0JHN3iARf2Ov4pY5kPGJC8,242
-clox-0.4.dist-info/LICENSE,sha256=WoAsqqZ_lNVBGdyxjwh7YnVNXKfOB-qYVrRhrn-e-_4,1072
-clox-0.4.dist-info/METADATA,sha256=GI4KRV6m3peEREQOp6PEaPUb7caNVaz12WmmVsN3eNk,7504
-clox-0.4.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-clox-0.4.dist-info/entry_points.txt,sha256=sP4Rmoe-DxYGjlF_Tld6nghbt_u-fK8h9ZUQFmO8TJs,45
-clox-0.4.dist-info/top_level.txt,sha256=5DxGH-4VNfYkM8vbfngObh6-jpFEoSW4M90EvDGfhSw,5
-clox-0.4.dist-info/RECORD,,