@vjlanguage/extend-file-collector

CLI tool for recursively collecting files with specific extensions and copying them to a target directory.

Installation

# Install globally
npm install -g @vjlanguage/extend-file-collector

# Or from the project directory
cd /path/to/extend-file-collector
npm install
npm link

Usage

vj-file-collect <sourceDir> [options]

Arguments

• <sourceDir>: The source directory to search for files (required)

Options

• -e, --extension <ext>: File extension to collect without the dot (default: "svg")
• -t, --target <directory>: Target directory for collected files (default: "~/target-directory/files")
• -h, --help: Display help information
• -V, --version: Display version number

Examples

# Collect all SVG files from the current directory and copy to default target
vj-file-collect .

# Collect PNG files from a specific directory and copy to a custom target
vj-file-collect /path/to/source -e png -t ~/my-images/png-files

# Display help
vj-file-collect --help

Features

• Recursively searches directories for files with specified extensions
• Automatically expands tilde (~) in paths to the user's home directory
• Creates target directory if it doesn't exist
• Provides summary of operation after completion

API

The package can also be used programmatically:

const fileCollector = require('@vjlanguage/extend-file-collector');

// Expand tilde in path
const expandedPath = fileCollector.expandTilde('~/some/path');

// Find files with specific extension
const files = fileCollector.findFiles('/path/to/source', 'svg');

// Ensure directory exists
fileCollector.ensureDirectoryExists('/path/to/directory');

// Copy files to target directory
fileCollector.copyFilesToTarget(files, '/path/to/target');