get-exts

A command-line tool to scan directories recursively and return a list of file extensions found within them.

Installation

Global Installation

npm install -g get-exts

Using npx (Recommended)

npx get-exts [directories...] [options]

Usage

Basic Usage

# Scan current directory
get-exts

# Scan specific directories
get-exts /path/to/directory1 /path/to/directory2

# Scan multiple directories
get-exts src/ lib/ tests/

Options

• -c, --count - Show count of files for each extension
• -h, --hidden - Include hidden files and directories
• -e, --exclude-dirs <dirs> - Comma-separated list of directories to exclude (default: node_modules,.git,.vscode,.idea)
• -x, --exclude-exts <extensions> - Comma-separated list of extensions to exclude
• -j, --json - Output results in JSON format
• -s, --sort <method> - Sort method: count, name, or none (default: name)
• -f, --formatted - Output in formatted display mode (default is plain comma-separated)
• -V, --version - Show version number
• --help - Show help information

Examples

# Basic scan of current directory
get-exts

# Scan with file counts
get-exts --count

# Include hidden files
get-exts --hidden

# Exclude specific directories
get-exts --exclude-dirs "node_modules,dist,build"

# Exclude specific extensions
get-exts --exclude-exts ".log,.tmp,.cache"

# Output as JSON
get-exts --json

# Formatted display mode
get-exts --formatted

# Formatted output with counts
get-exts --formatted --count

# Sort by count (most files first)
get-exts --count --sort count

# Scan multiple directories with custom options
get-exts src/ lib/ --count --exclude-dirs "node_modules,temp" --json

Features

• Recursive Scanning: Automatically scans subdirectories
• Smart Exclusions: Excludes common directories like node_modules, .git, etc.
• Hidden File Support: Option to include or exclude hidden files
• Extension Filtering: Exclude specific file extensions from results
• Count Mode: Show how many files exist for each extension
• Multiple Output Formats: Plain text or JSON output
• Flexible Sorting: Sort by extension name or file count
• Multiple Directory Support: Scan multiple directories at once

Output Examples

Default Output (comma-separated without dots)

js,json,md,txt

Formatted Output

File Extensions Found:
==============================
.js
.json
.md
.txt
==============================
Scanned 1 directory: .

Count Mode Output

File Extensions Found:
==============================
.js: 15
.json: 3
.md: 2
.txt: 1
==============================
Scanned 1 directory: .

JSON Output

{
  ".js": 15,
  ".json": 3,
  ".md": 2,
  ".txt": 1
}

Default Output with Counts

js:15,json:3,md:2,txt:1

Development

Local Development

# Clone the repository
git clone <repository-url>
cd get-exts

# Install dependencies
npm install

# Run locally
npm start

# Or run the CLI directly
node bin/cli.js

Publishing to npm

# Login to npm
npm login

# Publish the package
npm publish

License

MIT

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

Issues

If you encounter any issues or have feature requests, please open an issue on the GitHub repository.