File Explorer

1# Copyright (C) 2013-2016 Red Hat, Inc.2#3# This copyrighted material is made available to anyone wishing to use,4# modify, copy, or redistribute it subject to the terms and conditions of5# the GNU General Public License v.2, or (at your option) any later version.6# This program is distributed in the hope that it will be useful, but WITHOUT7# ANY WARRANTY expressed or implied, including the implied warranties of8# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General9# Public License for more details.  You should have received a copy of the10# GNU General Public License along with this program; if not, write to the11# Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA12# 02110-1301, USA.  Any Red Hat trademarks that are incorporated in the13# source code or documentation are not subject to the GNU General Public14# License and may only be used or replicated with the express permission of15# Red Hat, Inc.16 17from __future__ import unicode_literals18from dnf.pycomp import long19 20def format_number(number, SI=0, space=' '):21    """Return a human-readable metric-like string representation22    of a number.23 24    :param number: the number to be converted to a human-readable form25    :param SI: If is 0, this function will use the convention26       that 1 kilobyte = 1024 bytes, otherwise, the convention27       that 1 kilobyte = 1000 bytes will be used28    :param space: string that will be placed between the number29       and the SI prefix30    :return: a human-readable metric-like string representation of31       *number*32    """33 34    # copied from from urlgrabber.progress35    symbols = [ ' ', # (none)36                'k', # kilo37                'M', # mega38                'G', # giga39                'T', # tera40                'P', # peta41                'E', # exa42                'Z', # zetta43                'Y'] # yotta44 45    if SI: step = 1000.046    else: step = 1024.047 48    thresh = 99949    depth = 050    max_depth = len(symbols) - 151 52    if number is None:53        number = 0.054 55    # we want numbers between 0 and thresh, but don't exceed the length56    # of our list.  In that event, the formatting will be screwed up,57    # but it'll still show the right number.58    while number > thresh and depth < max_depth:59        depth  = depth + 160        number = number / step61 62    if isinstance(number, int) or isinstance(number, long):63        format = '%i%s%s'64    elif number < 9.95:65        # must use 9.95 for proper sizing.  For example, 9.99 will be66        # rounded to 10.0 with the .1f format string (which is too long)67        format = '%.1f%s%s'68    else:69        format = '%.0f%s%s'70 71    return(format % (float(number or 0), space, symbols[depth]))72 73def format_time(seconds, use_hours=0):74    """Return a human-readable string representation of a number75    of seconds.  The string will show seconds, minutes, and76    optionally hours.77 78    :param seconds: the number of seconds to convert to a79       human-readable form80    :param use_hours: If use_hours is 0, the representation will81       be in minutes and seconds. Otherwise, it will be in hours,82       minutes, and seconds83    :return: a human-readable string representation of *seconds*84    """85 86    # copied from from urlgrabber.progress87    if seconds is None or seconds < 0:88        if use_hours: return '--:--:--'89        else:         return '--:--'90    elif seconds == float('inf'):91        return 'Infinite'92    else:93        seconds = int(seconds)94        minutes = seconds // 6095        seconds = seconds % 6096        if use_hours:97            hours = minutes // 6098            minutes = minutes % 6099            return '%02i:%02i:%02i' % (hours, minutes, seconds)100        else:101            return '%02i:%02i' % (minutes, seconds)102 103def indent_block(s):104    return '\n'.join('  ' + s for s in s.splitlines())105