gittycent 0.0.4 → 0.1.0

data/CHANGELOG

@@ -1,3 +1,5 @@
+v0.1.0. Changed class name to Gittycent.
+
 v0.0.4. Documentation, better support for repos, minor bug fixes and basic specs.
 
 v0.0.3. Less tagline lameness.

data/gittycent.gemspec

@@ -2,11 +2,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{gittycent}
-  s.version = "0.0.4"
+  s.version = "0.1.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
   s.authors = ["Elijah Miller"]
-  s.date = %q{2010-05-24}
+  s.date = %q{2010-07-22}
   s.description = %q{A GitHub wrapper in Ruby.}
   s.email = %q{elijah.miller@gmail.com}
   s.extra_rdoc_files = ["CHANGELOG", "LICENSE", "README.rdoc", "lib/gittycent.rb"]

data/lib/gittycent.rb

@@ -3,17 +3,17 @@ require 'active_support/all'
 require 'httparty'
 require 'pp'
 
-class GitHub
+class Gittycent
   API_VERSION = 'v2'
   FORMAT = 'yaml'
   NONE, WARNING, INFO, DEBUG = *1..10
-  
+
   attr_accessor :options
-  
+
   # Connects to GitHub using login/token. Yields or returns the new 
   # connection.
   #
-  #  GitHub.connect(:login => 'jqr', :token => 'somesecretstuff123')
+  #  Gittycent.connect(:login => 'jqr', :token => 'somesecretstuff123')
   def self.connect(options)
     connection = new(options)
     if block_given?
@@ -22,34 +22,34 @@ class GitHub
       connection
     end
   end
-  
+
   # Simplified method for connecting with git config specified credentials.
   # Also allows for using an alternate section for easy handling of multiple
   # credentials. Just like connect this yields or returns the new connection.
   #
-  #  github = GitHub.connect_with_git_config
+  #  gittycent = Gittycent.connect_with_git_config
   def self.connect_with_git_config(section = :github, options = {}, &block)
     config = Hash[*`git config -l`.scan(/^(.*?)=(.*)$/).flatten]
     connect(options.merge(:login => config["#{section}.user"], :token => config["#{section}.token"]), &block)
   end
-  
-  # Returns a new GitHub connection object, requires :login and :token 
+
+  # Returns a new Gittycent connection object, requires :login and :token 
   # options.
   #
-  #  github = GitHub.new(:login => 'jqr', :token => 'somesecretstuff123')
+  #  gittycent = Gittycent.new(:login => 'jqr', :token => 'somesecretstuff123')
   def initialize(options)
     self.options = options
     debug "Login using login #{options[:login]} with token #{options[:token]}"
   end
-  
+
   # Returns the verbosity level.
   def verbosity
     options[:verbosity] || NONE
   end
-  
+
   # Finds a GitHub user by login.
   #
-  #  user = github.user('jqr')
+  #  user = gittycent.user('jqr')
   def user(login)
     if login == options[:login]
       AuthenticatedUser.new(self, :login => options[:login])
@@ -57,7 +57,7 @@ class GitHub
       User.new(self, :login => login)
     end
   end
-  
+
   # Finds GitHub users by a query string.
   def user_search(query)
     get("/user/search/#{query}")['users'].map { |u| User.new(self, u) }
@@ -67,11 +67,11 @@ class GitHub
   def authenticated_user
     @authenticated_user ||= user(options[:login])
   end
-  
+
   def inspect # :nodoc:
     "#<#{self.class}#{' ' + options[:login] if options[:login].present?}>"
   end
-  
+
   def default_http_options
     { 
       :query => {
@@ -80,7 +80,7 @@ class GitHub
       }
     }
   end
-  
+
   # Performs a GET request on path, automatically prepending api version and 
   # format paramters. Will automatically retry if the request rate limiting is 
   # hit.
@@ -95,7 +95,7 @@ class GitHub
       response
     end
   end
-  
+
   # Performs a POST request on path, automatically prepending api version and 
   # format paramters. Will automatically retry if the request rate limiting is 
   # hit.
