Added utility to execute functions within a time limit

[andrecsilva]

No description provided.

[nahsra]

A few issues:

1. I think this library shouldn't offer what should be available in other libraries, like Guava, which offers lots of execute-with-timeout options. There are probably many others that feel more idiomatic to developers.

2. I believe this code won't work with Java 8, which this project requires.

[nahsra]

For your needs, consider Guava's SimpleTimeLimiter:

import com.google.common.util.concurrent.SimpleTimeLimiter;
import com.google.common.util.concurrent.TimeLimiter;
import java.util.concurrent.TimeUnit;

public class GuavaTimeoutExample {
    public static void main(String[] args) {
        TimeLimiter timeLimiter = SimpleTimeLimiter.create();

        try {
            String result = timeLimiter.callWithTimeout(() -> {
                // long-running operation
                return "task completed";
            }, 1, TimeUnit.SECONDS);

            System.out.println("Result: " + result);
        } catch (Exception e) {
            System.out.println("Task timed out or failed!");
        }
    }
}