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

Author: mdbenito

.vscode/launch.json

@@ -19,7 +19,8 @@
         "src/index.ts"
       ],
       "protocol": "inspector",
-      "sourceMaps": true
+      "sourceMaps": true,
+      "console": "integratedTerminal"
     }
   ]
 }

README.md

@@ -86,6 +86,12 @@ Set to the user name of the user whose token is used (see above). This is requir
 
 What is the name of the new repo
 
+#### github.recreateRepo
+
+If true (default is false), we will try to delete the destination github repository if present, and (re)create it. The github token must be granted `delete_repo` scope. The newly created repository will be made private by default.
+
+This is useful when debugging this tool or a specific migration. You will always be prompted for confirmation.
+
 ### s3 (optional)
 
 S3 can be used to store attachments from issues. If omitted, `has attachment` label will be added to GitHub issue.

package-lock.json

@@ -33,11 +33,13 @@
     "aws-sdk": "^2.1053.0",
     "axios": "^0.24.0",
     "mime-types": "^2.1.34",
+    "readline-sync": "^1.4.10",
     "ts-node": "^10.4.0"
   },
   "devDependencies": {
     "@types/mime-types": "^2.1.1",
-    "@types/node": "^14.0.20",
+    "@types/node": "^14.18.5",
+    "@types/readline-sync": "^1.4.4",
     "husky": "^7.0.4",
     "lint-staged": "^12.1.7",
     "prettier": "^2.5.1",

package.json

@@ -14,6 +14,7 @@ export default {
     token: '{{token}}',
     token_owner: '{{token_owner}}',
     repo: '{{repo}}',
+    recreateRepo: false,
   },
   s3: {
     accessKeyId: '{{accessKeyId}}',

sample_settings.ts

@@ -1379,4 +1379,34 @@ export class GithubHelper {
       milestoneData.forEach(m => this.milestoneMap.set(m.number, m));
     }
   }
+
+  /**
+   * Deletes the GH repository, then creates it again.
+   */
+  async recreateRepo() {
+    let params = {
+      owner: this.githubOwner,
+      repo: this.githubRepo,
+    };
+
+    try {
+      console.log(`Deleting repo ${params.owner}/${params.repo}...`);
+      await this.githubApi.repos.delete(params);
+      console.log('\t...done.');
+    } catch (err) {
+      if (err.status == 404) console.log(' not found.');
+      else console.error(`\n\tSomething went wrong: ${err}.`);
+    }
+    try {
+      console.log(`Creating repo ${params.owner}/${params.repo}...`);
+      await this.githubApi.repos.createForAuthenticatedUser({
+        name: this.githubRepo,
+        private: true,
+      });
+      console.log('\t...done.');
+    } catch (err) {
+      console.error(`\n\tSomething went wrong: ${err}.`);
+    }
+    await utils.sleep(this.delayInMs);
+  }
 }

src/githubHelper.ts

@@ -11,6 +11,7 @@ import { Octokit as GitHubApi } from '@octokit/rest';
 import { throttling } from '@octokit/plugin-throttling';
 import { Gitlab } from '@gitbeaker/node';
 
+import { default as readlineSync } from 'readline-sync';
 import * as fs from 'fs';
 
 import AWS from 'aws-sdk';
@@ -94,11 +95,28 @@ if (!settings.gitlab.projectId) {
   gitlabHelper.listProjects();
 } else {
   // user has chosen a project
+  if (settings.github.recreateRepo === true) {
+    recreate();
+  }
   migrate();
 }
 
 // ----------------------------------------------------------------------------
 
+/**
+ * Asks for confirmation and maybe recreates the GitHub repository.
+ */
+async function recreate() {
+  readlineSync.setDefaultOptions({
+    limit: ['no', 'yes'],
+    limitMessage: 'Please enter yes or no',
+    defaultInput: 'no',
+  });
+  const ans = readlineSync.question('Delete and recreate? [yes/no] ');
+  if (ans == 'yes') await githubHelper.recreateRepo();
+  else console.log("OK, I won't delete anything then.");
+}
+
 /**
  * Creates dummy data for a placeholder milestone
  *

src/index.ts

@@ -43,6 +43,7 @@ export interface GithubSettings {
   repo: string;
   timeout?: number;
   username?: string; // when is this set???
+  recreateRepo?: boolean;
 }
 
 export interface GitlabSettings {