Skip to main content

`pls` is a better `ls` for developers.

Project description

pls on PyPI Python ^3.9 GPL-3.0-or-later

pls is a better ls for developers. The "p" stands for "pro" as in "professional" or "programmer".

It works in a manner similar to ls, in that it lists directories and files in a given directory, but it adds many more developer-friendly features.

Note that pls is not a replacement for ls. ls is a tried, tested and trusted tool with lots of features. pls, on the other hand, is a simple tool for people who just want to see the contents of their directories.

Features

pls provides many features over ls command. pls can:

  • show Nerd Font icons or emoji next to files and directories making it easier to grep the output
  • colour output to further distinguish important files
  • use a more nuanced approach to hidden files than plainly hiding files with a leading dot .
  • groups directories and shows them all before files
  • ignores leading dots . in sorting files

The icon, color and most behaviour in the application can be configured using plain-text YAML files for the pros who prefer to tweak their tools.

Upcoming features

In the future pls will be able to

  • generate visibility rules by parsing .gitingore
  • add MIME type as another method for matching files to specs
  • use complete path based matching for files
  • cascade specs based on specificity levels
  • provide channels to extend specs per user, per project
  • link files and hide derived files behind the main ones
  • support more columns like permissions, owner and size
  • support for tree-like output

If you want to help implement any of these features, feel free to submit a PR. pls is free and open-source software.

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

pls-1.1.0.tar.gz (24.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pls-1.1.0-py3-none-any.whl (27.2 kB view details)

Uploaded Python 3

File details

Details for the file pls-1.1.0.tar.gz.

File metadata

  • Download URL: pls-1.1.0.tar.gz
  • Upload date:
  • Size: 24.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.11 CPython/3.8.9 Darwin/21.2.0

File hashes

Hashes for pls-1.1.0.tar.gz
Algorithm Hash digest
SHA256 2a5fa6eb99c65da5f675777fcd2f304edcf1388ae36d1d9b9425acc14bd5571a
MD5 ebb54ef94562f8c8bd79a929813865de
BLAKE2b-256 8e60ba9adf902b8777b94837db0bd5f99d603e0b4899515ca91f2de7789ecd61

See more details on using hashes here.

File details

Details for the file pls-1.1.0-py3-none-any.whl.

File metadata

  • Download URL: pls-1.1.0-py3-none-any.whl
  • Upload date:
  • Size: 27.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.1.11 CPython/3.8.9 Darwin/21.2.0

File hashes

Hashes for pls-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c7a446cb9fccdf488ed2a4973961084bb69798f04b6fe911ffda6d68ab652540
MD5 1d8d64fd9f36417e46cb3da974cfd83e
BLAKE2b-256 e45cb54e7442545f06d73e13b96210002d2d3b5c136151a538d29ab2d361530e

See more details on using hashes here.

Supported by

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