Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/xonsh/xontrib-bashisms
Bash-like interactive mode extensions for the xonsh shell. It's made mostly for education reasons.
https://github.com/xonsh/xontrib-bashisms
bash xonsh xontrib
Last synced: 16 days ago
JSON representation
Bash-like interactive mode extensions for the xonsh shell. It's made mostly for education reasons.
- Host: GitHub
- URL: https://github.com/xonsh/xontrib-bashisms
- Owner: xonsh
- License: mit
- Created: 2023-02-14T15:14:17.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-10-21T17:56:16.000Z (18 days ago)
- Last Synced: 2024-10-22T08:41:15.679Z (18 days ago)
- Topics: bash, xonsh, xontrib
- Language: Python
- Homepage:
- Size: 36.1 KB
- Stars: 5
- Watchers: 4
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Bash-like interactive mode extensions for the xonsh shell.
## Note
We're not recommend to use this xontrib (see issues section). Use it carefully only if you have very strong muscle memory after hundred of years using Bash or for the education reasons and demonstration how agile is xonsh shell.
## Installation
To install use pip:
```bash
xpip install xontrib-bashisms
# or: xpip install -U git+https://github.com/xonsh/xontrib-bashisms
```
## Usage
```bash
xontrib load bashisms
```
Enables additional limited Bash-like syntax and commands while at the interactive command prompt:
| Added | Meaning |
|---|---|
| `!!` | Get the last command. |
| `!^` | Get the first argument from the preceding command. |
| `!$` | Get the last argument from the preceding command. |
| `!*` | Get all argument from the preceding command. |
| `alias` | Add alias. |
| `export NAME=Peter` | Setting an environment variable. |
| `shopt -s dotglob` | Globbing files with * or ** will also match dotfiles, or those "hidden" files. |
| `complete` | Show list of completers. |
| `set <-e/+e>` | Cause a failure after a non-zero return code. |
| `set <-x/+x>` | Turns on tracing of source code lines during execution. |
| `unset NAME` | Unsetting/deleting an environment variable. |
See also [Bash to Xonsh Translation Guide](https://xon.sh/bash_to_xsh.html).
## Known issues
The `xontrib-bashisms` appeared in the beginning of xonsh history as part of the default xontribs. It has issues and we recommend to use [xontrib-sh](https://github.com/anki-code/xontrib-sh) instead.
### Threading issues
Because of xontrib-bashisms sets [`THREAD_SUBPROCS=False`](https://xon.sh/envvars.html#thread-subprocs) there are issues around the threading could appear. If you're using bashisms and faced with issues try the same in `xonsh --no-rc` mode before reporting the issue.
### Only interactive mode
The xontrib features are implemented as [on_precommand events](https://xon.sh/events.html#on-precommand) and
these additions do not affect the xonsh language when run as script.
That said, you might find them useful if you have strong muscle memory in interactive mode.
## Debug
This xontrib may modify user command line input to implement its behavior.
To see the modifications as they are applied (in unified diffformat), please set [`$XONSH_DEBUG`](https://xon.sh/envvars.html#xonsh-debug) to `2` or higher.
## See also
* [Bash to Xonsh Translation Guide](https://xon.sh/bash_to_xsh.html)
* [xontrib-sh](https://github.com/anki-code/xontrib-sh) - Paste and run commands from bash, zsh, fish, tcsh in xonsh shell.
## Credits
This package was created with [xontrib template](https://github.com/xonsh/xontrib-template).