npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

fs-finder-updated

v2.1.0

Published

File system recursive finder

Downloads

3

Readme

This repo is solely meant for automated updates of dependencies found in Carrooi's Node-FsFinder package.

PRs will not be accepted for new features or bug fixes. Reach out to the original maintainer.

npm install fs-finder-updated

NPM version Dependency Status Build Status

Donate

fs-finder

File system finder inspired by finder in Nette framework.

Help

Unfortunately I don't have any more time to maintain this repository :-(

Don't you want to save me and this project by taking over it?

sad cat

Installing

$ npm install fs-finder

Searching

There are two ways of searching for files or directories: synchronous and asynchronous.

Synchronous

Searching files in directory

var Finder = require('fs-finder');

var files = Finder.in('/var/data/base-path').findFiles();		// returns array with file's names

Searching directories

var directories = Finder.in(baseDir).findDirectories();		// returns array with directories's names

Searching for files and directories

var paths = Finder.in(baseDir).find();		// returns array with file's and directories's names

Asynchronous

If fs-finder find callback in find* methods, it will automatically use asynchronous searching.

Searching files in directory

Finder.in('/var/data/base-path').findFiles(function(files) {
	console.log(files);
});

Searching directories

Finder.in(baseDir).findDirectories(function(directories) {
	console.log(directories);
});

Searching for files and directories

var paths = Finder.in(baseDir).find(function(paths) {
	console.log(paths);
});

Recursive searching

var paths = Finder.from(baseDir).find();

Path mask

var files = Finder.from(baseDir).findFiles('*.coffee');

or asynchronous:

Finder.from(baseDir).findFiles('*.coffee', function(files) {
	// do something with given list of files
});

In this example fs finder looks for all files in base directories recursively with '.coffee' in their name. Asterisk is just shortcut for regexp '[0-9a-zA-Z/.-_ ]+' so you can also use regexp in mask.

Only thing what you have to do, is enclose your regex into <>.

var files = Finder.from(baseDir).findFiles('temp/<[0-9]+>.tmp');		// files in temp directories with numbers in name and .tmp extension

Excluding

Same technique like path mask works also for excluding files or directories.

var files = Finder.from(baseDir).exclude(['/.git']).findFiles();

This code will return all files from base directory but not files beginning with .git or in .git directory. Also there you can use regular expressions or asterisk.

Filters

Filtering by file size

var files = Finder.from(baseDir).size('>=', 450).size('<=' 500).findFiles();

Returns all files with size between 450B and 500B.

Filtering by modification date

var files = Finder.from(baseDir).date('>', {minutes: 10}).date('<', {minutes: 1}).findFiles();

Returns all files which were modified between two and nine minutes ago. Date filter expecting literal object (you can see documentation in moment.js documentation) or string date representation in YYYY-MM-DD HH:mm format.

Custom filters

var filter = function(stat, path) {
	if ((new Date).getMinutes() === 42) {
		return true;
	} else {
		return false;
	}
});

var files = Finder.from(baseDir).filter(filter).findFiles();

Returns all files if actual time is any hour with 42 minutes. Custom filters are anonymous function with stat file object parameter (documentation) and file name.

System and temp files

In default, fs-finder ignoring temp and system files, which are created for example by gedit editor and which have got ~ character in the end of file name or dot in the beginning.

var files = Finder.in(dir).showSystemFiles().findFiles()

Look in parent directories

Finder can also look for files in parent directories. There is used exclude method, so directories in which were your files already searched, will not be opened for searching again in their next parent directory if you are using from method.

Keep in mind that one of parent directories is also your disk root directory, so you can get list of all of your files or directories on disk which are accessible from your user account. To avoid this, you can set depth.

var files = Finder.in(dir).lookUp().findFiles('5.log');

// set depth with number of parent directories
var files = Finder.in(dir).lookUp(3).findFiles('5.log');

// set depth with path to top directory
var files = Finder.in(dir).lookUp('/var/stop/here').findFiles('5.log');

Find first

When you want to find first occur of some file or directory, you can use option findFirst. fs-finder will not look into all directories (for recursive searching) but stop when it will find first matching path.

If there is no matching path, null will be returned.

var file = Finder.from(dir).findFirst().findFiles('<[0-9]{2}>');

There is also shortcut:

var file = Finder.from(dir).findFile('<[0-9]{2}>');

or:

var directory = Finder.from(dir).findDirectory();

Tests

$ npm test

If you want to use fs-finder in your own tests, you can use it with fs-mock module, which is already build it.

For more information how to use it, please read documentation for fs-mock.

var fs = null;

beforeEach(function() {
	fs = Finder.mock({
		'var': {
			'www': {
				'index.php': '<?php echo "hello; ?>'
			}
		}
	});
});

afterEach(function() {
	Finder.restore();
});

In fs variable is now mocked fs module, so if you need to use fs module in your tests, just use this one.

Changelog

  • 1.8.1

    • Move under Carrooi organization
    • Abandon package
  • 1.8.0

    • Added asynchronous searching
    • Optimized searching
    • Using fs-mock for testing
    • Refactoring tests
    • Optimized dependencies
    • Better documentation
  • 1.7.4

    • Bug in lookUp method
  • 1.7.3

    • Bug in lookUp method
  • 1.7.2

    • Added option to set depth in lookUp with path
  • 1.7.1

    • Catch errors when accessing secured paths (via lookUp option)
  • 1.7.0

    • Mistake in test
    • Bug in Finder (filters were shared across all instances)
    • Preferred way is to use 'static' methods
    • Tests uses 'static' methods
    • Added findFirst option
  • 1.6.0

    • New reporter for tests
    • Tests rewritten to coffeescript
    • Added lookUp option
    • Typos in readme
  • 1.5.1

  • 1.5.0

    • Added changelog
    • Created tests (npm test)
    • Repaired bugs with hiding system and temp files
  • 1.4.3

    • Added MIT license
  • 1.4.2

    • Renamed repository from fs-finder to node-fs-finder
  • 1.4.1

    • Type in readme
  • 1.4.0

    • Every regexp must be enclosed in <> (before this, dots means everything, not dot)
    • Every character, which does mean something in regexp and is not in <>, is escaped
  • 1.3.0 (it seems that I skipped this version, sorry)

  • 1.2.0

    • Added in, from methods
  • 1.1.0

    • Added shortcuts "static" methods
  • 1.0.1

    • Some bug in combination with simq
  • 1.0.0

    • Initial commit