added Repo#identity and Repo#identify with a unit test

src/repo.coffee

@@ -1,5 +1,6 @@
 _      = require 'underscore'
 cmd    = require './git'
+Actor  = require './actor'
 Commit = require './commit'
 Tree   = require './tree'
 Diff   = require './diff'
@@ -15,30 +16,63 @@ module.exports = class Repo
     else
       @dot_git = "#{@path}/.git"
     @git  = cmd @path, @dot_git
-
-
+
+
+  # Public: Get the commit identity for this repository.
+  #
+  # callback - Receives `(err, actor)`, where `actor` is an Actor.
+  #
+  identity: (callback) ->
+    # git config user.email
+    @git "config", {}, ["user.email"]
+    , (err, stdout = '') =>
+      return callback err if err
+      email = stdout?.trim()
+      # git config user.name
+      @git "config", {}, ["user.name"]
+      , (err, stdout = '') =>
+        return callback err if err
+        name = stdout?.trim()
+        return callback null, new Actor(name, email)
+
+
+  # Public: Set your account's default identity for commits.
+  #
+  # actor    - An instance of Actor.
+  # callback - Receives `(err)`.
+  #
+  identify: (actor, callback) ->
+    # git config user.email "[email protected]"
+    @git "config", {}, ["user.email", "\"#{actor.email}\""], (err) =>
+      return callback err if err
+      # git config user.name "Your Name"
+      @git "config", {}, ["user.name", "\"#{actor.name}\""], (err) =>
+        return callback err if err
+        return callback null
+
+
   # Public: Get a list of commits.
-  # 
+  #
   # treeish  - String  (optional).
   # limit    - Integer (optional).
   # skip     - Integer (optional).
   # callback - Function which receives `(err, commits)`, where `commits` is
   #            an Array of Commits.
-  # 
+  #
   # Examples
-  # 
+  #
   #   # Get the 10 most recent commits to master.
   #   repo.commits (err, commits) ->
-  # 
+  #
   #   # Or to a different tag or branch.
   #   repo.commits "v0.0.3", (err, commits) ->
-  # 
+  #
   #   # Limit the maximum number of commits returned.
   #   repo.commits "master", 30, (err, commits) ->
-  # 
+  #
   #   # Skip some (for pagination):
   #   repo.commits "master", 30, 30, (err, commits) ->
-  # 
+  #
   commits: (start, limit, skip, callback) ->
     [skip,  callback] = [callback, skip]  if !callback
     [limit, callback] = [callback, limit] if !callback
@@ -47,26 +81,26 @@ module.exports = class Repo
     start ?= "master"
     limit ?= 10
     skip  ?= 0
-    
+
     Commit.find_all this, start, {"max-count": limit, skip}, callback
-  
-  
+
+
   # Public: The tree object for the treeish or master.
-  # 
+  #
   # treeish - String treeish (such as a branch or tag) (optional).
-  # 
+  #
   # Returns Tree.
   tree: (treeish="master") ->
     return new Tree this, treeish
-  
-  
+
+
   # Public: Get the difference between the trees.
-  # 
+  #
   # commitA  - A Commit or String commit id.
   # commitB  - A Commit or String commit id.
   # paths    - A list of String paths to restrict the difference to (optional).
   # callback - A Function which receives `(err, diffs)`.
-  # 
+  #
   diff: (commitA, commitB, paths, callback) ->
     [callback, paths] = [paths, callback] if !callback
     paths ?= []
@@ -76,33 +110,33 @@ module.exports = class Repo
     , (err, stdout, stderr) =>
       return callback err if err
       return callback err, Diff.parse(this, stdout)
-  
-  
+
+
   # Public: Get the repository's remotes.
-  # 
+  #
   # callback - Receives `(err, remotes)`.
-  # 
+  #
   remotes: (callback) ->
     Ref.find_all this, "remote", Ref, callback
-  
+
   # Public: List the repository's remotes.
-  # 
+  #
   # callback - Receives `(err, names)`.
-  # 
+  #
   remote_list: (callback) ->
     @git.list_remotes callback
-  
+
   # Public: Add a remote.
-  # 
+  #
   # name     - String name of the remote.
   # url      - String url of the remote.
   # callback - Receives `(err)`
-  # 
+  #
   remote_add: (name, url, callback) ->
     @git "remote", {}, ["add", name, url]
     , (err, stdout, stderr) ->
       callback err
-  
+
   # Public: Remove a remote.
   #
   # name     - String name of the remote.
