xontrib-rc-awesome icon indicating copy to clipboard operation
xontrib-rc-awesome copied to clipboard

👓 🐚 Make your xonsh RC file installable with awesome snippets of code.

Awesome snippets of code for xonshrc in xonsh shell.

If you like the idea click ⭐ on the repo and tweet.

Use cases

Create your own installable RC based on the awesome xonsh RC

  1. Fork this repository
  2. Rename the repository to xontrib-rc-yourname
  3. Change the name in setup.py
  4. Change the name of xontrib/rc_awesome.xsh to xontrib/rc_yourname.xsh
  5. Add xontribs you need to setup.py (the xontribs will be installed automatically during pip install)
  6. Now you can just run anywhere:
    pip install -U git+https://github.com/yourname/xontrib-rc-yourname
    echo 'xontrib load rc_yourname' >> ~/.xonshrc
    xonsh
    
  7. Increment version to update the package using pip install -U git+https://github.com/yourname/xontrib-rc-yourname

Copy and paste

Just read rc_awesome and copy the snippets to your xonsh RC.

Or add awesome xonsh RC to the end of your xonshrc:

curl -s https://raw.githubusercontent.com/anki-code/xontrib-rc-awesome/main/xontrib/rc_awesome.xsh >> ~/.xonshrc

Or install awesome xonsh RC as a package with automatically installable xontribs:

pip install -U git+https://github.com/anki-code/xontrib-rc-awesome
echo 'xontrib load rc_awesome' >> ~/.xonshrc
xonsh

Learn from xonsh RC gurus

See also