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.31.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.31-py3-none-any.whl (18.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: helpman-2.31.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.31.tar.gz
Algorithm Hash digest
SHA256 53c27a650357a2fc4444a09fea2bef5ec48935641d8cd8e1aab793b1b40c1a3a
MD5 4e103377d7adb542b6312ce76417df86
BLAKE2b-256 54910878bad750855d9b4ea02a47e359befafda8d8fed2dfb99a076e70f9b922

See more details on using hashes here.

File details

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

File metadata

  • Download URL: helpman-2.31-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.31-py3-none-any.whl
Algorithm Hash digest
SHA256 0169015e910c90d90e205a609d60bcb97515a9cac0ef58582608bfdb9c70ce87
MD5 943c0b20dc111e7f3dae1c3f344e65ba
BLAKE2b-256 8c75add1c5b49a264821f905c34e1a1326486e6bc9d064172cc70b7eac157d78

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