timeleft 0.2

Description:

timeleft 0.2

Timeleft is a simple command line utility for displaying the amount of time left in a download. In the command line, one simply needs to input the file size remaining and the average download speed expected. Timeleft will output the time remaining in units that are easy to read.

Usage
$ timeleft 100MB 100MBps
1.0 second
$ timeleft 100MB 100mbps
8.0 seconds
$ timeleft 100MB 100mb/s
8.0 seconds
$ timeleft 100MB 1kbps
9.0 days, 11.0 hours, 33.0 minutes, 20.0 seconds
$ 3.4GB 3.4MBps
17.0 minutes, 4.0 seconds
$ timeleft 1.5YB 10gbps
28561641.0 years, 172.0 days, 10.0 hours, 21.0 minutes, 39.25 seconds
$ timeleft 100GB 100GBPS
1.0 second
As shown in the examples above, Timeleft can take a variety of inputs to produce a human-readable output.
Arguments can be input in any order: the only requirement for arguments is that one has file size units and the other has download speed units.


Features

Both bits and bytes are supported as file and speed units are supported (don’t let your ISP pull the wool over your eyes there). Accordingly, Timeleft is case-sensitive in that it distinguishes between B and b (i.e., 1MB = 8 Mb; all other characters should be case independent).
Speed units can take the format of B/s or Bps (e.g., both 1MBps and 1MB/s are accepted).
Sizes prefixes ranging from bits all the way up to yottabytes (280 bytes) are currently supported.
The output format only shows the largest unit necessary to display the time remaining (i.e., “0.0 minutes, 23.0 seconds” will never occur).



Dependencies
Timeleft is tested on Python 2.7 and 3.5 but should work on all versions 2.6 and above. There are no dependencies outside of the standard library. Testing (optionally included) is handled with Pytest.


Installation
To install Timeleft, simply:
$ pip install timeleft
Alternatively, if you would like to install from source:
$ pip install git+https://github.com/swareham/timeleft.git
Pip will automatically add the “timeleft” executable to your path and you will be ready to go!


Credits

Logic for powering Timeleft: Sean Wareham
Template for pip / setuptools support: Kenneth Reitz and all of the developers of requests at https://github.com/kennethreitz/requests


0.0.2 (2016-04-23)

First Public Release
Updated to use a module hierarchy
Added ability to install via pip
Updated error handling



0.0.1 (2015-06-29)

Original Implementation
Personal Utility
Unpublished