https://github.com/frgomes/bash-scripts

A collection of useful shell scripts, for the lazy and impatient.
https://github.com/frgomes/bash-scripts

Last synced: 15 days ago
JSON representation

A collection of useful shell scripts, for the lazy and impatient.

• Host: GitHub
• URL: https://github.com/frgomes/bash-scripts
• Owner: frgomes
• License: bsd-2-clause
• Created: 2018-04-04T12:18:17.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2024-10-16T01:24:42.000Z (27 days ago)
• Last Synced: 2024-10-17T14:07:01.594Z (25 days ago)
• Language: Shell
• Homepage:
• Size: 818 KB
• Stars: 65
• Watchers: 4
• Forks: 16
• Open Issues: 16
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• stars - frgomes/bash-scripts

README

        
This is a bunch of shell scripts containing useful functions aiming to deliver increased productivity.

> WARNING: This toolbox is under heavy development. Expect that things change.

See extra documentation: [docs](docs)

## Requirements

* Debian or Ubuntu or openSUSE or [maybe your preferred distribution?](docs/distros.md) ([contribute](docs/contribute.md)) 

* Python version 3.4+ ([why?](docs/python-venv.md))

## For the impatient

> WARNING: **Make sure you have two or more terminal window open** so that you can fix mistakes in case your ``.bashrc`` kicks you out next time you log in.

```bash

#!/usr/bin/env sh

[ -d "${HOME}/workspace" ] || mkdir -p "${HOME}/workspace"

[ -d "${HOME}/workspace/bash-scripts" ] || git -C "${HOME}/workspace" clone http://github.com/frgomes/bash-scripts

echo 'source ${HOME}/workspace/bash-scripts/bashrc ## http://github.com/frgomes/bash-scripts' >> ${HOME}/.bashrc

```

Open a new terminal session and enjoy!

## For the experienced and impatient

    curl -s https://raw.githubusercontent.com/frgomes/bash-scripts/master/unsafe/bashrc-up | sh

## Recommended ${HOME}/.bashrc

Below you find a suggestion for ${HOME}/.bashrc for every supported Linux distribution:

    #!/bin/bash -x

    

    ## http://github.com/frgomes/bash-scripts

    [[ -f ${HOME}/workspace/bash-scripts/bashrc ]] && source ${HOME}/workspace/bash-scripts/bashrc

    

    case $( cat /etc/os-release | grep -E '^ID=' | cut -d= -f2 | tr -d '"' ) in

        opensuse-tumbleweed) [[ -d !/.virtualenvs/tumbleweed ]] || mkvirtualenv tumbleweed ; workon tumbleweed ;;

        opensuse-microos)    [[ -d !/.virtualenvs/microos ]]    || mkvirtualenv microos    ; workon microos ;;

        debian)              [[ -d !/.virtualenvs/debian ]]     || mkvirtualenv debian     ; workon debian ;;

        ubuntu)              [[ -d !/.virtualenvs/ubuntu ]]     || mkvirtualenv ubuntu     ; workon ubuntu ;;

        *) ;;

    esac

## Design Concept

Starting from a brand new laptop with only the base operating system installed, I would like to be able to quickly have my environment setup. Then I open a new terminal window and all remaining bits are automagically configured for me. I also would like to install complex software packages easily, employing just a single command. Then I'm ready to go. The entire thing should not take more than a few minutes.

### Features in a nutshell

* Useful shell scripts aiming daily mundane tasks, such as finding text on large codebases;

* Shell scripts for installing Java, Node, Scala, Rust, among a bunch of other things;

* One [post installation script for sysadmins](docs/postinstall-sysadmin.md) configuring a brand new laptop or server;

* One [post installation script for regular users](docs/postinstall-user.md) seeking Firefox and Thunderbird in user's space;

* Employs [virtual environments](docs/python-venv.md) in order to allow distinct versions of your preferred tools;

* All [commands always available](docs/design.md), no matter if you are using functions, sub-shells or whatever;

* Flexibility of a separate history per session but also a [global history for all sessions](docs/history.md).

### Other use cases

* Opinionated [post installation on system's space](docs/postinstall-sysadmin.md);

* Opinionated [post installation on user's space](docs/postinstall-user.md);

## Additional tricks

### Source your own custom scripts

The initializaton runs scripts matching the pattern: ``$HOME/bin/bash_*.sh``

### Other custom scripts

> This is experimental and requires code review.

More details [here](docs/extensions.md).