Server to aid shell navigation.
Project description
ShellServer
It's a mix of Starship and Zoxide but faster.
On Starship, every 'Enter' keystroke spawns a new process, which may cause a lag between prompts.
Zoxide will raise a new process every time you call it.
ShellServer raises the server only in the first shell creation and will communicate with your shell on every 'Enter' keystroke.
Fastness comes from not having spawning time, which seems to be way higher in Windows.
But if your hardware gives you a fluid shell experience using Starship, I recommend that you keep with it because it's way more customizable.
Features
Prompt with a fast glance at what is in the directory
This is the most bloated prompt that you will get.
It will indicate the existence of Python, C, C++, Lua, Node, and PowerShell files in the directory.
The compilers searched are GCC and G++.
No lag from spawning processes
Better 'cd'
p -o path
for writing to output. Tool for things likemove somefile (p -o somepath)
p
behaves likecd
for unknown paths
Note: fzf is a dependency to use 'pz'
Switching Theme
Can take four arguments: all, system, terminal, and blue.
- terminal: Toggles Windows Terminal default theme.
- system: Toggles system-wide Dark Mode.
- blue: Toggles 'Blue light reduction'.
- all: Same as not passing arguments. Do all the above.
The system
option is not working properly on Windows 11 22h2...
Searching history
Listing directory
Plugins
All those are relative to getting the git status.
- watchdog: Filesystem watcher. Makes better caching possible.
- pygit2: libgit2 python bindings. Faster than using git itself.
- ssd_checker: Solid-State Drive checker. Change the strategy accordingly to drive speed.
Just pip install
the ones you want, restart shellserver, and no further config is needed.
Customization
The server will look for a .shellserver.toml
in the user home directory.
Only three options will be searched right now.
git_timeout = 500 # in ms, defaults to 2500
# the best value is really hardware dependent
# if you have watchdog, I would recommend something around 100
# if you don't and the value is too low you might get no status over and over: `[...]`
# Windows Terminal themes
dark_theme = '...' # defaults to Tango Dark
light_theme = '...' # Solarized Light
CLI
The server knows how many clients it haves and will know if you quit shell with 'exit'
but if the window or tab is closed on the 'X' button it may outlive the shell.
usage: shellserver [-h] {kill,clear}
positional arguments:
{kill,clear} "kill" to kill the server, "clear" to clear the cache.
options:
-h, --help show this help message and exit
Requirements
- Python 3.9+ or latest Pypy (still slower than Python 3.11)
- PowerShell 6.2+ (I think)
- Any NerdFont (I use MesloLGS NF)
- A xterm compatible terminal
Installation
Currently, ShellServer will work only in PowerShell on Windows.
> pip install shellserver # or pip install --user shellserver
> Install-Module ShellServer -Scope CurrentUser
In your PowerShell profile:
# By the beginning of the file
pythonw -m shellserver # note the 'w'
# By the end of the file
Import-Module ShellServer
Keep updated
As many things might change in versions below 0.1.0, pip install --upgrade shellserver
and Update-Module ShellServer
must both be run when one changes.
v0.0.8+ will work with the PowerShell ShellServer module 0.0.6+.
Debugging
The git status info is still experimental, do pythonw -m shellserver --use-git
in your profile to always use git.
If you have installed pygit2, you can pass --use-pygit2
instead, which is faster than --use-git
.
Any errors that occur will be saved in $env:localappdata\shellserver\traceback
.
Attach a stdout to the server, pass --verbose
to it and it will give the time taken for each communication.
--verbose --git-verbose
will give a lot of info when it sees a git repo.
> shellserver kill
# A message that the server is not responding and your prompt will be like before.
> python -m shellserver --verbose --git-verbose # no w, blocking
Open another shell and walk to a git repo.
There are also:
--disable-git
--wait
: We will use our 'gitstatus' subpackage for repos up to 2500 index entries (in ssd, 1000 otherwise if ssd_checker is present). Will use git otherwise, unless this flag is set.--git-linear
: Fill gitstatus synchronously--no-watchdog
: Disables Watchdog plugin--test-status
: Put gitstatus subpackage result and git.exe status side-by-side
On Pwsh module:
Set-ServerTimeout
: arg in ms.Set-ServerOpt
: Set options in runtime:- enable-git
- disable-git
- use-git: Use git.exe for git status info
- use-gitstatus: Use gitstatus subpackage for git status info
- wait: Use the 'gitstatus' subpackage no matter how big is repo
- verbose
- let-crash: At this point, it's probably useless
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for shellserver-0.0.13-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c3298c0b73219b6f1f6b375bbd1a4d4d0a7c3e4ab5160565161706c60fa93505 |
|
MD5 | 5f6025305781ce2120ec155121017da3 |
|
BLAKE2b-256 | 70571c9d139fd0e546b56e1ad471ebabdf050058e1691fb847daa5983b8be9f9 |