core base shell repo including setup scripts. The repo constitues a minimal install
Go to file
Kebler Network System Administrator 99c01d4bb7 add sudo module with Sudo function for running functions or alias as sudo
add install-shell-repo library for easy install of other shell repos (host, network)
2023-02-15 07:08:24 -08:00
alias add sdmt for showing systemd mounts 2023-02-07 09:18:52 -08:00
env fix: dont tee load log (llog) to console -shows on container boot 2023-01-22 08:29:41 -08:00
functions add sudo module with Sudo function for running functions or alias as sudo 2023-02-15 07:08:24 -08:00
install fix: dont tee load log (llog) to console -shows on container boot 2023-01-22 08:29:41 -08:00
modules add sudo module with Sudo function for running functions or alias as sudo 2023-02-15 07:08:24 -08:00
.bash-shell-ignore add: tools to shell directory includes 2022-02-20 12:44:29 -08:00
.bash-shell-include refactor user install and how $BASH_SHELL_USER_DIR is exported early. 2023-01-20 17:20:19 -08:00
.gitignore refactor shell install scripts 2023-01-18 16:50:31 -08:00
README.md refactor shell environmnet so user can have create customized shell.env 2022-12-30 09:18:39 -08:00
load.sh fix: dont tee load log (llog) to console -shows on container boot 2023-01-22 08:29:41 -08:00
module.lib move environment functions to env module from file module and helpers module 2023-01-05 12:36:23 -08:00
shell.env refactor user install and how $BASH_SHELL_USER_DIR is exported early. 2023-01-20 17:20:19 -08:00
startup.sh feat: clean up shell.env, improved comments, added in BAHS_SHELL_DEV repo /opt/shell default 2022-03-01 22:45:40 -08:00

README.md

Bash Shell Organizer

A better way to keep your shell setup organized, clean, and useful

interactive (.bashrc) environment, aliases, functions, modules

Install

Clone to a directory

git clone https://git.kebler.net/bashrc <repo path> suggestion: /opt/shell/base

The idea is to keep the .bashrc file completely clean and manage this repo instead so you should really find a home for all the existing content of your .bashrc file within the repo

Every file in env functions,aliases and misc subdirectories will be sourced in that order (in setup.sh). Within each folder all files are sourced except ones ending with a .off extension, starting with . and the README.md file plus any in any subfolder except /archive or /dep

The sourced files in this repo should be NOT be user/machine/network specific

if you include any of these environment variables all files in there directories will be sourced where

unless below specific directories are set

shell files are sourced in this order

sourced via /etc/bash.bashrc so for all machine users

$BASH_SHELL_BASE # this is set in /etc/bash.bashrc and etc/profile via the deploy script

$BASH_SHELL_NETWORK/all

$BASH_SHELL_NETWORK/$NETWORKNAME

$BASH_SHELL_HOST/all

$BASH_SHELL_HOST/

sourced via $HOME/.bashrc

$HOME/shell or $HOME/BASH_SHELL_USER

within each of those directories if setup.sh exits it will be run

otherwise files will be sourced exactly like in the base

identify a network name that this host resides on

like hostname but for the LAN network

if unset then only /all will be sourced

export NETWORKNAME=238

will use $BASH_SHELL_NETWORK/$NETWORKNAME under this directory unless specifically set

export BASH_SHELL_NETWORK=$BASH_SHELL/network

will use $BASH_SHELL_HOST/ unless specifically set

export BASH_SHELL_HOST=$BASH_SHELL/host

by default SHELL sources will be looked for under $HOME/shell

but can be user set below to BASH_SHELL_USER_DIR

export BASH_SHELL_USER=<some directory under $HOME>

if there is a script setup.sh in the root of these directoies it will be run. If not then all files no matter how deep will be sourced in alpha order order.

For those

If need to turn off a file just add .off to the file name rather than move or delete the file...simple.

If you are really done with something but want to keep a copy in the repo move it to /archive folder within the primary subfolders

if sourcing some file depends on another preface with numbers to put it before. Functions are all sourced before aliases so can be referred to there.

Be aware that an alias or function set in the repo could be subsuming some existing binary or script.

interactive non-login shells source /etc/profile via /etc/bash.bashrc otherwise non-interactive non-login shells only load a basic path and access to the module library. One needs to one off source the modules needed for the script. Aliases too are not loaded in this case.

Thus for non-interactive/non-login shells it is best to symlink a non-module file/directory in modules folder in order to give access to non-interactive shells