qleaner 1.0.9 → 1.0.10

package/README.md

@@ -1 +1,133 @@
-# react-cleaner
+# Qleaner
+
+A powerful CLI tool to analyze and clean up your React codebase by finding unused files and listing all imports. Built with Node.js and Babel AST parsing.
+
+## Features
+
+- 🔍 **Scan for unused files**: Identify files that are not imported anywhere in your project
+- 📋 **List all imports**: Get a complete list of all import statements in your codebase
+- 🎯 **File listing**: List all files in your project
+- ⚙️ **Flexible configuration**: Exclude directories and files from scanning
+- 🚀 **Fast performance**: Uses fast-glob for efficient file scanning
+- 💪 **TypeScript support**: Works with TypeScript, JavaScript, JSX, and TSX files
+
+## Installation
+
+```bash
+# Install globally
+npm install -g qleaner
+
+# Or use with npx
+npx qleaner
+
+# Or install locally
+yarn add qleaner
+```
+
+## Usage
+
+### List Imports and Files
+
+List all imports and files in your project:
+
+```bash
+qleaner qlean-list <path> [options]
+```
+
+**Options:**
+- `-l, --list-files` - List all the files in the project
+- `-i, --list-imports` - List all the imports in the project
+- `-e, --exclude-dir <dir...>` - Exclude directories from the scan
+- `-f, --exclude-file <file...>` - Exclude files from the scan
+- `-F, --exclude-file-print <file...>` - Do not print the excluded files
+
+**Examples:**
+
+```bash
+# List all files in src directory
+qleaner qlean-list src --list-files
+
+# List all imports in src directory
+qleaner qlean-list src --list-imports
+
+# List files excluding node_modules and dist
+qleaner qlean-list src --list-files -e node_modules dist
+
+# List imports excluding specific files
+qleaner qlean-list src --list-imports -f "**/*.test.js" "**/*.spec.js"
+```
+
+### Scan for Unused Files
+
+Find files that are not imported anywhere in your project:
+
+```bash
+qleaner qlean-scan <path> [options]
+```
+
+**Options:**
+- `-e, --exclude-dir <dir...>` - Exclude directories from the scan
+- `-f, --exclude-file <file...>` - Exclude files from the scan
+- `-F, --exclude-file-print <files...>` - Do not print the excluded files
+
+**Examples:**
+
+```bash
+# Scan src directory for unused files
+qleaner qlean-scan src
+
+# Scan excluding test directories
+qleaner qlean-scan src -e __tests__ __mocks__ test
+
+# Scan excluding specific file patterns
+qleaner qlean-scan src -f "**/*.test.js" "**/*.stories.js"
+
+# Scan with multiple exclusions
+qleaner qlean-scan src -e node_modules dist -f "**/*.config.js"
+```
+
+## How It Works
+
+1. **File Discovery**: Uses `fast-glob` to recursively find all `.tsx`, `.ts`, `.js`, and `.jsx` files in the specified directory
+2. **AST Parsing**: Uses Babel parser to parse files and extract import statements
+3. **Analysis**: Compares file paths with import paths to identify unused files
+4. **Reporting**: Outputs the results based on the selected command and options
+
+## Supported File Types
+
+- `.js` - JavaScript files
+- `.jsx` - JavaScript React files
+- `.ts` - TypeScript files
+- `.tsx` - TypeScript React files
+
+## Use Cases
+
+- 🧹 **Code cleanup**: Remove dead code and unused files from your React projects
+- 📊 **Code analysis**: Understand import patterns and dependencies in your codebase
+- 🔍 **Project audit**: Identify orphaned files that may have been forgotten
+- 📦 **Bundle optimization**: Find files that can be removed to reduce bundle size
+
+## Configuration
+
+You can exclude directories and files from scanning using the command-line options. This is useful for:
+- Excluding test files
+- Excluding build outputs
+- Excluding third-party libraries
+- Excluding configuration files
+
+## Requirements
+
+- Node.js 14+ 
+- Yarn or npm
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT
+
+## Version
+
+Current version: 1.0.9

package/bin/cli.js

@@ -1,38 +1,74 @@
 #!/usr/bin/env node
 const { Command } = require("commander");
 const { getFiles, unUsedFiles } = require("../command");
+const Table = require('cli-table3')
 
-const program = new Command();
+async function loadChalk() {
+  return (await import("chalk")).default;
+}
 
