Merge branch 'master' into feature/126-milestone-references

Author: mdbenito

sample_settings.ts

@@ -32,6 +32,7 @@ export default {
     useLowerCaseLabels: true,
   },
   transfer: {
+    description: true,
     milestones: true,
     labels: true,
     issues: true,

src/githubHelper.ts

@@ -308,6 +308,20 @@ export class GithubHelper {
     );
   }
 
+  /**
+   * Update the description of the repository on GitHub.
+   * Replaces newlines and tabs with spaces. No attempt is made to remove e.g. Markdown
+   * links or other special formatting.
+   */
+  async updateRepositoryDescription(description) {
+    let props : RestEndpointMethodTypes["repos"]["update"]["parameters"] = {
+      owner: this.githubOwner,
+      repo: this.githubRepo,
+      description: description.replace(/\s+/g, " ")
+    }
+    return this.githubApi.repos.update(props);
+  }
+
   /**
    * TODO description
    * @param milestones All GitHub milestones

src/index.ts

@@ -171,6 +171,10 @@ async function migrate() {
     await githubHelper.registerRepoId();
     await gitlabHelper.registerProjectPath(settings.gitlab.projectId);
 
+    if (settings.transfer.description) {
+      await transferDescription();
+    }
+
     if (settings.transfer.milestones) {
       await transferMilestones(
         settings.usePlaceholderMilestonesForMissingMilestones
@@ -207,6 +211,22 @@ async function migrate() {
 
 // ----------------------------------------------------------------------------
 
+/**
+ * Transfer the description of the repository.
+ */
+async function transferDescription() {
+  inform('Transferring Description');
+
+  // Get the description of this project
+  let project = await gitlabApi.Projects.show(
+    settings.gitlab.projectId
+  ) as any;
+
+  await githubHelper.updateRepositoryDescription(project.description);
+}
+
+// ----------------------------------------------------------------------------
+
 /**
  * Transfer any milestones that exist in GitLab that do not exist in GitHub.
  */

src/settings.ts

@@ -12,6 +12,7 @@ export default interface Settings {
     useLowerCaseLabels: boolean;
   };
   transfer: {
+    description: boolean;
     milestones: boolean;
     labels: boolean;
     issues: boolean;