README.md

ddev-pimp-my-shell

This a an addon that adds several nice command line utitlites I use across all projects, making it easier/nicer to work inside the container with some initial defaults.

• Features
• Tweaks
  • ahoy
  • starship
  • fish
  • lazygit
  • ddev post-import-db hook
• Install the dev version

Features

• https://github.com/ahoy-cli/ahoy

• https://github.com/skywind3000/z.lua (working on both bash and fish)

• https://github.com/junegunn/fzf

• https://github.com/junegunn/fzf-git.sh

• https://starship.rs/

• https://github.com/charmbracelet/gum

• https://github.com/fish-shell/fish-shell / https://fishshell.com/

  • https://github.com/jorgebucaran/fisher
  • https://github.com/IlanCosman/tide
  • https://github.com/edc/bass

• https://chrisbuilds.github.io/terminaltexteffects/

• https://bun.sh/

• https://github.com/eza-community/eza/

• https://github.com/jesseduffield/lazygit/

• https://github.com/noborus/ov

• Some useful scripts

Tweaks

ahoy

It bundles autocomplete for both bash and fish.

starship

If you want to use a Nerd font, there are many ways you can achieve that. I am personally editing my global ~/.ddev/global_config.yaml on the host and adding a STARSHIP_CONFIG environment variable pointing to an alternative config file which I also added to ~/.ddev/homeadditions/.config on the host with the content of this add-on's starship.toml and merging it with the output of ([directory] is in both):

starship preset nerd-font-symbols

fish

For tide, it uses the default configuration, if you want to have your own on all of your ddev projects you can create/edit ~/.ddev/homeadditions/.config/fish/conf.d/mytide.fish on the host with something like the following:

# Doing it as a fish_prompt event to make sure it is shown the first time it's
# run. Not sure if this is the best workaround, but otherwise the first `ddev fish`
# would show no prompt.
function mytide --on-event fish_prompt
  if not test -f ~/.config/fish/conf.d/.mytide && tide --version > /dev/null
    tide configure --auto --style=Classic --prompt_colors='True color' --classic_prompt_color=Light --show_time=No --classic_prompt_separators=Angled --powerline_prompt_heads=Sharp --powerline_prompt_tails=Flat --powerline_prompt_style='One line' --prompt_spacing=Compact --icons='Many icons' --transient=Yes
    touch ~/.config/fish/conf.d/.mytide
  end
endkkk

lazygit

It adds a config.yml diabling the startup popups.

ddev post-import-db hook

I generally have import scripts that I ship either from other add-ons or specific to projects and those scripts usually download the database from within the container. Rather than downloading the database and then running ddev import-db --file= I wanted to provide a way so that either way runs all of my post-import-db commands both with the ddev import command as well as from any helper script from within the project.

So the way this works is that you can run /var/www/html/.ddev/pimp-my-shell/hooks/post-import-db.sh from any script that will be run in the container and it will take care of running all scripts on .ddev/pimp-my-shell/post-import-db.d/.

This also allows for other add-ons to add scripts to this directory so that they will be run.

Example on how I am using it:

• https://github.com/hanoii/ddev-platformsh-lite/blob/ce4b95d578e82f942b75ec9fa6fa60f63473c90b/platformsh-lite/scripts/db-pull.sh#L91
• https://github.com/hanoii/ddev-platformsh-lite/blob/ce4b95d578e82f942b75ec9fa6fa60f63473c90b/pimp-my-shell/hooks/post-import-db.d/00-drupal.sh

Install the dev version

You can always install the latest code with

ddev get https://github.com/hanoii/ddev-pimp-my-shell/tarball/main

Contributed and maintained by @hanoii