added a convenience method

kohsuke · kohsuke · commit 6ce878fdcf71 · 2012-05-31T11:55:34.000-07:00
diff --git a/src/main/java/com/cloudbees/jenkins/GitHubRepositoryName.java b/src/main/java/com/cloudbees/jenkins/GitHubRepositoryName.java
@@ -90,6 +90,18 @@ protected GHRepository adapt(GitHub item) {
         };
     }
 
+    /**
+     * Variation of {@link #resolve()} method that just returns the first valid repository object.
+     *
+     * This is useful if the caller only relies on the read access to the repository and doesn't need to
+     * walk possible candidates.
+     */
+    public GHRepository resolveOne() {
+        for (GHRepository r : resolve())
+            return r;
+        return null;
+    }
+
     private <V> Iterator<V> filterNull(Iterator<V> itr) {
         return new FilterIterator<V>(itr) {
             @Override
