awesome-xontribs's Introduction

xonsh

xonsh is a Python-powered, cross-platform, Unix-gazing shell language and command prompt.

The language is a superset of Python 3.6+ with additional shell primitives. xonsh (pronounced conch) is meant for the daily use of experts and novices alike.

If you like xonsh, ⭐ the repo, write a tweet and stay tuned by watching releases.

First steps

Install xonsh from pip:

python -m pip install 'xonsh[full]'

And visit https://xon.sh for more information:

Installation - using packages, docker or AppImage.
Tutorial - step by step introduction in xonsh.

Extensions

Xonsh has an extension/plugin system. We call these additions xontribs.

Projects that use xonsh or compatible

gitsome: Supercharged Git/shell autocompleter with GitHub integration.
xxh: Using xonsh wherever you go through the SSH.
rever: Cross-platform software release tool.
Regro autotick bot: Regro Conda-Forge autoticker.
zoxide: A smarter cd command.
any-nix-shell: xonsh support for the nix run and nix-shell environments of the Nix package manager.

Jupyter-based interactive notebooks via xontrib-jupyter:

jupyter and jupyterlab: Interactive notebook platform.
euporie: Terminal based interactive computing environment.

The xonsh shell community

The xonsh shell is developed by a community of volunteers. There are a few ways to help out:

Solve a popular issue. You can start with the Developer guide.
Solve a good first issue.
Take an idea and create a new xontrib.
Become xonsh core by deep diving into xonsh and improve the threading and subprocess logic.
Become a sponsor to xonsh.
Write a tweet, post or an article to spread the good word about xonsh in the world.
Give a star to xonsh repository and to xontribs you like.

We welcome new contributors!

Credits

Thanks to Zulip for supporting the xonsh community!

awesome-xontribs's People

Contributors

Stargazers

Watchers

awesome-xontribs's Issues

installing xontribs is impossible

in the latest arch (Eos), i am not able install most of the xontribs. my old configuration files has many xontribs. what is the expected way for xontribs to be installed in rolling release distro. can you please guide me. some checks i made repeatedly.

A) arch package manager dont have much xontribs. if it is there i have installed
B) earlier xpip used to work, but now it does not work. i get a warning.

error: externally-managed-environment

× This environment is externally managed
╰─> To install Python packages system-wide, try 'pacman -S
    python-xyz', where xyz is the package you are trying to
    install.
    
    If you wish to install a non-Arch-packaged Python package,
    create a virtual environment using 'python -m venv path/to/venv'.
    Then use path/to/venv/bin/python and path/to/venv/bin/pip.
    
    If you wish to install a non-Arch packaged Python application,
    it may be easiest to use 'pipx install xyz', which will manage a
    virtual environment for you. Make sure you have python-pipx
    installed via pacman.

note: If you believe this is a mistake, please contact your Python installation or OS distribution provider. You can override this, at the risk of breaking your Python installation or OS, by passing --break-system-packages.
hint: See PEP 668 for the detailed specification.

should i simply install with sudo pip, instead. not sure it will work, though

C) pipx is able to install some, but it is not detected by xonsh. keeps complaining that it is not installed.

can you please help me. I cannot imagine going to another shell now.

xonsh / awesome-xontribs Goto Github PK