Go to file
bretello 25eb757af3
vim: formatting in vimrc
2020-12-07 23:41:44 +01:00
ipython/profile_default update ipython config, add to install script 2020-11-22 16:51:48 +01:00
vim vim: formatting in vimrc 2020-12-07 23:41:44 +01:00
.gitignore add ipython config 2020-06-15 01:49:03 +02:00
README.md update documentation 2020-12-07 23:41:44 +01:00
ackrc add .venv to ackrc's ignore 2020-11-13 13:23:50 +01:00
aliases.sh aliases: add dockerip to parse docker inspect's output 2020-12-07 00:43:34 +01:00
antibody_plugins.txt zsh: remove git-auto-fetch plugin, disable kubectl by default 2020-11-22 15:54:40 +01:00
antibody_plugins_arch.txt add conditional linux oh-my-zsh plugins loading 2020-02-27 18:48:01 +01:00
brethil-minimal.zsh-theme use antigen+oh-my-zsh for easy plugin maintenance 2020-02-14 16:37:47 +01:00
brethil.zsh-theme zsh-theme: add multi-line support for long prompts, cleanup 2020-12-05 02:04:38 +01:00
brethil_dotfile.sh cleanup documentation/install script 2020-12-07 23:41:44 +01:00
check_for_update.sh fix update script for antibody 2020-03-11 19:02:13 +01:00
colors.sh colors: improve readability 2020-12-04 15:58:10 +01:00
functions.sh functions: update pipupdate 2020-11-13 13:26:19 +01:00
gitconfig update git config 2020-12-04 15:58:09 +01:00
install.sh documentation cleanup 2020-12-07 23:41:44 +01:00
pdbrc.py pdbrc: add style options 2020-06-15 01:49:03 +02:00
twilight256.vim add vim colorscheme twilight256 2020-02-14 16:37:52 +01:00
useful_commands New repo initial commit 2017-06-12 16:22:05 +02:00

README.md

brethil's dotfiles

A set of zsh dotfiles based on antibody and oh-my-zsh

Description

├── README.md ├──────── Main files ──────── │ ├── aliases.sh │ │     └── aliases definitions (sources ~/.dotfiles_aliases) │ ├── colors.sh │ │     └── ANSI color escapes │ ├── functions.sh │ │     └── contains function definitions (sources ~/.dotfiles_functions) │ ├── install.sh │ │     └── main install script │ └── brethil_dotfile.sh: │       └── This file should be sourced by your .zshrc ├──────── antibody plugins ──────── │ ├── antibody_plugins_arch.txt │ └── antibody_plugins.txt ├──────── oh-my-zsh themes ──────── │ ├── brethil.zsh-theme │ └── brethil-minimal.zsh-theme ├──────── Misc rc files──────── │ ├── gitconfig │ │     └── git configuration │ ├── ackrc │ │     └── ack's rc: a grep-like text finder │ ├── ipython │ │     ├── profile_default │ │     ├── ipython_config.py │ │     ├── startup │ │     ├── 11-autoreload.py │ │     └── README │ ├── vim │ │    ├── vimrc │ │    │ └── main vim rc │ │    ├── plugs.vim │ │    │ └── plugins to be installed with vim-plug │ │    ├── plugins_config.vim │ │    │ └── plugins configuration │ │    ├── shortcuts.vim │ │    │ └── vim shortcuts definitions │ │    ├── functions.vim │ │    │ └── miscellaneous vim function │ │    └── twilight256.vim │ │      └── an old colorscheme │ └── pdbrc.py │      └── pdb++'s rc (a drop-in replacement for pdb) ├──────── Other ───────────── ├── check_for_update.sh │      └── selfupdate script └── useful_commands

Installation

git clone https://git.decapod.one/brethil/dotfiles ~/.dotfiles
cd .dotfiles && bash install.sh

A self-update mechanism is included. It asks for confirmation to pull the latest changes from the git repo every two weeks. This also updates the git-sourced repositories installed by the install script. The self-update routine can be called manually by calling

dotfiles_selfupdate

If you do not want to run the installer script, you can just add source brethil_dotfile.sh in your .zshrc. This requires antibody installed.

Available Functions

  1. cheat: show cheat sheet for commands using cheat.sh (cheat <commandname>)

  2. Quickly edit/reload profile (esource/resource)

  3. dockertags list all tags for a given docker image

  4. color to print colored text (see 3. in the Misc section):

    color $Red "This will be printed in red"
    color $Yellow "This will be printed in red"
    
  5. mecp to copy files back to the machine from wich you are ssh-ing. For this to work an ssh tunnel with Remoteforward is needed:

     ssh -R 22:localhost:2222 YOURHOSTNAMEHERE
    

    or specify this in ~/.ssh/config for a persistent configuration:

    Host YOURHOSTNAMEHERE
    Remoteforward 2222 localhost:22
    

    This can be enabled in ~/.ssh/config globally for all hosts by uncommenting the relevant Host * Remoteforward. You might have to manually edit the username in the mecp definition in functions.sh if this is different between the two machines. mecp copies by default on the local machine on ~/Desktop/

  6. Many more. Use list_functions to list defined functions and a small description

Files/Folders

  1. ~/bin, ~/git, ~/projects folders
  2. ssh config (~/.ssh/config):
    • Create ssh keys if not defined already
    • Keep connections alive by increasing timeout time
    • Include multiplexer to allow quick multiple connections to the same host
    • (Optional: Compression, this should allow more responsive shells with slow connections, but will slow things down when copying large files. My suggestion is to have compression enabled on a by-host basis in ~/.ssh/config)
  3. brethil.zsh-theme, brethil-minimal.zsh-themes, themes for oh-my-zsh, symlinked in $ZSH/custom/themes ($ZSH=~/.oh-my-zsh)
  4. ~/.dotfiles_functions, ~/.dotfiles_aliases are sourced by this dotfiles, allowing for custom functions/aliases
  5. useful_commands contains a list of useful commands (the first rule of the tautology club...)

Misc

  1. Colored output (via grc) for several commands.

  2. Easy names for ANSI color escapes (Black, Red, Green, Yellow, Blue, Cyan, Purple, White, CLEAR), for example:

    echo -e "${Green}This text will be green${CLEAR}"
    

    will result in green text. Use $CLEAR to clear previous escape sequences add B before the variable (check colors.sh) name to use bold and U to underline (examples: $BRed, $UBlack for bold red and underlined black)

  3. Autoupdate script running every two weeks, autoupdate function: dotfiles_selfupdate (or git pull from $DOTFILESfolder)

  4. Automatic fix of theSSH_AUTH_SOCKenvironment variable:~/.ssh/rc is installed run on every ssh login, and updates a symlink pointing (~/.ssh/ssh_auth_sock). SSH_AUTH_SOCKpoints to this (set inbrethil_dotfile.sh). The idea is that if the user is logging in using ssh -A, and using tmux, it will be possible to use the remote socket over different sessions by always using the symlink.