xmyshell 0.2.17__tar.gz → 0.2.19__tar.gz

{xmyshell-0.2.17/xmyshell.egg-info → xmyshell-0.2.19}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xmyshell
-Version: 0.2.17
+Version: 0.2.19
 Summary: XmyShell is a shell-like tool built on top of prompt_toolkit which provides a persistent Python runtime.
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
@@ -163,6 +163,15 @@ The exit code of the last command.
 - `exec_duration`
 The duration which last command took.
 
+- `last_error`
+The error raised from last Python operation (if exists).
+
+- `last_traceback`
+The traceback of last Python operation (if exists).
+
+- `ans`
+The result from last print command.
+
 - `SHOW_WELCOME`
 Toggle whether to show welcome message when staring.
 

{xmyshell-0.2.17 → xmyshell-0.2.19}/README.md

@@ -153,6 +153,15 @@ The exit code of the last command.
 - `exec_duration`
 The duration which last command took.
 
+- `last_error`
+The error raised from last Python operation (if exists).
+
+- `last_traceback`
+The traceback of last Python operation (if exists).
+
+- `ans`
+The result from last print command.
+
 - `SHOW_WELCOME`
 Toggle whether to show welcome message when staring.
 

{xmyshell-0.2.17 → xmyshell-0.2.19}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "xmyshell"
-version = "0.2.17"
+version = "0.2.19"
 description = "XmyShell is a shell-like tool built on top of prompt_toolkit which provides a persistent Python runtime."
 readme = "README.md"
 requires-python = ">=3.12"

{xmyshell-0.2.17 → xmyshell-0.2.19}/xmyshell/environment.py

