Metadata-Version: 1.1
Name: fr
Version: 1.14
Summary: A command-line tool to print free resources in delicious flavors.
Home-page: https://bitbucket.org/mixmastamyk/fr
Author: Mike Miller
Author-email: mixmastamyk@bitbucket.org
License: GPLv3
Download-URL: https://bitbucket.org/mixmastamyk/fr/get/default.tar.gz
Description: 
        fr - Free Resource Printer
        ==========================
        
        ``fr`` is a command-line tool to print free resources in delicious
        flavors.
        ``fr`` is to ``free`` as ``htop`` is to ``top``.
        
        It was written because of unhappiness with the bare-bones, hard-to-read
        ``free`` command.
        I wanted something a bit more... graphical.
        Instead of this::
        
                         total       used       free     shared    buffers     cached
            Mem:       4045216    2159764    1885452          0     192404     942944
            -/+ buffers/cache:    1024416    3020800
            Swap:            0          0          0
        
        You'll see something like this::
        
            Free Resources in Blocks of 1 Megabyte (1,000,000 bytes)
        
            DEVICE   VOLUME    CAPACITY       USED       FREE                 MOUNT CACHE
            RAM                   4,142      1,421      1,461  ▉▉▉▉▉▉▉░░░░░░▏       1,261
            SWAP                      0
        
            sda1     Ubuntu      18,617      7,000     10,671  ▉▉▉▉░░░░░░░░░▏ /
            sda5     Data        88,107     85,218      2,889  ▉▉▉▉▉▉▉▉▉▉▉▉░▏ /media/Data
            sr0      PREDATOR    45,206     45,206          0  ▉▉▉▉▉▉▉▉▉▉▉▉▉▏ /media/PREDATOR
        
        
        ... in fruity colors.
        Yes, colors can be turned off, units chosen, etc.
        ``fr`` has been tested on Ubuntu (Natty-Saucy), CentOS 6, Windows (XP, 7),
        and Mac OS X (10.7.5) so far.
        
        |
        
        Install
        ------------
        
        You'll need `pip <http://www.pip-installer.org/en/latest/index.html>`_,
        but not virtualenv.
        
        Linux
        ~~~~~~~~~
        
        Need ``pip``?  On Ubuntu::
        
            sudo apt-get install python-pip
        
        For Red Hat: ``s/apt-get/yum/``.
        Or follow the
        `manual instructions <http://stackoverflow.com/a/12234724/450917>`_.
        
        Next, run this::
        
            sudo pip install fr
        
        If you'd like the development version instead::
        
            sudo pip install https://bitbucket.org/mixmastamyk/fr/get/default.zip
        
        As Udisks is not installed by default on Precise Server (and possibly others),
        it can be installed if you'd like to print volume labels::
        
            sudo apt-get install udisks
        
        |
        
        Windows
        ~~~~~~~~~
        
        After eight years this script finally supports Windows.  ;)
        
        Need ``pip``?
        Instructions for
        `installing on Windows <http://stackoverflow.com/a/14407505/450917>`_.
        Put ``"%ProgramFiles%\PythonXX\Scripts"`` in your ``PATH``.
        
        Next, run these as Admin::
        
            pip install colorama        # want color?
            pip install fr[win]         # installs necessary winstats
        
        I've given up on Unicode icons (for now) on the Windows console and went back
        to cp437 for that old-timey DOS feel.
        Perhaps it should print out "conventional/high" memory too.
        
        |
        
        Mac OS X
        ~~~~~~~~~
        
        Yes, it supports that too::
        
            sudo pip install -U fr
        
        And off you go.
        
        
        |
        
        Use
        ------------
        
        
        Run it ;)
        
        ::
        
            fr
        
        And of course there are a number of options::
        
            fr -h
        
        Note:  Output will be in a compact format unless the width of the console
        is at least 90 characters.
        Give it more and it will expand to fill available space.
        
        |
        
        License
        ~~~~~~~~~
        
        Licensed under the `GPL, version 3+ <http://www.gnu.org/licenses/gpl.html>`_.
        
        |
        
        Release Notes
        ~~~~~~~~~~~~~~~
        
        - 1.14 - Fix: cache colors differed on 256 colors.
        - 1.12 - Darwin: fix subprocess call.
        - 1.11 - Darwin: support TERM=xterm.
        - 1.10 - Now supports Mac OS X (aka "Darwin")
        - 1.01 - Handle negative swap size on WinXP, swap numbers unreliable. :/
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: Microsoft :: Windows :: Windows 7
Classifier: Operating System :: Microsoft :: Windows :: Windows XP
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Topic :: System :: Hardware
Classifier: Topic :: System :: Monitoring
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Utilities
