githubris 0.0.1

data/.gitignore

@@ -0,0 +1,5 @@
+tags
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/.rvmrc

@@ -0,0 +1 @@
+rvm use 1.9.3@githubris --create

data/Gemfile

@@ -0,0 +1,11 @@
+source "http://rubygems.org"
+
+group :development, :test do
+  gem 'cucumber'
+  gem 'rspec', '~> 2.8.0'
+  gem 'rspec-spies'
+  gem 'fakeweb'
+  gem 'pry'
+  gem 'pry-doc'
+end
+gemspec

data/README.md

@@ -0,0 +1,3 @@
+#Githubris
+
+This is the best github API wrapper ever.

data/Rakefile

@@ -0,0 +1,8 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new :spec do |t|
+  t.rspec_opts = "--color --format=documentation"
+end
+
+task :default => :spec

data/config/base.yml

@@ -0,0 +1 @@
+base_uri: 'https://api.github.com'

data/config/gists.yml

@@ -0,0 +1,13 @@
+gists:
+  list_public_user:
+    method: 'get'
+    path: '/users/:user/gists'
+  list_public:
+    method: 'get'
+    path: '/gists'
+  list_authentic_user:
+    method: 'get'
+    path: '/gists'
+  list_authentic_user_starred:
+    method: 'get'
+    path: '/gists/starred'

data/config.yml

@@ -0,0 +1 @@
+base_uri: 'https://api.github.com/'

data/githubris.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+$:.push File.expand_path("../config", __FILE__)
+require "githubris/version"
+
+Gem::Specification.new do |s|
+  s.name        = "githubris"
+  s.version     = Githubris::VERSION
+  s.authors     = ["Isaac Sanders"]
+  s.email       = ["isaac@isaacbfsanders.com"]
+  s.homepage    = "http://isaacbfsanders.com/githubris"
+  s.summary     = %q{Githubris is meant to make Github API interaction a breeze.}
+  s.description = %q{Githubris is meant to make Github API interaction a breeze.}
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_dependency('httparty', '~> 0.8.1')
+end

data/lib/githubris/api.rb

@@ -0,0 +1,26 @@
+require 'httparty'
+
+module Githubris
+  class API
+    include HTTParty
+    base_uri(Githubris::Config[:base_uri])
+
+    def self.call(data, *args)
+
+      options = {data: data}
+      unless args.empty?
+        options.merge! args.inject(Githubris::Config) {|config, key|
+          config[key]
+        }
+      end
+      Githubris::API.resolve options
+    end
+
+    def self.resolve options
+      method = options[:method].intern
+      path = URI.parse(options[:path])
+      puts "#{method} #{path}"
+      Githubris::API.send(method, path)
+    end
+  end
+end

data/lib/githubris/builder.rb

@@ -0,0 +1,26 @@
+module Githubris
+  class GistBuilder
+    class << self
+      def build data
+        return data if data.instance_of? Githubris::Gist
+        if data.instance_of? Array
+          data.map do |gist_data|
+            self.build gist_data
+          end
+        else
+          data[:user] = Githubris::User.build data.delete('user')
+          data[:public] = data.delete('public')
+          data[:description] = data.delete('description')
+          data[:files] = data.delete('files').values
+          data[:url] = URI.parse data.delete('url')
+          data[:created_at] = DateTime.parse data.delete('created_at')
+          data[:updated_at] = DateTime.parse data.delete('updated_at')
+          tmp_arr = []
+          data.delete('comments').times { tmp_arr << Githubris::Comment.new }
+          data[:comments] = tmp_arr
+          Githubris::Gist.new data
+        end
+      end
+    end
+  end
+end

data/lib/githubris/comment.rb

@@ -0,0 +1,6 @@
+module Githubris
+  class Comment
+    def self.build comment_data
+    end
+  end
+end

data/lib/githubris/config.rb

