Skip to main content

Send notification once long running command is finished. Add duration PROMP_FIELD.

Project description

Overview

Send notification once long-running command is finished and also show the execution time.

Installation

To install use pip:

xpip install xontrib-cmd-durations
# or: xpip install -U git+https://github.com/jnoortheen/xontrib-cmd-durations

Usage

Add the long_cmd_duration section to the prompt fields and load the xontrib i.e.:

$RIGHT_PROMPT = '{long_cmd_duration:⌛{}}{user:{{BOLD_RED}}🤖{}}{hostname:{{BOLD_#FA8072}}🖥{}}'
$XONTRIB_CD_LONG_DURATION = 5  # default
xontrib load cmd_done

If the command is taking more than $XONTRIB_CD_LONG_DURATION seconds then long_cmd_duration returns the duration in human readable way:

The desktop notification is sent if the terminal is not focused:

Currently the focusing part requires xdotool to be installed.

Known issues

Notifications in Windows

On windows the notification will get triggered all the time. Finding whether the terminal is focused is not implemented for Windows yet and PRs are very welcome on that. Set $XONTRIB_CD_TRIGGER_NOTIFICATION = False to completely off the notification part.

Notifications in MacOS

If you want to change the app name in notification in MacOS you can use $XONTRIB_CD_NOTIFICATION_APP_NAME environment variable with automatically replaced keywords:

$XONTRIB_CD_NOTIFICATION_APP_NAME = '{user}@{hostname}:{cwd}'
$RIGHT_PROMPT = '{long_cmd_duration}'
xontrib load cmd_done

sleep 6
# Switch to another window

Result:

Credits

This package was created with xontrib cookiecutter template.

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-cmd-durations-0.3.1.tar.gz (4.2 kB view details)

Uploaded Source

Built Distribution

xontrib_cmd_durations-0.3.1-py3-none-any.whl (4.8 kB view details)

Uploaded Python 3

File details

Details for the file xontrib-cmd-durations-0.3.1.tar.gz.

File metadata

  • Download URL: xontrib-cmd-durations-0.3.1.tar.gz
  • Upload date:
  • Size: 4.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.0.0 CPython/3.12.2

File hashes

Hashes for xontrib-cmd-durations-0.3.1.tar.gz
Algorithm Hash digest
SHA256 7a1cc0413aa7fb4108bb32556a66fd1df0a15cce4e69f0a9613ed4add4ba34be
MD5 2d82fd21710ef500c95eb945c2439281
BLAKE2b-256 056839a0b3f269a414cba6eb7f44847c815e4917afb9a9c9305a703317d91b96

See more details on using hashes here.

File details

Details for the file xontrib_cmd_durations-0.3.1-py3-none-any.whl.

File metadata

File hashes

Hashes for xontrib_cmd_durations-0.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 4db8aec26a76229bb6bf077ca463cdc8b2ca4ae7cc64700a0a2fdbf3a640d428
MD5 b3d5bc79a05d05cba108a6b06b7a4e51
BLAKE2b-256 af6a90445b15cab7ff9d337246a964cfd91b0047b4388daab1bc293897d81d27

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