Skip to main content

A Python library for handling exceptions in a clean and organized way

Project description

HandleException - Python Wrapper Class to Catch Exceptions

PyPI version

HandleException is a Python wrapper class that helps to catch exceptions and raise them to an upper level. With HandleException, you can easily wrap any function that you want to monitor for exceptions and handle them as desired.

Installation

pip install handle-exception

Usage

To use HandleException, simply decorate the function that you want to wrap with the HandleException decorator. For example:

from handle_exception import HandleException

@HandleException
def my_function():
    raise ValueError("Test exception")

In this example, if the function my_function raises an exception, HandleException will catch it and raise it to the upper level. This way, you can handle exceptions in a centralized way, instead of having to write try-except blocks in multiple places.

Custom Exceptions

HandleException also allows you to catch specific custom exceptions by passing a list of exception classes as an argument to the ExceptionRaiser decorator. For example:

from handle_exception import ExceptionRaiser

class CustomException(Exception):
    pass

@ExceptionRaiser(exceptions=[CustomException])
def my_function():
    raise CustomException("This is a custom exception.")

In this example, the function my_function raises a custom exception, CustomException, which will be caught by HandleException.

Example

from handle_exception import HandleException

@HandleException
def divide(a, b):
    return a / b

result = divide(10, 0)
print(result)

In this example, the divide function is decorated with the HandleException decorator. This means that any exceptions raised in the divide function will be caught and handled by the HandleException class. The code is much cleaner and easier to understand, as it doesn't contain a try-except block or have to worry about handling exceptions manually.

Contributing

We welcome contributions to HandleException! If you'd like to contribute, please follow these steps:

  1. Fork the repository.
  2. Create a new branch for your changes.
  3. Make your changes and write tests for them.
  4. Submit a pull request.

License

HandleException is released under the MIT License.

We welcome contributions to this library. If you have an idea for a new feature or have found a bug, please open an issue on Github.

Buy me a Coffee

ko-fi

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

handle_exception-1.0.1.tar.gz (3.1 kB view hashes)

Uploaded Source

Built Distribution

handle_exception-1.0.1-py3-none-any.whl (3.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page