40 lines
1.1 KiB
TypeScript
40 lines
1.1 KiB
TypeScript
|
/// <reference types="node"/>
|
||
|
|
import * as fs from 'fs';
|
||
|
|
|
||
|
|
export interface Options {
|
||
|
|
/**
|
||
|
|
* Directory [permissions](https://x-team.com/blog/file-system-permissions-umask-node-js/).
|
||
|
|
*
|
||
|
|
* @default 0o777 & (~process.umask())
|
||
|
|
*/
|
||
|
|
readonly mode?: number;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Use a custom `fs` implementation. For example [`graceful-fs`](https://github.com/isaacs/node-graceful-fs).
|
||
|
|
*
|
||
|
|
* Using a custom `fs` implementation will block the use of the native `recursive` option if `fs.mkdir` or `fs.mkdirSync` is not the native function.
|
||
|
|
*
|
||
|
|
* @default require('fs')
|
||
|
|
*/
|
||
|
|
readonly fs?: typeof fs;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Make a directory and its parents if needed - Think `mkdir -p`.
|
||
|
|
*
|
||
|
|
* @param path - Directory to create.
|
||
|
|
* @returns A `Promise` for the path to the created directory.
|
||
|
|
*/
|
||
|
|
export default function makeDir(
|
||
|
|
path: string,
|
||
|
|
options?: Options
|
||
|
|
): Promise<string>;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Synchronously make a directory and its parents if needed - Think `mkdir -p`.
|
||
|
|
*
|
||
|
|
* @param path - Directory to create.
|
||
|
|
* @returns The path to the created directory.
|
||
|
|
*/
|
||
|
|
export function sync(path: string, options?: Options): string;
|