git-sample-repo-create.ps1

# git-sample-repo-create.ps1 from within http://github.com/wilsonmar/git-utilities.
# by Wilson Mar (wilsonmar@gmail.com, @wilsonmar)

# This script was created for experiementing and learning Git.
# Git commands in this script are meant as examples for manual entry
# explained during my live "Git and GitHub" tutorials and
# explained at https://wilsonmar.github.io/git-commands-and-statuses/).
# Most of the regularly used Git commands are covered here.

# This script creates and populates a sample repo which is then 
# uploaded to a new repo created using GitHub API calls

# This script is designed to be "idempotent" in that repeat runs
# begin by deleting what was created: the local repo and repo in GitHub.

# Sample call in Win10 running within MacOS:
# Set-ExecutionPolicy Unrestricted
# ./git-sample-repo-create.ps1

# Last tested on MacOS 10.12 (Sierra) 2017-01-12
# http://skimfeed.com/blog/windows-command-prompt-ls-equivalent-dir/

#################################

# Create blank lines in the log to differentiate different runs:
        echo ""
        echo ""
        echo ""
        echo ""
        echo ""
   # Make the beginning of run easy to find:
        echo "**********************************************************"
$NOW = Get-Date -Format "yyyy-MM-ddTHH:mmzzz"
        echo "******** NOW=$NOW $PSUICULTURE PID=$PID :"
             # $PSUICULTURE & $PID are built-in variables.
    $PSHOME # built-in varialbe # $psversiontable
        echo "******** IsWindows=$IsWindows IsOSX=$IsOSX IsLinux=$IsLinux"
    #[System.Environment]::OSVersion.Version
        echo "******** PSSCRIPTROOT= $PSSCRIPTROOT"
    git --version

# exit #1

    # Make the beginning of run easy to find: TODO: Parameterize:
    $REPONAME='git-sample-repo'


        echo "******** STEP Delete $REPONAME remnant from previous run:"
    $FileExists = Test-Path $REPONAME
if ($FileExists -eq $True ){
   # See https://technet.microsoft.com/en-ca/library/hh849765.aspx?f=255&MSPPError=-2147217396
   Remove-Item -path ${REPONAME} -Recurse -Force # instead of rm -rf ${REPONAME}
}
#  exit #2

New-item ${REPONAME} -ItemType "directory" >$null  # instead of mkdir ${REPONAME}
   # >$null suporesses several lines being printing out by PS to confirm.
cd ${REPONAME}
        echo "******** $CURRENTDIR pwd "
    pwd | foreach { $_.Name }

#  exit #3

    #$CURRENTDIR = (Get-Item -Path ".\" -Verbose).FullName   # Get-Location cmdlet
    $CURRENTDIR = $PSScriptRoot    # PowerShell specific
        echo "CURRENTDIR=$CURRENTDIR"

        echo "******** STEP Init repo :"
