nushell/docs/commands/path-dirname.md
JT bff81f24aa
Autogenerate missing docs (#3514)
* Autogenerate missing docs

* Update ansi.md

* Rename question mark command docs

* Delete empty?.md
2021-05-30 12:57:04 +12:00

32 lines
697 B
Markdown

# path dirname
Get the parent directory of a path
## Usage
```shell
> path dirname ...args {flags}
```
## Parameters
* ...args: Optionally operate by column path
## Flags
* -h, --help: Display this help message
* -r, --replace <string>: Return original path with dirname replaced by this string
* -n, --num-levels <integer>: Number of directories to walk up
## Examples
Get dirname of a path
```shell
> echo '/home/joe/code/test.txt' | path dirname
```
Walk up two levels
```shell
> echo '/home/joe/code/test.txt' | path dirname -n 2
```
Replace the part that would be returned with a custom path
```shell
> echo '/home/joe/code/test.txt' | path dirname -n 2 -r /home/viking
```