py-timelimit 1.0.1

Description:

pytimelimit 1.0.1

Python Timeout

Timeout & retry functions in Python with a single line of code

Explore the docs »

·
Report Bug
·
Request Feature
·




Table of Contents


About The Project


Getting Started

Installation


Usage

Basic Usage
Advanced Usage

Roadmap
Contributing
License
Contact



About The Project

This is a Python package that provides decorators for adding timeout and retry functionality to your functions. With just one line of code, you can easily set a timeout for your function and choose to retry it any number of times in case of timeout.
(back to top)

Getting Started
This is an example of how you may give instructions on setting up your project locally.
To get a local copy up and running follow these simple example steps.
Installation
Build from source

Clone the repository

git clone github.com/radioactive11/python-timeout


Run the following command to install the project

python3 setup.py install

Install using pip
To install the function using pip, run
pip3 install python-timeout

(back to top)

Usage
Basic Usage


To set timeout for a function, import the module using from libtimeout import Timeout.


Create a Timeout object class with the following parameters:
`timeout_limit`: The time limit for the function to run (in seconds). Default is 10 seconds.

`retry_limit`: The number of times to retry the function in case of timeout. Deafult is 0.



Use the bind method to bind the timeout decorator to the function you want to set timeout for. This returns a new function with the timeout decorator applied.


Call the new function with the same parameters as the original function.


Example
from libtimeout import Timeout


timeout_ = Timeout(timeout_limit=5, retry_limit=2)

@timeout_.bind()
def my_function(a, b):
# Do something
return a + b

my_function(1, 2)


Advanced Usage
By default, the timeout decorator raises a TimeoutError in case of timeout. You can change this behavior by passing the following parameters:
timeout_exception: The exception to raise in case of timeout. This must be a subclass of Exception.
timeout_handler: The function to call in case of timeout. This must raise the exception specified in timeout_exception.
Example
from libtimeout import Timeout

class CustomException(Exception):
pass

def custom_handler():
# do something like deleting partial downloaded files etc.
raise CustomException("Custom exception raised")

timeout_ = Timeout(timeout_limit=60, retry_limit=2, timeout_exception=CustomException, timeout_handler=custom_handler)

@timeout_.bind()
def download_large_file(url):
# Download file
return

(back to top)

Roadmap

[] Add retry with backoff
[] Add multi-threading support

See the open issues for a full list of proposed features (and known issues).
(back to top)

Contributing
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
Don't forget to give the project a star! Thanks again!

Fork the Project
Create your Feature Branch (git checkout -b feature/AmazingFeature)
Commit your Changes (git commit -m 'Add some AmazingFeature')
Push to the Branch (git push origin feature/AmazingFeature)
Open a Pull Request

(back to top)

License
Distributed under the MIT License. See LICENSE.txt for more information.
(back to top)

Contact
Arijit Roy - @radioactive11 - [email protected]
Project Link: https://github.com/your_username/repo_namehttps://github.com/radioactive11/python-timeout
(back to top)