JarCasting
JarCasting JarCasting

detect-file

WebJar for detect-file

License

License

MIT
GroupId

GroupId

org.webjars.npm
ArtifactId

ArtifactId

detect-file
Last Version

Last Version

1.0.0
Release Date

Release Date
Type

Type

jar
Description

Description

detect-file
WebJar for detect-file
Project URL

Project URL

http://webjars.org
Source Code Management

Source Code Management

https://github.com/doowb/detect-file

Download detect-file

Filename Size
detect-file-1.0.0.pom
detect-file-1.0.0.jar 6 KB
detect-file-1.0.0-sources.jar 22 bytes
detect-file-1.0.0-javadoc.jar 22 bytes
Browse

How to add to project

<!-- https://jarcasting.com/artifacts/org.webjars.npm/detect-file/ -->
<dependency>
    <groupId>org.webjars.npm</groupId>
    <artifactId>detect-file</artifactId>
    <version>1.0.0</version>
</dependency>
// https://jarcasting.com/artifacts/org.webjars.npm/detect-file/
implementation 'org.webjars.npm:detect-file:1.0.0'
// https://jarcasting.com/artifacts/org.webjars.npm/detect-file/
implementation ("org.webjars.npm:detect-file:1.0.0")
'org.webjars.npm:detect-file:jar:1.0.0'
<dependency org="org.webjars.npm" name="detect-file" rev="1.0.0">
  <artifact name="detect-file" type="jar" />
</dependency>
@Grapes(
@Grab(group='org.webjars.npm', module='detect-file', version='1.0.0')
)
libraryDependencies += "org.webjars.npm" % "detect-file" % "1.0.0"
[org.webjars.npm/detect-file "1.0.0"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

There are no modules declared in this project.

detect-file NPM version NPM monthly downloads NPM total downloads Linux Build Status Windows Build Status

Detects if a file exists and returns the resolved filepath.

Install

Install with npm:

$ npm install --save detect-file

Install with yarn:

$ yarn add detect-file

Usage

var detect = require('detect-file');

API

detect

Detect the given filepath if it exists.

Params

  • filepath {String}: filepath to detect.
  • options {Object}: Additional options.
  • options.nocase {Boolean}: Set this to true to force case-insensitive filename checks. This is useful on case sensitive file systems.
  • returns {String}: Returns the detected filepath if it exists, otherwise returns null.

Example

var res = detect('package.json');
console.log(res);
//=> "package.json"

var res = detect('fake-file.json');
console.log(res)
//=> null

Case sensitive file systems

When using the nocase option, this library will attempt to detect the filepath with the following methods:

  1. Try to read all files in the filepath using fs.readdirSync. If successful and filepath is a directory, return the filepath.
  2. Try to read all files in the filepath's directory using fs.readdirSync. If successful, do case insensitive comparasions of the filepath to the files in filepath's directory.

About

Related projects

fs-exists-sync: Drop-in replacement for fs.existsSync with zero dependencies. Other libs I found either have crucial differences… more | homepage

Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.

Building docs

(This project's readme.md is generated by verb, please don't edit the readme directly. Any changes to the readme must be made in the .verb.md readme template.)

To generate the readme, run the following command:

$ npm install -g verbose/verb#dev verb-generate-readme && verb

Running tests

Running and reviewing unit tests is a great way to get familiarized with a library and its API. You can install dependencies and run tests with the following command:

$ npm install && npm test

Author

Brian Woodward

License

Copyright © 2017, Brian Woodward. Released under the MIT License.

This file was generated by verb-generate-readme, v0.6.0, on August 05, 2017.

Versions

Version
1.0.0
0.1.0