feat: improve UX

Author: yangshun

README.md

@@ -1,12 +1,12 @@
 # Delete GitHub Forks
 
-Delete your forked GitHub repositories easily in two steps.
+Delete your forked GitHub repositories easily in two steps (takes less than 5 minutes).
 
-**Note:** Node 8+ is required because some new language features are used.
+## Motivation
 
-## Motivations
+Deleting GitHub repositories via the GitHub interface is a hassle; you have to enter your password followed by the name of the repository. This is not scalable if you contribute to open source a fair bit and have many forked repositories that you may not necessarily want to keep.
 
-Deleting GitHub repositories via the GitHub interface is a hassle; you have to enter your password followed by the name of the repository. This is not scalable if you contribute to open source a fair bit and have many forked repositories that you may not necessarily want to keep. Using this script, you can fetch a list of your GitHub repositories and delete the unwanted repositories in one go.
+Using these scripts, you can fetch a list of your GitHub repositories and delete all the unwanted repositories in one go.
 
 ## Getting Started
 
@@ -24,13 +24,13 @@ Add your GitHub username and access token to `config.json`. To get the access to
 Firstly, run the following command to fetch all your forked repositories.
 
 ```sh
-$ npm run fetch-repos # Writes to a src/repos.json file
+$ npm run fetch # Writes to a src/repos.json file
 ```
 
 A JSON file, `src/repos.json` containing an array of your repositories will be written into the same directory. Manually inspect it and remove the forked repositories that you want to keep. **The repositories that remain inside `src/repos.json` will be deleted on the next command. It is an irreversible operation. Use with great caution!**.
 
 ```sh
-$ npm run delete-repos # Reads from src/repos.json and deletes the repos inside it.
+$ npm run delete # Reads from src/repos.json and deletes the repos inside it.
 ```
 
 And all the repositories within `src/repos.json` will be deleted! It's that easy.

package.json

@@ -1,17 +1,17 @@
 {
   "name": "delete-github-forks",
   "version": "0.1.0",
-  "description": "Delete your Github forks.",
-  "main": "fetch-repos.js",
+  "author": "Yangshun Tay",
+  "description": "Delete your GitHub forks in bulk.",
+  "scripts": {
+    "fetch": "node src/fetchRepos.js",
+    "delete": "node src/deleteRepos.js"
+  },
   "dependencies": {
     "axios": "^0.21.2"
   },
-  "devDependencies": {},
-  "scripts": {
-    "fetch-repos": "node src/fetch-repos.js",	
-    "delete-repos": "node src/delete-repos.js",	
-    "test": "echo \"Error: no test specified\" && exit 1"
+  "engines": {
+    "node": ">=12.0.0"
   },
-  "author": "Yangshun Tay",
   "license": "MIT"
 }

src/delete-repos.js

@@ -0,0 +1,58 @@
+const axios = require('axios');
+const config = require('./config');
+const readline = require('readline');
+
+const reposForDeletion = require('./repos');
+
+async function deleteRepos(repos) {
+  let deleted = 0;
+  let failed = 0;
+
+  for (let i = 0; i < repos.length; i++) {
+    const repo = repos[i];
+    const URL = `${config.api_url}/repos/${repo}`;
+
+    try {
+      await axios.delete(URL, {
+        headers: {
+          Accept: 'application/vnd.github.v3+json',
+          Authorization: `token ${config.access_token}`,
+        },
+      });
+      deleted++;
+      console.log(`${repo} deleted!`);
+    } catch (err) {
+      failed++;
+      console.error(`Error deleting ${repo}`);
+    }
+  }
+
+  if (deleted > 0) {
+    console.log(`${deleted} repo(s) deleted!`);
+  }
+
+  if (failed > 0) {
+    console.log(`Failed to delete ${failed} repo(s)`);
+  }
+}
+
+const rl = readline.createInterface({
+  input: process.stdin,
+  output: process.stdout,
+  terminal: false,
+});
+
+console.log('The following repos will be deleted:');
+console.log(reposForDeletion.map((repo) => `- ${repo}`).join('\n'));
+console.log();
+console.log('Are you sure you want to delete the following repos? y/n');
+
+rl.on('line', async function (line) {
+  if (line.trim().toLowerCase() === 'y') {
+    console.log();
+    await deleteRepos(reposForDeletion);
+  }
+
+  // Terminate the process.
+  rl.close();
+});

src/deleteRepos.js

@@ -0,0 +1,55 @@
+const axios = require('axios');
+const fs = require('fs');
+const path = require('path');
+
+const config = require('./config');
+
+const username = config.github_username;
+const URL = `${config.api_url}/users/${username}/repos`;
+const OUT_FILE = 'src/repos.json';
+
+async function fetchRepos(url) {
+  const repos = [];
+  let page = 1;
+
+  while (true) {
+    try {
+      const res = await axios.get(url, {
+        headers: {
+          Accept: 'application/vnd.github.v3+json',
+          Authorization: `token ${config.access_token}`,
+        },
+        params: {
+          page,
+        },
+      });
+
+      if (res.data.length === 0) {
+        break;
+      }
+
+      const forkedRepos = res.data
+        .filter((repo) => repo.fork)
+        .map((repo) => repo.full_name);
+      console.log(`[Page ${page}] Found ${forkedRepos.length} forked repo(s):`);
+      console.log(forkedRepos.map((repo) => `- ${repo}`).join('\n') + '\n');
+      repos.push(...forkedRepos);
+      page++;
+    } catch (err) {
+      console.error(`Error fetching page ${page}: ${err}`);
+      break;
+    }
+  }
+
+  return repos;
+}
+
+fetchRepos(URL).then((result) => {
+  console.log('Forked repos found:', result.length);
+  console.log(result.map((repo) => `- ${repo}`).join('\n'));
+  console.log();
+  fs.writeFileSync(OUT_FILE, JSON.stringify(result, null, 2));
+  console.log(
+    `Wrote forked repos into "${path.join(process.cwd(), OUT_FILE)}"`,
+  );
+});