mytimer 2.1__tar.gz → 2.3__tar.gz

{mytimer-2.1 → mytimer-2.3}/CHANGELOG.md

@@ -5,6 +5,27 @@ 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]
+## [2.3] - 2025-07-17
+### Added
+- 2 new programs
+	1. `eye-break`
+	2. `power-nap`
+- Start time
+### Changed
+- `README.md` updated
+- Python typing features added to all modules
+- `print_date_time` function modified
+- Test system modified
+- `Python 3.6` support dropped
+## [2.2] - 2025-03-13
+### Added
+- `--date-system` argument
+### Changed
+- `README.md` updated
+- Test system modified
+- `countdown_timer` and `countup_timer` functions updated
+- String templates modified
+- Input case sensitivity bug fixed
 ## [2.1] - 2025-02-28
 ### Added
 - 4 new tones
@@ -209,7 +230,9 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - Count-up mode
 - Alarm
 
-[Unreleased]: https://github.com/sepandhaghighi/mytimer/compare/v2.1...dev
+[Unreleased]: https://github.com/sepandhaghighi/mytimer/compare/v2.3...dev
+[2.3]: https://github.com/sepandhaghighi/mytimer/compare/v2.2...v2.3
+[2.2]: https://github.com/sepandhaghighi/mytimer/compare/v2.1...v2.2
 [2.1]: https://github.com/sepandhaghighi/mytimer/compare/v2.0...v2.1
 [2.0]: https://github.com/sepandhaghighi/mytimer/compare/v1.9...v2.0
 [1.9]: https://github.com/sepandhaghighi/mytimer/compare/v1.8...v1.9

{mytimer-2.1 → mytimer-2.3}/PKG-INFO

@@ -1,9 +1,9 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: mytimer
-Version: 2.1
+Version: 2.3
 Summary: A Geeky Timer for Terminal Enthusiasts
 Home-page: https://github.com/sepandhaghighi/mytimer
-Download-URL: https://github.com/sepandhaghighi/mytimer/tarball/v2.1
+Download-URL: https://github.com/sepandhaghighi/mytimer/tarball/v2.3
 Author: Sepand Haghighi
 Author-email: me@sepand.tech
 License: MIT
@@ -13,7 +13,6 @@ Classifier: Development Status :: 5 - Production/Stable
 Classifier: Natural Language :: English
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3.6
 Classifier: Programming Language :: Python :: 3.7
 Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
@@ -27,11 +26,12 @@ Classifier: Intended Audience :: End Users/Desktop
 Classifier: Intended Audience :: Other Audience
 Classifier: Topic :: Games/Entertainment
 Classifier: Topic :: Utilities
-Requires-Python: >=3.6
+Requires-Python: >=3.7
 Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: AUTHORS.md
 Requires-Dist: art>=5.3
+Requires-Dist: jdatetime>=3.8.2
 Requires-Dist: nava>=0.4
 Dynamic: author
 Dynamic: author-email
@@ -42,6 +42,7 @@ Dynamic: download-url
 Dynamic: home-page
 Dynamic: keywords
 Dynamic: license
+Dynamic: license-file
 Dynamic: project-url
 Dynamic: requires-dist
 Dynamic: requires-python
@@ -96,8 +97,7 @@ The main objective of <strong>MyTimer</strong> is to offer a minimalistic and di
 	<tr> 
 		<td align="center">Code Quality</td>
 		<td align="center"><a href="https://www.codefactor.io/repository/github/sepandhaghighi/mytimer"><img src="https://www.codefactor.io/repository/github/sepandhaghighi/mytimer/badge" alt="CodeFactor" /></a></td>
-		<td align="center"><a href="https://www.codacy.com/gh/sepandhaghighi/mytimer/dashboard?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=sepandhaghighi/mytimer&amp;utm_campaign=Badge_Grade"><img src="https://app.codacy.com/project/badge/Grade/1bf28500431a498998ac79891cd79cda"/></a></td>
-		<td align="center"><a href="https://codebeat.co/projects/github-com-sepandhaghighi-mytimer-main"><img alt="codebeat badge" src="https://codebeat.co/badges/ae1c0ac1-9890-4149-b260-b1f3174ef520" /></a></td>
+		<td><a href="https://app.codacy.com/gh/sepandhaghighi/mytimer/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade"><img src="https://app.codacy.com/project/badge/Grade/1bf28500431a498998ac79891cd79cda"/></a></td>
 	</tr>
 </table>
 
@@ -105,13 +105,13 @@ The main objective of <strong>MyTimer</strong> is to offer a minimalistic and di
 ## Installation		
 
 ### Source Code
