Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/oh-my-xonsh/xontrib-up
A Xonsh plugin for the `up` command, which can `cd` up any number of directories
https://github.com/oh-my-xonsh/xontrib-up
extension python shell xonsh xontrib
Last synced: 3 months ago
JSON representation
A Xonsh plugin for the `up` command, which can `cd` up any number of directories
- Host: GitHub
- URL: https://github.com/oh-my-xonsh/xontrib-up
- Owner: oh-my-xonsh
- License: mit
- Created: 2021-11-08T19:37:17.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2021-11-13T18:24:42.000Z (almost 3 years ago)
- Last Synced: 2024-06-28T06:02:41.286Z (4 months ago)
- Topics: extension, python, shell, xonsh, xontrib
- Language: Python
- Homepage:
- Size: 28.3 KB
- Stars: 4
- Watchers: 2
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-xontribs - up - The fast way to go up directories. (Directory Navigation)
README
# UP! - the fast way to go up directories in xonsh
Tired of attaching "balloons" to your `cd` command to go up directories?
`cd ..`, `cd ../..`, `cd ../../..`, `cd ../../../..`, `cd ../../../../../../../../../../../../../..`?
Tired of creating weird aliases like `cd..4`, `cd..12`, ... `cd..100` to navigate up directories?
Now you can use `up`!
Type `up` to go up one directory. Type `up 2` to go up two directories. Type
`up 42` to go up forty-two directories. It's that easy.
No more defining an alias for `cd ../../../../../../..`. Just type `up 7`.
```shell
$ # cd ../../..
$ up 3
```
You can also get the path that `up` will produce by using `upp` (up path).
This lets you see what directory up will produce.
```shell
$ # pushd -q .; cd ../../../..; echo $PWD; popd -q
$ upp 4
```
Listing ancestor directories with `ls` requires balloons, but not anymore.
A simple way to list ancestor dirs is with `lsup`, which forwards on any options to `ls`.
```shell
$ # long list everything 3 dirs up (ie: `ls -opts ../../..`)
$ lsup -laFGh 3
```
## Commands
| Command | Description |
|:--------|:-------------------------------------------|
| `up` | Travel up any number of directories |
| `upp` | Get the path of an ancestor directory |
| `lsup` | List the contents of an ancestor directory |
## Install
Install from PyPI via `xpip`:
```shell
xpip install xontrib-up
# or: xpip install -U git+https://github.com/oh-my-xonsh/xontrib-up
```
Then, add this to your `~/.config/xonsh/rc.xsh` or `~/.xonshrc`:
```shell
xontrib load up
```
[xonsh]: https://xon.sh