reponaut 1.2.0 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e5b333973b1cadd089780a6ea4bd5984d4012b4d
-  data.tar.gz: dbb6f53a2e5b1b8abb304f2a327339e41c8595a6
+  metadata.gz: 985b9da1a543fc796c3ce12f0905e43cf20abb43
+  data.tar.gz: 7655ae1f153449137992b2a03f8be9fdcb9cbc77
 SHA512:
-  metadata.gz: b989b86496d509c117584388b061cd98d7b1dad3cf86bec1decca1e98c8a859fb0a4741c9f1077cf226b1e6de64c0dc3956190fdcfc5a54d3b02568bd9221907
-  data.tar.gz: 67d156104e115908c492d9c03e2e991d84618a1b59ffdf97aba50cd1506da74b0e8016fd89b1e19e43c2f82da12f8262a77edf0b6f05b371ace5d7c68a6eb4b8
+  metadata.gz: 9bc1b74370e8d307a6e297745b3ccc7c983edf91823144c38a5b34a1fe0cd2783fe4ec40843570ba822e6b08c3fe172d27e268294751581f4ab65aea01d54424
+  data.tar.gz: 1edef2e6384a54b7c907ec4e6d0c62e6b9bda58690baf7a5a237c0a042bbe98c38ad690018e56486f8f0f2207c14954f5a6dd5d8f4479748129e6dc73625f2f8

data/bin/reponaut

@@ -1,4 +1,22 @@
 #!/usr/bin/env ruby
 
+require 'mercenary'
 require 'reponaut'
-Reponaut::Application.run
+require 'reponaut/ext/mercenary'
+
+Mercenary.program(:reponaut) do |p|
+  p.version Reponaut::VERSION
+  p.description 'Explore GitHub users'
+  p.syntax 'reponaut <command> [options] <args>'
+
+  Reponaut::Application::Command.subclasses.each { |c| c.new(p) }
+
+  p.action do |args, options|
+    if args.empty?
+      puts p
+      exit 0
+    else
+      abort "Invalid command: #{args.first}"
+    end
+  end
+end

data/features/count.feature

@@ -6,7 +6,7 @@ Feature: Count repositories by language
 
   Scenario: List repository counts sorted by language
     Given the GitHub service returns repository data for the user "mdippery"
-    When I run `reponaut mdippery`
+    When I run `reponaut count mdippery`
     Then it should pass with:
       """
       C               1
@@ -23,24 +23,7 @@ Feature: Count repositories by language
 
   Scenario: List repository counts sorted by language count
     Given the GitHub service returns repository data for the user "mdippery"
-    When I run `reponaut -c mdippery`
-    Then it should pass with:
-      """
-      Objective-C     5
-      Python          4
-      Clojure         3
-      Ruby            3
-      VimL            3
-      Java            2
-      C               1
-      Erlang          1
-      JavaScript      1
-      Perl            1
-      """
-
-  Scenario: List repository counts sorted by language count using long option
-    Given the GitHub service returns repository data for the user "mdippery"
-    When I run `reponaut --count mdippery`
+    When I run `reponaut count -n mdippery`
     Then it should pass with:
       """
       Objective-C     5
@@ -57,7 +40,7 @@ Feature: Count repositories by language
 
   Scenario: List repository counts for source repositories ordered by language
     Given the GitHub service returns repository data for the user "mdippery"
-    When I run `reponaut -f mdippery`
+    When I run `reponaut count -f mdippery`
     Then it should pass with:
       """
       C               1
@@ -74,7 +57,7 @@ Feature: Count repositories by language
 
   Scenario: List repository counts for source repositories ordered by language using long option
     Given the GitHub service returns repository data for the user "mdippery"
-    When I run `reponaut --ignore-forks mdippery`
+    When I run `reponaut count --ignore-forks mdippery`
     Then it should pass with:
       """
       C               1
@@ -91,7 +74,7 @@ Feature: Count repositories by language
 
   Scenario: List repository counts for source repositories ordered by count
     Given the GitHub service returns repository data for the user "mdippery"
