0 purchases
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)
For personal and professional use. You cannot resell or redistribute these repositories in their original state.
There are no reviews.