@@ -111,19 +111,19 @@ class GitHub
       response
     end
   end
-  
+
   def debug(message = "")
     puts message if verbosity >= DEBUG
   end
-  
+
   def warn(message = "")
     puts message if verbosity >= WARNING
   end
-  
+
   def debug_inspect(object)
     debug object.pretty_inspect
   end
-  
+
   # Automatically retries a block of code if the returned value is rate 
   # limited (HTTP Code 403) by GitHub.
   def with_retry
@@ -140,37 +140,37 @@ class GitHub
       end
     end
   end
-  
+
   class Connectable
     class_inheritable_accessor :identified_by
-    attr_accessor :connection, :name
-    
+    attr_accessor :connection, :attributes
+  
     def initialize(connection, options)
       self.connection = connection
-      @attributes = options.dup
+      @attributes = options.symbolize_keys
       if self.class.identified_by && @attributes.include?(self.class.identified_by)
         send("#{identified_by}=", @attributes.delete(self.class.identified_by))
       end
       self.connection = connection
     end
-    
+  
     def get(*args)
       connection.get(*args)
     end
-    
+  
     def post(*args)
       connection.post(*args)
     end
-    
+  
     def debug(*args)
       connection.debug(*args)
     end
-    
+  
     def reload
       @attributes = {}
       load
     end
-    
+  
     def self.loadable_attributes(*attributes)
       (attributes - [identified_by]).each do |attribute|
         define_method(attribute) do
@@ -181,35 +181,41 @@ class GitHub
         end
       end
     end
-    
-  end
   
+  end
+
   class User < Connectable
     attr_accessor :login
     self.identified_by = :login
-    
-    loadable_attributes :created_at, :gravatar_id, :public_repo_count, 
-      :public_gist_count, :following_count, :followers_count
-    
+  
+
+    loadable_attributes :followers_count, :created_at, :company, :gravatar_id, 
+       :public_repo_count, :location, :email, :public_gist_count, :blog, 
+       :name, :following_count
+  
     def to_s
       login.to_s
     end
-    
+  
     # Returns this user's repositories.
     def repos
       @repos ||= get("/repos/show/#{login}")['repositories'].map { |r| Repo.new(connection, r) }
     end
-    
+  
+    def repo(name)
+      repos.detect { |r| r.name == name }
+    end
+  
     # Returns a list of all public repos thi user is watching.
     def watched_repos
       @repos ||= get("/repos/watched/#{login}")['repositories'].map { |r| Repo.new(connection, r) }
     end
-    
+  
     # Loads lazily-fetched attributes.
     def load
       @attributes = get("/user/show/#{login}")['user'].symbolize_keys
     end
-    
+  
     # Returns all the users that follow this user.
     def followers
       @followers ||= get("/user/show/#{login}/followers")['users'].map { |u| User.new(connection, :login => u) }
@@ -220,19 +226,16 @@ class GitHub
       @following||= get("/user/show/#{login}/following")['users'].map { |u| User.new(connection, :login => u) }
     end
   end
-  
+
   class AuthenticatedUser < User
-    loadable_attributes :followers_count, :owned_private_repo_count, 
-      :created_at, :company, :private_gist_count, :plan, :gravatar_id, 
-      :total_private_repo_count, :public_repo_count, :location, :email, 
-      :collaborators, :public_gist_count, :blog, :name, :following_count, 
-      :disk_usage
-      
+    loadable_attributes :owned_private_repo_count, :created_at,
+      :private_gist_count, :plan, :collaborators, :disk_usage
+    
     # Returns a list of all repos this user is watching.
     def watched_repos
       super
     end
-    
+  
     # Adds a new repository for this user. Supported options include: :name, 
     # :description, :homepage, :public.
     #
@@ -242,7 +245,7 @@ class GitHub
       Repo.new(connection, post("/repos/create", options)['repository'])
     end
   end
-  
+
   class Repo < Connectable
     attr_accessor :name
     self.identified_by = :name
