Gathering detailed insights and metrics for find-up-simple
Gathering detailed insights and metrics for find-up-simple
Find a file or directory by walking up parent directories — Zero dependencies
Installations
npm install find-up-simpleDeveloper
sindresorhus
Developer Guide
BETA
Module System
ESM
Min. Node Version
>=18
Typescript Support
Yes
Node Version
18.18.2
NPM Version
9.2.0
Statistics
71 Stars
3 Commits
3 Watching
1 Branches
1 Contributors
Updated on 22 Oct 2024
Bundle Size
1.26 kB
Minified
545.00 B
Minified + Gzipped
Languages
JavaScript (100%)
Total Downloads
Cumulative downloads
Total Downloads
60,323,350
Last day
-15.7%
398,922
Compared to previous day
Last week
3.9%
2,181,537
Compared to previous week
Last month
11.7%
9,358,682
Compared to previous month
Last year
7,113%
59,498,468
Compared to previous year
Daily Downloads
Weekly Downloads
Monthly Downloads
Yearly Downloads
Versions
find-up-simple
Find a file or directory by walking up parent directories
This is a simpler version of my find-up package, now with zero dependencies.
Install
1npm install find-up-simple
Usage
/
└── Users
└── sindresorhus
├── unicorn.png
└── foo
└── bar
├── baz
└── example.js
example.js
1import path from 'node:path'; 2import {findUp} from 'find-up-simple'; 3 4console.log(await findUp('unicorn.png')); 5//=> '/Users/sindresorhus/unicorn.png'
API
findUp(name, options?)
Returns a Promise for the found path or undefined if it could not be found.
findUpSync(name, options?)
Returns the found path or undefined if it could not be found.
name
Type: string
The name of the file or directory to find.
options
Type: object
cwd
Type: URL | string
Default: process.cwd()
The directory to start from.
type
Type: string
Default: 'file'
Values: 'file' | 'directory'
The type of path to match.
stopAt
Type: URL | string
Default: Root directory
A directory path where the search halts if no matches are found before reaching this point.
FAQ
How is it different from find-up?
- No support for multiple input names
- No support for finding multiple paths
- No custom matching
- No symlink option
- Zero dependencies
Related
- find-up - A more advanced version of this package
- find-up-cli - CLI for this module
- package-up - Find the closest package.json file
- pkg-dir - Find the root directory of an npm package
No vulnerabilities found.
Reason
no binaries found in the repo
Reason
no dangerous workflow patterns detected
Reason
security policy file detected
Details
- Info: security policy file detected: .github/security.md:1
- Info: Found linked content: .github/security.md:1
- Info: Found disclosure, vulnerability, and/or timelines in security policy: .github/security.md:1
- Info: Found text in security policy: .github/security.md:1
Reason
0 existing vulnerabilities detected
Reason
license file detected
Details
- Info: project has a license file: license:0
- Info: FSF or OSI recognized license: MIT License: license:0
Reason
Found 0/3 approved changesets -- score normalized to 0
Reason
0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0
Reason
no SAST tool detected
Details
- Warn: no pull requests merged into dev branch
Reason
no effort to earn an OpenSSF best practices badge detected
Reason
detected GitHub workflow tokens with excessive permissions
Details
- Warn: no topLevel permission defined: .github/workflows/main.yml:1
- Info: no jobLevel write permissions found
Reason
dependency not pinned by hash detected -- score normalized to 0
Details
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/main.yml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/sindresorhus/find-up-simple/main.yml/main?enable=pin
- Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/main.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/sindresorhus/find-up-simple/main.yml/main?enable=pin
- Warn: npmCommand not pinned by hash: .github/workflows/main.yml:21
- Info: 0 out of 2 GitHub-owned GitHubAction dependencies pinned
- Info: 0 out of 1 npmCommand dependencies pinned
Reason
project is not fuzzed
Details
- Warn: no fuzzer integrations found
Reason
branch protection not enabled on development/release branches
Details
- Warn: branch protection not enabled for branch 'main'
Score
4.1
/10
Last Scanned on 2024-11-18
The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.
Learn More