Urda's Bash Files

This is a collection of my bash prompt settings, aliases, exports, and other related shell scripts.

urda.bash Features

• Exposes the XDG Base Directory specification variables.
• Supports loading bash shell parts based on host operating system:
  • bash_linux - For Linux platforms.
  • bash_osx - For macOS platforms.
• Displays "information lines" in shell:
  • git working state information.
  • screen session name.
  • virtualenv / pyenv environment names.
• Understands various tools and tooling in shell:
  • direnv support.
  • nvm support.
  • pyenv support.
• Weekly VERSION check against GitHub remote.
  • Also supports on-demand version checking with _urdabash_version_check now

Should work with bash 3.2 or higher.

urda.bash Special Functions

These are helper functions for urda.bash. You should not rely on them as a public API at this time.

• _postpend_path_once
  • Postpends a value to the ${PATH} variable ONCE, and avoids duplicates.
• _prepend_path_once
  • Prepends a value to the ${PATH} variable ONCE, and avoids duplicates.
• _source_if_exists
  • Internal helper function to only source a file if it exists, skips otherwise.
• _urdabash_info
  • You can invoke this to see a little information printout about the current urda.bash configuration.
• _urdabash_version_check
  • This handles checking for a different VERSION (which should mean a new urda.bash release is out).

Working with urda.bash project files

Get Makefile help

You can run a bare make or make help to display the help screen.

Comparing to your local bash

After you clone this repo, you can also run a quick diff that will compare your local bash files against the repo files:

make diffs

Running tests

This will also run a make version-check.

make test

Copying files to your ${HOME}

WARNING! This is a DESTRUCTIVE operation and copies bash files from the project into your ${HOME}.

make copy

Project version check

Just run make version-check.