@puppedo/walk-sync

Synchronously walks through a directory and its subdirectories, returning an array of file paths.

Installation

1npm install @puppedo/walk-sync

Usage

1import { walkSync } from '@puppedo/walk-sync';
2
3const files = walkSync('./my-directory', {
4  ignoreFolders: ['node_modules', '.git'],
5  includeExtensions: ['.ts', '.js'],
6  ignoreFiles: ['.eslintrc.js', 'tsconfig.json'],
7  depth: 2, // Optional: limits the recursion depth
8});
9
10console.log(files); // Output: array of file paths

API

walkSync(dir, options)

• dir: string - The directory to start walking from.

• options: object - Options for the walk.

  • ignoreFolders: string[] - An array of folder names to ignore.
  • includeExtensions: string[] - An array of file extensions to include. If not provided, all file extensions are included.
  • ignoreFiles: string[] - An array of file names to ignore. Matching is done against the full file name, not just the extension.
  • depth: number - The maximum depth to walk. A value of 1 will only include files directly within the dir directory. If not provided, there is no depth limit.

• Returns: string[] - An array of file paths.

Examples

Basic usage:

1const files = walkSync('./path/to/directory');
2console.log(files);

Ignoring folders:

1const files = walkSync('./path/to/directory', {
2  ignoreFolders: ['node_modules', 'dist'],
3});
4console.log(files);

Filtering by extension:

1const tsFiles = walkSync('./path/to/directory', {
2  includeExtensions: ['.ts'],
3});
4console.log(tsFiles);

Limiting recursion depth:

1const files = walkSync('./path/to/directory', {
2  depth: 1, // Only files directly in the directory
3});
4console.log(files);

License

ISC