@@ -0,0 +1,13 @@
+require 'yaml'
+
+module Githubris
+  module Config
+    @@config = {}
+    @@config.merge! YAML.load_file('config/base.yml')
+    @@config.merge! YAML.load_file('config/gists.yml')
+
+    def self.[] (key)
+      @@config[key.to_s]
+    end
+  end
+end

data/lib/githubris/gist/file.rb

@@ -0,0 +1,9 @@
+module Githubris
+  class Gist
+    class File
+      def self.build data
+        new
+      end
+    end
+  end
+end

data/lib/githubris/gist.rb

@@ -0,0 +1,66 @@
+module Githubris
+  class Gist
+    autoload :File, 'githubris/gist/file'
+
+    class << self
+      def public_gists
+        Githubris::API.call(:gists, :list_public)
+      end
+
+      def default_options
+        {
+          user: Githubris.authenticated_user,
+          files: [],
+          created_at: DateTime.now,
+          updated_at: DateTime.now
+        }
+      end
+    end
+
+    def initialize options={}
+      options.merge! Githubris::Gist.default_options do |given_key, given_value|
+        if Githubris::Gist.default_options.has_key? given_key
+          given_value
+        end
+      end
+
+      @options = options
+    end
+
+    def user
+      @options[:user]
+    end
+
+    def created_at
+      @options[:created_at]
+    end
+
+    def updated_at
+      @options[:updated_at]
+    end
+
+    def description
+      @options[:description]
+    end
+
+    def files
+      @options[:files]
+    end
+
+    def url
+      @options[:url]
+    end
+
+    def save
+      Githubris::API.save_gist(self)
+    end
+
+    def public?
+      @options[:public]
+    end
+
+    def comments
+      @options[:comments]
+    end
+  end
+end

data/lib/githubris/issue.rb

@@ -0,0 +1,6 @@
+module Githubris
+  class Issue
+    autoload :Label, 'githubris/issue/label'
+    autoload :Milestone, 'githubris/issue/milestone'
+  end
+end

data/lib/githubris/organization.rb

@@ -0,0 +1,5 @@
+module Githubris
+  class Organization
+    autoload :Team, 'githubris/organization/team'
+  end
+end

data/lib/githubris/repository.rb

@@ -0,0 +1,7 @@
+module Githubris
+  class Repository
+    autoload :Download, 'githubris/repository/download'
+    autoload :Fork, 'githubris/repository/fork'
+    autoload :Hook, 'githubris/repository/hook'
+  end
+end

data/lib/githubris/user.rb

@@ -0,0 +1,11 @@
+module Githubris
+  class User
+    def self.build user_data
+      if user_data.instance_of? Githubris::User
+        return user_data
+      else
+        self.new
+      end
+    end
+  end
+end

data/lib/githubris/version.rb

@@ -0,0 +1,3 @@
+module Githubris
+  VERSION = "0.0.1"
+end

data/lib/githubris.rb

@@ -0,0 +1,38 @@
+$:.push File.expand_path("../../config", __FILE__)
+require_relative "githubris/version"
+
+module Githubris
+  autoload :API, 'githubris/api'
+  autoload :Blob, 'githubris/blob'
+  autoload :Comment, 'githubris/comment'
+  autoload :Commit, 'githubris/commit'
+  autoload :Config, 'githubris/config'
+  autoload :Event, 'githubris/event'
+  autoload :Gist, 'githubris/gist'
+  autoload :Issue, 'githubris/issue'
+  autoload :Organization, 'githubris/organization'
+  autoload :PullRequest, 'githubris/pull_request'
+  autoload :Reference, 'githubris/reference'
+  autoload :Repository, 'githubris/repository'
+  autoload :Tag, 'githubris/tag'
+  autoload :Tree, 'githubris/tree'
+  autoload :User, 'githubris/user'
+
+  class << self
+    def login(user_name, api_key)
+      @@authenticated_user = Githubris::User.new
+    end
+
+    def logout
+      @@authenticated_user = nil
+    end
+
+    def authenticated_user
+      begin
+        @@authenticated_user
+      rescue
+        nil
+      end
+    end
+  end
+end

