@danielbayley/uproot v0.1.2

Uproot

Reliable method to find the root path of your git repository, [p]npm/yarn package, or app.

The algorithm is primarily reliant on git rev-parse --show-toplevel, but will fallback on the following glob patterns to determine the root path:

Examples

import {root} from "@danielbayley/uproot"
console.log(root) // ~/path/to/project/root

import {uproot} from "@danielbayley/uproot"

const cwd  = import.meta.dirname
const root = await uproot({ cwd })

You can override the above search patterns with the match option:

const root = await uproot({ match: ["tsconfig.json"] })

or append an additional pattern to find:

import { uproot, match } from "@danielbayley/uproot"

match.push("tsconfig.json")
const root = await uproot({ match })

Any additional options will be passed onto matchup:

import path from "node:path"

const object = await uproot({ cwd, parse: true })
const root = path.format(object)
console.log(root) // ~/path/to/project/root

Install

pnpm install @danielbayley/matchup

!IMPORTANT This package is ESM only, so must be imported instead of required, and depends on Node >=20.

Specify this requirement with engines and/or devEngines:

// package.json
"type": "module",
"engines": {
  "node": ">=20"
},
"devEngines": {
  "runtime": {
    "name": "node",
    "version": ">=20"
  }
},

License

MIT © Daniel Bayley