Skip to main content

A python client for tldr: simplified and community-driven man pages.

Project description

Latest Version

Yet another python client for tldr.

Install

$ (sudo) pip install tldr.py

Usage

Initialize

  1. clone the tldr repo to somewhere(e.g. ~/code/tldr). We will use it when we look for a command usage.

    $ cd ~/code
    $ git clone git@github.com:tldr-pages/tldr.git
  2. init the configuration file.

    $ tldr init
    Input the tldr repo path(absolute path): (e.g. /home/lord63/code/tldr/)
    Input your platform(linux, osx or sunos): (e.g. linux)
    Initializing the config file at ~/.tldrrc

and you configuration file should look like this:

colors:
   command: cyan
   description: blue
   usage: green
platform: linux
repo_directory: /home/lord63/code/tldr

Don’t worry about the colors option, it is for the output when you look for a command, you can custom it by yourself.(Note that the color should be in [‘black’, ‘red’, ‘green’, ‘yellow’, ‘blue’, ‘magenta’, ‘cyan’, ‘white’])

Use tldr

look for a command usage:

$ tldr find {{command}}

check for updates(so that we can get the latest man pages):

$ tldr update

Or you can use tldr --help to get the help message.

Contributing

  • It sucks? Why not help me improve it? Let me know the bad things.

  • Want a new feature? Feel free to file an issue for a feature request.

  • Find a bug? Open an issue please, or it’s better if you can send me a pull request.

Contributions are always welcome at any time! :sparkles: :cake: :sparkles:

License

MIT.

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

tldr.py-0.1.1.tar.gz (4.8 kB view details)

Uploaded Source

File details

Details for the file tldr.py-0.1.1.tar.gz.

File metadata

  • Download URL: tldr.py-0.1.1.tar.gz
  • Upload date:
  • Size: 4.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for tldr.py-0.1.1.tar.gz
Algorithm Hash digest
SHA256 dcfe09e091259660591497974f0e6a4ea30c576d4cd17b123ca9a674ddb8690e
MD5 2abf5abbff371b159b215613aa1173dc
BLAKE2b-256 eb4f0a8bc7162039ae9a1b8600149c5b6a1b126bc83d3c7bfb1a1864df9c784e

See more details on using hashes here.

Supported by

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