data/spec/githubris/api_spec.rb

@@ -0,0 +1,30 @@
+require 'spec_helper'
+
+describe Githubris::API do
+  describe 'making calls' do
+    subject { Githubris::API }
+
+    before do
+      Githubris::API.stub(:resolve)
+    end
+
+    it 'takes a single required data requirement' do
+      lambda { subject.call({}) }.should_not raise_error
+    end
+
+    it 'takes multiple arguments' do
+      Githubris::Config.stub(:[] => {:bar => {:baz => {}}})
+      lambda {
+        subject.call({}, :foo)
+        subject.call({}, :foo, :bar)
+        subject.call({}, :foo, :bar, :baz)
+      }.should_not raise_error
+    end
+
+    it 'uses the config' do
+      Githubris::Config.stub(:[] => {})
+      subject.call({}, :foo)
+      Githubris::Config.should have_received(:[]).with(:foo)
+    end
+  end
+end

data/spec/githubris/builder_spec.rb

@@ -0,0 +1,54 @@
+require 'githubris/builder'
+require 'spec_helper'
+
+describe Githubris::GistBuilder do
+  describe 'build' do
+    let(:gist_data) { Githubris::SpecHelper.gist_data }
+
+    context 'when passed a collection of gist data' do
+      subject do
+        Githubris::GistBuilder.build Githubris::SpecHelper.gist_collection_data
+      end
+
+      it { should be_instance_of Array }
+
+      it 'is an array of gists' do
+        subject.each do |gist|
+          gist.should be_instance_of Githubris::Gist
+        end
+      end
+    end
+
+    context 'when passed the data for a single gist' do
+      subject { Githubris::GistBuilder.build gist_data }
+
+      it                { should be_instance_of Githubris::Gist }
+      it                { should be_public }
+      its(:user)        { should be_instance_of Githubris::User }
+      its(:description) { should be_instance_of String }
+      its(:created_at)  { should be_instance_of DateTime }
+      its(:updated_at)  { should be_instance_of DateTime }
+      its(:comments)    { should be_instance_of Array }
+      its(:files)       { should be_instance_of Array }
+      its(:url)         { should be_kind_of URI }
+    end
+
+    context 'when passed a specific gist' do
+      subject { Githubris::GistBuilder.build gist_data }
+
+      it 'is public' do
+        subject.should be_public
+      end
+
+      its(:description) { should eql 'the meaning of gist' }
+
+      it 'was created at 6:17:13 on July 15, 2008' do
+        subject.created_at.should eql DateTime.new(2008, 7, 15, 18, 17, 13)
+      end
+
+      it 'was updated at 2:58:22 on Feburary 22, 2011' do
+        subject.updated_at.should eql DateTime.new(2011, 2, 22, 2, 58, 22)
+      end
+    end
+  end
+end

data/spec/githubris/gist_spec.rb

@@ -0,0 +1,63 @@
+require 'spec_helper'
+
+describe Githubris::Gist do
+  describe '.public_gists' do
+    context 'when there are a few gists' do
+      it 'is an array of gists' do
+        Githubris::API.stub(:call => [Githubris::Gist.new, Githubris::Gist.new])
+        Githubris::Gist.public_gists.each do |gist|
+          gist.should be_instance_of Githubris::Gist
+        end
+      end
+    end
+  end
+
+  context 'instance methods' do
+    subject { gist }
+    let(:gist) { Githubris::Gist.new }
+
+    it 'new gists are created now' do
+      DateTime.stub(:now => DateTime.new(2012, 12, 21, 12, 0, 0))
+      gist.created_at.should eql DateTime.now
+    end
+    context "with a user is authenticated" do
+      it 'new gists belong to the authenticated user' do
+        Githubris.stub(:authenticated_user => Githubris::User.new )
+        gist.user.should eql Githubris.authenticated_user
+      end
+    end
+
+    context 'with no authenticated user' do
+      it 'is nil' do
+        gist.user.should be_nil
+      end
+    end
+
+    context 'Gist owned by Isaac' do
+      subject { Githubris::Gist.new user: user }
+      let(:user) { Githubris::User.new }
+      its(:user) { should eql user }
+    end
+
+
+    describe 'a gist without files' do
+      its(:files) { should be_empty }
+    end
+
+    describe 'a gist created with a file' do
+      subject do
+        Githubris::Gist.new(files: [stub])
+      end
+
+      its(:files) { should have(1).items }
+
+      describe 'saving' do
+        it 'gets sent to github' do
+          Githubris::API.stub(:save_gist)
+          subject.save
+          Githubris::API.should have_received(:save_gist).with(subject)
+        end
+      end
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,8 @@
+require 'rspec-spies'
+require 'pry'
+require 'fakeweb'
+require 'githubris'
+
+require 'support/fixtures'
+require 'support/fakeweb_responses'
+require 'support/custom_matchers'

