Library of the useful macroses for the xonsh shell.
Project description
fstrider is an intuitive and fast file system navigator for terminal.
If you like it click ⭐ on the repo and tweet.
fstrider is:
- to reduce keystrokes during navigation.
- to remember and reuse the behavior and choices.
- to be minimalistic until it's needed to do more.
- to create new paths without annoying asking.
Install
Before installation read the text below about using /
when copying or moving files and directories.
Install or update:
pip install fstrider
# OR: pip install -U git+https://github.com/anki-code/fstrider
Usage
Run fstrider and start striding:
fstrider
In the xonsh shell you can load xontrib with s
alias that works fast and allows to change directory using fstrider:
xontrib load fstrider
fs # or fstrider
Key bindings
Basic:
- Left - move to parent directory.
- Right - move to the selected directory.
- Space - open menu for the current file or directory.
- Enter - open file or directory using OS associations.
- Esc - quit.
Additional:
- Shift ~ - jump to the home directoy.
- Control j - jump to path. You can jump into new path and then create it.
- Control h - jump to directory from history.
- Control + - copy path to the current directory.
Midnight Commander bindings: F5 copy, F6 move, F7 rename, F8 delete, F10 quit, F12 open with.
Using /
when copying or moving.
fstrider was created to reduce keystrokes. So remember two things:
- Any new path will be created automatically. When you copy the file
example.txt
to/tmp/some/new/path/
the path/tmp/some/new/path/
will be created automatically. - If you copy directory
/tmp/dir1
and the target path ends with/
e.g./tmp/other/
then thedir1
will be putted into/tmp/other/dir
. - If you copy directory
/tmp/dir2
and the target path ends with directory name e.g./tmp/other
then thedir2
will be merged with/tmp/other
. Existing files will be overwritten.
Xonsh xontrib
fstrider xontrib features:
- Creates alias
fs
(orfstrider
iffs
exists). - Run fstrider as fast as possible.
- Keeps history between running fstrider.
Environment variables for fstrider xontrib:
$XONTRIB_FSTRIDER_ALIAS
- change the alias name. Recommendeds
.
Options
'show_symlink_paths': True
- show symlinks in the list.'keys_midnight_commander': True
- use Midnight Commander keys.'monitor_state': False
- Async monitoring of the list and update if new files created.'os_path_change': True
- change os path in xonsh shell.'app_associations_save_file': False
- save filename to apps associations.
You can change the option state by setting environment variable e.g. $FSTRIDER_MONITOR_STATE=True
.
Known issues
Tested only on Mac OS
Current version of fstrider is using and testing on Mac OS. It will be good to test and fix for Linux and Windows.
Roadmap
Feel free to grab and implement or propose new feature. PR is welcome!
v0.2.0
Xonsh xontrib
++ Creates alias `fs` (or `fstrider` if `fs` exists). (0.1.18)
++ Run fstrider as fast as possible. (0.1.18)
++ Keeps history between running fstrider. (0.1.18)
List
++ Async monitoring of the list and update if new files created. (0.1.19)
Configuration
++ Read env from `os.env`. See `fstrider.env`. (0.1.19)
Integration
"=" to move object from path to the current dir.
Tech
Errors processing
Show errors like in case of exception.
Process `File exists` error.
++ Resolve `/tmp/../../`. (0.1.17)
Symlinks: copying, moving
Style
Grey style for copy/move and red style for delete dialogue.
Navigation
++ Up key at first option moves cursor to end. (0.1.19)
Fix left key when go from history.
Fix right key when go to file from history.
v0.3.0
Navigation
Go back to previous directory after moving or copying.
List
Sorting by size/date `sorted(glob.glob('*.png'), key=os.path.getsize)`.
Modes: short, full (chmod/chown/date).
Jump
Use path from clipboard e.g. `text_area.buffer.paste_clipboard_data`.
Use directories from xonsh history i.e. `__xonsh__.history[-1].cwd`
v0.4.0
Title
Show chown/chmod if "Access denied".
Show what part of path is exist and what's new.
Dialog
Autocomplete for paths in menu - the feature from prompt-toolkit.
Copying progress bar or just the console log from `rsync`.
v0.5.0
List
Fuzzy search.
Research: Draggable items i.e. `ls --hyperlink`.
Associations
`.xonshrc` case in app_assoc.
Highlight known suffix from app_assoc.
Using $LS_COLORS and `dircolors` for color files.
v0.6.0
List
Improve speed of list on big amount of items - 10k+
Waiting for community
Integration
Other shells support.
Key bindings
The way to change key bindings.
VI mode, Emacs mode.
Style
Dark style.
Ideas for future
List
Fake files (items in the list)
Fake deleted file to show that this file was deleted.
Interstellar wormhole - path to another path added to this directory.
Read the path from files in this directory.
Colors and gradient: by time, by size. Show old files with dark color. Show small files with dark color.
Integration
Catching pasting path from clipboard and ask actions: cd-ing, copy/move from, open.
Using fstrider for anything e.g. striding around aws s3 bucket, ssh host.
The way to setup fstrider for special needs: colors, menus, hotkeys.
Keys
Free keys to use: `/`, `-`.
Xonsh shell
Using xonsh shell history to jump into directories.
Run shell command in this directory.
Crazy: use xonsh prompt as a prompt for ptk `TextArea`
AI
Predict the next choice of path based on history and maybe files in dir.
Good to know
- Copy the current path in MacOS Finder: Option Command C
- Jump to path in MacOS Finder: Command Shift G
Project details
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 fstrider-0.1.19-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7fb01902c61d046047dc82b6bbffb9db7a0962886c460c2ab45ab33663624869 |
|
MD5 | 0585d3daf40982dd2d4708968e048c15 |
|
BLAKE2b-256 | 9eb68b5e49951112afb8be36f18d3946405dca59a3a1c56e87622103c5bf37b2 |