Metadata-Version: 2.1
Name: colorls
Version: 1.1.1
Summary: c*ls commands that use colour and pipe output to less, with a sensible prompt
Home-page: https://github.com/unixnut/cls
Author: Alastair Irvine
Author-email: alastair@plug.org.au
License: GNU General Public License v2
Keywords: cls,ls,less,colour,color
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Environment :: Console
Classifier: Topic :: Utilities
Classifier: Operating System :: POSIX :: Linux
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Unix Shell
Requires-Python: >=3.4
Description-Content-Type: text/markdown
Requires-Dist: colored (~=1.4.3)

`c*ls`
======

Uses colour and pipes output to less, with a sensible prompt.

Each command is equivalent to:-

    cls      ls -FC
    clls     ls -lF --time-style=long-iso
    cllls    ls -lF --time-style=full-iso
    cals     ls -FCA
    calls    ls -lFA --time-style=long-iso
    callls   ls -lFA --time-style=full-iso
    csls     sudo ls -FC
    cslls    sudo ls -lF --time-style=long-iso
    csllls   sudo ls -lF --time-style=full-iso
    csals    sudo ls -FCA
    csalls   sudo ls -lFA --time-style=long-iso
    csallls  sudo ls -lFA --time-style=full-iso

Installation
------------

  1. Run **`pip3 -V`**
  1. If you get a *Command not found* error, run **`sudo apt install python3-pip`** and redo from start
  1. If your *pip* major version is less than 9, run **`pip3 install -U pip && hash -r`**
  1. Run **`pip3 install colorls`** 

TO-DO
-----
  + `LINK_COL_WIDTH` (what does this mean??)
  + Fix inum handling
  + Check for numeric owner/group
  + Use `type -a python3` and `unset VIRTUAL_ENV` when in a venv to break out of it

Development
-----------

Package dependencies are handled by [pipenv](https://pipenv.kennethreitz.org/).
It is assumed that *pipenv* will manage the installation of all concrete
dependency versions.  setup.py reads the dependency info from Pipfile
via the `pipenv` pacakge.

Before you can build the package, you will have to have `make`
installed.  You can then run **`make setup`** to create a [Virtualenv][]
(the `.venv` subdirectory where packages and metadata will be installed)
and then **`. .venv/bin/activate`** to activate it.

Then you can run **`pip install pipenv wheel`** and then use a build
process such as:-

    make build
    make dist
    # ... test .whl file now ...
    make release

Credits
-------

This package was created with [Cookiecutter][] and the [`audreyr/cookiecutter-pypackage`][pp]
project template.

  [Cookiecutter]: https://github.com/audreyr/cookiecutter
  [pp]: https://github.com/audreyr/cookiecutter-pypackage
  [Virtualenv]: http://packaging.python.org/guides/installing-using-pip-and-virtual-environments