-- Download [Version 2.1](https://github.com/sepandhaghighi/mytimer/archive/v2.1.zip) or [Latest Source](https://github.com/sepandhaghighi/mytimer/archive/dev.zip)
+- Download [Version 2.3](https://github.com/sepandhaghighi/mytimer/archive/v2.3.zip) or [Latest Source](https://github.com/sepandhaghighi/mytimer/archive/dev.zip)
 - `pip install .`				
 
 ### PyPI
 
 - Check [Python Packaging User Guide](https://packaging.python.org/installing/)     
-- `pip install mytimer==2.1`						
+- `pip install mytimer==2.3`						
 
 
 ## Usage
@@ -247,6 +247,16 @@ In this mode, the date/time will not be shown
 mytimer --minute=20 --hide-datetime
 ```
 
+### Date System
+
+ℹ️ Valid choices: [`gregorian`, `jalali`]
+
+ℹ️ The default date system is `gregorian`
+
+```console
+mytimer --minute=20 --date-system=jalali
+```
+
 ### Vertical Mode
 
 ```console
@@ -257,7 +267,7 @@ mytimer --minute=5 --vertical
 
 ⚠️ Local time
 
-In this mode, the timer sets on the given time. For example, here we set a timer for `15:05`.
+In this mode, the timer sets on the given time. For example, here we set a timer for `15:05`:
 
 ```console
 mytimer --hour=15 --minute=5 --set-on
@@ -353,7 +363,7 @@ GALPOLPISRHIYHLQER2TLJRGUSZH52RYDK6C3HIU4PSMNAV65Q36EGNL
 zil1knmz8zj88cf0exr2ry7nav9elehxfcgqu3c5e5
 <h4>Coffeete</h4>
 <a href="http://www.coffeete.ir/opensource">
-<img src="http://www.coffeete.ir/images/buttons/lemonchiffon.png" style="width:260px;" />
+<img src="http://www.coffeete.ir/images/buttons/lemonchiffon.png" style="width:260px;">
 </a>
 
 
@@ -364,6 +374,27 @@ 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]
+## [2.3] - 2025-07-17
+### Added
+- 2 new programs
+	1. `eye-break`
+	2. `power-nap`
+- Start time
+### Changed
+- `README.md` updated
+- Python typing features added to all modules
+- `print_date_time` function modified
+- Test system modified
+- `Python 3.6` support dropped
+## [2.2] - 2025-03-13
+### Added
+- `--date-system` argument
+### Changed
+- `README.md` updated
+- Test system modified
+- `countdown_timer` and `countup_timer` functions updated
+- String templates modified
+- Input case sensitivity bug fixed
 ## [2.1] - 2025-02-28
 ### Added
 - 4 new tones
@@ -568,7 +599,9 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - Count-up mode
 - Alarm
 
-[Unreleased]: https://github.com/sepandhaghighi/mytimer/compare/v2.1...dev
+[Unreleased]: https://github.com/sepandhaghighi/mytimer/compare/v2.3...dev
+[2.3]: https://github.com/sepandhaghighi/mytimer/compare/v2.2...v2.3
+[2.2]: https://github.com/sepandhaghighi/mytimer/compare/v2.1...v2.2
 [2.1]: https://github.com/sepandhaghighi/mytimer/compare/v2.0...v2.1
 [2.0]: https://github.com/sepandhaghighi/mytimer/compare/v1.9...v2.0
 [1.9]: https://github.com/sepandhaghighi/mytimer/compare/v1.8...v1.9

{mytimer-2.1 → mytimer-2.3}/PROGRAMS.md

@@ -1,6 +1,6 @@
 # Programs List
 
-**Last Update: 2025-01-25**
+**Last Update: 2025-05-22**
 
 ⚠️ By default, the **alarm** is **active** for all programs
 
@@ -131,6 +131,12 @@
 		<td>00:25:00</td>
 		<td>>=0.9</td>
 	</tr>
+	<tr align="center">
+		<td>Eye break</td>
+		<td><code>eye-break</code></td>
+		<td>00:02:00</td>
+		<td>>=2.3</td>
+	</tr>
 	<tr align="center">
 		<td>Short break</td>
 		<td><code>short-break</code></td>
@@ -155,6 +161,12 @@
 		<td>00:30:00</td>
 		<td>>=0.9</td>
 	</tr>
+	<tr align="center">
+		<td>Power nap</td>
+		<td><code>power-nap</code></td>
+		<td>00:20:00</td>
+		<td>>=2.3</td>
+	</tr>
 	<tr align="center">
 		<td>Meditation</td>
 		<td><code>meditation</code></td>

{mytimer-2.1 → mytimer-2.3}/README.md

@@ -46,8 +46,7 @@ The main objective of <strong>MyTimer</strong> is to offer a minimalistic and di
 	<tr> 
 		<td align="center">Code Quality</td>
 		<td align="center"><a href="https://www.codefactor.io/repository/github/sepandhaghighi/mytimer"><img src="https://www.codefactor.io/repository/github/sepandhaghighi/mytimer/badge" alt="CodeFactor" /></a></td>
-		<td align="center"><a href="https://www.codacy.com/gh/sepandhaghighi/mytimer/dashboard?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=sepandhaghighi/mytimer&amp;utm_campaign=Badge_Grade"><img src="https://app.codacy.com/project/badge/Grade/1bf28500431a498998ac79891cd79cda"/></a></td>
-		<td align="center"><a href="https://codebeat.co/projects/github-com-sepandhaghighi-mytimer-main"><img alt="codebeat badge" src="https://codebeat.co/badges/ae1c0ac1-9890-4149-b260-b1f3174ef520" /></a></td>
+		<td><a href="https://app.codacy.com/gh/sepandhaghighi/mytimer/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade"><img src="https://app.codacy.com/project/badge/Grade/1bf28500431a498998ac79891cd79cda"/></a></td>
 	</tr>
 </table>
 
@@ -55,13 +54,13 @@ The main objective of <strong>MyTimer</strong> is to offer a minimalistic and di
 ## Installation		
 
 ### Source Code
-- Download [Version 2.1](https://github.com/sepandhaghighi/mytimer/archive/v2.1.zip) or [Latest Source](https://github.com/sepandhaghighi/mytimer/archive/dev.zip)
+- Download [Version 2.3](https://github.com/sepandhaghighi/mytimer/archive/v2.3.zip) or [Latest Source](https://github.com/sepandhaghighi/mytimer/archive/dev.zip)
 - `pip install .`				
 
 ### PyPI
 
 - Check [Python Packaging User Guide](https://packaging.python.org/installing/)     
-- `pip install mytimer==2.1`						
+- `pip install mytimer==2.3`						
 
 
 ## Usage
@@ -197,6 +196,16 @@ In this mode, the date/time will not be shown
 mytimer --minute=20 --hide-datetime
 ```
 
+### Date System
+
+ℹ️ Valid choices: [`gregorian`, `jalali`]
+
+ℹ️ The default date system is `gregorian`
+
+```console
+mytimer --minute=20 --date-system=jalali
+```
+
 ### Vertical Mode
 
 ```console
@@ -207,7 +216,7 @@ mytimer --minute=5 --vertical
 
 ⚠️ Local time
 
-In this mode, the timer sets on the given time. For example, here we set a timer for `15:05`.
+In this mode, the timer sets on the given time. For example, here we set a timer for `15:05`:
 
 ```console
 mytimer --hour=15 --minute=5 --set-on
@@ -303,6 +312,6 @@ GALPOLPISRHIYHLQER2TLJRGUSZH52RYDK6C3HIU4PSMNAV65Q36EGNL
 zil1knmz8zj88cf0exr2ry7nav9elehxfcgqu3c5e5
 <h4>Coffeete</h4>
 <a href="http://www.coffeete.ir/opensource">
-<img src="http://www.coffeete.ir/images/buttons/lemonchiffon.png" style="width:260px;" />
+<img src="http://www.coffeete.ir/images/buttons/lemonchiffon.png" style="width:260px;">
 </a>
 

{mytimer-2.1 → mytimer-2.3}/SECURITY.md

@@ -4,8 +4,8 @@
 
 | Version       | Supported          |
 | ------------- | ------------------ |
-| 2.1           | :white_check_mark: |
-| < 2.1         | :x:                |
+| 2.3           | :white_check_mark: |
+| < 2.3         | :x:                |
 
 ## Reporting a Vulnerability
 

{mytimer-2.1 → mytimer-2.3}/dev-requirements.txt

@@ -1,5 +1,6 @@
 nava==0.7
-art==6.4
+art==6.5
+jdatetime==5.2.0
 setuptools>=40.8.0
 vulture>=1.0
 bandit>=1.5.1

{mytimer-2.1 → mytimer-2.3}/mytimer/__main__.py

@@ -2,16 +2,13 @@
 """mytimer main."""
 from mytimer.params import FACES_LIST, PROGRAMS_MAP, TONES_LIST
 from mytimer.params import EXIT_MESSAGE, ADDITIONAL_INFO, SIGNS_LIST
+from mytimer.params import DATE_SYSTEMS_LIST
 from mytimer.functions import run_timer
 import argparse
 
 
-def main():
-    """
-    CLI main function.
-
-    :return: None
-    """
+def main() -> None:
+    """CLI main function."""
     parser = argparse.ArgumentParser()
     parser.epilog = ADDITIONAL_INFO
     parser.add_argument('--minute', help='minute', type=int)
@@ -31,7 +28,7 @@ def main():
     parser.add_argument(
         '--program',
         help='program',
-        type=str,
+        type=str.lower,
         choices=sorted(PROGRAMS_MAP))
     parser.add_argument(
         '--sign',
@@ -58,6 +55,12 @@ def main():
     parser.add_argument('--hide-second', help='hide second', nargs="?", const=1)
     parser.add_argument('--hide-datetime', help='hide datetime', nargs="?", const=1)
     parser.add_argument('--vertical', help='vertical mode', nargs="?", const=1)
+    parser.add_argument(
+        '--date-system',
+        help='date system',
+        type=str.lower,
+        choices=DATE_SYSTEMS_LIST,
+        default="gregorian")
     parser.add_argument(
         '--programs-list',
         help='programs list',