@@ -112,17 +146,17 @@ module.exports = class Repo
     @git "remote", {}, ["rm", name]
     , (err, stdout, stderr) ->
       callback err
-  
+
   # Public: `git fetch <name>`.
-  # 
+  #
   # name     - String name of the remote
   # callback - Receives `(err)`.
-  # 
+  #
   remote_fetch: (name, callback) ->
     @git "fetch", {}, name
     , (err, stdout, stderr) ->
       callback err
-  
+
   # Public: `git push <name>`.
   #
   # name     - String name of the remote
@@ -132,82 +166,82 @@ module.exports = class Repo
     @git "push", {}, name
     , (err, stdout, stderr) ->
       callback err
-    
+
   # Public: `git merge <name>`.
-  # 
+  #
   # name     - String name of the source
   # callback - Receives `(err)`.
-  # 
+  #
   merge: (name, callback) ->
     @git "merge", {}, name
     , (err, stdout, stderr) ->
       callback err
-  
+
   # Public: Get the repository's status (`git status`).
-  # 
+  #
   # callback - Receives `(err, status)`
-  # 
+  #
   status: (callback) ->
     return Status(this, callback)
-  
-  
+
+
   # Public: Get the repository's tags.
-  # 
+  #
   # callback - Receives `(err, tags)`.
-  # 
+  #
   tags: (callback) ->
     Tag.find_all this, callback
-  
+
   # Public: Create a tag.
-  # 
+  #
   # name     - String
   # options  - An Object of command line arguments to pass to
   #            `git tag` (optional).
   # callback - Receives `(err)`.
-  # 
+  #
   create_tag: (name, options, callback) ->
     [options, callback] = [callback, options] if !callback
     @git "tag", options, [name], callback
-  
+
   # Public: Delete the tag.
-  # 
+  #
   # name     - String
   # callback - Receives `(err)`.
-  # 
+  #
   delete_tag: (name, callback) ->
     @git "tag", {d: name}, callback
-  
-  
+
+
   # Public: Get a list of branches.
-  # 
+  #
   # callback - Receives `(err, heads)`.
-  # 
+  #
   branches: (callback) ->
     Head.find_all this, callback
-  
+
   # Public: Create a branch with the given name.
-  # 
+  #
   # name     - String name of the new branch.
   # callback - Receives `(err)`.
-  # 
+  #
   create_branch: (name, callback) ->
     @git "branch", {}, name, (err, stdout, stderr) ->
       return callback err
-  
+
   # Public: Delete the branch with the given name.
-  # 
+  #
   # name     - String name of the branch to delete.
   # callback - Receives `(err)`.
-  # 
+  #
   delete_branch: (name, callback) ->
     @git "branch", {d: true}, name, (err, stdout, stderr) ->
       return callback err
-  
+
   # Public: Get the Branch with the given name.
-  # 
+  #
   # name     - String (optional). By default, get the current branch.
   # callback - Receives `(err, head)`
-  # 
+  #
   branch: (name, callback) ->
     [name, callback] = [callback, name] if !callback
     if !name
@@ -218,51 +252,51 @@ module.exports = class Repo
         for head in heads
           return callback null, head if head.name == name
         return callback new Error "No branch named '#{name}' found"
-  
-  
+
+
   # Public: Checkout the treeish.
   checkout: (treeish, callback) ->
     @git "checkout", {}, treeish, callback
-  
-  
+
+
   # Public: Commit some code.
-  # 
+  #
   # message  - String
   # options  - Object (optional).
   #            "amend" - Boolean
   #            "all"   - Boolean
   # callback - Receives `(err)`.
-  # 
+  #
   commit: (message, options, callback) ->
     [options, callback] = [callback, options] if !callback
     options ?= {}
     options = _.extend options, {m: "'#{message}'"}
     @git "commit", options, (err, stdout, stderr) ->
       callback err
-  
+
   # Public: Add files to the index.
-  # 
+  #
   # files    - Array of String paths; or a String path.
   # callback - Receives `(err)`.
-  # 
+  #
   add: (files, callback) ->
     files = [files] if _.isString files
     @git "add", {}, files, callback
-  
+
   # Public: Remove files from the index.
-  # 
+  #
   # files    - Array of String paths; or a String path.
   # callback - Receives `(err)`.
-  # 
+  #
   remove: (files, callback) ->
     files = [files] if _.isString files
     @git "rm", {}, files, callback
-  
+
   # Public: Revert the given commit.
   revert: (sha, callback) ->
     @git "revert", {}, sha, callback
-  
-  
+
+
   # Public: Sync the current branch with the remote.
   #
   # callback - Receives `(err)`.