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] [-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
  -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.32.tar.gz (19.2 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.32-py3-none-any.whl (18.4 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for helpman-2.32.tar.gz
Algorithm Hash digest
SHA256 0bee15489ebbbedc971d352a0e6f8440575eeba6cce08ebe8bd29cae36659f38
MD5 c89809b805e8f03f14a80a3e31cc1338
BLAKE2b-256 248e72a6daa6465441399c6a6e36b106d93cbabddbf24852754dac9b97ccb8ec

See more details on using hashes here.

File details

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

File metadata

  • Download URL: helpman-2.32-py3-none-any.whl
  • Upload date:
  • Size: 18.4 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.32-py3-none-any.whl
Algorithm Hash digest
SHA256 11f7a0c314745cc0fc32cb42964d399c1398807c1591a7ef3c1ad198443fca36
MD5 34992c2a642ea57a69bd2f8265b8a5be
BLAKE2b-256 28e14b703da10cbdb534cb6f42f90bc49e28370ec939c3a7a9f915734fa8caa6

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