🐚 Python-powered shell. Full-featured and cross-platform.
Find a file
Noorhteen Raja NJ 38295a1dd9
Remove globals (#4280)
* refactor: remove usage of global variables in abbrevs.py

* chore: add flake8-mutable to prevent mutable defaults

* fix: abbrevs expand test

* refactor: add xonsh session singleton

* refactor: fix circular errors when using xonshSession as singleton

* refactor: remove black magicked builtin attributes

* style: black format tests as well

* refactor: update tests to use xonsh-session singleton

* refactor: update abbrevs to not use builtins

* test: remove DummyCommandsCache and patch orig class

* fix: failing test_command_completers

* test: use monkeypatch to update xession fixture

* fix: failing test_pipelines

* fix: failing test_main

* chore: run test suit as single invocation

* test: fix tests/test_xonsh.xsh

* refactor: remove builtins from docs/conf.py

* fix: mypy error in jobs

* fix: test error from test_main

* test: close xession error in test_command_completers

* chore: use pytest-cov for reporting coverage

this will include subprocess calls, and will increase coverage

* style:
2021-05-20 13:14:26 +03:00
.github Please click the 👍 reaction (#4210) 2021-03-31 12:16:23 -04:00
appimage Update pre-requirements.txt (#4073) 2021-01-30 15:13:33 -05:00
ci chore (ci): improve ci workflows and deps management (#3873) 2020-10-19 11:52:37 -04:00
docs Remove globals (#4280) 2021-05-20 13:14:26 +03:00
news Test RC loading in different startup configurations (#4279) 2021-05-14 16:12:34 +03:00
requirements Remove globals (#4280) 2021-05-20 13:14:26 +03:00
scripts re-run CI tests 2020-08-08 14:02:44 -04:00
tests Remove globals (#4280) 2021-05-20 13:14:26 +03:00
xonsh Remove globals (#4280) 2021-05-20 13:14:26 +03:00
xontrib Remove globals (#4280) 2021-05-20 13:14:26 +03:00
.authors.yml Update author aliases 2021-03-30 13:48:34 -04:00
.coveragerc Completion context (#4017) 2021-03-30 13:37:56 -04:00
.gitattributes Syntax highlighting for xsh on Github 2020-10-01 23:33:19 +03:00
.gitignore Completion context (#4017) 2021-03-30 13:37:56 -04:00
.mailmap Updated authorship for 0.9.27 2021-03-03 11:29:57 -05:00
.pre-commit-config.yaml chore (ci): improve ci workflows and deps management (#3873) 2020-10-19 11:52:37 -04:00
.travis.yml Add groups to env vars (#4026) 2021-01-04 12:21:44 -05:00
amalgamate.py black updates to tests and docs 2020-08-26 10:10:59 -05:00
AUTHORS.rst Updated authorship for 0.9.27 2021-03-03 11:29:57 -05:00
CHANGELOG.rst fix: RST link typo (#4136) 2021-03-03 13:55:35 -05:00
conftest.py add comment on conftest.py to why it exists 2016-07-17 01:21:11 +02:00
CONTRIBUTING.rst Updated references to point to 'main' instead of 'master' (#4202) 2021-03-30 13:40:43 -04:00
github_deploy_key.enc publish dev and latest release docs on xonsh-docs 2016-10-20 19:48:38 -04:00
license copyright update 2016-06-30 12:24:55 -04:00
logo.txt accomodate pip bug by making setup.py ascii 2015-11-16 15:12:02 -08:00
Makefile Fix ply update directive in Makefile 2018-11-02 14:46:17 -04:00
MANIFEST.in Add all test files to MANIFEST.in 2019-04-07 22:33:01 +02:00
pyproject.toml Cleanup remaining vended ptk bits (#4130) 2021-03-01 16:55:23 -05:00
README.rst Delete codecov.yml (#4232) 2021-04-15 10:16:09 -04:00
release.xsh Fix deprecation warnings from unallowed escapes 2018-10-05 11:51:08 +02:00
rever.xsh Restore test command in rever.xsh 2021-02-04 12:35:30 -05:00
run-tests.xsh Remove globals (#4280) 2021-05-20 13:14:26 +03:00
scent.py feat: add setting to set custom function to format prompt 2020-10-25 22:49:22 +05:30
setup.cfg Remove globals (#4280) 2021-05-20 13:14:26 +03:00
setup.py Completion context (#4017) 2021-03-30 13:37:56 -04:00
travis.yml some v3.5 updates 2015-09-13 12:17:11 -04:00
xonsh-in-docker.py Make ptk default version much more recent 2020-09-12 20:01:41 -04:00

xonsh
=====

.. class:: center

    **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.

    .. image:: https://raw.githubusercontent.com/xonsh/xonsh/master/docs/_static/xonsh5.png
            :alt: What is xonsh?
            :align: center

.. class:: center

    If you like xonsh, :star: the repo, `write a tweet`_ and stay tuned by watching releases.

    .. image:: https://badges.gitter.im/xonsh/xonsh.svg
            :target: https://gitter.im/xonsh/xonsh?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge
            :alt: Join the chat at https://gitter.im/xonsh/xonsh

    .. image:: https://img.shields.io/badge/%23xonsh%3Afeneas.org-Matrix-green
            :target: https://matrix.to/#/#xonsh:feneas.org
            :alt: Matrix room: #xonsh:feneas.org

    .. image:: https://travis-ci.org/xonsh/xonsh.svg?branch=master
            :target: https://travis-ci.org/xonsh/xonsh
            :alt: Travis

    .. image:: https://ci.appveyor.com/api/projects/status/github/xonsh/xonsh?svg=true
            :target: https://ci.appveyor.com/project/xonsh/xonsh
            :alt: Appveyor

    .. image:: https://img.shields.io/badge/Google%20Cloud%20Shell-xonsh-green
            :target: https://ssh.cloud.google.com/cloudshell/editor?cloudshell_git_repo=https://github.com/xonsh/xonsh.git
            :alt: Open in Google Cloud Shell

First steps
***********

Visit https://xon.sh for more information:

- `Installation <https://xon.sh/contents.html#installation>`_ - using packages, docker or AppImage.
- `Tutorial <https://xon.sh/tutorial.html>`_ - step by step introduction in xonsh.
- `Xontribs <https://xon.sh/xontribs.html>`_ or `Github Xontribs <https://github.com/topics/xontrib>`_ - list of awesome xonsh extensions.

Projects that use xonsh
***********************

- `gitsome <https://github.com/donnemartin/gitsome>`_: A supercharged Git/shell autocompleter with GitHub integration.
- `rever <https://regro.github.io/rever-docs/>`_: Cross-platform software release tool.
- `Regro autotick bot <https://github.com/regro/cf-scripts>`_: Regro Conda-Forge autoticker.
- `xxh <https://github.com/xxh/xxh>`_: Using xonsh wherever you go through the ssh.

.. _write a tweet: https://twitter.com/intent/tweet?text=xonsh%20is%20a%20Python-powered,%20cross-platform,%20Unix-gazing%20shell%20language%20and%20command%20prompt.&url=https://github.com/xonsh/xonsh