Add Support for Retrieving Template Repository Information for a Repo…

src/main/java/org/kohsuke/github/GHCreateRepositoryBuilder.java

@@ -1,6 +1,7 @@
 package org.kohsuke.github;
 
 import java.io.IOException;
+import java.util.Objects;
 
 import static org.kohsuke.github.internal.Previews.BAPTISTE;
 
@@ -131,6 +132,20 @@ public GHCreateRepositoryBuilder fromTemplateRepository(String templateOwner, St
         return this;
     }
 
+    /**
+     * Create repository from template repository.
+     *
+     * @param templateRepository
+     *            the template repository as a GHRepository
+     * @return a builder to continue with building
+     * @see <a href="https://developer.github.com/v3/previews/">GitHub API Previews</a>
+     */
+    @Preview(BAPTISTE)
+    public GHCreateRepositoryBuilder fromTemplateRepository(GHRepository templateRepository) {
+        Objects.requireNonNull(templateRepository, "templateRepository cannot be null");
+        return fromTemplateRepository(templateRepository.getOwnerName(), templateRepository.getName());
+    }
+
     /**
      * Creates a repository with all the parameters.
      *

src/main/java/org/kohsuke/github/GHRepository.java

@@ -78,7 +78,7 @@
 @SuppressWarnings({ "UnusedDeclaration" })
 @SuppressFBWarnings(value = { "UWF_UNWRITTEN_PUBLIC_OR_PROTECTED_FIELD", "UWF_UNWRITTEN_FIELD", "NP_UNWRITTEN_FIELD" },
         justification = "JSON API")
-public class GHRepository extends GHObject {
+public class GHRepository extends GHObject implements Cloneable {
 
     private String nodeId, description, homepage, name, full_name;
 
@@ -120,6 +120,8 @@
 
     private String default_branch, language;
 
+    private GHRepository template_repository;
+
     private Map<String, GHCommit> commits = Collections.synchronizedMap(new WeakHashMap<>());
 
     @SkipFromToString
@@ -948,6 +950,17 @@
         return default_branch;
     }
 
+    /**
+     * Get Repository template was the repository created from.
+     *
+     * @throws CloneNotSupportedException
+     *             if the template repository is not cloneable
+     * @return the repository template
+     */
+    public GHRepository getTemplateRepository() throws CloneNotSupportedException {
+        return (GHRepository) template_repository.clone();
+    }
+
     /**
      * Gets size.
      *
@@ -1417,6 +1430,18 @@
         set().private_(value);
     }
 
+    /**
+     * Sets repository template
+     *
+     * @param value
+     *            the GitHub repository used as a template
+     * @throws IOException
+     *             the io exception
+     */
+    public void setTemplateRepository(GHRepository value) throws IOException {
+        set().templateRepository(value);
+    }
+
     /**
      * Sets visibility.
      *

src/main/java/org/kohsuke/github/GHRepositoryBuilder.java

@@ -169,6 +169,20 @@
         return with("private", enabled);
     }
 
+    /**
+     * Set template repository as GHRepository.
+     *
+     * @param repositoryTemplate
+     *            GHRepository
+     * @throws IOException
+     *             In case of any networking error or error from the server.
+     * @return a builder to continue with building
+     *
+     */
+    public S templateRepository(GHRepository repositoryTemplate) throws IOException {
+        return with("template_repository", repositoryTemplate);
+    }
+
     /**
      * Sets the repository visibility.
      *

src/test/java/org/kohsuke/github/GHContentIntegrationTest.java

@@ -75,6 +75,18 @@ public void testGetRepository() throws Exception {
         assertThat(testRepo.getName(), equalTo(repo.getName()));
     }
 
+    /**
+     * Test get repository created from a template repository
+     *
+     * @throws Exception
+     *             the exception
+     */
+    @Test
+    public void testGetRepositoryWithTemplateRepositoryInfo() throws Exception {
+        GHRepository testRepo = gitHub.getRepositoryById(repo.getId());
+        assertThat(testRepo.getTemplateRepository(), notNullValue());
+    }
+
     /**
      * Test get file content.
      *

src/test/java/org/kohsuke/github/GHOrganizationTest.java

@@ -154,6 +154,29 @@ public void testCreateRepositoryWithTemplate() throws IOException {
 
     }
 
+    /**
+     * Test create repository with template.
+     *
+     * @throws IOException
+     *             Signals that an I/O exception has occurred.
+     */
+    @Test
+    public void testCreateRepositoryWithTemplateAndGHRepository() throws IOException {
+        cleanupRepository(GITHUB_API_TEST_ORG + '/' + GITHUB_API_TEST);
+
+        GHOrganization org = gitHub.getOrganization(GITHUB_API_TEST_ORG);
+        GHRepository templateRepository = org.getRepository(GITHUB_API_TEMPLATE_TEST);
+
+        GHRepository repository = org.createRepository(GITHUB_API_TEST)
+                .fromTemplateRepository(templateRepository)
+                .owner(GITHUB_API_TEST_ORG)
+                .create();
+
+        assertThat(repository, notNullValue());
+        assertThat(repository.getReadme(), notNullValue());
+
+    }
+
     /**
      * Test invite user.
      *

src/test/resources/org/kohsuke/github/GHContentIntegrationTest/wiremock/testGetRepositoryWithTemplateRepositoryInfo/__files/1-user.json

@@ -0,0 +1,46 @@
+{
+  "login": "bitwiseman",
+  "id": 1958953,
+  "node_id": "MDQ6VXNlcjE5NTg5NTM=",
+  "avatar_url": "https://avatars.githubusercontent.com/u/1958953?v=4",
+  "gravatar_id": "",
+  "url": "https://api.github.com/users/bitwiseman",
+  "html_url": "https://github.com/bitwiseman",
+  "followers_url": "https://api.github.com/users/bitwiseman/followers",
+  "following_url": "https://api.github.com/users/bitwiseman/following{/other_user}",
+  "gists_url": "https://api.github.com/users/bitwiseman/gists{/gist_id}",
+  "starred_url": "https://api.github.com/users/bitwiseman/starred{/owner}{/repo}",
+  "subscriptions_url": "https://api.github.com/users/bitwiseman/subscriptions",
+  "organizations_url": "https://api.github.com/users/bitwiseman/orgs",
+  "repos_url": "https://api.github.com/users/bitwiseman/repos",
+  "events_url": "https://api.github.com/users/bitwiseman/events{/privacy}",
+  "received_events_url": "https://api.github.com/users/bitwiseman/received_events",
+  "type": "User",
+  "site_admin": false,
+  "name": "Liam Newman",
+  "company": "Cloudbees, Inc.",
+  "blog": "",
+  "location": "Seattle, WA, USA",
+  "email": "[email protected]",
+  "hireable": null,
+  "bio": null,
+  "twitter_username": "bitwiseman",
+  "public_repos": 202,
+  "public_gists": 8,
+  "followers": 179,
+  "following": 11,
+  "created_at": "2012-07-11T20:38:33Z",
+  "updated_at": "2021-02-25T18:01:06Z",
+  "private_gists": 19,
+  "total_private_repos": 18,
+  "owned_private_repos": 0,
+  "disk_usage": 33700,
+  "collaborators": 0,
+  "two_factor_authentication": true,
+  "plan": {
+    "name": "free",
+    "space": 976562499,
+    "collaborators": 0,
+    "private_repos": 10000
+  }
+}