Futures

Easy Async

Futures are a powerful tool in Dandy that allow you to run code asynchronously which is great for non-blocking calls like network requests.

All you need to do on any class that has a process method is to call the process_to_future method instead.

Without Async Futures

Let's run three LlmBot.process calls at once and see how long it takes.

from time import perf_counter
from dandy import Bot

start_time = perf_counter()

pants_intel = Bot().process('What type of pants should I wear in the rain?')
shirt_intel = Bot().process('What type of shirt should I wear in the sun?')
shoes_intel = Bot().process('What type of shoes should I wear in the mud?')

print('Pants: ' + pants_intel.text)
print('Shirt: ' + shirt_intel.text)
print('Shoes: ' + shoes_intel.text)

print(f'Finished in {perf_counter() - start_time:.3f} seconds')

Pants: Wear waterproof or water-resistant pants, such as rain pants or pants made from materials like Gore-Tex, to stay dry in the rain.
Shirt: Wear a lightweight, long-sleeved shirt made of breathable fabric like cotton or linen to protect your skin from the sun.
Shoes: Wear waterproof boots with deep treads for better grip and protection in muddy conditions.
Finished in 1.097 seconds

With Async Futures

Now let's run with futures, note you have to access the result attribute of the futures to get to the returned value.

Warning

We recommend you postfix your futures with _future to avoid naming conflicts and confusion.

from time import perf_counter
from dandy import Bot

start_time = perf_counter()

pants_intel_future = Bot().process_to_future('What type of pants should I wear in the rain?')
shirt_intel_future = Bot().process_to_future('What type of shirt should I wear in the sun?')
shoes_intel_future = Bot().process_to_future('What type of shoes should I wear in the mud?')

print('Pants: ' + pants_intel_future.result.text)
print('Shirt: ' + shirt_intel_future.result.text)
print('Shoes: ' + shoes_intel_future.result.text)

print(f'Finished in {perf_counter() - start_time:.3f} seconds')

Pants: Waterproof or water-resistant pants, such as rain pants or pants made from materials like Gore-Tex, nylon, or polyester with a DWR (durable water repellent) coating, are ideal for wearing in the rain.
Shirt: Wear a lightweight, long-sleeved shirt made of breathable fabric like cotton or linen to protect your skin from the sun.
Shoes: Wear waterproof boots with deep treads for better grip and protection in muddy conditions.
Finished in 0.530 seconds

Advanced Async

Sometimes in more complex situations you might need to cancel a future or set a timeout.

from dandy import Bot

user_likes_scary_animals = True

cute_animal_future = Bot().process_to_future('Can you tell me about a random cute animal?')

scary_animal_future = Bot().process_to_future('Can you tell me about a random scary animal?')
scary_animal_future.set_timeout(seconds=30)

if user_likes_scary_animals:
    cute_animal_future.cancel()

print(scary_animal_future.result.text)

The Gila monster is a venomous lizard found in the southwestern United States and northwestern Mexico. It has a slow, lumbering gait and a striking pattern of bright orange and black scales, which serve as a warning to predators. Its venom is delivered through grooves in its teeth when it chews on its prey, and while its bite is extremely painful to humans, it is rarely fatal. The Gila monster can store fat in its tail and survive for months without eating, making it a resilient and eerie survivor of harsh desert environments.