Paths-LE: Zero Hassle Path Extraction

Extract thousands of paths in under a second
JavaScript, TypeScript, JSON, HTML, CSS, TOML, CSV, and Environment files

⚡ See It In Action

Before: Manually searching through 500 lines for import paths (15 minutes)

import { Button } from './components/Button'
import { Header } from '../layout/Header'
// ... 50 more imports scattered across files

After: One command extracts all 52 paths in under a second

./components/Button (line 1)
../layout/Header (line 2)
./utils/helpers (line 15)
... (52 paths total)

Time Saved: Minutes → Under a second ⚡

✅ Why Paths-LE?

• Extract thousands of paths in under a second - Faster than manual searching
• Zero Config - Install → Press Cmd+Alt+P → Done
• Battle-Tested - 289 unit tests, 93.55% coverage, zero critical vulnerabilities
• Security-Hardened - 64 tests prevent path traversal, symlink exploits, injection attacks

Perfect for refactoring, dependency audits, and import analysis.

🙏 Thank You

If Paths-LE saves you time, a quick rating helps other developers discover it:
⭐ Open VSX • VS Code Marketplace

Key Features

• Complete path detection - Absolute, relative, Windows, Unix formats
• Powerful post-processing - Deduplicate and sort (alphabetically or by length)
• Dependency analysis - Identify missing files and circular dependencies
• 9 file formats - JavaScript, TypeScript, JSON, HTML, CSS, TOML, CSV, ENV, Log
• Smart filtering - Excludes npm packages (like 'react' or 'lodash')
• Cross-platform - Handles both Windows and Unix paths
• Canonical resolution 🆕 - Monorepo and symlink support (disabled by default for security)
• 13 languages - English, Chinese, German, Spanish, French, Indonesian, Italian, Japanese, Korean, Portuguese, Russian, Ukrainian, Vietnamese

🚀 More from the LE Family

• String-LE - Extract user-visible strings for i18n and validation • VS Code Marketplace
• Numbers-LE - Extract and analyze numeric data with statistics • VS Code Marketplace
• EnvSync-LE - Keep .env files in sync with visual diffs • VS Code Marketplace
• Regex-LE - Test and validate regex patterns with live feedback • VS Code Marketplace
• Secrets-LE - Detect and sanitize secrets before you commit • VS Code Marketplace
• Scrape-LE - Validate scraper targets before debugging • VS Code Marketplace
• Colors-LE - Extract and analyze colors from stylesheets • VS Code Marketplace
• URLs-LE - Extract URLs from any codebase with precision • VS Code Marketplace
• Dates-LE - Extract temporal data from logs and APIs • VS Code Marketplace

💡 Use Cases

• Import Analysis - Extract local imports from JS/TS (auto-excludes npm packages)
• Asset Auditing - Find all images, scripts, and styles referenced in HTML/CSS
• Config Validation - Pull file paths from JSON/TOML configs for verification
• Dependency Mapping - Track file references across your codebase

TOML & Environment Files

Extract file paths from configuration files:

# Extract from config.toml
[paths]
data_dir = "./data"
log_file = "/var/log/app.log"
backup_path = "C:\\backups\\app"

# Extract from .env
DATABASE_PATH=./data/app.db
LOG_FILE=/var/log/app.log
BACKUP_DIR=C:\backups

CSV Data Analysis

Extract paths from CSV data files:

path,type,description
./src/main.js,file,Main application file
/var/log/app.log,file,Application log
C:\Users\Name\data,dir,User data directory

Dependency Mapping & Validation

• Map file dependencies across JavaScript/TypeScript projects
• Identify missing or broken references in HTML/CSS
• Validate configuration file paths
• Analyze import patterns and detect circular dependencies

🚀 Quick Start

1. Install from Open VSX or VS Code Marketplace
2. Open any supported file (.js, .ts, .json, .html, .css, .toml, .csv, .env)
3. Run Paths-LE: Extract Paths (Cmd+Alt+P / Ctrl+Alt+P)
4. Use Deduplicate Paths or Sort Paths commands for post-processing

📋 Available Commands

Paths-LE provides 9 commands accessible via Command Palette (Ctrl+Shift+P / Cmd+Shift+P):

Core Extraction

• Extract Paths (Cmd/Ctrl+Alt+P) - Extract all file paths from current document

Post-Processing

• Deduplicate Paths - Remove duplicate path entries while preserving order
• Sort Paths - Sort extracted paths with multiple modes:
  • Alphabetical (A → Z)
  • Alphabetical (Z → A)
  • By Length (Short → Long)
  • By Length (Long → Short)

Settings & Help

• Open Settings - Quick access to extension settings
• Help & Troubleshooting - Comprehensive in-editor documentation
• Export/Import/Reset Settings - Manage extension configuration
• Create Test Fixture - Generate a complete test environment for canonical path resolution

⚙️ Configuration

Paths-LE has minimal configuration to keep things simple. Most settings are available in VS Code's settings UI under "Paths-LE".

Key settings include:

• Output format preferences (side-by-side, clipboard copy)
• Safety warnings and thresholds for large files
• Notification levels (silent, important, all)
• Status bar visibility
• Local telemetry logging for debugging