-    When I run `reponaut -f -c mdippery`
+    When I run `reponaut count -f -n mdippery`
     Then it should pass with:
       """
       Objective-C     5
@@ -108,7 +91,7 @@ Feature: Count repositories by language
 
     Scenario: List repository counts for users with over 10 repositories
       Given the GitHub service returns repository data for the user "testuser1"
-      When I run `reponaut testuser1`
+      When I run `reponaut count testuser1`
       Then it should pass with:
         """
         HTML             1
@@ -121,7 +104,7 @@ Feature: Count repositories by language
 
   Scenario: List repository counts for a non-existent user
     Given the GitHub service returns 404 for the user "nosuchuser"
-    When I run `reponaut nosuchuser`
+    When I run `reponaut count nosuchuser`
     Then the exit status should not be 0
     And the stderr should contain:
       """
@@ -130,9 +113,18 @@ Feature: Count repositories by language
 
   Scenario: List repository counts for a user with no repositories
     Given the GitHub service returns repository data for the user "emptyuser"
-    When I run `reponaut emptyuser`
+    When I run `reponaut count emptyuser`
     Then the exit status should not be 0
     And the stderr should contain:
       """
       emptyuser has no repositories
       """
+
+  Scenario: List repository counts when GitHub has limited the requests
+    Given the GitHub service is rate limiting requests for the user "mdippery"
+    When I run `reponaut count mdippery`
+    Then the exit status should not be 0
+    And stderr should contain:
+      """
+      GitHub rate limit exceeded. Try your request again later.
+      """

data/features/help.feature

@@ -8,34 +8,44 @@ Feature: Get help
     When I run `reponaut -h`
     Then it should pass with:
       """
-      Usage: reponaut [OPTIONS] USERNAME [LANGUAGE]
+      Usage:
+
+        reponaut <command> [options] <args>
 
       Options:
-          -c, --count         Sort by repo count
-          -f, --ignore-forks  Ignore forked repos
-          -h, --help          
-          --version           
+              -h, --help         Show this message
+              -v, --version      Print the name and version
+              -t, --trace        Show the full backtrace when an error occurs
+
+      Subcommands:
+        count                 Shows a breakdown of a user's total number of repos
+        list, ls              List a user's repos
       """
 
   Scenario: List usage details with long option
     When I run `reponaut --help`
     Then it should pass with:
       """
-      Usage: reponaut [OPTIONS] USERNAME [LANGUAGE]
+      Usage:
+
+        reponaut <command> [options] <args>
 
       Options:
-          -c, --count         Sort by repo count
-          -f, --ignore-forks  Ignore forked repos
-          -h, --help          
-          --version           
+              -h, --help         Show this message
+              -v, --version      Print the name and version
+              -t, --trace        Show the full backtrace when an error occurs
+
+      Subcommands:
+        count                 Shows a breakdown of a user's total number of repos
+        list, ls              List a user's repos
       """
 
   Scenario: Get version
     When I run `reponaut --version`
     Then the exit status should be 0
-    And the stdout should contain:
+    And the output should match:
       """
-      reponaut, version
+      reponaut [0-9]+\.[0-9]+\.[0-9]+(\.[a-z]+)?
       """
 
   Scenario: Specify an invalid option
@@ -43,20 +53,25 @@ Feature: Get help
     Then the exit status should not be 0
     And the stderr should contain:
       """
