xonsh 0.21.0

v0.21.0

on Python PyPI

0.21.0 (2025-12-10)

Features

• Added @ as a global object that provides easy access to @.env (xonsh env), @.imp(inline importer), @.lastcmd (last executed command pipeline)
  e.g. with @.env.swap(TIME=@.imp.time.time()): $[echo $TIME] (#5956) (64e3a3c, @shevtsova)
• Added support for multiline shebang (guix fixed) (#5957) (e9e0055, @anki-code)
• Added support for using a p-string as a context manager to temporarily change the working directory
  e.g., with p'~/test'.mkdir().cd(): $[pwd] (d9a14c1, @anki-code)
• Allow on_command_not_found handlers to return replacement commands (#5952) (#5962) (14d9686, @EclipseAditya)

Bug Fixes

• Allow numerical tokens in environment variable references (#5891) (9ae6911, @PodioSpaz)
• Expand ~(User's home path) in xonsh.tools.chdir function (#5969) (192248a, @anki-code)

Documentation

• Update tutorial example for piping into an alias (#5955) (07d4334, @fpusan)
• Add verification file for ads.fund project (#5946) (2482f06, @anki-code)
• Update tutorial to reduce ${...} accent (#5975) (e229ea5, @anki-code )

Deprecated

• $AUTO_SUGGEST is now deprecated in favour of $XONSH_PROMPT_AUTO_SUGGEST (1e5bda4, @anki-code )