-program
-  .name("qleaner")
-  .description("A tool to clean up your React code")
-  .version("1.0.0");
+(async () => {
+  const chalk = await loadChalk();
 
-program
-  .command("qlean-list")
-  .description("List all the imports in the project")
-  .argument("<path>", "The path to the directory to scan for imports")
-  .option("-l, --list-files", "List all the files in the project")
-  .option("-i, --list-imports", "List all the imports in the project")
-  .option("-e, --exclude-dir <dir...>", "Exclude directories from the scan")
-  .option("-f, --exclude-file <file...>", "Exclude files from the scan")
-  .option("-F, --exclude-file-print <file...>", "Do not Print the excluded files")
-  .action(async (path, options) => {
-    const imports = await getFiles(path, options);
-  });
+  const program = new Command();
 
-  program.command("qlean-scan")
-  .description("Scan the project for unused files")
-  .argument("<path>", "The path to the directory to scan for unused files")
-  .option("-e, --exclude-dir <dir...>", "Exclude directories from the scan")
-  .option("-f, --exclude-file <file...>", "Exclude files from the scan")
-  .option("-F, --exclude-file-print <files...>", "Do not Print the excluded files")
-  .action(async (path, options) => {
-    const unusedFiles = await unUsedFiles(path, options);
-    // console.clear()
-    unusedFiles.forEach((file) => {
-      console.log(file);
+  program
+    .name("qleaner")
+    .description("A tool to clean up your React code")
+    .version("1.0.0");
+
+  program
+    .command("qlean-list")
+    .description("List all the imports in the project")
+    .argument("<path>", "The path to the directory to scan for imports")
+    .option("-l, --list-files", "List all the files in the project")
+    .option("-i, --list-imports", "List all the imports in the project")
+    .option("-e, --exclude-dir <dir...>", "Exclude directories from the scan")
+    .option("-f, --exclude-file <file...>", "Exclude files from the scan")
+    .option(
+      "-F, --exclude-file-print <file...>",
+      "Do not Print the excluded files"
+    )
+    .option("-t, --table", "Print the results in a table")
+    .action(async (path, options) => {
+      const { tableImports, tableFiles } = await getFiles(path, options, chalk);
+      if(options.table){
+        console.log(chalk.yellow('***************** Imported Files *****************'));
+        console.log(tableImports.toString());
+        console.log(chalk.green('***************** List Files *****************'));
+        console.log(tableFiles.toString());
+      }
+    });
+
+  program
+    .command("qlean-scan")
+    .description("Scan the project for unused files")
+    .argument("<path>", "The path to the directory to scan for unused files")
+    .option("-e, --exclude-dir <dir...>", "Exclude directories from the scan")
+    .option("-f, --exclude-file <file...>", "Exclude files from the scan")
+    .option(
+      "-F, --exclude-file-print <files...>",
+      "Do not Print the excluded files"
+    )
+    .option("-t, --table", "Print the results in a table")
+    .action(async (path, options) => {
+      const unusedFiles = await unUsedFiles(path, options);
+      // console.clear()
+      if(options.table){
+        const table = new Table({
+            head: ['Unused Files'],
+            colWidths: [50]
+        })
+        unusedFiles.forEach(file => {
+            table.push([file])
+        })
+        console.log(table.toString())
+
+      }else {
+        unusedFiles.forEach((file) => {
+            console.log(chalk.red(file));
+          });
+      }
     });
-  });
-program.parse(process.argv);
+  program.parse(process.argv);
+})();

package/command.js

@@ -1,11 +1,13 @@
 const fg = require("fast-glob");
 const fs = require("fs");
-const path = require("path");
+const Table = require('cli-table3');
 const parser = require("@babel/parser");
 const traverse = require("@babel/traverse").default;
 
 
-async function getFiles(directory = "src", options) {
+
+
+async function getFiles(directory = "src", options, chalk) {
     const contentPaths = [`${directory}/**/*.{tsx,ts,js,jsx}`];
     if (options.excludeDir && options.excludeDir.length > 0) {
         options.excludeDir.forEach(dir => {
@@ -49,18 +51,42 @@ async function getFiles(directory = "src", options) {
     //   },
     // });
   }
-
-  if (options.listFiles) {
-    console.log('***************** Files *****************');
-    files.forEach((file) => {
-        console.log(file);
-    })
-  }
-  if (options.listImports) {
-    console.log('***************** Imports *****************');
-    imports.forEach((importStatement) => {
-      console.log(`${importStatement.file}:${importStatement.line}:${importStatement.column}  ${importStatement.from}`);
-    })
+  
+  if (options.table) {
+    const tableImports = new Table({
+        head: ['File', 'Line', 'Column', 'Import'],
+        colWidths: [20, 10, 10, 20],
+      });
+    
+      const tableFiles = new Table({
+        head: ['File'],
+        colWidths: [20],
+      });
+    
+      if (options.listFiles) {
+        files.forEach((file) => {
+            tableFiles.push([file]);
+        })
+      }
+      if (options.listImports) {
+        imports.forEach((importStatement) => {
+          tableImports.push([importStatement.file, importStatement.line, importStatement.column, importStatement.from]);
+        })
+      }
+      return { tableImports, tableFiles };
+  }else{
+    if (options.listFiles) {
+        console.log(chalk.green('***************** Files *****************'));
+        files.forEach((file) => {
+            console.log(chalk.green(file));
+        })
+      }
+      if (options.listImports) {
+        console.log(chalk.yellow('***************** Imports *****************'));
+        imports.forEach((importStatement) => {
+          console.log(chalk.yellow(`${importStatement.file}:${importStatement.line}:${importStatement.column}  ${importStatement.from}`));
+        })
+      }
   }
 }
 
@@ -76,6 +102,7 @@ async function unUsedFiles(directory = "src", options) {
             contentPaths.push(`!${directory}/**/${file}`);
         });
     }
+    
     const files = await fg(contentPaths);
     const imports = [];
     const unusedFiles = [];

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "qleaner",
   "packageManager": "yarn@4.6.0",
-  "version": "1.0.9",
+  "version": "1.0.10",
   "main": "command.js",
   "bin": "./bin/cli.js",
   "scripts": {
@@ -15,6 +15,7 @@
     "@babel/parser": "^7.28.5",
     "@babel/traverse": "^7.28.5",
     "chalk": "^5.6.2",
+    "cli-table3": "^0.6.5",
     "commander": "^14.0.2",
     "fast-glob": "^3.3.3"
   }