-      unknown option `-b'
-      Run `reponaut --help` for help information
+      Whoops, we can't understand your command.
+      invalid option: -b
+      Run your command again with the --help switch to see available options.
       """
 
   Scenario: Specify no options
     When I run `reponaut`
-    Then the exit status should not be 0
-    And the stderr should contain:
+    Then it should pass with:
       """
-      Usage: reponaut [OPTIONS] USERNAME [LANGUAGE]
+      Usage:
+
+        reponaut <command> [options] <args>
 
       Options:
-          -c, --count         Sort by repo count
-          -f, --ignore-forks  Ignore forked repos
-          -h, --help          
-          --version           
+              -h, --help         Show this message
+              -v, --version      Print the name and version
+              -t, --trace        Show the full backtrace when an error occurs
+
+      Subcommands:
+        count                 Shows a breakdown of a user's total number of repos
+        list, ls              List a user's repos
       """

data/features/list.feature

@@ -4,9 +4,211 @@ Feature: List repos for a given language
   I want to see what projects another user has created in a given language
   In order to see what software they've written
 
+  Scenario: List all repositories
+    Given the GitHub service returns repository data for the user "mdippery"
+    When I run `reponaut ls mdippery`
+    Then it should pass with:
+      """
+      3ddv
+      blackout
+      bucknellbug
+      chameleon
+      collections
+      dnsimple-python -> tbunnyman/dnsimple-python
+      dotfiles
+      glitz
+      homebrew-self
+      karmanaut
+      libtar
+      nginx.vim -> vim-scripts/nginx.vim
+      rack-pesticide
+      rainyday
+      reponaut
+      Smyck-Color-Scheme -> hukl/Smyck-Color-Scheme
+      snodes
+      squash
+      stackim
+      staticgenerator -> mrj0/staticgenerator
+      usaidwat
+      vimfiles
+      whitman
+      zanegort
+      """
+
+  Scenario: List all repositories without forks
+    Given the GitHub service returns repository data for the user "mdippery"
+    When I run `reponaut ls -f mdippery`
+    Then it should pass with:
+      """
+      3ddv
+      blackout
+      bucknellbug
+      chameleon
+      collections
+      dotfiles
+      glitz
+      homebrew-self
+      karmanaut
+      libtar
+      rack-pesticide
+      rainyday
+      reponaut
+      snodes
+      squash
+      stackim
+      usaidwat
+      vimfiles
+      whitman
+      zanegort
+      """
+
+  Scenario: Describe all repositories
+    Given the GitHub service returns repository data for the user "mdippery"
+    When I run `reponaut ls -d mdippery`
+    Then it should pass with:
+      """
+      3ddv
+          NEES 3D Data Viewer from the Center for Earthquake Engineering Simulation at RPI
+
+      blackout
+          Activate your Mac OS X screen saver with a simple keystroke
+
+      bucknellbug
+          Mac OS X weather widget that pulls info from Bucknell University's weather station
+
+      chameleon
+          Samples Stack Overflow user reputation scores
+
+      collections
+          Bringing Smalltalk and Ruby collections methods to Objective-C since 2011
+
+      dnsimple-python -> tbunnyman/dnsimple-python
+          Python client for DNSimple domain registration and DNS hosting
+
+      dotfiles
+          My configuration files
+
+      glitz
+          Track and manage your Sparkle-enabled software with a Django webapp
+
+      homebrew-self
+          My own Homebrew formulæ that aren't suitable for inclusion in the main Homebrew repo
+
+      karmanaut
+          Samples Reddit users' link and comment karma scores
+
+      libtar
+          A tarfile handling library for C and Objective-C
+
+      nginx.vim -> vim-scripts/nginx.vim
+          Ease editing of nginx conf files in Vim
+
+      rack-pesticide
+          Block annoying HTTP referrers
+
+      rainyday
+          Mac OS X screen saver that wraps Marek Brodziak's rainyday.js code
+
+      reponaut
+          Exploring the depths of GitHub
+
+      Smyck-Color-Scheme -> hukl/Smyck-Color-Scheme
+          Color Scheme for Terminal.app, iTerm2, Vim, MacVim, Sublime Text2 and Textmate
+
+      snodes
+          A distributed, encrypted file sharing network
+
+      squash
+          Minify your JavaScript, CSS, SASS, and LESS files—automagically!
+
+      stackim
+          URL shortener for Stack Overflow profiles
+
+      staticgenerator -> mrj0/staticgenerator
+          StaticGenerator for Django
+
+      usaidwat
+          Answers the age-old question, "Where does a Redditor comment the most?"
+
+      vimfiles
+          My Vim configuration
+
+      whitman
+          Sample data from JSON web APIs
+
+      zanegort
+          An IRC bot
+      """
+
+  Scenario: Describe all repositories without forks
+    Given the GitHub service returns repository data for the user "mdippery"
+    When I run `reponaut ls -fd mdippery`
+    Then it should pass with:
+      """
+      3ddv
+          NEES 3D Data Viewer from the Center for Earthquake Engineering Simulation at RPI
+
+      blackout
+          Activate your Mac OS X screen saver with a simple keystroke
+
+      bucknellbug
+          Mac OS X weather widget that pulls info from Bucknell University's weather station
+
+      chameleon
+          Samples Stack Overflow user reputation scores
+
+      collections
+          Bringing Smalltalk and Ruby collections methods to Objective-C since 2011
+
+      dotfiles
+          My configuration files
+
+      glitz
+          Track and manage your Sparkle-enabled software with a Django webapp
+
+      homebrew-self
+          My own Homebrew formulæ that aren't suitable for inclusion in the main Homebrew repo
+
+      karmanaut
+          Samples Reddit users' link and comment karma scores
+
+      libtar
+          A tarfile handling library for C and Objective-C
+
+      rack-pesticide
+          Block annoying HTTP referrers
+
+      rainyday
+          Mac OS X screen saver that wraps Marek Brodziak's rainyday.js code
+
+      reponaut
+          Exploring the depths of GitHub
+
+      snodes
+          A distributed, encrypted file sharing network
+
+      squash
+          Minify your JavaScript, CSS, SASS, and LESS files—automagically!
+
+      stackim
+          URL shortener for Stack Overflow profiles
+
+      usaidwat
+          Answers the age-old question, "Where does a Redditor comment the most?"
+
+      vimfiles
+          My Vim configuration
+
+      whitman
+          Sample data from JSON web APIs
+
+      zanegort
+          An IRC bot
+      """
+
   Scenario: List repositories in a given language
     Given the GitHub service returns repository data for the user "mdippery"
-    When I run `reponaut mdippery VimL`
+    When I run `reponaut ls mdippery VimL`
     Then it should pass with:
       """
       nginx.vim -> vim-scripts/nginx.vim
@@ -16,7 +218,7 @@ Feature: List repos for a given language
 
   Scenario: List repositories in a given language, ignoring case
     Given the GitHub service returns repository data for the user "mdippery"
-    When I run `reponaut mdippery viml`
+    When I run `reponaut ls mdippery viml`
     Then it should pass with:
       """
       nginx.vim -> vim-scripts/nginx.vim
@@ -26,7 +228,7 @@ Feature: List repos for a given language
 
   Scenario: List repositories in a given language, excluding forks
     Given the GitHub service returns repository data for the user "mdippery"
-    When I run `reponaut -f mdippery VimL`
+    When I run `reponaut ls -f mdippery VimL`
     Then it should pass with:
       """
       vimfiles
@@ -34,18 +236,18 @@ Feature: List repos for a given language
 
   Scenario: List repositories in a given language with no results
     Given the GitHub service returns repository data for the user "mdippery"
-    When I run `reponaut mdippery C++`
+    When I run `reponaut ls mdippery C++`
     Then the exit status should not be 0
     And the output should contain:
       """
       mdippery has no repositories written in C++
       """
 
-  Scenario: List repositories in a given language with counts
-    Given the GitHub service returns repository data for the user "mdippery"
-    When I run `reponaut -c mdippery ruby`
+  Scenario: List repositories for a given user when the API has been rate limited
+    Given the GitHub service is rate limiting requests for the user "mdippery"
+    When I run `reponaut ls mdippery python`
     Then the exit status should not be 0
     And stderr should contain:
       """
-      Cannot pass -c when filtering by language
+      GitHub rate limit exceeded. Try your request again later.
       """