Difference between revisions of "Git/hacks"

From Freephile Wiki
< Git
Jump to navigation Jump to search
(hack about file modes)
 
(18 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== Ignore File Mode ==
+
==Search==
 +
<code>git grep</code> only works on the current content of your working copy. To search through all revisions, you can use something like
 +
<source lang="bash">
 +
# -F is --fixed-strings
 +
# Interpret PATTERN as a list of fixed strings (instead of regular expressions), separated by newlines, any of which is to be matched.
 +
git rev-list --all | ( while read revision; do git grep -F 'wgAWSCredentials' $revision; done; )
 +
</source>
 +
 
 +
==Ignore File Mode==
 
Sometimes you have to temporarily change file modes (or some script might alter your working directory).  Anyway, to ignore file mode changes temporarily, you can just add <code>-c core.fileMode=false</code> to your command. E.g.:
 
Sometimes you have to temporarily change file modes (or some script might alter your working directory).  Anyway, to ignore file mode changes temporarily, you can just add <code>-c core.fileMode=false</code> to your command. E.g.:
 
<source lang="bash">
 
<source lang="bash">
Line 12: Line 20:
 
</source>
 
</source>
  
== Working on a remote terminal ==
+
==Working on a remote terminal==
  
 
If you're working on a remote terminal  and your repository get's complicated, but you don't have desktop tools like [[meld]] or [[gitk]] to look at it, you can copy the remote repo to your desktop with <code>rsync</code>, even if you have to jump through a bastion host with something like:
 
If you're working on a remote terminal  and your repository get's complicated, but you don't have desktop tools like [[meld]] or [[gitk]] to look at it, you can copy the remote repo to your desktop with <code>rsync</code>, even if you have to jump through a bastion host with something like:
Line 20: Line 28:
 
If that complains about host-key verification, then simply do an SSH first to the host, accept the host key identity, and logout.  Now the rsync will work because the host-key is already accepted as valid.
 
If that complains about host-key verification, then simply do an SSH first to the host, accept the host key identity, and logout.  Now the rsync will work because the host-key is already accepted as valid.
  
== Tracking remote branches ==
+
==Tracking remote branches==
  
 
Checkout a specific branch from origin, and track it.
 
Checkout a specific branch from origin, and track it.
What if you enter <code>git checkout -b REL1_29</code> when you *should have entered* <code>git checkout -b REL1_29 origin/REL1_29</code>? Just tell git that you meant to track the branch in origin: <code>git branch --set-upstream-to=origin/REL1_29 REL1_29</code>
+
What if you enter <code>git checkout -b REL1_29</code> when you *should have entered* <code>git checkout -b REL1_29 origin/REL1_29</code>? J<s>ust tell git that you meant to track the branch in origin: <code>git branch --set-upstream-to=origin/REL1_29 REL1_29</code></s>  Set upstream doesn't do what's intended here! You should delete the branch that you created as a 'copy'; and then checkout the branch correctly.  To checkout the branch correctly, just IGNORE the <code>-b</code> flag altogether.  If you ''do'' use the <code>-b</code> flag, then you ''must'' use the long form that references the remote branch to track.  If you just do a '<code>git checkout foo</code>' and there exists the same branch upstream at <code>origin/foo</code> then git will checkout a new branch set to track the remote.
  
== Tracing in Status ==
+
==Tracing in Status==
  
 
Add <code>GIT_TRACE=1</code> to your command to see more of what's going on. (Note that there are no spaces and no semicolon.)
 
Add <code>GIT_TRACE=1</code> to your command to see more of what's going on. (Note that there are no spaces and no semicolon.)
Line 32: Line 40:
 
</source>
 
</source>
  
== Just the facts ==
+
==Just the facts==
  
 
Want simple red/green diff lines?
 
Want simple red/green diff lines?
Line 42: Line 50:
 
</source>
 
</source>
  
== What is this miscellaneous file, and how does it compare to what's in my repo? ==
+
==What is this miscellaneous file, and how does it compare to what's in my repo?==
 +
 
 
Say you've got a config file lying around (untracked) in your local working tree.  It's not in your current project branch, but you know it's an important file.  How does it compare to what's in the '''freephile''' remote, '''es128''' branch version of the file?
 
Say you've got a config file lying around (untracked) in your local working tree.  It's not in your current project branch, but you know it's an important file.  How does it compare to what's in the '''freephile''' remote, '''es128''' branch version of the file?
 
<source lang="bash">
 
<source lang="bash">
Line 48: Line 57:
 
</source>
 
</source>
  
== Add that forgotten file ==
+
==How has this file changed over time?==
 +
 
 +
While you can use gitk on your desktop, if you're on a headless server, you can ask <code>git log</code> to show you the '''patch''' for each commit: <code>git log -p path/to/file</code>
 +
 
 +
==Compare a file between branches==
 +
 
 +
Do you think a particular file has changed between two separate feature branches (ea based off master)?
 +
<source lang="bash">
 +
# git diff branch1..branch2 -- path/to/file
 +
git diff es128-rebased..get-to-know-meza -- manual/commands.md
 +
</source>
 +
 
 +
==Add that forgotten file==
  
 
You forgot to add a file to the last commit?  Just add it to the index, and commit with <code>--amend</code>.  Added a file that shouldn't be there? <code>git rm</code> it.  If you leave off the -m (message) option in the new commit, it will let you re-use the last commit message.  This lets you "undo the last commit" and redo it right.  You usually do not want to amend a commit if you've already pushed it to other repos, but if it's just local <code>--amend</code> is awesome-sauce.
 
You forgot to add a file to the last commit?  Just add it to the index, and commit with <code>--amend</code>.  Added a file that shouldn't be there? <code>git rm</code> it.  If you leave off the -m (message) option in the new commit, it will let you re-use the last commit message.  This lets you "undo the last commit" and redo it right.  You usually do not want to amend a commit if you've already pushed it to other repos, but if it's just local <code>--amend</code> is awesome-sauce.
Line 58: Line 79:
 
</source>
 
</source>
  
== Git Branch ==
+
==Undo a commit==
* list the branches you have locally <code>git branch --list</code>
+
 
* list the branches that are on remotes <code>git branch -r --list</code>
+
Sometimes a commit is just wrong or 'breaks the build' so to speak. If you really just want to '''undo''' a commit, then
* checkout a remote branch, setting the local one to track <code>git checkout -t freephile/patch-1</code>
+
<source lang="bash">
 +
# view what changes were made in the last commit
 +
git difftool HEAD~
 +
# reset --soft will undo the last commit, but leave the changes locally as 'modified' files that you can re-work or commit.
 +
git reset --soft HEAD~
 +
# reset --hard will undo the last commit, and discard any changes that were made in the commit. Your work tree will be identical to the way it was after the prior commit.
 +
git reset --hard HEAD~
 +
</source>
 +
 
 +
Using <code>reset</code> you can even go backwards several commits if you want. 
 +
 
 +
The entire internet tells you not to <code>reset</code> if you've already pushed. But if you're just pushing (from machine A: your desktop) to a remote (machine B: eg. GitHub) so that you can then pull those changes into another space (machine C: development/staging/production/other machine) you can push your changes with <code>--force</code>; and pull them from that other environment.  It may be quicker and easier though to identify the SHA of the n-1 commit and then <code>reset</code> on machine C
 +
<source lang="bash">
 +
git log -n 4
 +
# find the commit SHA, and use it on machine C
 +
git reset --hard d89c004cfe4bd67838fb41c7a6644bb15feee5cc
 +
</source>
 +
 
 +
Credit: there's a clear explanation at https://www.git-tower.com/learn/git/faq/undo-last-commit
 +
 
 +
==Good and Consistent commit messages==
 +
You hopefully know what constitutes a [https://cbea.ms/git-commit/ good] [https://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html commit message]. What about consistency? Say you need to add standard language to every commit message like
 +
<tt>"This work  was performed for NASA GRC-ATF by WikiWorks per NASA Contract  NNC15BA02B."</tt>
 +
 
 +
To consistently format your commit messages, use the configuration parameter <code>commit.template</code> which you can do with <code>git config</code>, or else in your ~/.gitconfig file. Here's my [[Git/commit.template|commit.template]]
 +
 
 +
https://thoughtbot.com/blog/5-useful-tips-for-a-better-commit-message
 +
 
 +
The GitLab project uses the concept of commit templates<ref>https://docs.gitlab.com/ee/user/project/merge_requests/commit_templates.html</ref>
 +
 
 +
 
 +
==Git Branch==
 +
 
 +
*list the branches you have locally <code>git branch --list</code>
 +
*list the branches that are on remotes <code>git branch -r --list</code>
 +
*checkout a remote branch, setting the local one to track <code>git checkout -t freephile/patch-1</code>
 +
*git branch --merged (while on master) shows you branches which are fully contained in HEAD, and can be deleted.
 +
 
 +
 
 +
==Comparing local to upstream==
 +
 
 +
If you do a <code>git status</code> and it tells you that your (local) branch is behind the remote tracking branch, then maybe you want to look at what those changes are.
 +
<pre>
 +
# On branch master
 +
# Your branch is behind 'freephile/master' by 6 commits, and can be fast-forwarded.
 +
#  (use "git pull" to update your local branch)
 +
</pre>
 +
Tell git to fetch the branch named 'master' from the remote named 'origin'.  Git fetch will not affect the files in your working directory; it does not try to merge changes like <code>git pull</code> does.<br />
 +
<code>git fetch origin master</code>
 +
 
 +
When the remote branch is fetched, it can be referenced locally via FETCH_HEAD. Tell git to diff the working directory files against the FETCHed branch's HEAD and report the results in summary format.<br />
 +
<code>git diff --summary FETCH_HEAD</code>
 +
 
 +
If you want to see changes to a specific file, for example myfile.js, skip the --summary option and reference the file you want (or tree). Note: paths (or pathspecs) should be separated from command options with a double dash (<code>--</code>)<br />
 +
<code>git diff FETCH_HEAD -- mydir/myfile.js</code>
 +
 
 +
==Comparing Branches==
 +
 
 +
What's in this old branch, not in my new branch (ignoring merges)?
 +
 
 +
*git log oldbranch ^newbranch --no-merges
 +
*git log master..feature (everything on the feature branch that is not in master)
 +
*git log HEAD..freephile/master (everything in the remote 'freephile/master' that's not in HEAD locally)
 +
*git log origin/master..HEAD (everything in the local branch that you would push)
 +
*git log --left-right master...experiment (triple dot shows everything since the common ancestor) <ref>https://git-scm.com/book/en/v2/Git-Tools-Revision-Selection#Commit-Ranges</ref>
 +
 
 +
<br />
 +
 
 +
==How did I get here?==
 +
What branch did this branch originate from?  Or more precisely, what's the nearest ancestor commit on a separate branch?<syntaxhighlight lang="bash" line="1">
 +
branch=`git rev-parse --abbrev-ref HEAD` \
 +
git show-branch -a 2>/dev/null \
 +
| grep '\*' \
 +
| grep -v "$branch" \
 +
| head -n1 \
 +
| sed 's/.*\[\(.*\)\].*/\1/' \
 +
| sed 's/[\^~].*//'
 +
</syntaxhighlight>Explanation:
 +
 
 +
#Grab the name of the current branch.
 +
#Show all commits (with errors or warnings going to dev null).
 +
#Ancestors of the current commit are indicated by a star. Filter out everything else.
 +
#Ignore all the commits in the current branch.
 +
#The first commit remaining is the nearest ancestor from another branch.
 +
#Branch names are displayed [in brackets]. Ignore the brackets and everything else.
 +
#Sometimes the branch name will include a ~2 or ^1 to indicate how many commits are between the referenced commit and the branch tip. We don't care. Ignore them.
 +
 
 +
<ref>https://stackoverflow.com/questions/3161204/how-to-find-the-nearest-parent-of-a-git-branch</ref>
 +
 
 +
==Don't merge, Rebase!==
  
== Don't merge, Rebase! ==
 
 
Get familiar with how to rebase your work each day http://www.bitsnbites.eu/a-tidy-linear-git-history/
 
Get familiar with how to rebase your work each day http://www.bitsnbites.eu/a-tidy-linear-git-history/
  
== Delete local and remote merged branches ==
+
If you forget to pull before you commit some local changes, you might just be able to `git rebase` to pull and re-play your changes on top of the branch.
 +
 
 +
==Delete local and remote merged branches==
 +
 
 
<source lang="bash">
 
<source lang="bash">
 
git branch --merged | egrep -v "(^\*|master|dev)" | xargs -I % echo 'git branch -d % ; git push --delete freephile % ;'
 
git branch --merged | egrep -v "(^\*|master|dev)" | xargs -I % echo 'git branch -d % ; git push --delete freephile % ;'
Line 72: Line 184:
 
Using '''echo''' helps you look before you leap. '''%''' is the replacement string in <code>xargs</code>. Change '<code>echo</code>' to '<code>sh -c</code>' to execute. Does both local and remote prunes.
 
Using '''echo''' helps you look before you leap. '''%''' is the replacement string in <code>xargs</code>. Change '<code>echo</code>' to '<code>sh -c</code>' to execute. Does both local and remote prunes.
  
== Git Log ==
+
==Git Log==
 +
 
 
What's the commit history?  The [https://git-scm.com/docs/git-log man page for git log] is so big, it's a forest.  There are examples in the book for [https://git-scm.com/book/en/v2/Git-Basics-Viewing-the-Commit-History viewing commit history].  For a quick cheatsheet, try these.
 
What's the commit history?  The [https://git-scm.com/docs/git-log man page for git log] is so big, it's a forest.  There are examples in the book for [https://git-scm.com/book/en/v2/Git-Basics-Viewing-the-Commit-History viewing commit history].  For a quick cheatsheet, try these.
  
Line 117: Line 230:
 
</source>
 
</source>
  
== Tags ==
+
==Tags==
 +
 
 
With git, you can just tag something with <code>git tag foo</code>.  This produces a 'lightweight' tag <ref>[https://stackoverflow.com/questions/21031201/how-can-i-list-all-lightweight-tags how can I list all the lightweight tags]</ref>.  Use "annotated tags" whenever you want to know '''when''' something was tagged and '''who''' did it.  Pass an empty message if you really don't care or need extra annotation.
 
With git, you can just tag something with <code>git tag foo</code>.  This produces a 'lightweight' tag <ref>[https://stackoverflow.com/questions/21031201/how-can-i-list-all-lightweight-tags how can I list all the lightweight tags]</ref>.  Use "annotated tags" whenever you want to know '''when''' something was tagged and '''who''' did it.  Pass an empty message if you really don't care or need extra annotation.
 
<source lang="bash">
 
<source lang="bash">
Line 124: Line 238:
  
  
== [https://stackoverflow.com/questions/12921125/git-merge-branch-of-another-remote Git merge branch of another remote] ==
+
==[https://stackoverflow.com/questions/12921125/git-merge-branch-of-another-remote Git merge branch of another remote]==
 +
 
 
When using git between a local repository and a single 'origin' remote, it's a simple process to work locally and push things back up to origin.  But, what if you have a separate remote repository... perhaps on GitHub, or a collaborator who has similar sources but not using your origin (so disconnected, and perhaps not even linked ancestrally like a fork).  How do you add that other remote to your project and then pull in the code "they" have on top of yours?  Here's an example of how we started with a repo from github and added a repo that we were developing privately. (The reality is that we were developing a repo privately; created a sibling version of the code at github; and then wanted to re-incorporate the changes of the github repo back into our private repo.)
 
When using git between a local repository and a single 'origin' remote, it's a simple process to work locally and push things back up to origin.  But, what if you have a separate remote repository... perhaps on GitHub, or a collaborator who has similar sources but not using your origin (so disconnected, and perhaps not even linked ancestrally like a fork).  How do you add that other remote to your project and then pull in the code "they" have on top of yours?  Here's an example of how we started with a repo from github and added a repo that we were developing privately. (The reality is that we were developing a repo privately; created a sibling version of the code at github; and then wanted to re-incorporate the changes of the github repo back into our private repo.)
 
<source lang="bash">
 
<source lang="bash">
Line 156: Line 271:
 
</source>
 
</source>
  
== Unbloat ==
+
==Unbloat==
 +
 
 
https://stackoverflow.com/questions/3797907/how-to-remove-unused-objects-from-a-git-repository
 
https://stackoverflow.com/questions/3797907/how-to-remove-unused-objects-from-a-git-repository
  
Line 165: Line 281:
 
</source>
 
</source>
  
== Put your project on GitHub ==
+
==Put your project on GitHub==
 +
 
 
Been hacking away on a project and now it's time to unveil it? Here are the quick and easy steps to get your local repo into your GitHub account.
 
Been hacking away on a project and now it's time to unveil it? Here are the quick and easy steps to get your local repo into your GitHub account.
 
<source lang="bash">
 
<source lang="bash">
Line 190: Line 307:
 
</source>
 
</source>
  
== Create a README from a webpage ==
+
==Create a README from a webpage==
  
 
Now create a fine README file using [[pandoc]] to convert your webpage to [[Markdown]]
 
Now create a fine README file using [[pandoc]] to convert your webpage to [[Markdown]]
Line 197: Line 314:
 
</source>
 
</source>
  
 +
==Remember your password==
 +
I know how to configure my user and email, but how do I tell git to remember my password for repos that I'm interacting with?
 +
The answer is credential helper
 +
 +
<br />
 +
 +
==Rewriting History==
 +
Developers need git as a way to track changes and collaborate on software. Release Engineers need git, and '''higher-level''' tools to manage entire repositories of code. Whether Developer or Release Engineer, sometimes you need a do over.
 +
 +
When [https://git-scm.com/book/en/v2/Git-Tools-Rewriting-History rewriting history in your git project], If an interactive git rebase using 'edit' or 'reword' doesn't suffice for your use-case, you are probably looking for a higher-level tool.
  
 +
To make subtle changes, or even large changes on a whole series of commits in a git repository, [https://github.com/newren/git-filter-repo/ <code>git filter-repo</code>](Python) is that tool. The git maintainers themselves do '''NOT''' recommend using <code>git filter-branch</code> - which is slow and painful and prone to problems.  Consult the '''Git Filter Repo''' [https://htmlpreview.github.io/?https://github.com/newren/git-filter-repo/blob/docs/html/git-filter-repo.html User Manual] for examples.
  
 
{{References}}
 
{{References}}
  
 
[[Category:Development]]
 
[[Category:Development]]
 +
[[Category:Version Control]]

Latest revision as of 02:34, 28 March 2024

Search[edit | edit source]

git grep only works on the current content of your working copy. To search through all revisions, you can use something like

# -F is --fixed-strings
# Interpret PATTERN as a list of fixed strings (instead of regular expressions), separated by newlines, any of which is to be matched.
git rev-list --all | ( while read revision; do git grep -F 'wgAWSCredentials' $revision; done; )

Ignore File Mode[edit | edit source]

Sometimes you have to temporarily change file modes (or some script might alter your working directory). Anyway, to ignore file mode changes temporarily, you can just add -c core.fileMode=false to your command. E.g.:

git -c core.fileMode=false status

You can also put this into a repo or global config, but you probably shouldn't.

If you need to change filemodes back to the way they were in the repo, you can do something like

git diff --summary | grep --color 'mode change 100755 => 100644' | cut -d' ' -f7 | xargs chmod +x
git diff --summary | grep --color 'mode change 100644 => 100755' | cut -d' ' -f7 | xargs chmod -x

Working on a remote terminal[edit | edit source]

If you're working on a remote terminal and your repository get's complicated, but you don't have desktop tools like meld or gitk to look at it, you can copy the remote repo to your desktop with rsync, even if you have to jump through a bastion host with something like:

rsync -e "ssh -t bastion ssh -A" -ravz centos@10.0.50.68:/opt/meza/ ./meza-es1/

If that complains about host-key verification, then simply do an SSH first to the host, accept the host key identity, and logout. Now the rsync will work because the host-key is already accepted as valid.

Tracking remote branches[edit | edit source]

Checkout a specific branch from origin, and track it. What if you enter git checkout -b REL1_29 when you *should have entered* git checkout -b REL1_29 origin/REL1_29? Just tell git that you meant to track the branch in origin: git branch --set-upstream-to=origin/REL1_29 REL1_29 Set upstream doesn't do what's intended here! You should delete the branch that you created as a 'copy'; and then checkout the branch correctly. To checkout the branch correctly, just IGNORE the -b flag altogether. If you do use the -b flag, then you must use the long form that references the remote branch to track. If you just do a 'git checkout foo' and there exists the same branch upstream at origin/foo then git will checkout a new branch set to track the remote.

Tracing in Status[edit | edit source]

Add GIT_TRACE=1 to your command to see more of what's going on. (Note that there are no spaces and no semicolon.)

GIT_TRACE=1 git status

Just the facts[edit | edit source]

Want simple red/green diff lines?

See all the changes in color, but without any context lines, and without the leading +/-/[space] This makes it easy to grab changes and stuff them in another file for example.

git diff -U0 --color myfile | sed -r "s/^([^-+ ]*)[-+ ]/\\1/"

What is this miscellaneous file, and how does it compare to what's in my repo?[edit | edit source]

Say you've got a config file lying around (untracked) in your local working tree. It's not in your current project branch, but you know it's an important file. How does it compare to what's in the freephile remote, es128 branch version of the file?

git diff freephile/es128:config/core/MezaLocalExtensions.yml config/core/MezaLocalExtensions.yml

How has this file changed over time?[edit | edit source]

While you can use gitk on your desktop, if you're on a headless server, you can ask git log to show you the patch for each commit: git log -p path/to/file

Compare a file between branches[edit | edit source]

Do you think a particular file has changed between two separate feature branches (ea based off master)?

# git diff branch1..branch2 -- path/to/file
git diff es128-rebased..get-to-know-meza -- manual/commands.md

Add that forgotten file[edit | edit source]

You forgot to add a file to the last commit? Just add it to the index, and commit with --amend. Added a file that shouldn't be there? git rm it. If you leave off the -m (message) option in the new commit, it will let you re-use the last commit message. This lets you "undo the last commit" and redo it right. You usually do not want to amend a commit if you've already pushed it to other repos, but if it's just local --amend is awesome-sauce.

git add forgotten.php
git rm oops.txt
git commit --amend
git log --stat

Undo a commit[edit | edit source]

Sometimes a commit is just wrong or 'breaks the build' so to speak. If you really just want to undo a commit, then

# view what changes were made in the last commit
git difftool HEAD~
# reset --soft will undo the last commit, but leave the changes locally as 'modified' files that you can re-work or commit.
git reset --soft HEAD~
# reset --hard will undo the last commit, and discard any changes that were made in the commit. Your work tree will be identical to the way it was after the prior commit.
git reset --hard HEAD~

Using reset you can even go backwards several commits if you want.

The entire internet tells you not to reset if you've already pushed. But if you're just pushing (from machine A: your desktop) to a remote (machine B: eg. GitHub) so that you can then pull those changes into another space (machine C: development/staging/production/other machine) you can push your changes with --force; and pull them from that other environment. It may be quicker and easier though to identify the SHA of the n-1 commit and then reset on machine C

git log -n 4
# find the commit SHA, and use it on machine C
git reset --hard d89c004cfe4bd67838fb41c7a6644bb15feee5cc

Credit: there's a clear explanation at https://www.git-tower.com/learn/git/faq/undo-last-commit

Good and Consistent commit messages[edit | edit source]

You hopefully know what constitutes a good commit message. What about consistency? Say you need to add standard language to every commit message like "This work was performed for NASA GRC-ATF by WikiWorks per NASA Contract NNC15BA02B."

To consistently format your commit messages, use the configuration parameter commit.template which you can do with git config, or else in your ~/.gitconfig file. Here's my commit.template

https://thoughtbot.com/blog/5-useful-tips-for-a-better-commit-message

The GitLab project uses the concept of commit templates[1]


Git Branch[edit | edit source]

  • list the branches you have locally git branch --list
  • list the branches that are on remotes git branch -r --list
  • checkout a remote branch, setting the local one to track git checkout -t freephile/patch-1
  • git branch --merged (while on master) shows you branches which are fully contained in HEAD, and can be deleted.


Comparing local to upstream[edit | edit source]

If you do a git status and it tells you that your (local) branch is behind the remote tracking branch, then maybe you want to look at what those changes are.

# On branch master
# Your branch is behind 'freephile/master' by 6 commits, and can be fast-forwarded.
#   (use "git pull" to update your local branch)

Tell git to fetch the branch named 'master' from the remote named 'origin'. Git fetch will not affect the files in your working directory; it does not try to merge changes like git pull does.
git fetch origin master

When the remote branch is fetched, it can be referenced locally via FETCH_HEAD. Tell git to diff the working directory files against the FETCHed branch's HEAD and report the results in summary format.
git diff --summary FETCH_HEAD

If you want to see changes to a specific file, for example myfile.js, skip the --summary option and reference the file you want (or tree). Note: paths (or pathspecs) should be separated from command options with a double dash (--)
git diff FETCH_HEAD -- mydir/myfile.js

Comparing Branches[edit | edit source]

What's in this old branch, not in my new branch (ignoring merges)?

  • git log oldbranch ^newbranch --no-merges
  • git log master..feature (everything on the feature branch that is not in master)
  • git log HEAD..freephile/master (everything in the remote 'freephile/master' that's not in HEAD locally)
  • git log origin/master..HEAD (everything in the local branch that you would push)
  • git log --left-right master...experiment (triple dot shows everything since the common ancestor) [2]


How did I get here?[edit | edit source]

What branch did this branch originate from? Or more precisely, what's the nearest ancestor commit on a separate branch?

1 branch=`git rev-parse --abbrev-ref HEAD` \
2 git show-branch -a 2>/dev/null \
3 | grep '\*' \
4 | grep -v "$branch" \
5 | head -n1 \
6 | sed 's/.*\[\(.*\)\].*/\1/' \
7 | sed 's/[\^~].*//'

Explanation:

  1. Grab the name of the current branch.
  2. Show all commits (with errors or warnings going to dev null).
  3. Ancestors of the current commit are indicated by a star. Filter out everything else.
  4. Ignore all the commits in the current branch.
  5. The first commit remaining is the nearest ancestor from another branch.
  6. Branch names are displayed [in brackets]. Ignore the brackets and everything else.
  7. Sometimes the branch name will include a ~2 or ^1 to indicate how many commits are between the referenced commit and the branch tip. We don't care. Ignore them.

[3]

Don't merge, Rebase![edit | edit source]

Get familiar with how to rebase your work each day http://www.bitsnbites.eu/a-tidy-linear-git-history/

If you forget to pull before you commit some local changes, you might just be able to `git rebase` to pull and re-play your changes on top of the branch.

Delete local and remote merged branches[edit | edit source]

git branch --merged | egrep -v "(^\*|master|dev)" | xargs -I % echo 'git branch -d % ; git push --delete freephile % ;'

Using echo helps you look before you leap. % is the replacement string in xargs. Change 'echo' to 'sh -c' to execute. Does both local and remote prunes.

Git Log[edit | edit source]

What's the commit history? The man page for git log is so big, it's a forest. There are examples in the book for viewing commit history. For a quick cheatsheet, try these.

--stat gives a nice view of what happened in the log.

git log --stat
# try these other git log variatiations
git log --patch
git log -2
git log -p -2 # - p is the same as --patch
git log --pretty
git log --pretty=oneline
git log --pretty=short
git log --pretty=full
git log --pretty=fuller
git log --graph
git log --pretty=oneline --graph
git log --name-only
git log --name-status
git log --abbrev-commit
git log -S<string> # find when the number of instances of the string are added or deleted
git log -G<regex> # same with POSIX extended regex
git log -- filename # look for commits that touch filename
git log -p -- filename
git log --since 'last week'
git log --since 2017-01-01

How do you ignore a directory, but make an exception? What if you already added certain directories to git but want to stop tracking them now (ie. "take them out of version control")? A combination of editting your .gitignore file and git rm --cached to the rescue. I had accidentally added and committed some files into git which should have been ignored because they are 3rd party files managed by Composer. I fixed my .gitignore to track only what I want while ignoring a parent directory:

/nbproject/*
# ignore everything in the 'vendor' directory
/vendor/*
# but don't ignore the 'eqt' directory
!/vendor/eqt/

Then you simply remove all files from git's index, and add them back (only now adding them back will look to .gitignore for the corrected rules)

git rm -r --cached .
git add .
git commit -m 'ignoring vendor/*'

Tags[edit | edit source]

With git, you can just tag something with git tag foo. This produces a 'lightweight' tag [4]. Use "annotated tags" whenever you want to know when something was tagged and who did it. Pass an empty message if you really don't care or need extra annotation.

git tag -am '' 'REL-1.0-alpha'


Git merge branch of another remote[edit | edit source]

When using git between a local repository and a single 'origin' remote, it's a simple process to work locally and push things back up to origin. But, what if you have a separate remote repository... perhaps on GitHub, or a collaborator who has similar sources but not using your origin (so disconnected, and perhaps not even linked ancestrally like a fork). How do you add that other remote to your project and then pull in the code "they" have on top of yours? Here's an example of how we started with a repo from github and added a repo that we were developing privately. (The reality is that we were developing a repo privately; created a sibling version of the code at github; and then wanted to re-incorporate the changes of the github repo back into our private repo.)

# start with one 'origin' remote
git clone https://github.com/freephile/qb.git
# add another remote that has similar code
git remote add private greg@eqt:/home/greg/src/ad.git
# check
git remote -v
# rename it for the host it came from
git remote rename private eqt
# pull our 'eqt' remote onto the master branch of the code we got from 'origin'
git pull eqt master
# But there are some unversioned files in the way (git complains)
# So, create a new 'dev' branch and stuff all the new things there (which we can either delete, or resume later)
git checkout -b dev
git add hosts package.json requirements.txt scripts/
git commit -m 'stashing some files into a dev branch'
git checkout master
# now we can merge again
git pull eqt master
# git complains about some merge conflicts (changes on both sides so it can't just do a fast-forward)
# edit those files to remove the conflict markers and get them the way you want them
git add install* launch.yml
# finish your merge by committing the result
git commit -m 'merged additional plays from eqt'
# and push upstream to 'origin'
git push
# and push to other remote 'eqt'
git push eqt

Unbloat[edit | edit source]

https://stackoverflow.com/questions/3797907/how-to-remove-unused-objects-from-a-git-repository

git -c gc.reflogExpire=0 -c gc.reflogExpireUnreachable=0 \
  -c gc.rerereresolved=0 -c gc.rerereunresolved=0 \
  -c gc.pruneExpire=now gc

Put your project on GitHub[edit | edit source]

Been hacking away on a project and now it's time to unveil it? Here are the quick and easy steps to get your local repo into your GitHub account.

# first make a "bare" clone
# from your server
git clone --bare greg@example.com:/var/www/baz.com/www/project
# or from a local directory
git clone --bare /tmp/project
# produces project.git directory
cd project.git
# push that to your new project (created via browser at GitHub.com)
git push --mirror https://github.com/USER/project.git
# go back to the original project folder
cd /tmp/project
# optionally remove local remotes that are no longer needed
git remote remove origin
# add GitHub as a remote named 'github' (assuming SSH key-based auth)
git remote add github git@github.com:USER/project.git
# pull in anything from 'upstream' (assuming that now GitHub is the canonical source)
git pull github master
# push any changes up; setting the new remote as the upstream for the 'master' branch
git push --set-upstream github master
# from now on you can just 'git push' from master

Create a README from a webpage[edit | edit source]

Now create a fine README file using pandoc to convert your webpage to Markdown

pandoc --standalone --read html https://freephile.org/barcode/index.html -o README.md

Remember your password[edit | edit source]

I know how to configure my user and email, but how do I tell git to remember my password for repos that I'm interacting with? The answer is credential helper


Rewriting History[edit | edit source]

Developers need git as a way to track changes and collaborate on software. Release Engineers need git, and higher-level tools to manage entire repositories of code. Whether Developer or Release Engineer, sometimes you need a do over.

When rewriting history in your git project, If an interactive git rebase using 'edit' or 'reword' doesn't suffice for your use-case, you are probably looking for a higher-level tool.

To make subtle changes, or even large changes on a whole series of commits in a git repository, git filter-repo(Python) is that tool. The git maintainers themselves do NOT recommend using git filter-branch - which is slow and painful and prone to problems. Consult the Git Filter Repo User Manual for examples.

References[edit source]