# Install ugit from the PowerShell Gallery
Install-Module ugit -Scope CurrentUser
# Then import it.
Import-Module ugit -Force -PassThru

# Once you've imported ugit, just run git commands normally.
# If ugit has an extension for the command, it will output as an object.
# These objects can be formatted by PowerShell
git log -n 5 

# To get a sense of what you can do, pipe a given git command into Get-Member.
git log -n 5 |
  Get-Member

    git blame ugit.psd1

    git branch -Remote

    git branch  # Get a list of branches

    git branch |                                          # Get all branches
        Where-Object -Not IsCurrentBranch |               # where it is not the current branch
        Where-Object BranchName -NotIn 'main', 'master' | # and the name is not either main or master
        git branch -d                                     # then attempt to delete the branch.

    git checkout -b CreateNewBranch

    git checkout main

    git clone https://github.com/MDN/content.git # This is a big repo.  Progress bars will be very welcome.

    # If we don't check things out, cloning is faster.
    git clone https://github.com/PowerShell/PowerShell -NoCheckout 
    # (of course, that's because we're not copying files, just history)

    # We can also clone more quickly by only picking a certain number of commits
    git clone https://github.com/Microsoft/vscode.git -Depth 1
    # (of course, this will make the history lie to you,
    # by saying everything was changed whenever anything was changed)

    git clone https://github.com/StartAutomating/ugit.git

    # Clone a large repo.
    # When --progress is provided, Write-Progress will be called.
    git clone https://github.com/Azure/azure-quickstart-templates --progress

    git commit -Title "Fixing Something"

    git commit -Title "Changing Stuff" -Trailers @{"Co-Authored-By"="SOMEONE ELSE <[email protected]>"}

    git commit -m "Updating #123"

    $committedMessage = git commit -m "Committting Stuff" # Whoops, this commit had a typo
    $commitMessage.Amend("Committing stuff") # that's better

    git config --list

    git config --global --list

    git config --list --local

    git config --list --show-origin

    git diff --name-only

    git archive -o My.zip

    git branch --format "{'ref':'%(refname:short)','parent':'%(parent)'}"

    git branch --format "%(refname:short)|%(objectname)|%(parent)|%(committerdate:iso8601)|%(objecttype)"

    git grep '-i' example # look for all examples in the repository

    git help -a

    git help --all

    git init # Initialize the current directory as a repository

    git log -CurrentBranch

    # Get all logs
    git log |
        # until the first merged pull request
        Where-Object -Not Merged

    # Get a single log entry
    git log -n 1 |
        # and see what the log object can do.
        Get-Member

    # Get all logs
    git log |
        # Group them by the author
        Group-Object GitUserEmail -NoElement |
        # sort them by count
        Sort-Object Count -Descending

    # Get all logs
    git log |
        # Group them by day of week
        Group-Object { $_.CommitDate.DayOfWeek } -NoElement

    # Get all logs
    git log |
        # where there is a pull request number
        Where-Object PullRequestNumber |
        # pick out the PullRequestNumber and CommitDate
        Select PullRequestNumber, CommitDate

    git log --merges

    git mv .\OldName.txt .\NewName.txt

    git mv .\OldName.txt .\NewName.txt --verbose

    git pull

    git push

    git reflog

    git remote

    git remote | git remote get-url

    git remote | git remote show

    git rm .\FileIDontCareAbout.txt

    git shortlog  # Get a shortlog

    git shortlog --email # Get a shortlog with email information

    git shortlog --summary # Get a shortlog summary

    git shortlog --sumary --email # Get a shortlog summary, with email.

    git sparse-checkout -FileFilters *.ps1,*.psm1

    git stash list

    git status

    git status | Select-Object -ExpandProperty Untracked

    git submodule