For the complete list of available settings, open VS Code Settings and search for "paths-le".

📁 Supported File Types

Paths-LE supports 9 file types for path extraction:

Smart Features

• JavaScript/TypeScript: Excludes npm package names—only extracts local file paths
• HTML: Automatically excludes data: and javascript: URLs
• CSS: Automatically excludes data: URLs
• All types: Handles Windows (C:\) and Unix (/) paths, plus URLs

🌍 Language Support

13 languages: English, German, Spanish, French, Indonesian, Italian, Japanese, Korean, Portuguese (Brazil), Russian, Ukrainian, Vietnamese, Chinese (Simplified)

🧩 System Requirements

VS Code 1.70.0+ • Platform Windows, macOS, Linux
Memory 200MB recommended for large files

🔒 Privacy

100% local processing. No data leaves your machine. Optional logging: paths-le.telemetryEnabled

⚡ Performance

Paths-LE is built for speed and handles files from 100KB to 30MB+. See detailed benchmarks.

Real-World Performance: Tested with actual data up to 30MB (practical limit: 1MB warning, 10MB error threshold)
Performance Monitoring: Built-in real-time tracking with configurable thresholds
Full Metrics: docs/PERFORMANCE.md • Test Environment: macOS, Bun 1.2.22, Node 22.x

🔧 Troubleshooting

Not detecting paths?
Ensure file is saved with supported extension (.js, .ts, .json, .html, .css, .toml, .csv, .env)

Large files slow?
Files over 10MB may take longer. Consider splitting into smaller chunks

Need help?
Check Issues or enable logging: paths-le.telemetryEnabled: true

❓ FAQ

What paths are extracted?
Absolute (/usr/local), relative (./src), Windows (C:\Users), Unix (/home) paths

JS/TS imports?
Auto-excludes npm packages (react, lodash) - only extracts local file paths

Cross-platform?
Yes! Handles both Windows and Unix path formats automatically

Max file size?
Up to 30MB. Practical limit: 10MB for optimal performance

📊 Testing

289 unit tests • 93.55% function coverage, 84.32% line coverage
Powered by Vitest • Run with bun run test:coverage

Core Principle

No broken or failed tests are allowed in commits. All tests must pass before code can be committed or merged.

For detailed testing guidelines, see Testing Guidelines.

Test Suite Breakdown

Performance Benchmarks (Internal)

Real-world extraction speeds tested on macOS (Apple Silicon):

• HTML: 1.96M paths/sec (675 lines, 0.03MB file, 667 paths extracted)
• JSON: 2.23M paths/sec (196K lines, 6.07MB file, 125K paths extracted)
• CSV: 1.01M paths/sec (89K lines, 10MB file, 449K paths extracted)
• TOML: 105K paths/sec (1.1K lines, 0.02MB file, 556 paths extracted)
• JavaScript: 914K paths/sec (268 lines, 0.01MB file, 201 paths extracted)

Running Tests Locally

bun run test              # Run all 289 tests
bun run test:coverage     # Generate detailed coverage report
bun run test:watch        # Watch mode for development

Coverage reports are generated in coverage/ directory (open coverage/index.html for detailed view).

Testing Canonical Path Resolution

For Extension Users (easiest method):

1. Open Command Palette (Ctrl+Shift+P / Cmd+Shift+P)
2. Run Paths-LE: Create Test Fixture
3. Select a folder where you want to create the test environment
4. Follow the prompts to open the generated test workspace

For Developers (from repository):

# 1. Setup test environment
cd test-fixtures/monorepo-test
./setup-symlinks.sh

# 2. Open test workspace
code workspace.code-workspace

Testing the Feature:

1. Enable canonical resolution in VS Code settings:

   • Paths-le › Resolution: Resolve Symlinks ✅
   • Paths-le › Resolution: Resolve Workspace Relative ✅

2. Open test file: packages/frontend/src/symlink-test.js

3. Run extraction: Paths-LE: Extract Paths (Cmd+Alt+P)

4. Expected results:

   • Before: ./utils-link.js (symlink path)
   • After: /full/path/to/packages/shared/src/utils.js (resolved canonical path)

The test fixture includes a complete monorepo with symlinks, cross-package imports, and comprehensive documentation for testing all canonical path resolution features.

🔒 Security Considerations

Canonical Path Resolution

⚠️ IMPORTANT SECURITY NOTICE: Canonical path resolution is disabled by default for security reasons.

Why it's disabled:

• May expose sensitive file system paths in extracted output
• Could reveal internal directory structures
• Might leak information about development environment setup

When to enable:

• ✅ Trusted development environments
• ✅ Internal monorepo workflows
• ✅ When you control the output destination
• ❌ Public repositories or shared workspaces
• ❌ When output might be shared externally

Security Settings:

{
  "paths-le.resolution.resolveSymlinks": false, // Default: disabled
  "paths-le.resolution.resolveWorkspaceRelative": false // Default: disabled
}

First-time Warning: When you first enable canonical resolution, Paths-LE will show a security warning dialog with options to:

• Continue with canonical resolution
• Disable and continue with standard resolution
• Learn more about security implications

Copyright © 2025 @OffensiveEdge. All rights reserved.