Skip to main content

Enhanced Python Help Tool with Rich Library - Beautiful terminal output.

Project description

🚀 pyhelp (Helpman)

Enhanced Python Help Tool with Rich Library - Beautiful terminal output

pyhelp or helpman is a Python command-line tool that lets you quickly view the documentation (docstring) of Python functions, classes, or objects directly from your terminal. It helps you inspect documentation without opening source files or browsing online docs.

Example Usage

✨ Features

  • Displays docstrings for Python functions, classes, and objects.
  • Supports searching in standard Python modules and installed third-party packages.
  • Provides clean, readable output right in the terminal.

📦 Installation

   git clone https://github.com/cumulus13/pyhelp.git
   cd pyhelp
   pip install .

   # or

   pip install helpman

Usage

After installation, use pyhelp in your terminal with the following syntax:

pyhelp <object_name>

Replace <object_name> with the name of the Python function, class, or object you want to view the documentation for.

Usage: pyhelp/helpman [-h] [-s] [-a] [-i] [-v] [module ...]

🐍 Enhanced Python Help Tool with Rich formatting

Positional Arguments:
  module             Module, function, or class to get help for (e.g., os.path, json.loads)

Options:
  -h, --help         show this help message and exit
  -s, --source       Show source code instead of help documentation
  -a, --show-all     Show all the attributes
  -i, --interactive  Interactive mode
  -v, --version      show program's version number and exit

Examples:

  pyhelp os.path                    # Show help for os.path module
  pyhelp json.loads                 # Show help for json.loads function
  pyhelp -s requests.get            # Show source code for requests.get
  pyhelp --source collections.Counter  # Show source code for Counter class

You can clear the terminal while inputting a query by prefixing or suffixing with "c", e.g. "c query" or "query c".

Examples

  • View docstring for the print function:

    pyhelp print
    
  • View docstring for the list class:

    pyhelp list
    
  • View docstring for numpy.array function (if numpy is installed):

    pyhelp numpy.array
    

If the requested object is not found directly, pyhelp will attempt to locate it in standard Python modules and installed third-party packages.

Contribution

Contributions to improve pyhelp are welcome! Please fork the repository, create a new branch (git checkout -b new-feature), make your changes, and submit a pull request. Make sure to add tests and update documentation as needed.

License

pyhelp is licensed under the MIT License.


If you have any questions or need help, feel free to open an issue on the GitHub repository.

author

Hadi Cahyadi

Buy Me a Coffee

Donate via Ko-fi

Support me on Patreon

medium.com

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

helpman-2.33.tar.gz (19.5 kB view details)

Uploaded Source

Built Distribution

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

helpman-2.33-py3-none-any.whl (18.5 kB view details)

Uploaded Python 3

File details

Details for the file helpman-2.33.tar.gz.

File metadata

  • Download URL: helpman-2.33.tar.gz
  • Upload date:
  • Size: 19.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.4

File hashes

Hashes for helpman-2.33.tar.gz
Algorithm Hash digest
SHA256 01d340a5ada8efb7ec35a51142671f8b4acfdd5a96fe628aa617dbd933551765
MD5 00e95a71bcae0a9c4dfd9a464a0151bd
BLAKE2b-256 d4d8c260ecabbfa42b409a07869211638443041999cfaf3c9e1f6c3f2d1ec561

See more details on using hashes here.

File details

Details for the file helpman-2.33-py3-none-any.whl.

File metadata

  • Download URL: helpman-2.33-py3-none-any.whl
  • Upload date:
  • Size: 18.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.4

File hashes

Hashes for helpman-2.33-py3-none-any.whl
Algorithm Hash digest
SHA256 7f64a106bc44b4faa561c90e5f89c9581351acba01c6673b1209645f39ae50cb
MD5 d08df244c9764e98e0d2ff873c77d313
BLAKE2b-256 c7cc2958ca5c5ebf8b75a19b3bb16f1a711c51f322e7c4c849bdf651b47e5ba3

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