From 468f0f6317673f461cf7222daa35b3b0feed61d4 Mon Sep 17 00:00:00 2001
From: "Martin A. Brown" <martin@linux-ip.net>
Date: Mon, 22 Feb 2016 12:32:16 -0800
Subject: [PATCH] adding firstfoundfile function

---
 tldp/utils.py | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/tldp/utils.py b/tldp/utils.py
index 11fd162..40127ba 100644
--- a/tldp/utils.py
+++ b/tldp/utils.py
@@ -24,6 +24,13 @@ def getLogger(**opts):
 
 logger = getLogger()
 
+def firstfoundfile(locations):
+    '''return the first existing file from a list of filenames (or None)'''
+    for option in locations:
+        if os.path.isfile(option):
+            return option
+    return None
+
 
 def stem_and_ext(name):
     '''return (stem, ext) for any relative or absolute filename'''