Issue 434: Define method to get release by tag name

ueg1990 · ueg1990 · commit 152bb8d4ac9f · 2015-11-12T01:39:09.000-05:00
diff --git a/github3/repos/repo.py b/github3/repos/repo.py
@@ -1653,6 +1653,17 @@ def release(self, id):
             json = self._json(self._get(url), 200)
         return self._instance_or_null(Release, json)
 
+    def release_by_tag_name(self, tag_name):
+        """Get a relase by tag name
+
+        :param str tag_name: (required) name of tag
+        :returns: :class:`Release <github3.repos.release.Release>`
+        """
+        url = self._build_url('releases', 'tags', tag_name,
+                              base_url=self._api)
+        json = self._json(self._get(url), 200)
+        return self._instance_or_null(Release, json)
+
     def releases(self, number=-1, etag=None):
         r"""Iterate over releases for this repository.
 
diff --git a/tests/test_repos.py b/tests/test_repos.py
@@ -491,6 +491,14 @@ def test_ref(self):
         assert isinstance(self.repo.ref('fakesha'), github3.git.Reference)
         self.mock_assertions()
 
+    def test_release_by_tag_name(self):
+        self.response('release', 200)
+        self.get(self.api + 'releases/tags/v0.7.1')
+
+        assert isinstance(self.repo.release_by_tag_name('v0.7.1'),
+                          github3.repos.release.Release)
+        self.mock_assertions()
+
     def test_remove_collaborator(self):
         self.response('', 204)
         self.delete(self.api + 'collaborators/login')
