Nice Developer References – an espanso package

A package for espanso/espanso.

Takes URLs from the clipboard and inserts a formatted link based on it.

Usage

➡️ nice-dev-refs

Installation

Requirements: Python >= 3.9

Unfortunately, we have to perform the installation with a little bit more finger-grease as we are used to (Discussion):

# cd anywhere/you/want
git clone git@github.com:reitzig/espanso-nice-dev-refs.git
cd espanso-nice-dev-refs

espanso install nice-dev-refs --git "$(realpath "$(pwd)")" --external

mkdir -p ~/.config/espanso/scripts/
ln -s "$(realpath "$(pwd)")"/scripts/*.py ~/.config/espanso/scripts/

For more selective application refer to Include and Exclude rules

Contributing

🥳 Support for additional URL patterns is welcome – unless and until replace performance decreases too much. To limit the scope somewhat, let's stick to things you link to all the time in software development.

Whether you want to fix a bug or add a feature,

• add at least one (red) test,
• make it green,
• make sure ruff does not complain, and
• create a PR.

Development

Prepare a checkout of your fork:

pyenv local  # if you are into this kind of thing
poetry install --no-root
# activate .venv

Now you should be able to run the relevant commands:

ruff format . # formatting
ruff check .  # linting
pytest        # testing

For convenience, there are also

poe lint
poe test

Other tools can be installed with aqua:

aqua install

We include configuration for evilmartians/lefthook which we encourage you to use:

lefthook install

We also consider direnv/direnv to be inherently useful, and therefore include our .envrc.