data/spec/support/custom_matchers.rb

@@ -0,0 +1,27 @@
+RSpec::Matchers.define :be_greater_than do |first|
+  match do |actual|
+    (actual > first) && (actual < @second)
+  end
+
+  chain :but_less_than do |second|
+    @second = second
+  end
+end
+
+RSpec::Matchers.define :all do |expected|
+
+  match do |actual|
+    @actual = actual
+    @actual.all?(&@expectation)
+  end
+  chain :be_instance_of do |expected_klazz|
+    @message = "be instances of #{expected_klazz}"
+    @expectation = lambda do |actual|
+      actual.instance_of? expected_klazz
+    end
+  end
+
+  description do
+    "all #{@message}"
+  end
+end

data/spec/support/fakeweb_responses.rb

@@ -0,0 +1,61 @@
+require 'fakeweb'
+
+FakeWeb.allow_net_connect = false
+FakeWeb.register_uri(:get, 'https://api.github.com/', :body => '{}')
+FakeWeb.register_uri(:get, 'https://api.github.com/gists', :body => <<-BODY
+[
+  {
+    "url": "https://api.github.com/gists/2",
+    "id": "2",
+    "description": "description of gist number two",
+    "public": true,
+    "user": {
+      "login": "rocktocat",
+      "id": 1,
+      "avatar_url": "https://github.com/images/error/octocat_happy.gif",
+      "gravatar_id": "somehexcode",
+      "url": "https://api.github.com/users/octocat"
+    },
+    "files": {
+      "ring.erl": {
+        "size": 932,
+        "filename": "ring.erl",
+        "raw_url": "https://gist.github.com/raw/365370/8c4d2d43d178df44f4c03a7f2ac0ff512853564e/ring.erl",
+        "content": "contents of gist"
+      }
+    },
+    "comments": 0,
+    "html_url": "https://gist.github.com/1",
+    "git_pull_url": "git://gist.github.com/1.git",
+    "git_push_url": "git@gist.github.com:1.git",
+    "created_at": "2010-04-14T02:15:15Z"
+  },
+  {
+    "url": "https://api.github.com/gists/1",
+    "id": "1",
+    "description": "description of gist",
+    "public": true,
+    "user": {
+      "login": "octocat",
+      "id": 1,
+      "avatar_url": "https://github.com/images/error/octocat_happy.gif",
+      "gravatar_id": "somehexcode",
+      "url": "https://api.github.com/users/octocat"
+    },
+    "files": {
+      "ring.erl": {
+        "size": 932,
+        "filename": "ring.erl",
+        "raw_url": "https://gist.github.com/raw/365370/8c4d2d43d178df44f4c03a7f2ac0ff512853564e/ring.erl",
+        "content": "contents of gist"
+      }
+    },
+    "comments": 0,
+    "html_url": "https://gist.github.com/1",
+    "git_pull_url": "git://gist.github.com/1.git",
+    "git_push_url": "git@gist.github.com:1.git",
+    "created_at": "2010-04-14T02:15:15Z"
+  }
+]
+BODY
+)