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.30.tar.gz (19.1 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.30-py3-none-any.whl (18.3 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for helpman-2.30.tar.gz
Algorithm Hash digest
SHA256 b486006ced17ffc19f3670dde795587101c9e17b574c4a036df116ae7a9f69b1
MD5 a8d880fd6444a31d6a6552c26fe64660
BLAKE2b-256 d7393736d01c9c076db5248519ef0fcd5609065fa7f9088ec767f9b998a97a8c

See more details on using hashes here.

File details

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

File metadata

  • Download URL: helpman-2.30-py3-none-any.whl
  • Upload date:
  • Size: 18.3 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.30-py3-none-any.whl
Algorithm Hash digest
SHA256 e6e5f1b410380a72cdc46723806af027b1f9923fcfbe05082901e6ab7c7dc56a
MD5 1f3542e8b2262146cfa725d0cf7f0386
BLAKE2b-256 77c4a3ce2549f3aa16dbc2792acd889f0fb3adcfbb300202a071aaa0b7e296f2

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