Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

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

A collection of tools I like to have on ddev.
https://github.com/hanoii/ddev-pimp-my-shell

Last synced: 1 day ago
JSON representation

A collection of tools I like to have on ddev.

Awesome Lists containing this project

README 

        
[![tests](https://github.com/hanoii/ddev-pimp-my-shell/actions/workflows/tests.yml/badge.svg)](https://github.com/hanoii/ddev-pimp-my-shell/actions/workflows/tests.yml)

![project is maintained](https://img.shields.io/maintenance/yes/2024.svg)



# 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](#features)

- [Tweaks](#tweaks)

  * [ahoy](#ahoy)

  * [starship](#starship)

  * [fish](#fish)

  * [ddev `post-import-db` hook](#ddev-post-import-db-hook)

- [Install the dev version](#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



It also has:



- Some useful [scripts](pimp-my-shell/scripts)



## Tweaks



### ahoy



It bundles autocomplete for both bash and fish.



### starship



If you want to use a [Nerd font](https://starship.rs/presets/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`](homeadditions/.config/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:



```fish

# 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

```



### 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](https://github.com/hanoii)**