@@ -253,17 +256,17 @@ class GitHub
     def to_s
       name.to_s
     end
-    
+  
     # Returns the owner of this repository.
     def owner
       @owner ||= User.new(connection, :login => @attributes[:owner])
     end
-    
+  
     # Returns a list of all collaborators.
     def collaborators
       @collaborators ||= get("/repos/show/#{owner.login}/#{name}/collaborators")['collaborators'] || []
     end
-    
+  
     # Sets the list of collaborators.
     def collaborators=(value)
       value = value.dup.uniq
@@ -279,7 +282,7 @@ class GitHub
       end
       @collaborators = nil
     end
-    
+  
     # Returns the shell commands used to do an initial push of this project to
     # GitHub.
     def initial_push_command
@@ -288,30 +291,84 @@ class GitHub
       "git config --add branch.master.remote origin &&\n" +
       "git config --add branch.master.merge refs/heads/master" 
     end
-    
+  
     # Returns repositories in this repository's network.
     def network
       @network ||= get("/repos/show/#{owner.login}/#{name}/network")['network'].map { |r| Repo.new(connection, r) }
     end
-    
+  
     # Returns the languages detected.
     def languages
       get("/repos/show/#{owner.login}/#{name}/languages")['languages']
     end
-    
+  
     # Loads lazily-fetched attributes.
     def load
       @attributes = get("/repos/show/#{owner.login}/#{name}")['repository'].symbolize_keys
     end
-    
+  
     # Returns all tags of this repository.
     def tags
       get("/repos/show/#{owner.login}/#{name}/tags")['tags']
     end
-    
+  
     # Returns all branches of this repository.
     def branches
       get("/repos/show/#{owner.login}/#{name}/branches")['branches']
     end
+  
+    # Returns all commits of the master branch.
+    def commits
+      get("/commits/list/#{owner.login}/#{name}/master")['commits'].map { |c| Commit.new(connection, c.merge(:repo => self)) }
+    end
+  end
+
+
+  class Commit < Connectable
+    attr_accessor :id
+    self.identified_by = :id
+
+    loadable_attributes :author, :parents, :url, :committed_date, :authored_date, :message, :committer, :tree
+
+    def to_s
+      id.to_s
+    end
+  
+    # Returns the associated repository.
+    def repo
+      @attributes[:repo]
+    end
+  
+    # Returns the parent commits of this commit.
+    def parents
+      load unless @attributes.include?(:parents)
+      @parents ||= @attributes[:parents].map { |p| Commit.new(connection, p.merge(:repo => repo)) }
+    end
+  
+    # Returns the Person who authored this commit.
+    def author
+      @author ||= Person.new(connection, @attributes[:author])
+    end
+
+    # Returns the Person who committed this commit.
+    def committer
+      @committer ||= Person.new(connection, @attributes[:committer])
+    end
+  
+    # Loads lazily-fetched attributes.
+    def load
+      @attributes = get("/commits/show/#{repo.owner.login}/#{repo.name}/#{id}")['commit'].symbolize_keys.merge(:repo => repo)
+    end
+  
+  end
+
+  class Person < Connectable
+    loadable_attributes :name, :email, :login
+
+    def user
+      if login
+        connection.user(login)
+      end
+    end
   end
-end
+end

metadata

@@ -1,13 +1,12 @@
 --- !ruby/object:Gem::Specification 
 name: gittycent
 version: !ruby/object:Gem::Version 
-  hash: 23
   prerelease: false
   segments: 
   - 0
+  - 1
   - 0
-  - 4
-  version: 0.0.4
+  version: 0.1.0
 platform: ruby
 authors: 
 - Elijah Miller
@@ -15,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-05-24 00:00:00 -04:00
+date: 2010-07-22 00:00:00 -04:00
 default_executable: 
 dependencies: []
 
@@ -57,7 +56,6 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 3
       segments: 
       - 0
       version: "0"
@@ -66,7 +64,6 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 11
       segments: 
       - 1
       - 2