Skip to main content

Path to action.

Project description

When you click to a file or folder in graphical OS they will be opened in associated app. The xontrib-onepath brings the same logic for the xonsh shell. Type the filename or path without preceding command and an associated action will be executed. The actions are customizable.

If you like the idea of bar theme click ⭐ on the repo and stay tuned by watching releases.

Install

xpip install -U xontrib-onepath
echo 'xontrib load onepath' >> ~/.xonshrc
# Reload xonsh

Default actions

Type Action
inode/directory ls
text/plain vim
image/ xdg-open

Help to add more types and best default actions. PRs are welcome!

Example

$ /                      # ls /
$ ~/.xonshrc             # vim ~/.xonshrc
$ ~/Downloads/logo.png   # xdg-open ~/Downloads/logo.png 

Type format

Priority Format Example
1 Full path to file. /etc/passwd
2 File name. file.txt
3 File extension. *.txt
4 MIME type/subtype and extension. text/plain.txt
5 MIME type/subtype. text/plain
6 MIME type. text/
7 Any file. FILE (constant)
8 Any directory. DIR (constant)
9 Any file or directory. * (constant)

To get MIME type for the file run file --mime-type --brief <file>.

Customize actions

Use XONTRIB_ONEPATH_ACTIONS environment variable to add new actions:

$XONTRIB_ONEPATH_ACTIONS['.xonshrc'] = 'vim'         # vim for `.xonshrc` file
$XONTRIB_ONEPATH_ACTIONS['*.log'] = 'tail'           # tail for text type *.log files
$XONTRIB_ONEPATH_ACTIONS['text/plain.txt'] = 'less'  # less for plain text *.txt files 
$XONTRIB_ONEPATH_ACTIONS['DIR'] = 'cd'               # the same as xonsh $AUTO_CD=True
$XONTRIB_ONEPATH_ACTIONS['application/zip'] = 'als'  # list files in zip file using atool

Complex actions

If you need more complex actions use callable xonsh aliases:

import pandas as pd
def _view_csv_with_pandas(args):
    print(pd.read_csv(args[0]))

aliases['view_csv_with_pandas'] = _view_csv_with_pandas
del _view_csv_with_pandas

$XONTRIB_ONEPATH_ACTIONS['application/csv'] = 'view_csv_with_pandas'

Known issues

NTFS in Linux: all files have execute permission

If you mount NTFS partition with default permissions then all files will have execute permission and onepath will execute them instead of action. The right way is to change default /etc/fstab settings. Example:

sudo umount /d
sudo mount -o uid=1000,gid=1000,dmask=027,fmask=137 /d 
ls -la /d

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

xontrib-onepath-0.0.4.tar.gz (4.7 kB view details)

Uploaded Source

Built Distribution

xontrib_onepath-0.0.4-py3-none-any.whl (4.6 kB view details)

Uploaded Python 3

File details

Details for the file xontrib-onepath-0.0.4.tar.gz.

File metadata

  • Download URL: xontrib-onepath-0.0.4.tar.gz
  • Upload date:
  • Size: 4.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/47.1.0 requests-toolbelt/0.9.1 tqdm/4.49.0 CPython/3.8.5

File hashes

Hashes for xontrib-onepath-0.0.4.tar.gz
Algorithm Hash digest
SHA256 5bcba2eab0a7877895959746efb4f6117aa518743e991f2b17804e8581c6721a
MD5 54b38e6bda60f1a205c187e909972d2e
BLAKE2b-256 fcbfd0b27f3a3be41ed76877a0554fd0f3f5f2e7f8d3da90b8e491702aed1079

See more details on using hashes here.

File details

Details for the file xontrib_onepath-0.0.4-py3-none-any.whl.

File metadata

  • Download URL: xontrib_onepath-0.0.4-py3-none-any.whl
  • Upload date:
  • Size: 4.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/47.1.0 requests-toolbelt/0.9.1 tqdm/4.49.0 CPython/3.8.5

File hashes

Hashes for xontrib_onepath-0.0.4-py3-none-any.whl
Algorithm Hash digest
SHA256 e4614236568f4ad92d6cbdde5942157b22d6137036b64db54e457d6c862f470f
MD5 b23b680ad78b43704232ebd4dbce0d46
BLAKE2b-256 cb4eddf237ce453aa84033688b00a65ac314de050f219ab85a0fb8fca82eb5e9

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page