Event Scheduler

Table of Contents

• Overview
• Installing
• Documentation
• Quick Start
• Example
• Contact

Overview

The Event Scheduler uses an internal thread to allow the application to
schedule events to occur either ASAP or at a specified time in the future.
Instead of blocking your application’s main thread, you can concurrently run
some lightweight tasks. We took some inspiration for the API design from the
python library’s scheduler. Unlike
the native sched module, the Event Scheduler is always on and ready to accept
events. Event Scheduler is completely thread-safe too!

Installing

You should already have pip installed if you’re using python > 3.4. If you
don’t, please visit this link to
install it.

To install event scheduler, type the following command in the terminal:

pip install event-scheduler

To import the module, add the following lines in your Python file.

from event_scheduler import EventScheduler

To download directly visit PyPi or
the GitHub repository.

Documentation

Full documentation can be found here.

Quick Start

event_scheduler.start()

Enable the event scheduler to start taking events

event_scheduler.stop(hard_stop=False)

Stop the event scheduler and its internal thread. Set hard_stop to True
to stop the scheduler right away and discard all pending events. Set
hard_stop to False to wait for all events to finish executing at their
scheduled times.

event_scheduler.enter(delay, priority, action, arguments=(), kwargs={})

Schedule an event with a callable action to be executed after the delay.
Events will be executed according to their delay and priority (lower
number = higher priority). arguments holds positional arguments and
kwargs hold keyword arguments for the action. Returns an event object which
can be used to cancel the event.

event_scheduler.cancel(event)

Cancel the event if it has not yet been executed.

event_scheduler.cancel_recurring(event_id)

Cancel the recurring event and all future occurrences.

from event_scheduler import EventScheduler
event_scheduler = EventScheduler()
# Starts the scheduler
event_scheduler.start()
# Schedule an event that prints a message after 5 seconds
event_scheduler.enter(5, 0, print, ('5 seconds has passed since this event was entered!',))
# Schedule a recurring event that prints a message every 10 seconds
event_scheduler.enter_recurring(10, 0, print, ('10 second interval has passed!',))

Output:
\
5 seconds has passed since this event was entered!
\
10 second interval has passed!
\
10 second interval has passed!
\
...

Example

Please refer
here
for the example.

Contact

Please email phluentmed@gmail.com or open an issue if you need any help using
the module, have any questions, or even have some feature suggestions.

Recommended Email format:

Subject: EventScheduler - [Issue]

Steps to reproduce: (Please include code snippets or stack trace where possible)

Device used:

Platform:

Actual result:

Expected result:

Comments: