bucketface2 0.4.0

data/.gitignore

@@ -0,0 +1,5 @@
+
+*.swp
+pkg/*
+*.gem
+.bundle

data/.rvmrc

@@ -0,0 +1 @@
+rvm 1.9.2@bucketface --create

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in bucketface.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,38 @@
+PATH
+  remote: .
+  specs:
+    bucketface (0.3.1)
+      hashie (~> 0.3.0)
+      httparty (~> 0.6.1)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    crack (0.1.8)
+    diff-lcs (1.1.3)
+    fakeweb (1.3.0)
+    hashie (0.3.1)
+    httparty (0.6.1)
+      crack (= 0.1.8)
+    jnunemaker-matchy (0.4.0)
+    mocha (0.9.10)
+      rake
+    rake (0.8.7)
+    rspec (2.11.0)
+      rspec-core (~> 2.11.0)
+      rspec-expectations (~> 2.11.0)
+      rspec-mocks (~> 2.11.0)
+    rspec-core (2.11.1)
+    rspec-expectations (2.11.1)
+      diff-lcs (~> 1.1.3)
+    rspec-mocks (2.11.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bucketface!
+  fakeweb (~> 1.3)
+  jnunemaker-matchy (~> 0.4.0)
+  mocha (~> 0.9)
+  rspec (~> 2.11)

data/README.markdown

@@ -0,0 +1,69 @@
+# bucketface
+
+Simple Ruby wrapper for the Bitbucket API. (This code is based on octopussy)
+
+## Installation
+
+    sudo gem install bucketface
+
+## Some examples
+
+### Show a user
+
+    Bucketface.user('cored')
+    <#Hashie::Mash first_name="Rafael" last_name="George" resource_uri="/1.0/users/cored/" username="cored">
+
+### Show followers for a giving user
+
+    Bucketface.followers('cored')
+    [<#Hashie::Mash _state="<django.db.models.base.ModelState object at 0x66d8590>" avatar_id=nil cname=nil differ="udiff" digest="b0634325ca1a1bb69bd227f521b9b20c" email_notifications=false feature_per_user_pricing=true id=1600 location="Denver, CO" plan_id=7 user_id=1602 website="http://www.percious.com/">, <#Hashie::Mash _state="<django.db.models.base.ModelState object at 0x66d8f90>" avatar_id=nil cname=nil differ="udiff" digest="861e1c2f15e3fc5f55b32a1e10f6ec78" email_notifications=true feature_per_user_pricing=true id=7010 location=nil plan_id=7 user_id=7012 website=nil>, <#Hashie::Mash _state="<django.db.models.base.ModelState object at 0x66d88d0>" avatar_id=nil cname=nil differ="udiff" digest="24c19e325a62a293c26c2f38ee62f6ef" email_notifications=true feature_per_user_pricing=true id=1906 location="Detroit, Michigan, USA" plan_id=7 user_id=1908 website="http://lost-theory.org/">]
+
+### Working with repositories
+
+Methods that require a repo argument may be passed in any of the following forms
+
+* "cored/test-repo"
+* {:username => 'cored', :name => 'test-repo'}
+* {:username => 'cored', :repo => 'test-repo'}
+* instance of Repo
+
+### Show a repo
+
+    Bucketface.repo("cored/test-repo")
+    <#Hashie::Mash description="Testing ticketmaster with this repo" followers_count=1 name="test-repo" slug="test-repo" website="">
+
+## Authenticated requests
+
+Some methods require authentication so you'll need to pass a login and a password.
+
+    client = Bucketface::Client.new(:login => 'cored', :password => 'hithere')
+    client.open_issue('cored/test-repo', 'testing', 'testing')
+
+## TODO
+
+* Add documentation to all classes
+* Functionality for the following API resources
+  * Privileges
+  * Wiki
+  * Source
+* Create examples
+* Refactor code to abstract functionality from client class
+* Add bad response handling
+
+## Note on Patches/Pull requests
+
+* Fork the project
+* Make your feature addition or bug fix
+* Add tests for it. This is important so I don't break it in a future version unintentionally
+* Commit, do not mess with rakefile, version, or history
+  (if you want to have your own version, that is fine but bump version in a commit by itself 
+  I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+## Credits
+
+Bucketface is based and inspired by [Octopussy](http://github.com/pengwynn/octopussy)
+
+## Copyright
+
+Copyright (c) 2010 [Rafael George](http://bandw.tumblr.com)

data/Rakefile

@@ -0,0 +1,8 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new
+
+task :default => :spec
+task :test => :spec
+

data/bucketface.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "bucketface/version"
+
+Gem::Specification.new do |s|
+  s.name        = "bucketface2"
+  s.version     = Bucketface::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Rafael George", "Jon Willis"]
+  s.email       = ["george.rafael@gmail.com", "jondwillis@gmail.com"]
+  s.homepage    = ""
+  s.summary     = %q{Provides a wrapper for Bitbucket API}
+  s.description = %q{Provides a wrapper for Bitbucket API}
+
+  s.rubyforge_project = "bucketface2"
+
+  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_development_dependency('fakeweb', '~> 1.3')
+  s.add_development_dependency('jnunemaker-matchy', '~> 0.4.0')
+  s.add_development_dependency('mocha', '~> 0.9')
+  s.add_development_dependency('rspec', '~> 2.11')
+  s.add_runtime_dependency('hashie', '~> 0.3.0')
+  s.add_runtime_dependency('httparty', '~> 0.6.1')
+end

data/changelog.markdown

@@ -0,0 +1,11 @@
+# Changelog
+## 0.3.1
+  * Fixed close issue method it was deleting the issue 
+  * Fixed opening of issue it was not creating it as new
+  * Added a class api method to extract current state of the client data
+## 0.2.1
+  * Downgrade version of Hashie to 0.3.0 it wasn't compatible with ticketmaster
+## 0.1.1
+  * Started the use of the Repository class 
+## 0.0.1 Initial version
+  * Bitbucket API 

data/lib/bucketface/client.rb

@@ -0,0 +1,136 @@
+module Bucketface
+  class Client
+    include HTTParty 
+    format :json
+    base_uri "https://api.bitbucket.org/1.0"
+
+    attr_reader :login 
+
+    def initialize(auth={})
+      if auth[:password].nil?
+        @login = auth[:login]
+        @token = auth[:token]
+        self.class.basic_auth(nil, nil)
+      else
+        @login = auth[:login]
+        self.class.basic_auth(@login, auth[:password])
+      end
+      @@api = self
+    end
+
+    def self.api
+      @@api
+    end
+
+    def user(login=self.login)
+      get("/users/#{login}/").user
+    end
+
+    def followers(login=self.login)
+      get("/users/#{login}/followers/").followers
+    end
+
+    def repo_followers(repo)
+      repo = Repository.new(repo)
+      get("/repositories/#{repo.user}/#{repo}/followers/").followers
+    end
+
+    def issue_followers(repo, id)
+      repo = Repository.new(repo)
+      get("/repositories/#{repo.user}/#{repo}/issues/#{id}/followers/").followers
+    end
+
+    def issues(repo)
+      repo = Repository.new(repo)
+      get("/repositories/#{repo.user}/#{repo}/issues/").issues
+    end
+
+    def issue(repo, id)
+      repo = Repository.new(repo)
+      get("/repositories/#{repo.user}/#{repo}/issues/#{id}/")
+    end
+
+    def repo(repo)
+      repo = Repository.new(repo)
+      get("/repositories/#{repo.user}/#{repo}/")
+    end
+
+    def list_repos(login=self.login)
+      get("/users/#{login}/").repositories
+    end
+
+    def branches(repo)
+      repo = Repository.new(repo)
+      get("/repositories/#{repo.user}/#{repo}/branches/")
+    end
+
+    def tags(repo)
+      repo = Repository.new(repo)
+      get("/repositories/#{repo.user}/#{repo}/tags/")
+    end
+
+    def open_issue(repo, title, body)
+      rep = Repository.new(repo)
+      post("/repositories/#{rep.user}/#{rep}/issues/", :body => {:title => title, :content => body, :status => 'new'})
+    end
+
+    def delete_issue(repo, id)
+      repo = Repository.new(repo)
+      delete("/repositories/#{repo.user}/#{repo}/issues/#{id}/")
+    end
+
+    def changesets(repo)
+      repo = Repository.new(repo)
+      get_resource("/repositories/#{repo.user}/#{repo}/changesets/").changesets
+    end
+
+    def changeset(repo, changeset)
+      repo = Repository.new(repo)
+      get("/repositories/#{repo.user}/#{repo}/changesets/#{changeset}/")
+    end
+
+    def events(login=self.login)
+      get("/users/#{login}/events/").events
+    end
+    
+    def repo_events(repo)
+      repo = Repository.new(repo)
+      get("/repositories/#{repo.user}/#{repo}/events/").events
+    end
+
+    def groups(login=self.login)
+      get("/groups/{login}/")
+    end
+
+    private
+    def get(path, options = {})
+      Hashie::Mash.new(self.class.get(path, options))
+    end
+
+    def post(path, options = {})
+      Hashie::Mash.new(self.class.post(path, options))
+    end
+
+    def delete(path, options = {})
+      self.class.delete(path, options)
+    end
+
+    def get_resource(path, options ={})
+      get(path, {:query => options})
+    end
+
+    def post_resource(path, options = {})
+      post(path, options)
+    end
+
+    def self.delete(*args); handle_response super end
+
+    def self.handle_response(response)
+      case response.code
+      when 204        then return "Success!"
+      else
+        response
+      end
+    end
+  end
+end

data/lib/bucketface/repository.rb

@@ -0,0 +1,28 @@
+module Bucketface
+  class Repository
+    attr_accessor :username, :name
+
+    def initialize(repo)
+      case repo
+      when String
+        repo = repo.split("/")
+        @name = repo.pop
+        @username = repo.pop
+      when Repository
+        @username = repo.username
+        @name = repo.name
+      when Hash
+        @name = repo[:repo] ||= repo[:name]
+        @username = repo[:username] ||= repo[:user] 
+      end
+    end
+
+    def user
+      @username
+    end
+
+    def to_s
+      @name
+    end
+  end
+end

data/lib/bucketface/version.rb

@@ -0,0 +1,3 @@
+module Bucketface
+  VERSION = "0.4.0"
+end

data/lib/bucketface.rb

@@ -0,0 +1,41 @@
+require 'forwardable'
+
+require 'httparty'
+require 'hashie'
+Hash.send :include, Hashie::HashExtensions
+
+libdir = File.dirname(__FILE__)
+$LOAD_PATH.unshift(libdir) unless $LOAD_PATH.include?(libdir)
+
+require 'bucketface/repository'
+require 'bucketface/client'
+
+module Bucketface
+  extend SingleForwardable
+
+  class BucketfaceError < StandardError
+    attr_reader :data
+
+    def initialize(data)
+      @data = data
+      super
+    end
+  end
+
+  def self.client; Client.new end
+
+  # Users
+  def_delegators :client, :user, :followers 
+
+  # Repositories
+  def_delegators :client, :repo_followers, :repo, :list_repos, :branches, :tags
+
+  # Issues
+  def_delegators :client, :issue_followers, :issues, :issue
+
+  # Changesets
+  def_delegators :client, :changesets, :changeset
+
+  # Events
+  def_delegators :client, :events, :repo_events
+end

data/test/bucketface_test.rb

@@ -0,0 +1,146 @@
+require File.expand_path(File.dirname(__FILE__)) + '/helper'
+
+class BucketfaceTest < MiniTest::Spec
+  context "when authenticated" do 
+    setup do 
+      @client = Bucketface::Client.new(:login => 'cored', :token => '2U812')
+    end
+
+    should "authenticate via basic auth" do 
+      stub_get('https://cored:2U812@api.bitbucket.org/1.0/users/cored/?', 'full_user.json')
+      client = Bucketface::Client.new(:login => 'cored', :password => '2U812')
+      user = client.user
+      user.is_private?.should == false
+    end
+
+    should "extract api from Bucketface module" do
+      stub_get('https://cored:2U812@api.bitbucket.org/1.0/users/cored/?', 'full_user.json')
+      Bucketface::Client.new(:login => 'cored', :password => '2U812')
+      api = Bucketface::Client.api
+      api.user.username.should be_eql('cored')
+    end
+
+    should "return followers for an user authenticated user" do 
+      stub_get('/users/cored/followers/?', 'followers.json')
+      followers = @client.followers
+      followers.size.should == 3
+    end
+
+    should "open an issue" do
+      stub_post('/repositories/cored/test-repo/issues/', 'open_issue.json')
+      issue = @client.open_issue({:username => 'cored', :repo => 'test-repo'}, "testing", "testing")
+      issue.title.should == "new issue"
+    end
+
+    should "delete an issue" do 
+      stub_delete('/repositories/cored/test-repo/issues/1/', 'close_issue.txt')
+      issue = @client.delete_issue({:username => 'cored', :repo => 'test-repo'}, 1)
+      issue.should == "Success!"
+    end
+
+    should "reopen an issue"
+
+    should "close an issue"
+
+  end
+
+  context "user resource" do 
+    should "return user info" do 
+      stub_get("/users/cored/", "user.json")
+      user = Bucketface.user("cored")
+      user.username.should == 'cored'
+    end
+
+    should "return followers for a user" do
+      stub_get("/users/cored/followers/", "followers.json")
+      followers = Bucketface.followers("cored")
+      followers.size.should == 3 
+    end
+  end
+
+  context "changeset resource" do 
+    should "return a list of changeset for a giving repository" do
+      stub_get("/repositories/cored/test-repo/changesets/", "changesets.json")
+      changesets = Bucketface.changesets(:username => 'cored', :repo => 'test-repo') 
+      changesets.size.should == 15
+    end
+
+    should "return an specific changeset for a giving repository" do 
+      stub_get("/repositories/cored/test-repo/changesets/fa57572a9acf/", "changeset.json")
+      changeset = Bucketface.changeset({:username => 'cored', :repo => 'test-repo'}, 'fa57572a9acf')
+      changeset.author.should == 'jespern'
+    end
+  end
+
+  context "events resource" do
+    should "return a list of events for a giving user" do
+      stub_get("/users/cored/events/", "events.json")
+      events = Bucketface.events('cored')
+      events.size.should == 5
+      events.first.repository.slug.should == 'test-repo'
+    end
+
+    should "return a list of events for a giving repository" do
+      stub_get("/repositories/cored/test-repo/events/", "repo_events.json")
+      events = Bucketface.repo_events(:username => 'cored', :repo => 'test-repo')
+      events.size.should == 6
+      events.first.repository.slug == 'test-repo'
+    end
+  end
+
+  context "repository resource" do
+    should "return list of followers for a giving repository" do
+      stub_get("/repositories/cored/test-repo/followers/", "repo_followers.json")
+      repo_followers = Bucketface.repo_followers({:user => "cored", :repo => "test-repo"})
+      repo_followers.size.should == 1
+    end
+
+    should "return repository info" do 
+      stub_get("/repositories/cored/test-repo/", "repo.json")
+      repo = Bucketface.repo(:user => "cored", :repo => "test-repo")
+      repo.name.should == "test-repo"
+    end
+
+    should "list repositories for an user" do
+      stub_get("/users/cored/", "repos.json")
+      repos = Bucketface.list_repos("cored")
+      repos.first.name.should == "test-repo"
+    end
+
+    should "list branches in a giving repo" do
+      stub_get("/repositories/cored/test-repo/branches/", "branches.json")
+      branches = Bucketface.branches(:user => "cored", :repo => "test-repo")
+      branches.size.should == 1
+      assert branches.include?("default")
+    end
+
+    should "list all the tags in a giving repo" do 
+      stub_get("/repositories/cored/test-repo/tags/", "tags.json")
+      tags = Bucketface.tags(:user => "cored", :repo => "test-repo")
+      tags.size.should == 6
+      assert tags.include?("0.6.4")
+    end
+  end
+  
+  context "issue resource" do
+    should "return the list of followers of an issue" do 
+      stub_get("/repositories/cored/test-repo/issues/1/followers/", "issue_followers.json")
+      issue_followers = Bucketface.issue_followers({:user => "cored", :repo => "test-repo"},"1")
+      issue_followers.size.should == 1
+    end
+
+    should "return the list of issues for a giving repository" do
+      stub_get("/repositories/cored/test-repo/issues/", "issues.json")
+      issues = Bucketface.issues({:user => "cored", :repo => "test-repo"})
+      issues.size.should == 2
+      issues.first.title.should == "Another issue test" 
+    end
+
+    should "return an individual issue" do 
+      stub_get("/repositories/cored/test-repo/issues/1/", "issue.json")
+      issue = Bucketface.issue({:user => "cored", :repo => "test-repo"}, "1")
+      issue.title.should == "Test issue"
+    end
+
+  end
+end

data/test/fixtures/branches.json

@@ -0,0 +1,17 @@
+{
+    "default": {
+        "node": "10c1068f1171", 
+        "files": [], 
+        "author": "elpargo", 
+        "timestamp": "2009-08-26 17:11:33", 
+        "raw_node": "10c1068f117163e7c3e98d2a461799481367b727", 
+        "parents": [
+            "041529d47395", 
+            "b119fb3263f7"
+        ], 
+        "branch": "default", 
+        "message": "- merging", 
+        "revision": 132, 
+        "size": 0
+    }
+}

data/test/fixtures/changeset.json

@@ -0,0 +1,19 @@
+{
+    "node": "fa57572a9acf", 
+    "files": [
+        {
+            "type": "modified", 
+            "file": "piston/handler.py"
+        }
+    ], 
+    "author": "jespern", 
+    "timestamp": "2009-09-09 12:55:07", 
+    "raw_node": "fa57572a9acf7b66aa66f739af6d1391075f9f21", 
+    "parents": [
+        "aaf0c2d64294"
+    ], 
+    "branch": "default", 
+    "message": "warning in case of a model being registered twice under different handlers, configurable via PISTON_IGNORE_DUPE_MODELS", 
+    "revision": 207, 
+    "size": 561
+}