init: start new project [create-git] as wrapper for git command

Author: maveius

.gitignore

@@ -0,0 +1,4 @@
+/git
+/src/create-git.sh.x.c
+/src/git
+.idea/

README.md

@@ -0,0 +1,83 @@
+# Create Git - Executable file with SSH Key
+This project contains tool to generate binary executable git file which using your SSH private key in passed path.
+This is wrapper for git command.
+
+## Why and When ?
+- When You are working on private machine (Notebook, Desktop) and You would like to separate your
+  private configuration (private OpenSource projects) and your company configuration.
+- When Your company has implemented not-standard authentication methods (i.e., Username & Password) by HTTPS
+  (i.e., by Token in GitLab self-hosted)
+- When Your favourite IDE does not support and store path to SSH Key for Git (i.e., PyCharm 2021.1.2)
+- When You don't run ssh-agent in daemon mode using only in your company (and adding SSH Key to each session in shell)
+- When You don't want to configure in global home directory ssh-keys used by Your company [Security Reason]
+
+## Requirements
+- ssh 
+- ssh-agent
+- ssh-add
+- bash
+- git
+- shc           #   compile sh scripts to binary executable
+
+## Installation
+
+### [How to install required SHC](doc/install.md)
+
+### Create-Git
+
+Download or clone this repository:
+
+    git clone https://github.com/Webinterpret/create-git.git
+Change directory:
+
+    cd create-git
+
+Check files:
+
+    ls -la
+
+Compare if structure is like below:
+
+    ├── create-git              # The main git executable creator (compiled from ./src/create-git.sh)
+    ├── README.md               # This README.md file
+    └── src                     # Source directory
+        ├── create-git.sh       # Main git executable creator source code written in bash
+        └── git.sh              # Main source code of git wrapper command used to compile locally written in bash 
+
+
+## Usage (after `cd` to `create-git` directory)
+
+To see available options:
+
+    $ ./create-git -h
+or
+
+    $ ./create-git --help
+
+or 
+
+    $ ./create-git -?
+
+
+Example:
+
+    $ ./create-git -k /path/to/your/company/topsecret/private/key [-s|--source] [i.e. /home/{user}/repositories/create-git/src] [-t|--target] [i.e. /top/secret/path/to/encrypted/company/drive/bin/]
+
+
+## Compiling `create-git.sh` script
+
+When you change `/src/create-git.sh` file then you need to compile new version like below (when you inside main project dir):
+
+    $ shc -f src/create-git.sh -o create-git && rm src/create-git.sh.x.c
+
+After that you can commit new version for create-git tool.
+
+## Use cases
+
+When you want to change system git executable in PyCharm:
+
+1. Open `Settings`
+2. Find `Version Control` section
+3. Find `Git` section
+4. Find `Git executable` and fill like below:
+![pycharm](./doc/pycharm.png)

create-git

@@ -0,0 +1,44 @@
+## Installation
+
+### SHC (Required)   
+1. For Debian family [Debian, Ubuntu, Xubuntu, Lubuntu, etc.]
+
+
+    sudo add-apt-repository -y ppa:neurobin/ppa
+    sudo apt-get update
+    sudo apt-get install shc
+
+2. For ArchLinux family [ArchLinux, Manjaro, etc.]
+
+   
+    pacman -S shc
+
+Alternative by `yay` or alias for yay `ya`:
+    
+    yay -S shc
+    ya -S shc
+
+
+3. CentOS & Fedora family [CentOS, Fedora, etc.] 
+
+   
+    yum install -y epel-release shc
+
+X. From source:
+
+Download the latest version of shc
+Open a terminal and changeg directory to your downloads directory, or wherever the tar file is.
+Extract it:
+    
+    $ tar xvfz shc-4.0.3.tar.gz  # depending on version
+
+Then do the installation:
+    
+    $ ./configure
+    ...
+    $ make
+    ...
+    $ sudo make install
+    ...
+
+### [Back to README](../README.md)

doc/install.md

@@ -0,0 +1,73 @@
+#!/bin/bash
+key=""
+source="./src/"
+target="."
+
+NC='\033[0m'
+RED='\033[0;31m'
+GREEN="\033[0;32m"
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+
+function help() {
+  echo
+  echo "Create Git - Tool to create binary executable git file using compiled SSH Key"
+  echo
+  echo -e  "Syntax: ${GREEN}create-git ${YELLOW}[OPTIONS]${NC}"
+  echo
+  echo "Example usage: "
+  echo -e "${BLUE}$ ${NC}create-git -k /path/to/your/company/topsecret/private/key [-s|--source] [i.e. /home/{user}/repositories/create-git/src] [-t|--target] [i.e. /top/secret/path/to/encrypted/company/drive/bin/]"
+  echo
+  echo "OPTIONS:"
+  echo "   -k, --key             Full absolute path to SSH Key file (i.e. /home/{user}/.ssh/id_rsa)"
+  echo "   [-h, --help, -?]      Print this help"
+  echo "   [-s, --source]        Path to source directory"
+  echo "   [-t, --target]        Target source to create git executable file"
+  echo
+}
+
+no_args="true"
+while [[ $# -gt 0 ]]; do
+  option="$1"
+
+  case $option in
+    -k|--key)
+      key="$2"
+      shift # past argument
+      shift # past value
+      ;;
+    -s|--source)
+      source="$2"
+      shift # past argument
+      shift # past value
+      ;;
+    -t|--target)
+      target="$2"
+      shift # past argument
+      shift # past value
+      ;;
+    -h|--help|-?)
+      help
+      shift # past argument
+      shift # past value
+      ;;
+    *)
+      # shellcheck disable=SC2059
+      printf "${RED}Unknown option passed:${NC} ${YELLOW}$1${NC}\n\n"
+      help
+      exit
+      ;;
+  esac
+  no_args="false"
+done;
+
+if [[ "$no_args" == "true" ]]; then
+  echo -n 'Enter source to private key SSH: '
+  read -r key
+fi
+
+cp "$source/git.sh" git.sh.tmp
+sed -i -e "s|\$SSH_KEY|$key|g" git.sh.tmp
+shc -f git.sh.tmp
+mv git.sh.tmp.x "$target/git"
+rm git.sh.tmp*

doc/pycharm.png

@@ -0,0 +1,3 @@
+#!/bin/bash
+args="${@}"
+ssh-agent bash -c "ssh-add $SSH_KEY; git $args"