Script 'mail_helper' called by obssrc Hello community, here is the log from the commit of package python-pdd for openSUSE:Factory checked in at 2022-10-06 07:42:08 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Comparing /work/SRC/openSUSE:Factory/python-pdd (Old) and /work/SRC/openSUSE:Factory/.python-pdd.new.2275 (New) ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Package is "python-pdd" Thu Oct 6 07:42:08 2022 rev:5 rq:1008155 version:1.6 Changes: -------- --- /work/SRC/openSUSE:Factory/python-pdd/python-pdd.changes 2021-05-19 17:49:32.549493784 +0200 +++ /work/SRC/openSUSE:Factory/.python-pdd.new.2275/python-pdd.changes 2022-10-06 07:42:18.664701596 +0200 @@ -1,0 +2,8 @@ +Tue Oct 4 22:51:47 UTC 2022 - Yogalakshmi Arunachalam <yarunacha...@suse.com> + +- version update to v1.6 + * long variants for short program options + * completion scripts for Bash, Fish and Zsh + * add support for pyhton 3.10 (dropped 3.6) + +------------------------------------------------------------------- Old: ---- pdd-1.5.tar.gz New: ---- pdd-1.6.tar.gz ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Other differences: ------------------ ++++++ python-pdd.spec ++++++ --- /var/tmp/diff_new_pack.xpk10e/_old 2022-10-06 07:42:19.604703688 +0200 +++ /var/tmp/diff_new_pack.xpk10e/_new 2022-10-06 07:42:19.608703697 +0200 @@ -1,7 +1,7 @@ # # spec file for package python-pdd # -# Copyright (c) 2021 SUSE LLC +# Copyright (c) 2022 SUSE LLC # # All modifications and additions to the file contributed by third parties # remain the property of their copyright owners, unless otherwise agreed @@ -20,7 +20,7 @@ %define skip_python2 1 %{?!python_module:%define python_module() python-%{**} python3-%{**}} Name: python-pdd -Version: 1.5 +Version: 1.6 Release: 0 Summary: Tiny date, time diff calculator with timers License: GPL-3.0-only @@ -34,7 +34,7 @@ Requires: python-python-dateutil Requires: python-setuptools Requires(post): update-alternatives -Requires(postun): update-alternatives +Requires(postun):update-alternatives BuildArch: noarch # SECTION test requirements BuildRequires: %{python_module pytest} ++++++ pdd-1.5.tar.gz -> pdd-1.6.tar.gz ++++++ diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/pdd-1.5/CHANGELOG new/pdd-1.6/CHANGELOG --- old/pdd-1.5/CHANGELOG 2020-10-10 17:51:15.000000000 +0200 +++ new/pdd-1.6/CHANGELOG 2022-08-27 17:46:29.000000000 +0200 @@ -1,3 +1,12 @@ +pdd v1.6 +2022-08-27 + +- long variants for short program options +- completion scripts for Bash, Fish and Zsh +- add support for pyhton 3.10 (dropped 3.6) + +------------------------------------------------------------------------------- + pdd v1.5 2020-10-10 diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/pdd-1.5/PKG-INFO new/pdd-1.6/PKG-INFO --- old/pdd-1.5/PKG-INFO 2020-10-12 12:54:13.069662800 +0200 +++ new/pdd-1.6/PKG-INFO 2022-08-27 18:06:13.093867000 +0200 @@ -1,264 +1,11 @@ Metadata-Version: 2.1 Name: pdd -Version: 1.5 +Version: 1.6 Summary: Tiny date, time diff calculator with timers Home-page: https://github.com/jarun/pdd Author: Arun Prakash Jana Author-email: engineera...@gmail.com License: GPLv3 -Description: <h1 align="center">pdd</h1> - - <p align="center"> - <a href="https://github.com/jarun/pdd/releases/latest"><img src="https://img.shields.io/github/release/jarun/pdd.svg?maxAge=600" alt="Latest release" /></a> - <a href="https://repology.org/project/pdd/versions"><img src="https://repology.org/badge/tiny-repos/pdd.svg" alt="Availability"></a> - <a href="https://pypi.org/project/pdd/"><img src="https://img.shields.io/pypi/v/pdd.svg?maxAge=600" alt="PyPI" /></a> - <a href="https://circleci.com/gh/jarun/workflows/pdd"><img src="https://img.shields.io/circleci/project/github/jarun/pdd.svg" alt="Build Status" /></a> - <a href="https://github.com/jarun/pdd/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-GPLv3-yellowgreen.svg?maxAge=2592000" alt="License" /></a> - <a href="https://repl.it/github/jarun/pdd"><img src="https://repl.it/badge/github/jarun/pdd?maxAge=2592000" alt="Repl.it" /></a> - </p> - - <p align="center"> - <a href="https://asciinema.org/a/189581"><img src="https://asciinema.org/a/189581.png" alt="Asciicast" width="650"/></a> - </p> - - `pdd` (Python3 Date Diff) is a tiny command line utility to calculate date and time difference. It can also be used as a timer. If no program arguments are specified it shows the current date, time and timezone. - - `pdd` has been written with only one goal - simplicity. Users shouldn't have to memorize anything. - - *Love smart and efficient utilities? Explore [my repositories](https://github.com/jarun?tab=repositories). Buy me a cup of coffee if they help you.* - - <p align="center"> - <a href="https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=RMLTQ76JSXJ4Q"><img src="https://img.shields.io/badge/PayPal-donate-1eb0fc.svg" alt="Donate via PayPal!" /></a> - </p> - - ### Table of Contents - - - [Features](#features) - - [Installation](#installation) - - [Dependencies](#dependencies) - - [From a package manager](#from-a-package-manager) - - [Release packages](#release-packages) - - [From source](#from-source) - - [Running standalone](#running-standalone) - - [Usage](#usage) - - [cmdline options](#cmdline-options) - - [Operational notes](#operational-notes) - - [Examples](#examples) - - [Copyright](#copyright) - - ### Features - - - easy to use, minimal dependencies - - calculate date and time difference - - calculate diff from *today* and *now* - - add, subtract duration (timeslice) to/from date (time) - - countdown timer with command piggybacking - - custom resolution stopwatch - - non-verbose mode for background timers - - show current date, time and timezone - - follows ISO 8601 - - ### Installation - - #### Dependencies - - `pdd` requires Python 3.6 (or later) and the `dateutil` module. - - To install `dateutil` on Ubuntu, run: - - $ sudo apt-get install python3-dateutil - - or, using pip3: - - $ sudo pip3 install python-dateutil - - #### From a package manager - - Install `pdd` from your package manager. If the version available is dated try an alternative installation method. - - <details><summary>Packaging status (expand)</summary> - <p> - <br> - <a href="https://repology.org/project/pdd/versions"><img src="https://repology.org/badge/vertical-allrepos/pdd.svg" alt="Packaging status"></a> - </p> - Unlisted packagers: - <p> - <br> - ??? <a href="https://pypi.org/project/pdd/">PyPI</a> (<code>pip3 install pdd</code>)<br> - ??? Termux (<code>pip3 install pdd</code>)<br> - </p> - </details> - - #### Release packages - - Packages for Arch Linux, CentOS, Debian, Fedora and Ubuntu are available with the [latest stable release](https://github.com/jarun/pdd/releases/latest). - - #### From source - - If you have git installed, clone this repository. Otherwise download the latest [latest stable release](https://github.com/jarun/pdd/releases/latest) or [development version](https://github.com/jarun/pdd/archive/master.zip) (*risky*). - - Install to default location (`/usr/local`): - - $ sudo make install - - To remove, run: - - $ sudo make uninstall - - `PREFIX` is supported, in case you want to install to a different location. - - #### Running standalone - - `pdd` is a standalone utility. From the containing directory, run: - - $ chmod +x pdd - $ ./pdd - - ### Usage - - #### cmdline options - - ``` - usage: pdd [-h] [-d yyyy mmm dd [yyyy mmm dd | y m d]] - [-t hh:mm:ss [hh:mm:ss | h:m:s]] [--add] [--sub] - [--day yyyy mmm dd] [-c hh:mm:ss] [-r command] [-s [resolution]] - [-q] - [keywords [keywords ...]] - - Tiny date, time difference calculator with timers. - - positional arguments: - keywords diff/add/subtract from today or now - - optional arguments: - -h, --help show this help message and exit - -d yyyy mmm dd [yyyy mmm dd | y m d] - calculate date difference - -t hh:mm:ss [hh:mm:ss | h:m:s] - calculate time difference - --add add to date (/today) or time (/now) - --sub subtract from date (/today) or time (/now) - --day yyyy mmm dd show day of the week on a date - -c hh:mm:ss start a countdown timer - -r command run command when countdown timer reaches 0 - -s [resolution] start a stopwatch [default resolution: 3 (ms)] - -q quiet mode for background timer/stopwatch - ``` - - #### Operational notes - - - ISO 8601 format. Month can be specified as month number (e.g. Jan - 1, Dec - 12). - - Time is in 24-hr format. - - The absolute difference is shown. Argument order is ignored. - - The end date is excluded in date difference calculations. - - Hour, minute or second can be omitted. Partial inputs are recognized as `mm:ss` or `ss`. - - The keybind to stop timers is <kbd>Ctrl-C</kbd>. - - ### Examples - - 1. Calculate diff from **today**: - - $ pdd 2014 Jan 15 - 5y 2m 21d - 1906d - - 2. Calculate diff from **now**: - - $ pdd 24:00:00 - 15:24:03 - 55443s - - $ pdd 0 - 08:36:22 - 30982s - - 3. Calculate date diff: - - $ pdd -d 1983 jul 3 2014 1 15 - 30y 6m 12d - 11154d - - 4. Calculate time diff: - - $ pdd -t 45:50 6:17:33 - 05:31:43 - 19903s - - 5. Show current date, time and timezone: - - $ pdd - Fri 2019 Apr 5 08:37:25 IST - - 6. Specify time with roll-over: - - $ pdd -t 5:80:75 6:17:33 - 00:03:42 - 222s - - 7. Add a duration (3 years, 2 months, 1 day) to 28 Feb, 2000: - - $ pdd -d 2000 FEB 28 3 2 1 --add - Tue 2003 Apr 29 - - 8. Add a timeslice (1 hour 2 mins 3 secs) to 23:45:37: - - $ pdd -t 23:45:37 1:2:3 --add - 1 day(s) later, 00:47:40 - 89260s - - 9. Add a duration (3 years, 2 months, 1 day) to **today**: - - $ pdd 3 2 1 --add - Mon 2022 Jun 06 - - 10. Add a timeslice (1 hour 2 minutes 3 seconds) to **now**: - - $ pdd 1:2:3 --add - 09:41:26 - 34886s - - 11. Subtract a duration (1 day) from 1 Mar, 2000: - - $ pdd -d 2000 Mar 01 0 0 1 --sub - Tue 2000 Feb 29 - - 12. Subtract a timeslice (1 sec) from midnight: - - $ pdd -t 00:00:00 0:0:1 --sub - 1 day(s) earlier, 23:59:59 - -1s - - 13. Subtract a duration (3 years, 2 months, 1 day) from **today**: - - $ pdd 3 2 1 --sub - Thu 2016 Feb 04 - - 14. Subtract a timeslice (1 hour 2 minutes 3 seconds) from **now**: - - $ pdd 1:2:3 --sub - 07:40:02 - 27602s - - 15. Show the day of the week on 15 Jan 2014: - - $ pdd --day 2014 Jan 15 - Wed - - 16. Start a countdown timer or stopwatch in **quiet mode** in the background: - - $ pdd -qs & - $ pdd -qc 3:0:0 & - To see the final counter run `fg` and press <kbd>Ctrl-C</kbd>. - - 17. Run a command when countdown timer reaches 0 - - $ pdd -c 00:00:5 -r 'ps -aux' - $ pdd -c 00:00:5 -r 'notify-send pdd "timer expired"' - - ### Copyright - - Copyright ?? 2017 [Arun Prakash Jana](https://github.com/jarun) - Keywords: date time calculator timer Platform: any Classifier: Development Status :: 5 - Production/Stable @@ -270,12 +17,263 @@ Classifier: Operating System :: OS Independent Classifier: Programming Language :: Python :: 3 Classifier: Programming Language :: Python :: 3 :: Only -Classifier: Programming Language :: Python :: 3.6 Classifier: Programming Language :: Python :: 3.7 Classifier: Programming Language :: Python :: 3.8 Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 Classifier: Topic :: Utilities -Requires-Python: >=3.6 +Requires-Python: >=3.7 Description-Content-Type: text/markdown -Provides-Extra: packaging Provides-Extra: tests +Provides-Extra: packaging +License-File: LICENSE + +<h1 align="center">pdd</h1> + +<p align="center"> +<a href="https://github.com/jarun/pdd/releases/latest"><img src="https://img.shields.io/github/release/jarun/pdd.svg?maxAge=600" alt="Latest release" /></a> +<a href="https://repology.org/project/pdd/versions"><img src="https://repology.org/badge/tiny-repos/pdd.svg" alt="Availability"></a> +<a href="https://pypi.org/project/pdd/"><img src="https://img.shields.io/pypi/v/pdd.svg?maxAge=600" alt="PyPI" /></a> +<a href="https://circleci.com/gh/jarun/workflows/pdd"><img src="https://img.shields.io/circleci/project/github/jarun/pdd.svg" alt="Build Status" /></a> +<a href="https://github.com/jarun/pdd/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-GPLv3-yellowgreen.svg?maxAge=2592000" alt="License" /></a> +</p> + +<p align="center"> +<a href="https://asciinema.org/a/189581"><img src="https://asciinema.org/a/189581.svg" alt="Asciicast" width="650"/></a> +</p> + +`pdd` (Python3 Date Diff) is a tiny command line utility to calculate date and time difference. It can also be used as a timer. If no program arguments are specified it shows the current date, time and timezone. + +`pdd` has been written with only one goal - simplicity. Users shouldn't have to memorize anything. + +### Table of Contents + +- [Features](#features) +- [Installation](#installation) + - [Dependencies](#dependencies) + - [From a package manager](#from-a-package-manager) + - [Release packages](#release-packages) + - [From source](#from-source) + - [Running standalone](#running-standalone) +- [Usage](#usage) + - [cmdline options](#cmdline-options) + - [Operational notes](#operational-notes) +- [Examples](#examples) +- [Copyright](#copyright) + +### Features + +- easy to use, minimal dependencies +- calculate date and time difference +- calculate diff from *today* and *now* +- add, subtract duration (timeslice) to/from date (time) +- countdown timer with command piggybacking +- custom resolution stopwatch +- non-verbose mode for background timers +- show current date, time and timezone +- follows ISO 8601 + +### Installation + +#### Dependencies + +`pdd` requires Python 3.7 (or later) and the `dateutil` module. + +To install `dateutil` on Ubuntu, run: + + $ sudo apt-get install python3-dateutil + +or, using pip3: + + $ sudo pip3 install python-dateutil + +#### From a package manager + +Install `pdd` from your package manager. If the version available is dated try an alternative installation method. + +<details><summary>Packaging status (expand)</summary> +<p> +<br> +<a href="https://repology.org/project/pdd/versions"><img src="https://repology.org/badge/vertical-allrepos/pdd.svg" alt="Packaging status"></a> +</p> +Unlisted packagers: +<p> +<br> +??? <a href="https://pypi.org/project/pdd/">PyPI</a> (<code>pip3 install pdd</code>)<br> +??? Termux (<code>pip3 install pdd</code>)<br> +</p> +</details> + +#### Release packages + +Packages for Arch Linux, CentOS, Debian, Fedora and Ubuntu are available with the [latest stable release](https://github.com/jarun/pdd/releases/latest). + +#### From source + +If you have git installed, clone this repository. Otherwise download the latest [latest stable release](https://github.com/jarun/pdd/releases/latest) or [development version](https://github.com/jarun/pdd/archive/master.zip) (*risky*). + +Install to default location (`/usr/local`): + + $ sudo make install + +To remove, run: + + $ sudo make uninstall + +`PREFIX` is supported, in case you want to install to a different location. + +#### Running standalone + +`pdd` is a standalone utility. From the containing directory, run: + + $ chmod +x pdd + $ ./pdd + +### Usage + +#### cmdline options + +``` +usage: pdd [-h] [-d yyyy mmm dd [yyyy mmm dd | y m d]] + [-t hh:mm:ss [hh:mm:ss | h:m:s]] [--add] [--sub] + [--day yyyy mmm dd] [-c hh:mm:ss] [-r command] [-s [resolution]] [-q] + [keywords ...] + +Tiny date, time difference calculator with timers. + +positional arguments: + keywords diff/add/subtract from today or now + +options: + -h, --help show this help message and exit + -d yyyy mmm dd [yyyy mmm dd | y m d], --date yyyy mmm dd [yyyy mmm dd | y m d] + calculate date difference + -t hh:mm:ss [hh:mm:ss | h:m:s], --time hh:mm:ss [hh:mm:ss | h:m:s] + calculate time difference + --add add to date (/today) or time (/now) + --sub subtract from date (/today) or time (/now) + --day yyyy mmm dd show day of the week on a date + -c hh:mm:ss, --timer hh:mm:ss + start a countdown timer + -r command, --run command + run command when countdown timer reaches 0 + -s [resolution], --stopwatch [resolution] + start a stopwatch [default resolution: 3 (ms)] + -q, --quiet quiet mode for background timer/stopwatch +``` + +Completion scripts are available for Bash, Fish and Zsh shells. + +#### Operational notes + +- ISO 8601 format. Month can be specified as month number (e.g. Jan - 1, Dec - 12). +- Time is in 24-hr format. +- The absolute difference is shown. Argument order is ignored. +- The end date is excluded in date difference calculations. +- Hour, minute or second can be omitted. Partial inputs are recognized as `mm:ss` or `ss`. +- The keybind to stop timers is <kbd>Ctrl-C</kbd>. + +### Examples + +1. Calculate diff from **today**: + + $ pdd 2014 Jan 15 + 5y 2m 21d + 1906d + +2. Calculate diff from **now**: + + $ pdd 24:00:00 + 15:24:03 + 55443s + + $ pdd 0 + 08:36:22 + 30982s + +3. Calculate date diff: + + $ pdd -d 1983 jul 3 2014 1 15 + 30y 6m 12d + 11154d + +4. Calculate time diff: + + $ pdd -t 45:50 6:17:33 + 05:31:43 + 19903s + +5. Show current date, time and timezone: + + $ pdd + Fri 2019 Apr 5 08:37:25 IST + +6. Specify time with roll-over: + + $ pdd -t 5:80:75 6:17:33 + 00:03:42 + 222s + +7. Add a duration (3 years, 2 months, 1 day) to 28 Feb, 2000: + + $ pdd -d 2000 FEB 28 3 2 1 --add + Tue 2003 Apr 29 + +8. Add a timeslice (1 hour 2 mins 3 secs) to 23:45:37: + + $ pdd -t 23:45:37 1:2:3 --add + 1 day(s) later, 00:47:40 + 89260s + +9. Add a duration (3 years, 2 months, 1 day) to **today**: + + $ pdd 3 2 1 --add + Mon 2022 Jun 06 + +10. Add a timeslice (1 hour 2 minutes 3 seconds) to **now**: + + $ pdd 1:2:3 --add + 09:41:26 + 34886s + +11. Subtract a duration (1 day) from 1 Mar, 2000: + + $ pdd -d 2000 Mar 01 0 0 1 --sub + Tue 2000 Feb 29 + +12. Subtract a timeslice (1 sec) from midnight: + + $ pdd -t 00:00:00 0:0:1 --sub + 1 day(s) earlier, 23:59:59 + -1s + +13. Subtract a duration (3 years, 2 months, 1 day) from **today**: + + $ pdd 3 2 1 --sub + Thu 2016 Feb 04 + +14. Subtract a timeslice (1 hour 2 minutes 3 seconds) from **now**: + + $ pdd 1:2:3 --sub + 07:40:02 + 27602s + +15. Show the day of the week on 15 Jan 2014: + + $ pdd --day 2014 Jan 15 + Wed + +16. Start a countdown timer or stopwatch in **quiet mode** in the background: + + $ pdd -qs & + $ pdd -qc 3:0:0 & + To see the final counter run `fg` and press <kbd>Ctrl-C</kbd>. + +17. Run a command when countdown timer reaches 0 + + $ pdd -c 00:00:5 -r 'ps -aux' + $ pdd -c 00:00:5 -r 'notify-send pdd "timer expired"' + +### Copyright + +Copyright ?? 2017 [Arun Prakash Jana](https://github.com/jarun) diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/pdd-1.5/README.md new/pdd-1.6/README.md --- old/pdd-1.5/README.md 2020-10-10 17:34:27.000000000 +0200 +++ new/pdd-1.6/README.md 2022-08-26 16:15:58.000000000 +0200 @@ -6,23 +6,16 @@ <a href="https://pypi.org/project/pdd/"><img src="https://img.shields.io/pypi/v/pdd.svg?maxAge=600" alt="PyPI" /></a> <a href="https://circleci.com/gh/jarun/workflows/pdd"><img src="https://img.shields.io/circleci/project/github/jarun/pdd.svg" alt="Build Status" /></a> <a href="https://github.com/jarun/pdd/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-GPLv3-yellowgreen.svg?maxAge=2592000" alt="License" /></a> -<a href="https://repl.it/github/jarun/pdd"><img src="https://repl.it/badge/github/jarun/pdd?maxAge=2592000" alt="Repl.it" /></a> </p> <p align="center"> -<a href="https://asciinema.org/a/189581"><img src="https://asciinema.org/a/189581.png" alt="Asciicast" width="650"/></a> +<a href="https://asciinema.org/a/189581"><img src="https://asciinema.org/a/189581.svg" alt="Asciicast" width="650"/></a> </p> `pdd` (Python3 Date Diff) is a tiny command line utility to calculate date and time difference. It can also be used as a timer. If no program arguments are specified it shows the current date, time and timezone. `pdd` has been written with only one goal - simplicity. Users shouldn't have to memorize anything. -*Love smart and efficient utilities? Explore [my repositories](https://github.com/jarun?tab=repositories). Buy me a cup of coffee if they help you.* - -<p align="center"> -<a href="https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=RMLTQ76JSXJ4Q"><img src="https://img.shields.io/badge/PayPal-donate-1eb0fc.svg" alt="Donate via PayPal!" /></a> -</p> - ### Table of Contents - [Features](#features) @@ -54,7 +47,7 @@ #### Dependencies -`pdd` requires Python 3.6 (or later) and the `dateutil` module. +`pdd` requires Python 3.7 (or later) and the `dateutil` module. To install `dateutil` on Ubuntu, run: @@ -113,30 +106,34 @@ ``` usage: pdd [-h] [-d yyyy mmm dd [yyyy mmm dd | y m d]] [-t hh:mm:ss [hh:mm:ss | h:m:s]] [--add] [--sub] - [--day yyyy mmm dd] [-c hh:mm:ss] [-r command] [-s [resolution]] - [-q] - [keywords [keywords ...]] + [--day yyyy mmm dd] [-c hh:mm:ss] [-r command] [-s [resolution]] [-q] + [keywords ...] Tiny date, time difference calculator with timers. positional arguments: keywords diff/add/subtract from today or now -optional arguments: +options: -h, --help show this help message and exit - -d yyyy mmm dd [yyyy mmm dd | y m d] + -d yyyy mmm dd [yyyy mmm dd | y m d], --date yyyy mmm dd [yyyy mmm dd | y m d] calculate date difference - -t hh:mm:ss [hh:mm:ss | h:m:s] + -t hh:mm:ss [hh:mm:ss | h:m:s], --time hh:mm:ss [hh:mm:ss | h:m:s] calculate time difference --add add to date (/today) or time (/now) --sub subtract from date (/today) or time (/now) --day yyyy mmm dd show day of the week on a date - -c hh:mm:ss start a countdown timer - -r command run command when countdown timer reaches 0 - -s [resolution] start a stopwatch [default resolution: 3 (ms)] - -q quiet mode for background timer/stopwatch + -c hh:mm:ss, --timer hh:mm:ss + start a countdown timer + -r command, --run command + run command when countdown timer reaches 0 + -s [resolution], --stopwatch [resolution] + start a stopwatch [default resolution: 3 (ms)] + -q, --quiet quiet mode for background timer/stopwatch ``` +Completion scripts are available for Bash, Fish and Zsh shells. + #### Operational notes - ISO 8601 format. Month can be specified as month number (e.g. Jan - 1, Dec - 12). diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/pdd-1.5/pdd.egg-info/PKG-INFO new/pdd-1.6/pdd.egg-info/PKG-INFO --- old/pdd-1.5/pdd.egg-info/PKG-INFO 2020-10-12 12:54:12.000000000 +0200 +++ new/pdd-1.6/pdd.egg-info/PKG-INFO 2022-08-27 18:06:12.000000000 +0200 @@ -1,264 +1,11 @@ Metadata-Version: 2.1 Name: pdd -Version: 1.5 +Version: 1.6 Summary: Tiny date, time diff calculator with timers Home-page: https://github.com/jarun/pdd Author: Arun Prakash Jana Author-email: engineera...@gmail.com License: GPLv3 -Description: <h1 align="center">pdd</h1> - - <p align="center"> - <a href="https://github.com/jarun/pdd/releases/latest"><img src="https://img.shields.io/github/release/jarun/pdd.svg?maxAge=600" alt="Latest release" /></a> - <a href="https://repology.org/project/pdd/versions"><img src="https://repology.org/badge/tiny-repos/pdd.svg" alt="Availability"></a> - <a href="https://pypi.org/project/pdd/"><img src="https://img.shields.io/pypi/v/pdd.svg?maxAge=600" alt="PyPI" /></a> - <a href="https://circleci.com/gh/jarun/workflows/pdd"><img src="https://img.shields.io/circleci/project/github/jarun/pdd.svg" alt="Build Status" /></a> - <a href="https://github.com/jarun/pdd/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-GPLv3-yellowgreen.svg?maxAge=2592000" alt="License" /></a> - <a href="https://repl.it/github/jarun/pdd"><img src="https://repl.it/badge/github/jarun/pdd?maxAge=2592000" alt="Repl.it" /></a> - </p> - - <p align="center"> - <a href="https://asciinema.org/a/189581"><img src="https://asciinema.org/a/189581.png" alt="Asciicast" width="650"/></a> - </p> - - `pdd` (Python3 Date Diff) is a tiny command line utility to calculate date and time difference. It can also be used as a timer. If no program arguments are specified it shows the current date, time and timezone. - - `pdd` has been written with only one goal - simplicity. Users shouldn't have to memorize anything. - - *Love smart and efficient utilities? Explore [my repositories](https://github.com/jarun?tab=repositories). Buy me a cup of coffee if they help you.* - - <p align="center"> - <a href="https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=RMLTQ76JSXJ4Q"><img src="https://img.shields.io/badge/PayPal-donate-1eb0fc.svg" alt="Donate via PayPal!" /></a> - </p> - - ### Table of Contents - - - [Features](#features) - - [Installation](#installation) - - [Dependencies](#dependencies) - - [From a package manager](#from-a-package-manager) - - [Release packages](#release-packages) - - [From source](#from-source) - - [Running standalone](#running-standalone) - - [Usage](#usage) - - [cmdline options](#cmdline-options) - - [Operational notes](#operational-notes) - - [Examples](#examples) - - [Copyright](#copyright) - - ### Features - - - easy to use, minimal dependencies - - calculate date and time difference - - calculate diff from *today* and *now* - - add, subtract duration (timeslice) to/from date (time) - - countdown timer with command piggybacking - - custom resolution stopwatch - - non-verbose mode for background timers - - show current date, time and timezone - - follows ISO 8601 - - ### Installation - - #### Dependencies - - `pdd` requires Python 3.6 (or later) and the `dateutil` module. - - To install `dateutil` on Ubuntu, run: - - $ sudo apt-get install python3-dateutil - - or, using pip3: - - $ sudo pip3 install python-dateutil - - #### From a package manager - - Install `pdd` from your package manager. If the version available is dated try an alternative installation method. - - <details><summary>Packaging status (expand)</summary> - <p> - <br> - <a href="https://repology.org/project/pdd/versions"><img src="https://repology.org/badge/vertical-allrepos/pdd.svg" alt="Packaging status"></a> - </p> - Unlisted packagers: - <p> - <br> - ??? <a href="https://pypi.org/project/pdd/">PyPI</a> (<code>pip3 install pdd</code>)<br> - ??? Termux (<code>pip3 install pdd</code>)<br> - </p> - </details> - - #### Release packages - - Packages for Arch Linux, CentOS, Debian, Fedora and Ubuntu are available with the [latest stable release](https://github.com/jarun/pdd/releases/latest). - - #### From source - - If you have git installed, clone this repository. Otherwise download the latest [latest stable release](https://github.com/jarun/pdd/releases/latest) or [development version](https://github.com/jarun/pdd/archive/master.zip) (*risky*). - - Install to default location (`/usr/local`): - - $ sudo make install - - To remove, run: - - $ sudo make uninstall - - `PREFIX` is supported, in case you want to install to a different location. - - #### Running standalone - - `pdd` is a standalone utility. From the containing directory, run: - - $ chmod +x pdd - $ ./pdd - - ### Usage - - #### cmdline options - - ``` - usage: pdd [-h] [-d yyyy mmm dd [yyyy mmm dd | y m d]] - [-t hh:mm:ss [hh:mm:ss | h:m:s]] [--add] [--sub] - [--day yyyy mmm dd] [-c hh:mm:ss] [-r command] [-s [resolution]] - [-q] - [keywords [keywords ...]] - - Tiny date, time difference calculator with timers. - - positional arguments: - keywords diff/add/subtract from today or now - - optional arguments: - -h, --help show this help message and exit - -d yyyy mmm dd [yyyy mmm dd | y m d] - calculate date difference - -t hh:mm:ss [hh:mm:ss | h:m:s] - calculate time difference - --add add to date (/today) or time (/now) - --sub subtract from date (/today) or time (/now) - --day yyyy mmm dd show day of the week on a date - -c hh:mm:ss start a countdown timer - -r command run command when countdown timer reaches 0 - -s [resolution] start a stopwatch [default resolution: 3 (ms)] - -q quiet mode for background timer/stopwatch - ``` - - #### Operational notes - - - ISO 8601 format. Month can be specified as month number (e.g. Jan - 1, Dec - 12). - - Time is in 24-hr format. - - The absolute difference is shown. Argument order is ignored. - - The end date is excluded in date difference calculations. - - Hour, minute or second can be omitted. Partial inputs are recognized as `mm:ss` or `ss`. - - The keybind to stop timers is <kbd>Ctrl-C</kbd>. - - ### Examples - - 1. Calculate diff from **today**: - - $ pdd 2014 Jan 15 - 5y 2m 21d - 1906d - - 2. Calculate diff from **now**: - - $ pdd 24:00:00 - 15:24:03 - 55443s - - $ pdd 0 - 08:36:22 - 30982s - - 3. Calculate date diff: - - $ pdd -d 1983 jul 3 2014 1 15 - 30y 6m 12d - 11154d - - 4. Calculate time diff: - - $ pdd -t 45:50 6:17:33 - 05:31:43 - 19903s - - 5. Show current date, time and timezone: - - $ pdd - Fri 2019 Apr 5 08:37:25 IST - - 6. Specify time with roll-over: - - $ pdd -t 5:80:75 6:17:33 - 00:03:42 - 222s - - 7. Add a duration (3 years, 2 months, 1 day) to 28 Feb, 2000: - - $ pdd -d 2000 FEB 28 3 2 1 --add - Tue 2003 Apr 29 - - 8. Add a timeslice (1 hour 2 mins 3 secs) to 23:45:37: - - $ pdd -t 23:45:37 1:2:3 --add - 1 day(s) later, 00:47:40 - 89260s - - 9. Add a duration (3 years, 2 months, 1 day) to **today**: - - $ pdd 3 2 1 --add - Mon 2022 Jun 06 - - 10. Add a timeslice (1 hour 2 minutes 3 seconds) to **now**: - - $ pdd 1:2:3 --add - 09:41:26 - 34886s - - 11. Subtract a duration (1 day) from 1 Mar, 2000: - - $ pdd -d 2000 Mar 01 0 0 1 --sub - Tue 2000 Feb 29 - - 12. Subtract a timeslice (1 sec) from midnight: - - $ pdd -t 00:00:00 0:0:1 --sub - 1 day(s) earlier, 23:59:59 - -1s - - 13. Subtract a duration (3 years, 2 months, 1 day) from **today**: - - $ pdd 3 2 1 --sub - Thu 2016 Feb 04 - - 14. Subtract a timeslice (1 hour 2 minutes 3 seconds) from **now**: - - $ pdd 1:2:3 --sub - 07:40:02 - 27602s - - 15. Show the day of the week on 15 Jan 2014: - - $ pdd --day 2014 Jan 15 - Wed - - 16. Start a countdown timer or stopwatch in **quiet mode** in the background: - - $ pdd -qs & - $ pdd -qc 3:0:0 & - To see the final counter run `fg` and press <kbd>Ctrl-C</kbd>. - - 17. Run a command when countdown timer reaches 0 - - $ pdd -c 00:00:5 -r 'ps -aux' - $ pdd -c 00:00:5 -r 'notify-send pdd "timer expired"' - - ### Copyright - - Copyright ?? 2017 [Arun Prakash Jana](https://github.com/jarun) - Keywords: date time calculator timer Platform: any Classifier: Development Status :: 5 - Production/Stable @@ -270,12 +17,263 @@ Classifier: Operating System :: OS Independent Classifier: Programming Language :: Python :: 3 Classifier: Programming Language :: Python :: 3 :: Only -Classifier: Programming Language :: Python :: 3.6 Classifier: Programming Language :: Python :: 3.7 Classifier: Programming Language :: Python :: 3.8 Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 Classifier: Topic :: Utilities -Requires-Python: >=3.6 +Requires-Python: >=3.7 Description-Content-Type: text/markdown -Provides-Extra: packaging Provides-Extra: tests +Provides-Extra: packaging +License-File: LICENSE + +<h1 align="center">pdd</h1> + +<p align="center"> +<a href="https://github.com/jarun/pdd/releases/latest"><img src="https://img.shields.io/github/release/jarun/pdd.svg?maxAge=600" alt="Latest release" /></a> +<a href="https://repology.org/project/pdd/versions"><img src="https://repology.org/badge/tiny-repos/pdd.svg" alt="Availability"></a> +<a href="https://pypi.org/project/pdd/"><img src="https://img.shields.io/pypi/v/pdd.svg?maxAge=600" alt="PyPI" /></a> +<a href="https://circleci.com/gh/jarun/workflows/pdd"><img src="https://img.shields.io/circleci/project/github/jarun/pdd.svg" alt="Build Status" /></a> +<a href="https://github.com/jarun/pdd/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-GPLv3-yellowgreen.svg?maxAge=2592000" alt="License" /></a> +</p> + +<p align="center"> +<a href="https://asciinema.org/a/189581"><img src="https://asciinema.org/a/189581.svg" alt="Asciicast" width="650"/></a> +</p> + +`pdd` (Python3 Date Diff) is a tiny command line utility to calculate date and time difference. It can also be used as a timer. If no program arguments are specified it shows the current date, time and timezone. + +`pdd` has been written with only one goal - simplicity. Users shouldn't have to memorize anything. + +### Table of Contents + +- [Features](#features) +- [Installation](#installation) + - [Dependencies](#dependencies) + - [From a package manager](#from-a-package-manager) + - [Release packages](#release-packages) + - [From source](#from-source) + - [Running standalone](#running-standalone) +- [Usage](#usage) + - [cmdline options](#cmdline-options) + - [Operational notes](#operational-notes) +- [Examples](#examples) +- [Copyright](#copyright) + +### Features + +- easy to use, minimal dependencies +- calculate date and time difference +- calculate diff from *today* and *now* +- add, subtract duration (timeslice) to/from date (time) +- countdown timer with command piggybacking +- custom resolution stopwatch +- non-verbose mode for background timers +- show current date, time and timezone +- follows ISO 8601 + +### Installation + +#### Dependencies + +`pdd` requires Python 3.7 (or later) and the `dateutil` module. + +To install `dateutil` on Ubuntu, run: + + $ sudo apt-get install python3-dateutil + +or, using pip3: + + $ sudo pip3 install python-dateutil + +#### From a package manager + +Install `pdd` from your package manager. If the version available is dated try an alternative installation method. + +<details><summary>Packaging status (expand)</summary> +<p> +<br> +<a href="https://repology.org/project/pdd/versions"><img src="https://repology.org/badge/vertical-allrepos/pdd.svg" alt="Packaging status"></a> +</p> +Unlisted packagers: +<p> +<br> +??? <a href="https://pypi.org/project/pdd/">PyPI</a> (<code>pip3 install pdd</code>)<br> +??? Termux (<code>pip3 install pdd</code>)<br> +</p> +</details> + +#### Release packages + +Packages for Arch Linux, CentOS, Debian, Fedora and Ubuntu are available with the [latest stable release](https://github.com/jarun/pdd/releases/latest). + +#### From source + +If you have git installed, clone this repository. Otherwise download the latest [latest stable release](https://github.com/jarun/pdd/releases/latest) or [development version](https://github.com/jarun/pdd/archive/master.zip) (*risky*). + +Install to default location (`/usr/local`): + + $ sudo make install + +To remove, run: + + $ sudo make uninstall + +`PREFIX` is supported, in case you want to install to a different location. + +#### Running standalone + +`pdd` is a standalone utility. From the containing directory, run: + + $ chmod +x pdd + $ ./pdd + +### Usage + +#### cmdline options + +``` +usage: pdd [-h] [-d yyyy mmm dd [yyyy mmm dd | y m d]] + [-t hh:mm:ss [hh:mm:ss | h:m:s]] [--add] [--sub] + [--day yyyy mmm dd] [-c hh:mm:ss] [-r command] [-s [resolution]] [-q] + [keywords ...] + +Tiny date, time difference calculator with timers. + +positional arguments: + keywords diff/add/subtract from today or now + +options: + -h, --help show this help message and exit + -d yyyy mmm dd [yyyy mmm dd | y m d], --date yyyy mmm dd [yyyy mmm dd | y m d] + calculate date difference + -t hh:mm:ss [hh:mm:ss | h:m:s], --time hh:mm:ss [hh:mm:ss | h:m:s] + calculate time difference + --add add to date (/today) or time (/now) + --sub subtract from date (/today) or time (/now) + --day yyyy mmm dd show day of the week on a date + -c hh:mm:ss, --timer hh:mm:ss + start a countdown timer + -r command, --run command + run command when countdown timer reaches 0 + -s [resolution], --stopwatch [resolution] + start a stopwatch [default resolution: 3 (ms)] + -q, --quiet quiet mode for background timer/stopwatch +``` + +Completion scripts are available for Bash, Fish and Zsh shells. + +#### Operational notes + +- ISO 8601 format. Month can be specified as month number (e.g. Jan - 1, Dec - 12). +- Time is in 24-hr format. +- The absolute difference is shown. Argument order is ignored. +- The end date is excluded in date difference calculations. +- Hour, minute or second can be omitted. Partial inputs are recognized as `mm:ss` or `ss`. +- The keybind to stop timers is <kbd>Ctrl-C</kbd>. + +### Examples + +1. Calculate diff from **today**: + + $ pdd 2014 Jan 15 + 5y 2m 21d + 1906d + +2. Calculate diff from **now**: + + $ pdd 24:00:00 + 15:24:03 + 55443s + + $ pdd 0 + 08:36:22 + 30982s + +3. Calculate date diff: + + $ pdd -d 1983 jul 3 2014 1 15 + 30y 6m 12d + 11154d + +4. Calculate time diff: + + $ pdd -t 45:50 6:17:33 + 05:31:43 + 19903s + +5. Show current date, time and timezone: + + $ pdd + Fri 2019 Apr 5 08:37:25 IST + +6. Specify time with roll-over: + + $ pdd -t 5:80:75 6:17:33 + 00:03:42 + 222s + +7. Add a duration (3 years, 2 months, 1 day) to 28 Feb, 2000: + + $ pdd -d 2000 FEB 28 3 2 1 --add + Tue 2003 Apr 29 + +8. Add a timeslice (1 hour 2 mins 3 secs) to 23:45:37: + + $ pdd -t 23:45:37 1:2:3 --add + 1 day(s) later, 00:47:40 + 89260s + +9. Add a duration (3 years, 2 months, 1 day) to **today**: + + $ pdd 3 2 1 --add + Mon 2022 Jun 06 + +10. Add a timeslice (1 hour 2 minutes 3 seconds) to **now**: + + $ pdd 1:2:3 --add + 09:41:26 + 34886s + +11. Subtract a duration (1 day) from 1 Mar, 2000: + + $ pdd -d 2000 Mar 01 0 0 1 --sub + Tue 2000 Feb 29 + +12. Subtract a timeslice (1 sec) from midnight: + + $ pdd -t 00:00:00 0:0:1 --sub + 1 day(s) earlier, 23:59:59 + -1s + +13. Subtract a duration (3 years, 2 months, 1 day) from **today**: + + $ pdd 3 2 1 --sub + Thu 2016 Feb 04 + +14. Subtract a timeslice (1 hour 2 minutes 3 seconds) from **now**: + + $ pdd 1:2:3 --sub + 07:40:02 + 27602s + +15. Show the day of the week on 15 Jan 2014: + + $ pdd --day 2014 Jan 15 + Wed + +16. Start a countdown timer or stopwatch in **quiet mode** in the background: + + $ pdd -qs & + $ pdd -qc 3:0:0 & + To see the final counter run `fg` and press <kbd>Ctrl-C</kbd>. + +17. Run a command when countdown timer reaches 0 + + $ pdd -c 00:00:5 -r 'ps -aux' + $ pdd -c 00:00:5 -r 'notify-send pdd "timer expired"' + +### Copyright + +Copyright ?? 2017 [Arun Prakash Jana](https://github.com/jarun) diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/pdd-1.5/pdd.egg-info/entry_points.txt new/pdd-1.6/pdd.egg-info/entry_points.txt --- old/pdd-1.5/pdd.egg-info/entry_points.txt 2020-10-12 12:54:12.000000000 +0200 +++ new/pdd-1.6/pdd.egg-info/entry_points.txt 2022-08-27 18:06:12.000000000 +0200 @@ -1,3 +1,2 @@ [console_scripts] pdd = pdd:main - diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/pdd-1.5/pdd.py new/pdd-1.6/pdd.py --- old/pdd-1.5/pdd.py 2020-10-12 12:54:12.000000000 +0200 +++ new/pdd-1.6/pdd.py 2022-08-27 18:06:12.000000000 +0200 @@ -39,7 +39,7 @@ monthdict = {name.lower(): num for num, name in enumerate(cal.month_abbr) if num} -_VERSION_ = '1.5' # current program version +_VERSION_ = '1.6' # current program version def is_int(arg): @@ -303,7 +303,7 @@ else: showtimediff(t0, secs) else: - print('keywords can be [dd mmm yyyy] OR [hh:mm:ss]') + print('keywords can be [yyyy mmm dd] OR [hh:mm:ss]') def run_countdown_timer(args): @@ -389,27 +389,21 @@ self.print_extended_help(file) -def parse_args(args=None, namespace=None): - '''Parse arguments/options. - Parameters - ---------- - args : list, optional - Arguments to parse. Default is ``sys.argv``. - namespace : argparse.Namespace - Namespace to write to. Default is a new namespace. +def get_parser(): + '''Get parser. Returns ------- - argparse.Namespace - Namespace with parsed arguments / options. + argparse.ArgumentParser + Parser with arguments / options. ''' argparser = ExtendedArgumentParser( description='Tiny date, time difference calculator with timers.') addarg = argparser.add_argument - addarg('-d', dest='date', nargs=6, + addarg('-d', '--date', dest='date', nargs=6, metavar=('yyyy', 'mmm', 'dd', '[yyyy', 'mmm', 'dd | y m d]'), help='calculate date difference') - addarg('-t', dest='time', nargs=2, + addarg('-t', '--time', dest='time', nargs=2, metavar=('hh:mm:ss', '[hh:mm:ss | h:m:s]'), help='calculate time difference') addarg('--add', action='store_true', @@ -418,26 +412,26 @@ help='subtract from date (/today) or time (/now)') addarg('--day', nargs=3, metavar=('yyyy', 'mmm', 'dd'), help='show day of the week on a date') - addarg('-c', dest='timer', nargs=1, metavar=('hh:mm:ss'), + addarg('-c', '--timer', dest='timer', nargs=1, metavar=('hh:mm:ss'), help='start a countdown timer') - addarg('-r', dest='run', nargs=1, metavar=('command'), + addarg('-r', '--run', dest='run', nargs=1, metavar=('command'), help='run command when countdown timer reaches 0') - addarg('-s', dest='stopwatch', nargs='?', type=int, const=3, choices=range(1, 10), + addarg('-s', '--stopwatch', dest='stopwatch', nargs='?', type=int, const=3, choices=range(1, 10), metavar=('resolution'), help='start a stopwatch [default resolution: 3 (ms)]') - addarg('-q', dest='quiet', action='store_true', + addarg('-q', '--quiet', dest='quiet', action='store_true', help='quiet mode for background timer/stopwatch') addarg('keywords', nargs='*', help='diff/add/subtract from today or now') + return argparser + + +def main(): # Show `date` and exit if no arguments if len(sys.argv) < 2: showdate() sys.exit(0) - return argparser.parse_args(args, namespace) - - -def main(): - args = parse_args() + args = get_parser().parse_args() if args.add and args.sub: print('error: cannot add and subtract simultaneously') diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/pdd-1.5/setup.py new/pdd-1.6/setup.py --- old/pdd-1.5/setup.py 2020-10-10 17:34:00.000000000 +0200 +++ new/pdd-1.6/setup.py 2022-07-03 19:18:23.000000000 +0200 @@ -26,7 +26,7 @@ author_email='engineera...@gmail.com', url='https://github.com/jarun/pdd', license='GPLv3', - python_requires='>=3.6', # requires pip>=9.0.0 + python_requires='>=3.7', # requires pip>=9.0.0 platforms=['any'], py_modules=['pdd'], install_requires=['python-dateutil'], @@ -51,10 +51,10 @@ 'Operating System :: OS Independent', 'Programming Language :: Python :: 3', 'Programming Language :: Python :: 3 :: Only', - 'Programming Language :: Python :: 3.6', 'Programming Language :: Python :: 3.7', 'Programming Language :: Python :: 3.8', 'Programming Language :: Python :: 3.9', + 'Programming Language :: Python :: 3.10', 'Topic :: Utilities' ] )