Skip to main content

lscolors

usage: lscolors [-h] [-H] [-v] [-V] [--print-config] [--print-url]
                [--completion [SHELL]]
                COMMAND ...

Utilities for `dircolors(1)` and `dir_colors(5)`.

Specify one of:
  COMMAND
    chart               Print color chart.
    check               Check database for required items.
    configs             Print path to sample configuration files.
    docs                Create documentation.
    paint               Paint dircolors.
    report              Print colorized database report.
    samples             Create directory of sample filesystem items.
    sort                Sort lines of database file by color.

General options:
  -h, --help            Show this help message and exit.
  -H, --long-help       Show help for all commands and exit.
  -v, --verbose         `-v` for detailed output and `-vv` for more detailed.
  -V, --version         Print version number and exit.
  --print-config        Print effective config and exit.
  --print-url           Print project url and exit.
  --completion [SHELL]  Print completion scripts for `SHELL` and exit
                        (default: `bash`).

See `lscolors COMMAND --help` for help on a specific command.

lscolors chart

usage: lscolors chart [-h] [color ...]

Print color-chart.

positional arguments:
  color       Print color palette with given colors.

options:
  -h, --help  Show this help message and exit.

lscolors check

usage: lscolors check [-h] [-q] [--config CONFIG] [DIR_COLORS]

Check database in `$LS_COLORS` for required items.

positional arguments:
  DIR_COLORS       Read file `DIR_COLORS` instead of `$LS_COLORS`.

options:
  -h, --help       Show this help message and exit.
  -q, --quiet      Suppress warning if default `CONFIG` cannot be found.
  --config CONFIG  Require filenames, directories and extensions specified in
                   `CONFIG` file.

Exit Status: zero indicates success, nonzero indicates failure.

lscolors configs

usage: lscolors configs [-h]

Print path to sample `.lscolors.yml` and `.dircolors` configuration files.

options:
  -h, --help  Show this help message and exit.

lscolors docs

usage: lscolors docs [-h] [-f] {ansi,md,txt} DIR

Create documentation files for this application.

positional arguments:
  {ansi,md,txt}  Output format.
  DIR            Create directory `DIR`. (default: './docs').

options:
  -h, --help     Show this help message and exit.
  -f, --force    Ok to clobber `DIR` if it exists.

This is an internal command used during the packaging process.

lscolors paint

usage: lscolors paint [-h] [--encoding NAME] [--palettes-dir DIR]
                      [--palette-num NUMBER] [--palette-file FILE]
                      [--pick COLORNUM [COLORNUM ...]] [--add-samples]
                      [--group-color GROUP=COLOR [GROUP=COLOR ...]]
                      [DIR_COLORS]

Apply palette to dircolors.

positional arguments:
  DIR_COLORS            Read `DIR_COLORS` file.

options:
  -h, --help            Show this help message and exit.
  --encoding NAME       File encoding.
  --palettes-dir DIR    Directory of `coloors.co` palettes.
  --palette-num NUMBER  Id of `coloors.co` palette file to apply.
  --palette-file FILE   `coloors.co` palette file to apply.
  --pick COLORNUM [COLORNUM ...]
                        Select and order colors by palette-`COLORNUM`.
  --add-samples         Add color samples.
  --group-color GROUP=COLOR [GROUP=COLOR ...]
                        Paint `GROUP` with `COLOR`, where `GROUP` is one of
                        `archive`, `image`, `audio`, `data`, `source`,
                        `config`, `history`, `doc`, `NORMAL`, `FILE`, `RESET`,
                        `DIR`, `LINK`, `MULTIHARDLINK`, `FIFO`, `SOCK`,
                        `DOOR`, `BLK`, `CHR`, `ORPHAN`, `MISSING`, `SETUID`,
                        `SETGID`, `CAPABILITY`, `STICKY_OTHER_WRITABLE`,
                        `OTHER_WRITABLE`, `STICKY`, `EXEC`.

lscolors report

usage: lscolors report [-h] [--left | --right] [DIR_COLORS]

Print colorized report for database in `$LS_COLORS`.

positional arguments:
  DIR_COLORS  Read file `DIR_COLORS` instead of `$LS_COLORS`.

options:
  -h, --help  Show this help message and exit.
  --left      Format report for display in left window.
  --right     Format report for display in right window.

A default format is produced when `--left/--right` is not given.

lscolors samples

usage: lscolors samples [-h] [-q] [--config CONFIG] [--samplesdir DIR] [-f]
                        [DIR_COLORS]

Create directory and populate with sample files, directories, etc.,
for each item in `$LS_COLORS`, and all required items in
configuration file `CONFIG`.

positional arguments:
  DIR_COLORS        Read file `DIR_COLORS` instead of `$LS_COLORS`.

options:
  -h, --help        Show this help message and exit.
  -q, --quiet       Suppress warning if default `CONFIG` cannot be found.
  --config CONFIG   Require filenames, directories and extensions specified in
                    `CONFIG` file.
  --samplesdir DIR  Create directory `DIR`.
  -f, --force       Ok to clobber `DIR` if it exists.

lscolors sort

usage: lscolors sort [-h]

Filter `stdin` to `stdout` sorting lines of a `DIR_COLORS` file
by color then filetype. Blank lines and comments are unsorted
and moved to the end.

options:
  -h, --help  Show this help message and exit.

Release files for lscolors 1.0.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for lscolors 1.0.6
File Size Uploaded
lscolors-1.0.6.tar.gz 26.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for lscolors 1.0.6
File Interpreter ABI Platform
lscolors-1.0.6-py3-none-any.whl Python 3 none any Details

Total release size: 57.9 kB

Release files / lscolors-1.0.6.tar.gz

Download URL lscolors-1.0.6.tar.gz
Size 26.0 kB
Tags Source
SHA-256 checksum
How to use checksums
7c797bc3ff48681ca99b85d5187d172e53c68e6acc77916a89c8871ddaa794cb
BLAKE2b-256 checksum
How to use checksums
4e4d68b6d87c6e2913aca8b3a955c1aff464d057641bc628dbd5f00e7d74952a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.1 CPython/3.13.0

Release files / lscolors-1.0.6-py3-none-any.whl

Download URL lscolors-1.0.6-py3-none-any.whl
Size 31.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
277fb13acd2e81120645c9b832789b3953b3eac2aa96ab3d3204ee1dd551afef
BLAKE2b-256 checksum
How to use checksums
dca02abd965d763bc75a49bbcbab009c56c2c9a8dd4d9b2d95faa7a30498ac6b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.1 CPython/3.13.0

Release history Release notifications | RSS feed

This release

1.0.6 This release

2 release files

1.0.5

2 release files

1.0.3

2 release files

1.0.2

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page