trackrepos 1.0.0 → 1.0.1

data/README.md

@@ -10,19 +10,21 @@ Install the Ruby Gem `track-repos`:
 
 ## Setup
 
-Create a `.tracked-repos.yaml` file to update and keep track of either existing git repositores or new ones you intend to add.
+Create a `.tracked-repos.yaml` file to update and keep track of either existing git repositories or new ones you intend to add.
 
-There are currently three types of git repositores that can be tracked andupdated:
+There are currently three types of git repositories that can be tracked and updated:
 
 1. Regular git repositories.
 2. Git clones of Subversion repositories
-3. Git clones of git mirrors of subversion repositories (need to explicity request new tags).
+3. Git clones of git mirrors of subversion repositories (need to explicitly request new tags).
 
 Here's an example yaml configuration file that tracks the Ruby Gems `aasm`, and `builder`.
-Normally the master branch is fetched hower the specifiction for thr `builder` gem indicates that
-the `trunk` branch should be checked out and tracked.In addition the `arduino` project which
+Normally the master branch is fetched however the specifiction for thr `builder` gem indicates that
+the `trunk` branch should be checked out and tracked.  In addition the `arduino` project which
 is located in a Subersion repository is checked out as a git clone of a subversion repository.
 
+file: .tracked-repos.yaml
+
     ---
     :git:
     - :path: aasm
@@ -40,9 +42,66 @@ is located in a Subersion repository is checked out as a git clone of a subversi
 
 The last item in the list specifies that the source code for Ruby should be checked out. In
 this case it is being cloned from a git repository on github which is a miirror of the main
-Ruby Subversion repository. This tpe if differentiated from a normal git repository because an
+Ruby Subversion repository. This type if differentiated from a normal git repository because an
 additional action is taken to manually fetch any updated tags.
 
+### tracked-repos.yaml examples
+
+1. [gems](https://raw.github.com/gist/2907585/gems-tracked-repos.yaml)
+2. [javascript](https://raw.github.com/gist/2907585/javascript-tracked-repos.yaml)
+
+Running: trackrepos in a directory with a file in that format named .tracked-repos.yaml will update (checking out the repo if it doesn't exist locally) and summarize the newest and oldest projects that were updated.
+
+Here's a truncated version of the console output when running trackrepos in the directory that contains
+the jacvascript yaml tracking file linked above.
+
+    =======================================================================================
+
+    Tracking git repositories in directory: /Users/stephen/dev/javascript
+
+      Updating local git clones of external git repositories
+      commands: git pull
+
+        accordion-git                                           3 years, 4 months ago
+        accordion-js-git                                        3 years, 5 months ago
+        ajax_org/ace-git                                        25 hours ago
+        ajax_org/gherkin-editor-git                             11 months ago
+        ...
+
+    -----------------------------------------------------------------------------------
+
+      Updating local git clones of external subversion repositories
+      commands: git svn rebase
+
+        asciimathml-svn-git                                     4 years, 8 months ago
+        canvas/canvas-text-svn-git                              1 year, 10 months ago
+        canvas/excanvas-svn-git                                 3 years, 5 months ago
+        canvas/canvg-svn-git                                    2 weeks ago
+        closure-compiler-svn-git                                3 days ago
+        ...
+
+Which ends with a summary like this:
+
+    =======================================================================================
+
+      Git repositories in directory: /Users/stephen/dev/javascript
+      updated in the last week:
+
+        mvc/ember/ember-git                                     2 hours ago
+        node/modules/express-git                                4 hours ago
+        node/npm-git                                            4 hours ago
+        underscore-git                                          5 hours ago
+        mvc/angular/angular.js-git                              7 hours ago
+        maqetta-git                                             8 hours ago
+        jquery-ui-git                                           23 hours ago
+        ajax_org/ace-git                                        25 hours ago
+        testing/phantomjs-git                                   26 hours ago
+        node/node-git                                           29 hours ago
+        editors/codemirror2-git                                 2 days ago
+        webgl/webgl-svn-git                                     2 days ago
+        Modernizr-git                                           2 days ago
+        ...
+
 The `.tracked-repos.yaml` file is a YAML serialization of the kind of data expressed in this Ruby Hash.
 Each type of external repositor consists of an array of repository specificationns with keys for
 `:path` and `:remote` git url, as well as an optional key for the `:branch` that should be tracked

data/lib/trackrepos/version.rb

@@ -1,3 +1,3 @@
 module TrackRepos
-  VERSION = "1.0.0"
+  VERSION = "1.0.1"
 end

data/trackrepos.gemspec

@@ -6,7 +6,7 @@ require 'trackrepos/version'
 
 Gem::Specification.new do |gem|
   gem.authors       = ["Stephen Bannasch"]
-  gem.email         = ["sbannasch@concord.org"]
+  gem.email         = ["stephen@deanbrook.org"]
   gem.description   = %q{Uses yaml configuration files to track and update collections of external git repositories}
   gem.summary       = %q{Useful for tracking large numbers of external git repositories}
   gem.homepage      = "https://github.com/concord-consortium/trackrepos"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: trackrepos
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
   prerelease: 
 platform: ruby
 authors:
@@ -14,7 +14,7 @@ dependencies: []
 description: Uses yaml configuration files to track and update collections of external
   git repositories
 email:
-- sbannasch@concord.org
+- stephen@deanbrook.org
 executables:
 - trackrepos
 extensions: []