Shaun Smith » osx

OS X Git Prompt

shaun — Sun, 15 Nov 2009 01:26:37 +0000

I’m currently using a modified version of git-prompt that looks something like this:

If you want to try it out, you can download this zip-ball:

Unpack that into your User folder, and add this to your bash .profile:

# Git Prompt - Modified from: http://volnitsky.com/project/git-prompt/
[[ $- == *i* ]] && . ~/git-prompt/git-prompt.sh

Tip: You can open your .profile from your terminal like so:

open ~/.profile

Note: You will need to start a new shell session after editing that file in order to see the changes.

I use Nano as my default bash text editor. If you want that, add this to your .profile:

# Use the nano text editor
export EDITOR="nano"

And for the Terminal.app style:

Power-User-Pro.terminal.zip

The shell commands (copy-paste):

mkdir Test
cd Test/
git init
touch somefile
git add somefile
git commit -m "commit message"
echo "hi" > somefile
git add somefile
git commit -m "second commit"
git checkout -b temp
echo "hello" > somefile
git add .
git commit -m "3rd commit"

Getting Started with Git on Mac OS X

shaun — Sat, 14 Mar 2009 18:42:32 +0000

Some Background

I’ve recently switched from using SVN to using Git as my source control management tool of choice. It took a little while to get to grips with, but it rocks!

Git is not an evolution of SVN. It is entirely different. Git is a distributed revision control system – everybody working on a project has their own full copy of the repository and its entire history.

Git does not require the presence of a network connection: most commands in Git operate locally, allowing you to review your project history, make branches and tags, merge changes, but most importantly, allowing you to commit while offline.

If you’ve used SVN you’ve probably noticed the littering of .svn folders across your entire project tree, requiring the need for an export tool to retrieve clean copies of your code, and introducing problems when you delete, rename or move files or folders in your project. Git takes a slightly more sensible approach: it creates one folder (named .git) in the root folder of your project.

Git Concepts

With Git there are 3 important things to be aware of: the Git object database, the “index”, and your working area.

The Git object database contains a bunch of stuff that you typically don’t need to worry about. Essentially it’s the repository.

Your working area is the collection of files currently sitting in your project folder. You should treat these files as if they are temporary – because they are! Things you want to keep should be committed to the repository.

The Index is sometimes referred to as the Staging Area. It’s a list of what will get stored on your next commit. Conceptually it sits between your working files and the Git object database. Files that haven’t been staged to the index will be ignored when doing a commit. This gives you great control over what gets committed when.

A branch is a cheap copy of a particular state of the Git object database. Branches are easy to create and switch between, giving you a safe way to try out ideas quickly and easily. Switching to another branch updates your working area to reflect the state of that branch – this is why you should consider your working area temporary.

Installing Git on Mac OS X

Grab and install the latest OS-X Installer from:

http://code.google.com/p/git-osx-installer/

Configuring Git

You need to tell Git who you are – it uses this information for your commits etc.

Fire up your terminal, and type:

git config --global user.name "Your Name"
git config --global user.email your@email.com

Using Git

Once Git is installed on your system, creating a Git repository is easy: open your terminal, cd into the root folder of your project, and type: git init

That’s pretty much it!

After initialising your Git repository, it will most likely be empty. In order to commit files to the repository you first need to “stage” them by adding them to the index. To add all the files in your current project to the index type:

git add .

To commit these files type:

git commit -m "your commit message"

To view the status of your repository type:

git status

To Summarise

[Download and install Git]
[cd into the root of your project]

git init
ls -la
git status
git add .
git status
git commit -m "a useful commit message"
git status

[change some files in your working area]

git status
git diff
git commit -a -m "commit message. -a adds all files from your working area to the index"
git status

[delete some files from your local working area]

git status
git add -u
git commit -m "commit message. -u adds deleted files to the index"
git status

Ignoring Files

You will probably want to ensure than certain files don’t ever get committed to the repo:

http://www.kernel.org/pub/software/scm/git/docs/gitignore.html

Extra Configuration

You can enabled colorful output:

git config --global color.diff auto
git config --global color.status auto
git config --global color.branch auto

Some Bundled Visual Tools

gitk
git gui

Git Screencasts

http://gitcasts.com/

Installing Git on Windows

http://gitcasts.com/posts/git-on-windows

Some Other Git Links

Eclipse Integration

Point your eclipse update manager to: http://www.jgit.org/update-site

More info: http://www.jgit.org/

Some Commands

Add all working files to the index:

git add .

Add deleted files to the index:

git add -u

Create and switch to a new branch:

git checkout -b newbranchname

Review last commit:

git show
git show --stat
git show --name -status
git show HEAD

Review commit history:

git log
git log tag..branch
git log -10
git log --since="May 1" --until="June 1"
git log --author=fred
git log -- some/file

Creating branches:

git branch name
git branch name commit

Switching branches:

git checkout name
git checkout -f name

Flash Mousewheel Scrolling on Mac OSX

shaun — Sat, 07 Mar 2009 10:47:29 +0000

Update: This was fixed and released in Player 10.0.42.34.. Woop! (Wed, 9 Dec, 2009)

Mousewheel scrolling is not properly supported by the Flash Player on Mac OSX. There is a bug in the Adobe bug tracker here:

http://bugs.adobe.com/jira/browse/FP-503

But I feel that it’s misleading, and dilutes the issue. Firstly, the title has the word Flex in it. Secondly, it’s complaining about mousewheel support in Safari on Windows XP! Perhaps that is why it currently only has 10 votes.

The actual issue is that the mousewheel doesn’t work in any version of the Flash Player on OSX. It’s just a side-effect that it affects Safari on Windows.

This is a HUGE issue – Flash is all about Rich GUI these days, and OSX users are still without proper mouse support! How could this be an issue with only 10 votes?

At some point, the Flash Player will HAVE to support the Trackpad (with vertical and horizontal scrolling) properly, or risk continuing to look like a piece of ancient technology that doesn’t properly integrate with modern operating systems. I don’t think that’s an exaggeration: OSX users are generally very critical of UI nuances, and this is a biggie!

In the meantime there are a number of workarounds:

Update: The bug entry has been edited a little to better reflect the problem.
Update: This was fixed and released in Player 10.0.42.34.. Woop! (Wed, 9 Dec, 2009)

Invert Your Display in OSX

shaun — Sat, 14 Jun 2008 11:27:46 +0000

Sweet. Just what I always wanted – the ability to invert my display with the touch of a button:

Control-Option-Command-8

Perfect for late night coding sessions!