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:

```bash
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.29.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.29-py3-none-any.whl (18.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: helpman-2.29.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.29.tar.gz
Algorithm Hash digest
SHA256 d43d0fcb8ed5070bf17400216628fcfcfe7c21aec73874e0d8b9e84c7c49c8ed
MD5 d70d7e4c4784081af26a50bd87361ab8
BLAKE2b-256 efa1b943b8ee449d201f653c30e906c049a6c5a57439fa5aef563a4fa10de609

See more details on using hashes here.

File details

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

File metadata

  • Download URL: helpman-2.29-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.29-py3-none-any.whl
Algorithm Hash digest
SHA256 da2cc5989c05b9eec0b690a2f96f219c2a8c480b125eefae2a57171b8d04d009
MD5 161ce013fdfd565316625042bcc27cc4
BLAKE2b-256 72b615d0f9606715d87fab3c84b399d9aa07de9d1fac5cd6327faab0a9d66002

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