Commit graph

76 commits

Author SHA1 Message Date
Andy Kipp
1d7cc00962
refactoring: move shell to shells.shell to avoid unwanted init (#5556)
Continue #5550 for https://github.com/xonsh/xonsh/issues/5538 

---------

Co-authored-by: a <1@1.1>
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Noorhteen Raja NJ <jnoortheen@gmail.com>
2024-06-29 14:26:50 +05:30
Andy Kipp
610f1a41e8
refactoring: form shell submodule (#5550)
#5538


Co-authored-by: a <1@1.1>
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
2024-06-29 12:25:07 +05:30
Gil Forsyth
572ebb576d
docs: change theme to furo (#4809)
Trying out a new theme -- I really like the way `furo` looks and I think
it makes it easier to navigate our overly dense docs pages.
2022-05-18 20:36:45 +05:30
Noorhteen Raja NJ
15ff663530
Rm xontrib meta (#4790) 2022-05-04 15:02:20 -04:00
Noorhteen Raja NJ
d49b164379
gitstatus modular (#4697) 2022-03-21 11:18:36 -04:00
Noorhteen Raja NJ
9fbecfc155
feat: use github actions to deploy docs (#4641)
* feat: use github actions to deploy docs

fixes #4473

* fix: install xonsh

* fix: doc action

* chore: support *.md for documentation

* fix: remove hardcoded docs link

it affects local testing

* refactor: move sphinx extensions to its own package

* fix: remove deprecated get_theme_dir

As of Sphinx 1.2, this is passed to Sphinx via a ``setup.py`` entry
point,
and no longer needs to be included in your documentation's
``conf.py``.

* feat: jinja2 render without affecting incremental build

* style:

* feat: auto generate API doc

no need to create a file for each module

* chore: watch top-level and nested files

* refactor: update lib api-docs as well

* fix: import errors when doc generated

for some modules

* fix: relative path

* feat: add release handling

* Update .github/workflows/docs.yml

Co-authored-by: Gil Forsyth <gforsyth@users.noreply.github.com>

* refactor: use github-app-token

* chore: deploy docs only when merged

Co-authored-by: Gil Forsyth <gforsyth@users.noreply.github.com>
2022-01-18 11:38:27 -05:00
Noorhteen Raja NJ
c2d25ac251
pre-commit hook for pyupgrade (#4583)
* chore: add pyupgrade

* refactor: upgrade code to py3.7+

ran `pre-commit run pyupgrade -a` while excluding changes to ply

* fix: flake errors
2021-12-06 14:42:26 -05:00
Noorhteen Raja NJ
b2516737b6
code refactor (#4571)
* style:

* refactor: tests of xoreutils
2021-11-30 08:23:32 -05:00
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
Andy Kipp
c1118f3180
docs: copy robots.txt second try (#4171)
* Update conf.py

* Delete robots.txt

* Create robots.txt
2021-03-12 09:39:48 -05:00
Andy Kipp
1269a6a393
Update conf.py (#4170) 2021-03-11 12:33:27 -05:00
Noorhteen Raja NJ
bceaafae4d
Add groups to env vars (#4026)
* feat: add grouped-settings for env variables

fixes #4014

style: fix mypy errors

chore: update testing requirements versions

fix: update xonsh.tools import error

* chore: add news item

* fix: update Var.with_default handling env defaults

* fix: set env var.doc_default=DefaultNotGiven

there is a custom handler for it

* chore: update travis

speedup docs generation

* chore: add command to serve docs during development

* docs: add jinja2 helpers/renderers extension for sphinx

* docs: update envvars document

* docs: fix docs failing

* Update xonsh/environ.py

commit suggestion

Co-authored-by: Gil Forsyth <gforsyth@users.noreply.github.com>

* Update xonsh/environ.py

Co-authored-by: Gil Forsyth <gforsyth@users.noreply.github.com>

* Update xonsh/environ.py

Co-authored-by: Gil Forsyth <gforsyth@users.noreply.github.com>

* Update xonsh/environ.py

Co-authored-by: Gil Forsyth <gforsyth@users.noreply.github.com>

* Update xonsh/environ.py

Co-authored-by: Gil Forsyth <gforsyth@users.noreply.github.com>

* Update xonsh/environ.py

Co-authored-by: Gil Forsyth <gforsyth@users.noreply.github.com>

* refactor: update rst-extension

Co-authored-by: Gil Forsyth <gforsyth@users.noreply.github.com>
2021-01-04 12:21:44 -05:00
Noortheen Raja
2b947e9e66 refactor: replace xontribs.json with xontribs_meta.py
closes #3931
2020-11-10 22:12:27 +05:30
Bob Hyman
f034d3dc06 Merge branch 'master' into is_3622 2020-08-28 23:15:03 -04:00
Anthony Scopatz
f048b295d6 black updates to tests and docs 2020-08-26 10:10:59 -05:00
Bob Hyman
a67df4fd5f Enable xonshcon blocks in docs. 2020-08-20 01:13:45 -04:00
Anthony Scopatz
fc745561cf landing page 2020-08-09 18:00:23 -05:00
David Dotson
a8d4a57f01
Environment variable registration, deregistration (addresses #3227) (#3377)
* First attempt at register/deregister machinery for envvars

* Added detailed docstring, simplified ensurers

Also added some type checking that became clear from docstring writing.

* Changes in response to @scopatz review

Simplified kwarg names.

* defaultval -> default

* Created new Var namedtuple, as well as DEFAULT_VARS

We should now delete DEFAULT_ENSURERS, DEFAULT_VALUES, DEFAULT_DOCS, and
refactor Env to use the new single namedtuple and the DEFAULT_VARS dict

* Removed DEFAULT_ENSURERS, DEFAULT_VALUES, DEFAULT_DOCS

Now need to edit Env to use new DEFAULT_VARS, Var namedtuple

* Finished updating Env object to use new combined Var

Also made corresponding changes elsewhere ensurer was used

* Working on test failures

* More fixes in light of test failures

* Set default values for Var in register.

There's a bit of duplication here, but makes for a cleaner function.

* Black reformatting on environ.py

* Removed history replay

* Added register tests

* Added addtional deregistration test

* Removed all replay references, in docs too

* Added news item for env-reg-dereg

* trigger rebuild

* doc fix

* more doc fixes

* again

* attr names

* reorder imports

* fix flake error

Co-authored-by: Anthony Scopatz <scopatz@gmail.com>
2020-08-05 10:39:11 -04:00
Bob Hyman
53bfe8c99c
Add ptk3 (#3521)
* delete package ptk; rename ptk2 to ptk_shell.; leave ptk2 as alias for ptk_shell.
* SHELL_TYPE "prompt_toolkit" only; remove ptk1 specific behavior.
* Doc updates: eliminate reference to prompt-toolkit < 2.0
* update requirements files ptk>=2; test shell_style="none"
* fix ptk2 stub per code review
* Add ptk2 to list of packages to install.
2020-04-18 10:44:27 -04:00
Anthony Scopatz
0942d7b3d7 runthis 2020-03-19 23:05:18 -05:00
Morten Enemark Lund
4805f10095 Make it easier to built tutorials offline 2019-10-07 21:08:58 +02:00
Morten Enemark Lund
98a62c492c Workaround a problem with cloud_theme and sphinx2
This fixes a problem with sphinx and the cloud theme. Sphinx 2 adds <p> elements
in the tables and lists, which causes the theme to look werid.
2019-07-31 14:47:45 +02:00
Morten Enemark Lund
4c639beb89 Black formatting 2019-07-31 12:58:00 +02:00
Morten Enemark Lund
22bb5718ae Fix admonitions with sphinx 2.0 2019-07-31 12:55:17 +02:00
Anthony Scopatz
0b58eed37f doc fixes 2018-09-13 17:26:37 -04:00
Anthony Scopatz
0f00519d16 some more docfix bugs 2018-09-13 17:16:37 -04:00
Anthony Scopatz
6028bdfb95 fix sphinx conf import for ptk 2018-07-16 10:06:41 -04:00
Morten Enemark Lund
2ee57ce2b8 Update xontrib description
Installation instructions are now hidden if the
xontrib is preinstalled with xonsh. Also adds a 'Usage'
section on how to enable the xontrib.
2018-04-25 11:11:21 +02:00
Morten Enemark Lund
a036149be8 More fixes for building docs on Windows 2018-04-25 11:09:47 +02:00
Andrew Hundt
fce093fd3b reverse build changes for travis 2017-08-15 13:10:20 -04:00
Andrew Hundt
80a43d8697 return to cloud_sptheme so new PR only has layout improvements 2017-08-15 11:16:05 -04:00
Andrew Hundt
3fb8131cb7 ascii_conch_part_transparent_tight.png added and enabled in sphinx conf.py 2017-08-14 17:02:32 -04:00
Andrew Hundt
9557950cc4 Greatly improved webpage layout so it is easier to find what you need. (#2477) 2017-08-13 21:48:26 -04:00
Gil Forsyth
bc7d4117e9 don't require prompt toolkit for docs on user side
we'll make sure it's available on CI when the docs are generated for the
website, but it shouldn't fail to build in userspace just because of the
ptk events hack thing
2017-02-28 15:17:43 -05:00
Gil Forsyth
91653dafa8 import events via ptk shell to gather all events
Not the prettiest thing but if we don't import the events via the PTK
shell then ``on_ptk_create`` doesn't get picked up during doc generation
2017-02-28 15:13:47 -05:00
Gil Forsyth
582d9abf23 fix incorrect eventsbody generation in conf.py 2016-12-16 11:22:32 -05:00
Gil Forsyth
45670f1dd6 import xonsh.main to fix events docs generation
sphinx will implicitly import main, but not before we call
`make_events()`, so only `on_chdir` shows up on the events listing.
explicitly importing `xonsh.main` fixes this up so all of the available
events are documented properly.
2016-12-01 12:41:19 -05:00
Matthias Bussonnier
c0d584d7a3 Hack a rel=canonical in the templates.
We do not want non-canonical versions of xonsh docs to be indexed. OR at
least they should point to the canonical version.

Technically we should even try to have the stable version under a
/stable/ url (to leave us with some freedom of changing things) So that
later we can replace stable with X.y and have a version switcher.
2016-10-30 12:27:40 -07:00
Gil Forsyth
8a5dfcf3a7 add xonshcon lexer to sphinx conf 2016-10-25 10:53:30 -04:00
Matthias Bussonnier
e67c448290 Build docs on 3.5 otherwise we'll never caught failures. 2016-09-17 13:20:17 -07:00
Matthias Bussonnier
1dbfb41499 Define __xonsh_commands_cache__ during doc builds. 2016-09-08 13:56:31 -07:00
Jamie Bliss
ce61c59d4b Do some fixed-width formatting 2016-08-27 22:29:11 -04:00
Jamie Bliss
3721204304 Add an autogenerated events listing 2016-08-27 22:25:29 -04:00
Anthony Scopatz
cd468a45ce 3 to 5 col 2016-07-20 21:41:29 -04:00
Anthony Scopatz
9b054c9ba2 docs fix 2016-07-20 21:39:00 -04:00
Anthony Scopatz
d14292cb9c some doc fixes 2016-06-18 17:32:37 -04:00
Anthony Scopatz
231c7f0a6e add completer API doc hooks 2016-06-04 20:05:55 -04:00
Frank Sachsenheim
38a65f755e Use a common prefix in doc's modindex 2016-05-24 20:49:46 +02:00
Anthony Scopatz
362a098d84 added store_as_str to vardocs 2016-05-21 15:03:27 -04:00
Anthony Scopatz
4a6e153396 doc fixes 2016-05-20 17:58:50 -04:00