git init  # init without --bare so we get a working directory:
    #    echo "******** git rev-parse --git-dir (return the .git path of the current project:"
    #git rev-parse --git-dir

        echo "******** remove hooks/*.sample files :"
    del .git/hooks/*.sample
        # No files yet for Get-ChildItem -Recurse | ?{ $_.PSIsContainer }
        echo "******** tree .git  (blank repo)"
    tree .git

#  exit #4 the file structure of an empty repo.

        echo "******** STEP Make develop the default branch instead of master :"
    # The contents of HEAD is stored in this file:
    cat .git/HEAD
    # Change from default "ref: refs/heads/master" :
    # See http://www.kernel.org/pub/software/scm/git/docs/git-symbolic-ref.html
        echo "******** git symbolic-ref HEAD ... :"
    git symbolic-ref HEAD refs/heads/develop
        echo "******** cat .git/HEAD :"
    cat .git/HEAD
        echo "******** git branch :"
    git branch

$DEFAULT_BRANCH="develop"
        echo "DEFAULT_BRANCH=$DEFAULT_BRANCH"

#  exit #5

        echo "******** STEP Attribution & Config (not --global):"
# See https://git-scm.com/docs/pretty-formats :
git config user.email "wilsonmar@gmail.com"
git config user.name "Wilson Mar" # Username (not email) in GitHub.com cloud.
$GITHUB_USER="wilsonmar"
        echo "******** GITHUB_USER=$GITHUB_USER "


        echo "******** Run PowerShell file for Git configurations at the repo level:"
        # PS TRICK: Get parent folder path using the $MyInvocation built-in PS variable:
        # See http://stackoverflow.com/questions/7377981/how-do-i-call-another-powershell-script-with-a-relative-path
        $ScriptPath = Split-Path -Parent $MyInvocation.InvocationName 
        $UtilPath  = Join-Path -Path $ScriptPath -ChildPath ..\
        #Write-Host "Path:" $UtilPath 
        # NOTE: PowerShell accepts both forward and backward slashes:
    & "$UtilPath/git-client-config.ps1"
        # Alternately, use & to run scripts in same scope: 
        # & "../git_client-config.ps1 global" #
        # Alternately, use . to run scripts in child scope that will be thrown away: 
        # . "../git_client-config.ps1 global" #
        #echo "******** Present Working Directory :"
    #pwd
    # git config --list   # Dump config file

#  exit #6

# WORKFLOW: After gpg is installed, find:
    # gpg --gen-key
git config user.signingkey 2E23C648  # not --global
    gpg --list-keys

# exit #7


        echo "******** STEP commit (initial) README :"
        echo "hello" > README.md  # no touch command on Windows.
git add . -A
git commit -m "README.md"
     # In "create mode 100644", first three is about the file type 
     # "644" (last three numbers) is the file permissions 
git l -1

exit #8  # after first commit.
    

        echo "******** STEP amend commit README : "
# ammend last commit with all uncommitted and un-staged changes:
        echo "color">>README.md
git ca  # use this alias instead of git commit -a --amend -C HEAD
git l -1

# exit #9

        echo "******** STEP amend commit 2 : "
# ammend last commit with all uncommitted and un-staged changes:
        echo "still more">>README.md
git ca  # alias for git commit -a --amend -C HEAD
git l -1
git diff

# exit #10

        echo "******** STEP commit .DS_Store in .gitignore :"
        echo ".DS_Store">>.gitignore
git add .
git commit -m "Add .gitignore"
git l -1

# exit #11

        echo "******** STEP commit --amend .secrets in .gitignore :"
        echo "secrets/">>.gitignore
        echo ".secrets">>.gitignore
        echo "*.log">>.gitignore
git add .
git ca  # use this alias instead of git commit -a --amend -C HEAD
git l -1

# exit #12

git reflog
dir | format-table # Get-ChildItem  # ps for ls -al

cat README.md

        echo "******** STEP lightweight tag :"
git tag "v1"  # lightweight tag

# exit #13

        echo "******** STEP checkout HEAD to create feature1 branch : --------------------------"
git checkout HEAD -b feature1
# git branch
ls .git/refs/heads/
git l -1

# exit #14

       echo "******** STEP commit .secrets : "
       echo "shessh!">>.secrets
git add .
git commit -m "Add .secrets"
git l -1
dir | format-table 

# exit #15

        echo "******** STEP commit: empty-folder"
mkdir empty-folder

        echo "******** STEP commit: d"
        echo "free!">>LICENSE.md
        echo "d">>file-d.txt
git add .
git commit -m "Add d in feature1"
git l -1
dir | format-table 

# exit #16


        echo "******** STEP Merge feature1 :"
# Instead of git checkout $DEFAULT_BRANCH :
# git checkout @{-1}  # doesn't work in PowerShell.
git checkout $DEFAULT_BRANCH
   # response is "Switched to branch 'develop"

    # Alternately, use git-m.sh to merge and delete in one step.
# git merge --no-ff (no fast forward) for "true merge":
#git merge feature1 --no-ff --no-commit  # to see what may happen
git merge feature1 -m "merge feature1" --no-ff  # --verify-signatures 
# resolve conflicts here?
git add .
# git commit -m "commit merge feature1"
git branch
git l -1

# exit #17

        echo "******** STEP Remove merged branch ref :"
git branch -D feature1
git branch
git l -1

# exit #18

        echo "******** $NOW What's dangling? "
git fsck --dangling --no-progress

        echo "******** STEP commit: e"
        echo "e money">>file-e.txt
git add .
git commit -m "Add e"
git l -1

# exit #19

        echo "******** STEP commit f : "
        echo "f money">>file-f.txt
dir | format-table 
git add .
git commit -m "Add f"
git l -1

# exit #20

        echo "******** STEP heavyeight tag (a commit) :"
#  git tag -a v0.0.1 -m"v1 unsigned"
   git tag -a v0.0.1 -m"v1 signed" -s  # signed "heavyweight" tag
   # For numbering, see http://semver.org/
#         echo "******** STEP tag verify :"
# git tag -v v1  # calls verify-tag.
git verify-tag v0.0.1

 exit #21

#         echo "******** STEP tag show :"
# git show v1  # Press q to exit scroll.


        echo "Copy this and paste to a text edit for reference: --------------"
git l
        echo "******** show HEAD : ---------------------------------------"
git w HEAD
        echo "******** show HEAD~1 :"
git w HEAD~1
        echo "******** show HEAD~2 :"
git w HEAD~2
        echo "******** show HEAD~3 :"
git w HEAD~3
        echo "******** show HEAD~4 :"
git w HEAD~4

        echo "******** show HEAD^ :"
git w HEAD^
        echo "******** show HEAD^^ :"
git w HEAD^^
        echo "******** show HEAD^^^ :"
git w HEAD^^^
        echo "******** show HEAD^^^^ :"
git w HEAD^^^^

        echo "******** show HEAD^1 :"
git w HEAD^1
        echo "******** show HEAD^2 :"
git w HEAD^2

        echo "******** show HEAD~1^1 :"
git w HEAD~1^1
        echo "******** show HEAD~2^1 :"
git w HEAD~2^1
        echo "******** show HEAD~3^1 :"
git w HEAD~3^1

        echo "******** show HEAD~1^2 :"
git w HEAD~1^2

        echo "******** show HEAD~2^2 :"
git w HEAD~2^2
        echo "******** show HEAD~2^3 :"
git w HEAD~2^3
dir | format-table 

        echo "******** Reflog: ---------------------------------------"
git reflog

 exit #22


        echo "******** show HEAD@{5} :"
# FIX: git w HEAD@{5}

        echo "******** Create archive file, excluding .git directory :"
$NOW = Get-Date -Format "yyyy-MM-ddTHH:mmzzz"
# WARNING: The DateTime string format returned by Get-Date contains characters that can't be used for file names. Try something like this:
# new-item -path .\desktop\testfolder -name "$NOW.txt" `
#        -value (get-date).toString() -itemtype file
$FILENAME="$REPONAME_$NOW.zip"
#NOW=$(date +%Y-%m-%d:%H:%M:%S)
#FILENAME=$(        echo ${REPONAME}_${NOW}.zip)
   # See https://gallery.technet.microsoft.com/scriptcenter/Get-TimeZone-PowerShell-4f1a34e6

        echo "FILENAME=$FILENAME"

# Commented out to avoid creating a file from each run:
# git archive --format zip --output ../$FILENAME  feature1
# ls -l ../$FILENAME


        echo "******** STEP checkout c :"
Get-ChildItem  # ls -al
git show HEAD@{5}
git checkout HEAD@{5}
Get-ChildItem

        echo "******** Go back to HEAD --hard :"
git reset --hard HEAD
# git checkout HEAD
Get-ChildItem

        echo "******** Garbage Collect (gc) what Git can't reach :"
git gc
git reflog
Get-ChildItem
        echo "******** Compare against previous reflog."

# exit #11


# See https://gist.github.com/caspyin/2288960 about GitHub API
# From https://gist.github.com/robwierzbowski/5430952 on Windows
# From https://gist.github.com/jerrykrinock/6618003 on Mac

        echo "****** GITHUB_USER=$GITHUB_USER, CURRENTDIR=$CURRENTDIR, REPONAME=$REPONAME"
        echo "****** DESCRIPTION=$DESCRIPTION"

# Invoke file defined manually containing definition of GITHUB_PASSWORD:
# Dot is cross-platform whereas source command is only for Bash:
   $RSA_PUBLIC_KEY = Get-Content "$home/.ssh/id_rsa.pub"
   #         echo "RSA_PUBLIC_KEY=$RSA_PUBLIC_KEY"
      # Bash command to load contents of file into env. variable:
#   export RSA_PUBLIC_KEY=$(cat ~/.ssh/id_rsa.pub)
   #         echo "RSA_PUBLIC_KEY=$RSA_PUBLIC_KEY"

   # Ignore SSL errors:
   # http://connect.microsoft.com/PowerShell/feedback/details/419466/new-webserviceproxy-needs-force-parameter-to-ignore-ssl-errors
   $SECRETS = Get-Content "$home/.secrets" | ConvertFrom-StringData
   # Please don't         echo $SECRETS.GITHUB_TOKEN.Substring(0,8)
   # err:         echo "SECRETS.TWITTER_TOKEN=${SECRETS.TWITTER_TOKEN}"


[System.Net.ServicePointManager]::CertificatePolicy = New-Object TrustAllCertsPolicy

#Install from the PowerShell Gallery (requires PowerShell 5.0+)
#Copy-install the module to your $env:PSModulePath
#Extract the module anywhere on the filesystem, and import it explicitly, using Import-Module
#   Import-module "../MyTwitter.psm1"
#   Send-Tweet -Message '@adbertram Thanks for the Powershell Twitter module'
#   $body = @{
#    Name = "So long and thanks for all the fish"
#   }

# exit #31

# $GITHUB_TOKEN is not defined before this point so code can test if
# one needs to be created:
If ("$GITHUB_TOKEN" -eq "") {
          echo "******** Creating Auth GITHUB_TOKEN to delete repo later : "
   # Based on http://douglastarr.com/using-powershell-3-invoke-restmethod-with-basic-authentication-and-json

   $secpasswd = ConvertTo-SecureString $GITHUB_USER -AsPlainText -Force
   $cred = New-Object System.Management.Automation.PSCredential ($SECRETS.GITHUB_PASSWORD, $secpasswd)
      # CAUTION: which sends passwords through the internet here.
      # You may instead manually obtain a token on GitHub.com.

  #$Body_JSON = '{"scopes":["delete_repo"],"note":"token with delete repo scope"}'
   $BODY_JSON = "{""scopes"":[""delete_repo""], ""note"":""token with delete repo scope""}"
               echo "Body_JSON=$Body_JSON"  # DEBUGGING

   $response = Invoke-RestMethod -Method Post `
     -Credential $cred `
     -Body $Body_JSON `
     -Uri "https://api.github.com/authorizations"
   $GITHUB_TOKEN = $response.Stuffs | where { $_.Name -eq "token" }
       # Do not display token secret!
       # API Token (32 character long string) is unique among all GitHub users.
       # Response: X-OAuth-Scopes: user, public_repo, repo, gist, delete_repo scope.
       # See https://developer.github.com/v3/oauth_authorizations/#create-a-new-authorization

   # WORKFLOW: Manually see API Tokens on GitHub | Account Settings | Administrative Information 
} Else {
           echo "******** Verifying Auth GITHUB_TOKEN to delete repo later : "

   $Headers = @{
      Authorization = 'Basic ' + ${GITHUB_TOKEN}
      };
      # -f is for substitution of (0).
      # See https://technet.microsoft.com/en-us/library/ee692795.aspx
      # Write-Host ("Headers="+$Headers.Authorization)

   $response = Invoke-RestMethod -Method Get `
    -Headers $Headers `
    -ContentType 'application/json' `
    -Uri https://api.github.com

   # Expect HTTP 404 Not Found if valid to avoid disclosing valid data with 401 response as RFC 2617 defines.
    $GITHUB_AVAIL = $response.Stuffs | where { $_.Name -eq "authorizations_url" }
           echo "******** authorizations_url=$GITHUB_AVAIL.Substring(0,8)"  # DEBUGGING
}

            echo "******** Checking GITHUB repo exists (_AVAIL) from prior run: "
   $response = Invoke-WebMethod -Method Put `
    -Headers $Headers `
    -ContentType 'application/json' `
    -Uri https://api.github.com/repos/${GITHUB_USER}/${REPONAME}
    $GITHUB_AVAIL = $response.Stuffs | where { $_.Name -eq "full_name" }
           echo "******** authorizations_url=$GITHUB_AVAIL"  # DEBUGGING

# exit #41

# 15:49 into https://channel9.msdn.com/Blogs/trevor-powershell/Automating-the-GitHub-REST-API-Using-PowerShell
# https://developer.github.com/v3/users/
# https://github.com/pcgeek86/PSGitHub