Skip to main content

dircolors utilities

Project description

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

lscolors-1.0.3.tar.gz (26.0 kB view details)

Uploaded Source

Built Distribution

lscolors-1.0.3-py3-none-any.whl (32.0 kB view details)

Uploaded Python 3

File details

Details for the file lscolors-1.0.3.tar.gz.

File metadata

  • Download URL: lscolors-1.0.3.tar.gz
  • Upload date:
  • Size: 26.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.13.0

File hashes

Hashes for lscolors-1.0.3.tar.gz
Algorithm Hash digest
SHA256 0bf451f9573540b924d42361055810cd030c0aaff8e69635dc2c5d1ee3678533
MD5 7235e228d41134703dcbd45e8421358f
BLAKE2b-256 e14c190a87c84b46e67890be1b574c671b8191a03e05329335d9f84cd5361afd

See more details on using hashes here.

File details

Details for the file lscolors-1.0.3-py3-none-any.whl.

File metadata

  • Download URL: lscolors-1.0.3-py3-none-any.whl
  • Upload date:
  • Size: 32.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.13.0

File hashes

Hashes for lscolors-1.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 dc0160495858775d7b1bb641def6b82f7eaf5eb3cc7a272ac0886a40be3d04f7
MD5 e7de58b16331ad356bfd740fb642208b
BLAKE2b-256 4b6810bf398ecc0334c4b968a6a3d48b322fe4a4c58f98180f370da98c65074b

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page