@@ -43,6 +43,7 @@ _init_namespace: dict[str, Any] = {
     "exec_duration": 0,
     "last_error": None,
     "last_traceback": None,
+    "ans": None,
     "shell_prompt": "",
     "shell_rprompt": "",
     "prompt_placeholder": "",

{xmyshell-0.2.17 → xmyshell-0.2.19}/xmyshell/kernel.py

@@ -189,10 +189,10 @@ def xmyshell_raw_command(cmd_line: str) -> int | None:
                 result = eval(expr, dict(os.environ), namespace)
                 print(result)
                 namespace["last_error"] = None
+                namespace["ans"] = result
                 return 0
             except Exception as e:
                 import traceback
-
                 namespace["last_error"] = e
                 namespace["last_traceback"] = traceback.format_exc()
                 pyerror(f"{type(e).__name__}: {e}")

xmyshell-0.2.19/xmyshell/meta.py

@@ -0,0 +1,85 @@
+from importlib.metadata import version
+
+# ANSI color codes
+RESET   = "\033[0m"
+BOLD    = "\033[1m"
+NOBOLD  = "\033[22m"
+CYAN    = "\033[36m"
+GREEN   = "\033[92m"
+YELLOW  = "\033[93m"
+BLUE = "\033[94m"
+MAGENTA = "\033[95m"
+
+NAME            = "xmyshell"
+DISPLAY_NAME    = "XmyShell"
+VERSION         = version(NAME)
+AUTHOR          = "CaptainSuo"
+EMAIL           = "captainsuo@outlook.com"
+WELCOME_MESSAGE = f"""{BOLD}{BLUE}{DISPLAY_NAME} {CYAN}{VERSION}{RESET}"""
+
+HELP_MESSAGE = f"""{BOLD}{CYAN}
+ ███╗  ███╗ ███╗   ███╗ ██╗   ██╗ ███████╗ ██╗   ██╗ ███████╗ ██╗      ██╗
+ ╚═██╗██╔═╝ ████╗ ████║ ╚██╗ ██╔╝ ██╔════╝ ██║   ██║ ██╔════╝ ██║      ██║
+   ╚███╔╝   ██╔████╔██║  ╚████╔╝  ███████╗ ████████║ ██████╗  ██║      ██║
+   ██╔██╗   ██║╚██╔╝██║   ╚██╔╝   ╚════██║ ██╔═══██║ ██╔═══╝  ██║      ██║
+ ███╔╝ ███╗ ██║ ╚═╝ ██║    ██║    ███████║ ██║   ██║ ███████╗ ███████╗ ███████╗
+ ╚══╝  ╚══╝ ╚═╝     ╚═╝    ╚═╝    ╚══════╝ ╚═╝   ╚═╝ ╚══════╝ ╚══════╝ ╚══════╝
+{RESET}
+{WELCOME_MESSAGE}
+
+{BOLD}{YELLOW}Built-in Commands{BOLD}{CYAN}
+  {BOLD}{GREEN}help{CYAN}                          {NOBOLD}Show help documents.
+  {BOLD}{GREEN}print{CYAN} <expr>                  {NOBOLD}Evaluate and print a Python expression.
+  {BOLD}{GREEN}pyexec{CYAN} <stmt>                 {NOBOLD}Execute a Python statement.
+  {BOLD}{GREEN}source{CYAN} <file.py>              {NOBOLD}Run a Python script in the current namespace.
+  {BOLD}{GREEN}export{CYAN} <NAME>=<value>         {NOBOLD}Set an environment variable (supports {{expr}}).
+  {BOLD}{GREEN}import{CYAN} <module> [as <alt>]    {NOBOLD}Import a Python module.
+  {BOLD}{GREEN}from{CYAN} <module> import <names>  {NOBOLD}Import names from a module.
+  {BOLD}{GREEN}reload{CYAN}                        {NOBOLD}Reload environment.
+  {BOLD}{GREEN}update{CYAN} [<version>]            {NOBOLD}Update xmyshell.
+  {BOLD}{GREEN}cd{CYAN} <dir>                      {NOBOLD}Change directory (supports {{expr}}).
+  {BOLD}{GREEN}pwd{CYAN}                           {NOBOLD}Print working directory.
+  {BOLD}{GREEN}clear{CYAN}                         {NOBOLD}Clear the terminal screen.
+  {BOLD}{GREEN}alias{CYAN} altname=<cmd>           {NOBOLD}Create an alias command.
+  {BOLD}{GREEN}unalias{CYAN} altname               {NOBOLD}Remove an alias command.
+  {BOLD}{GREEN}exit{CYAN}                          {NOBOLD}Exit XmyShell.
+
+{BOLD}{YELLOW}Inline Python{NOBOLD}{CYAN}
+  Use {{expression}} anywhere in a command to expand its result.
+  {BOLD}{MAGENTA}Example{NOBOLD}{CYAN} mkdir {{" ".join(f"test{{i}}" for i in range(3))}}
+  Escape braces as {{{{ and }}}}.
+
+{BOLD}{YELLOW}IO{NOBOLD}{CYAN}
+  Append => variable to a command to capture its output while still
+  displaying it.
+  {BOLD}{MAGENTA}Example{NOBOLD}{CYAN} which python => path
+  Redirect the output of Python commands (print, pyexec) with |>
+  {BOLD}{MAGENTA}Example{NOBOLD}{CYAN} print "\\n".join(str(i) for i in range(100)) |> grep 42
+
+{BOLD}{YELLOW}Helper Functions{NOBOLD}{CYAN}
+  {BLUE}getlogin{CYAN}()           current username
+  {BLUE}getcwd{CYAN}()             current working directory
+  {BLUE}dirname{CYAN}(p)           parent directory of path
+  {BLUE}basename{CYAN}(p)          final component of path
+  {BLUE}cat{CYAN}(file)            Shortcut for open(file).read().
+  {BLUE}alias{CYAN}(altname, cmd)  Same as the command.
+  {BLUE}unalias{CYAN}(altname)     Same as the command.
+
+{BOLD}{YELLOW}Built-in variables{NOBOLD}{CYAN}
+  {BLUE}exit_code{CYAN}            The exit code of the last command.
+  {BLUE}exec_duration{CYAN}        The duration which last command took.
+  {BLUE}last_error{CYAN}           The error raised from last Python operation (if exists).
+  {BLUE}last_traceback{CYAN}       The traceback of last Python operation (if exists).
+  {BLUE}ans{CYAN}                  The result from last print command.
+  {BLUE}HOME_DIR{CYAN}             The home directory, similar to "~".
+  {BLUE}PROFILE{CYAN}              The path of config file.
+  {BLUE}SHOW_WELCOME{CYAN}         Toggle whether to show welcome message.
+  {BLUE}SHELL_CMD{CYAN}            Shell command line prefix, e.g. ["cmd", "/c"]
+
+{BOLD}{YELLOW}Keyboard Shortcuts{NOBOLD}{CYAN}
+  {MAGENTA}↑↓                   {CYAN}Navigate through command history.
+  {MAGENTA}→                    {CYAN}Apply selected history entry to the prompt.
+  {MAGENTA}Ctrl+R               {CYAN}Reverse incremental searching (history).
+  {MAGENTA}Ctrl+Z               {CYAN}Undo.
+  {MAGENTA}Ctrl+Y               {CYAN}Redo.
+  {MAGENTA}Ctrl+D               {CYAN}Exit XmyShell.{RESET}"""

{xmyshell-0.2.17 → xmyshell-0.2.19/xmyshell.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xmyshell
-Version: 0.2.17
+Version: 0.2.19
 Summary: XmyShell is a shell-like tool built on top of prompt_toolkit which provides a persistent Python runtime.
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
@@ -163,6 +163,15 @@ The exit code of the last command.
 - `exec_duration`
 The duration which last command took.
 
+- `last_error`
+The error raised from last Python operation (if exists).
+
+- `last_traceback`
+The traceback of last Python operation (if exists).
+
+- `ans`
+The result from last print command.
+
 - `SHOW_WELCOME`
 Toggle whether to show welcome message when staring.
 

xmyshell-0.2.17/xmyshell/meta.py

@@ -1,71 +0,0 @@
-from importlib.metadata import version
-
-NAME            = "xmyshell"
-DISPLAY_NAME    = "XmyShell"
-VERSION         = version(NAME)
-AUTHOR          = "CaptainSuo"
-EMAIL           = "captainsuo@outlook.com"
-WELCOME_MESSAGE = f"""{DISPLAY_NAME} {VERSION}"""
-HELP_MESSAGE    = f"""\033[1;36m
- ███╗  ███╗ ███╗   ███╗ ██╗   ██╗ ███████╗ ██╗   ██╗ ███████╗ ██╗      ██╗
- ╚═██╗██╔═╝ ████╗ ████║ ╚██╗ ██╔╝ ██╔════╝ ██║   ██║ ██╔════╝ ██║      ██║
-   ╚███╔╝   ██╔████╔██║  ╚████╔╝  ███████╗ ████████║ ██████╗  ██║      ██║
-   ██╔██╗   ██║╚██╔╝██║   ╚██╔╝   ╚════██║ ██╔═══██║ ██╔═══╝  ██║      ██║
- ███╔╝ ███╗ ██║ ╚═╝ ██║    ██║    ███████║ ██║   ██║ ███████╗ ███████╗ ███████╗
- ╚══╝  ╚══╝ ╚═╝     ╚═╝    ╚═╝    ╚══════╝ ╚═╝   ╚═╝ ╚══════╝ ╚══════╝ ╚══════╝
-\033[0m
-{WELCOME_MESSAGE}
-
-Built-in Commands:
-  help                          Show help documents.
-  print <expr>                  Evaluate and print a Python expression.
-  pyexec <stmt>                 Execute a Python statement (e.g. pyexec x = 1).
-  source <file.py>              Run a Python script in the current namespace.
-  export <NAME>=<value>         Set an environment variable (supports {{expr}}).
-  import <module> [as <alt>]    Import a Python module.
-  from <module> import <names>  Import names from a module.
-  reload                        Reload environment (e.g. exit virtualenv).
-  update [<version>]            Update xmyshell (optionally to a specific version).
-  cd <dir>                      Change directory (supports {{expr}}).
-  pwd                           Print working directory.
-  clear                         Clear the terminal screen.
-  alias altname=<cmd>           Create an alias command.
-  unalias altname               Remove an alias command.
-  exit                          Exit XmyShell.
-
-Inline Python:
-  Use {{expression}} anywhere in a command to expand its result.
-  Example: mkdir {{" ".join(f"test{{i}}" for i in range(3))}}
-  Escape braces as {{{{ and }}}}.
-
-IO:
-  Append => variable to a command to capture its output while still
-  displaying it.
-  Example: which python => path
-  Redirect the output of Python commands (print, pyexec) with |>
-  Example: print "\\n".join(str(i) for i in range(100)) |> grep 42
-
-Helper Functions:
-  getlogin()          -  current username
-  getcwd()            -  current working directory
-  dirname(p)          -  parent directory of path
-  basename(p)         -  final component of path
-  cat(file)           -  Shortcut for open(file).read().
-  alias(altname, cmd) -  Same as the command.
-  unalias(altname) -  Same as the command.
-
-Built-in variables:
-  exit_code       -  The exit code of the last command.
-  exec_duration   -  The duration which last command took.
-  HOME_DIR        -  The home directory, similar to "~".
-  PROFILE         -  The path of config file.
-  SHOW_WELCOME    -  Toggle whether to show welcome message.
-  SHELL_CMD       -  Shell command line prefix, e.g. ["cmd", "/c"]
-
-Keyboard Shortcuts:
-  ↑↓      -  Navigate through command history.
-  →       -  Apply selected history entry to the prompt.
-  Ctrl+R  -  Reverse incremental searching (history).
-  Ctrl+Z  -  Undo.
-  Ctrl+Y  -  Redo.
-  Ctrl+D  -  Exit XmyShell."""