hubba 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 9937213efe86ccdf1201342462c78ab41a5989ab
+  data.tar.gz: ebaa428b0f7ed4fcf42faacc3cf4246f49b82df6
+SHA512:
+  metadata.gz: 09c25c8a5f786a22639e437905f0f44223ac5722bac018243a56ab830651f3b4c6592bef0c6738cc880e5da4f720b334eabb54c0ccf0aaa6af19cae1c2bcbd6b
+  data.tar.gz: cb1f795ea7fb06f1804f1cf40350635305d22a6d96e45a3242fd477054dbdf35f86a8d74b55c8ab2755721108e884ff0b6a8505d651836a8f1a95bf85b4d3967

data/HISTORY.md

@@ -0,0 +1,4 @@
+### 0.0.1 / 2015-11-10
+
+* Everything is new. First release.
+

data/Manifest.txt

@@ -0,0 +1,13 @@
+HISTORY.md
+Manifest.txt
+README.md
+Rakefile
+lib/hubba.rb
+lib/hubba/cache.rb
+lib/hubba/client.rb
+lib/hubba/github.rb
+lib/hubba/version.rb
+test/cache/users~geraldb~orgs.json
+test/cache/users~geraldb~repos.json
+test/helper.rb
+test/test_cache.rb

data/README.md

@@ -0,0 +1,20 @@
+# hubba
+
+hubba gem - (yet) another (lite) GitHub HTTP API client / library
+
+* home  :: [github.com/rubylibs/hubba](https://github.com/rubylibs/hubba)
+* bugs  :: [github.com/rubylibs/hubba/issues](https://github.com/rubylibs/hubba/issues)
+* gem   :: [rubygems.org/gems/hubba](https://rubygems.org/gems/hubba)
+* rdoc  :: [rubydoc.info/gems/hubba](http://rubydoc.info/gems/hubba)
+
+
+## Usage
+
+TBD
+
+
+## License
+
+The `hubba` scripts are dedicated to the public domain.
+Use it as you please with no restrictions whatsoever.
+

data/Rakefile

@@ -0,0 +1,30 @@
+require 'hoe'
+require './lib/hubba/version.rb'
+
+Hoe.spec 'hubba' do
+
+  self.version = Hubba::VERSION
+
+  self.summary = 'hubba -  (yet) another (lite) GitHub HTTP API client / library'
+  self.description = summary
+
+  self.urls    = ['https://github.com/rubylibs/hubba']
+
+  self.author  = 'Gerald Bauer'
+  self.email   = 'ruby-talk@ruby-lang.org'
+
+  # switch extension to .markdown for gihub formatting
+  self.readme_file  = 'README.md'
+  self.history_file = 'HISTORY.md'
+
+  self.extra_deps = [
+    ['logutils' ],
+  ]
+
+  self.licenses = ['Public Domain']
+
+  self.spec_extras = {
+   required_ruby_version: '>= 1.9.2'
+  }
+
+end

data/lib/hubba.rb

@@ -0,0 +1,23 @@
+# encoding: utf-8
+
+require 'net/http'
+require "net/https"
+require 'uri'
+
+require 'pp'
+require 'json'
+require 'yaml'
+
+
+# 3rd party gems/libs
+require 'logutils'
+
+# our own code
+require 'hubba/version'   # note: let version always go first
+require 'hubba/cache'
+require 'hubba/client'
+require 'hubba/github'
+
+
+# say hello
+puts Hubba.banner    if defined?($RUBYLIBS_DEBUG)

data/lib/hubba/cache.rb

@@ -0,0 +1,61 @@
+# encoding: utf-8
+
+module Hubba
+
+class Cache    ## lets you work with  GitHub api "offline" using just a local cache of stored json
+
+  def initialize( dir )
+    @dir = dir
+  end
+
+  ##  fix/todo:  cut of query string e.g. ?per_page=100  why? why not?
+  def get( request_uri )
+    ## check if request_uri exists in local cache
+    basename = request_uri_to_basename( request_uri )
+    path = "#{@dir}/#{basename}.json"
+    if File.exist?( path )
+      text = File.read( path )   ## todo/fix:  use File.read_utf8
+      json = JSON.parse( text )
+    else
+      nil   ## todo/fix: raise exception - why? why not??
+    end    
+  end
+
+  def put( request_uri, obj )
+    basename = request_uri_to_basename( request_uri )
+    path = "#{@dir}/#{basename}.json"
+    
+    if obj.is_a?( Resource )  ## note: for convenience support Resource obj too  
+      data = obj.data
+    else
+      data = obj   # assume Hash or Array -- todo: add support for String - why? why not??
+    end
+
+    File.open( path, 'w' ) do |f|
+      f.write JSON.pretty_generate( data )
+    end   
+  end
+
+
+  def request_uri_to_basename( request_uri )
+    ## 1) cut off leading /
+    ## 2) convert / to ~
+    ## 3) remove (optional) query string (for now) - why? why not?
+    ##
+    ## e.g.
+    ##  '/users/geraldb'           => 'users~geraldb',
+    ##  '/users/geraldb/repos'     => 'users~geraldb~repos',
+    ##  '/users/geraldb/orgs'      => 'users~geraldb~orgs',
+    ##  '/orgs/wikiscript/repos'   => 'orgs~wikiscript~repos',
+    ##  '/orgs/planetjekyll/repos' => 'orgs~planetjekyll~repos',
+    ##  '/orgs/vienna-rb/repos'    => 'orgs~vienna~rb.repos',
+
+    basename = request_uri[1..-1]
+    basename = basename.gsub( '/', '~')
+    basename = basename.sub( /\?.*\z/, '' )    ## note: must escape ? (use \z for $)
+    basename
+  end
+
+end  ## class Cache
+
+end ## module Hubba

data/lib/hubba/client.rb

@@ -0,0 +1,46 @@
+# encoding: utf-8
+
+module Hubba
+
+
+class Client
+
+def initialize
+  uri = URI.parse( "https://api.github.com" )
+  @http = Net::HTTP.new(uri.host, uri.port)
+  @http.use_ssl = true
+  @http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+end # method initialize
+
+def get( request_uri )
+  puts "GET #{request_uri}"
+
+  req = Net::HTTP::Get.new( request_uri )
+  ## req = Net::HTTP::Get.new( "/users/geraldb" )
+  ## req = Net::HTTP::Get.new( "/users/geraldb/repos" )
+  req["User-Agent"] = "ruby/github.rb"                  ## required by GitHub API 
+  req["Accept" ]    = "application/vnd.github.v3+json"  ## recommend by GitHub API
+
+  res = @http.request(req)
+
+  # Get specific header
+  # response["content-type"]
+  # => "text/html; charset=UTF-8"
+
+  # Iterate all response headers.
+  res.each_header do |key, value|
+    p "#{key} => #{value}"
+  end
+  # => "location => http://www.google.com/"
+  # => "content-type => text/html; charset=UTF-8"
+  # ...
+
+  json = JSON.parse( res.body )
+  ## pp json
+  json
+end  # methdo get
+
+end  ## class Client
+
+
+end # module Hubba

data/lib/hubba/github.rb

@@ -0,0 +1,83 @@
+# encoding: utf-8
+
+module Hubba
+
+class Resource
+  attr_reader :data
+  def initialize( data )
+    @data = data
+  end
+end
+
+class Repos < Resource
+  def names
+    ## sort by name
+    data.map { |item| item['name'] }.sort
+  end
+end
+
+class Orgs < Resource
+  def logins
+    ## sort by name
+    data.map { |item| item['login'] }.sort
+  end
+end
+
+
+
+class Github
+
+def initialize( cache_dir: './cache' )
+   @cache  = Cache.new( cache_dir )
+   @client = Client.new
+   
+   @offline = false
+end
+
+def offline!()  @offline = true;  end   ## switch to offline  - todo: find a "better" way - why? why not?
+def offline?()  @offline; end
+
+
+def user( name )
+  Resource.new( get "/users/#{name}" )
+end
+
+
+def user_repos( name )
+  Repos.new( get "/users/#{name}/repos" )   ## add ?per_page=100 - why? why not?
+end
+
+
+##
+# note: pagination
+#  requests that return multiple items will be paginated to 30 items by default.
+#   You can specify further pages with the ?page parameter.
+# For some resources, you can also set a custom page size up to 100
+#  with the ?per_page=100 parameter
+
+def user_orgs( name )
+  Orgs.new( get "/users/#{name}/orgs?per_page=100" )
+end
+
+
+def org( name )
+  Resource.new( get "/orgs/#{name}" )
+end
+
+def org_repos( name )
+  Repos.new( get "/orgs/#{name}/repos?per_page=100" )
+end
+
+
+private
+def get( request_uri )
+  if offline?
+    @cache.get( request_uri )
+  else
+    @client.get( request_uri )
+  end
+end
+
+end  # class Github
+
+end # module Hubba

data/lib/hubba/version.rb

@@ -0,0 +1,21 @@
+# encoding: utf-8
+
+module Hubba
+  MAJOR = 0    ## todo: namespace inside version or something - why? why not??
+  MINOR = 1
+  PATCH = 0
+  VERSION = [MAJOR,MINOR,PATCH].join('.')
+
+  def self.version
+    VERSION
+  end
+
+  def self.banner
+    "hubba/#{VERSION} on Ruby #{RUBY_VERSION} (#{RUBY_RELEASE_DATE}) [#{RUBY_PLATFORM}]"
+  end
+
+  def self.root
+    "#{File.expand_path( File.dirname(File.dirname(File.dirname(__FILE__))) )}"
+  end
+end # module Hubba
+

data/test/cache/users~geraldb~orgs.json

@@ -0,0 +1,46 @@
+[
+  {
+    "login": "vienna-rb",
+    "id": 3541331,
+    "url": "https://api.github.com/orgs/vienna-rb",
+    "repos_url": "https://api.github.com/orgs/vienna-rb/repos",
+    "events_url": "https://api.github.com/orgs/vienna-rb/events",
+    "members_url": "https://api.github.com/orgs/vienna-rb/members{/member}",
+    "public_members_url": "https://api.github.com/orgs/vienna-rb/public_members{/member}",
+    "avatar_url": "https://avatars.githubusercontent.com/u/3541331?v=3",
+    "description": null
+  },
+  {
+    "login": "openbeer",
+    "id": 4464191,
+    "url": "https://api.github.com/orgs/openbeer",
+    "repos_url": "https://api.github.com/orgs/openbeer/repos",
+    "events_url": "https://api.github.com/orgs/openbeer/events",
+    "members_url": "https://api.github.com/orgs/openbeer/members{/member}",
+    "public_members_url": "https://api.github.com/orgs/openbeer/public_members{/member}",
+    "avatar_url": "https://avatars.githubusercontent.com/u/4464191?v=3",
+    "description": "Open Public Domain Beer, Brewery n Brewpub Data - Incl. The Free World Beer Book"
+  },
+  {
+    "login": "slideshow-s9",
+    "id": 4464373,
+    "url": "https://api.github.com/orgs/slideshow-s9",
+    "repos_url": "https://api.github.com/orgs/slideshow-s9/repos",
+    "events_url": "https://api.github.com/orgs/slideshow-s9/events",
+    "members_url": "https://api.github.com/orgs/slideshow-s9/members{/member}",
+    "public_members_url": "https://api.github.com/orgs/slideshow-s9/public_members{/member}",
+    "avatar_url": "https://avatars.githubusercontent.com/u/4464373?v=3",
+    "description": "Free Web Alternative to PowerPoint and Keynote Using Easy-to-Write and Easy-to-Read Plain Text Wiki-Style Markup"
+  },
+  {
+    "login": "openfootball",
+    "id": 4477026,
+    "url": "https://api.github.com/orgs/openfootball",
+    "repos_url": "https://api.github.com/orgs/openfootball/repos",
+    "events_url": "https://api.github.com/orgs/openfootball/events",
+    "members_url": "https://api.github.com/orgs/openfootball/members{/member}",
+    "public_members_url": "https://api.github.com/orgs/openfootball/public_members{/member}",
+    "avatar_url": "https://avatars.githubusercontent.com/u/4477026?v=3",
+    "description": "Open Public Domain Football Data - Incl. The Free World Football Almanac"
+  }
+]

data/test/cache/users~geraldb~repos.json

@@ -0,0 +1,263 @@
+[
+  {
+    "id": 33192631,
+    "name": "austria",
+    "full_name": "geraldb/austria",
+    "owner": {
+      "login": "geraldb",
+      "id": 53281,
+      "avatar_url": "https://avatars.githubusercontent.com/u/53281?v=3",
+      "gravatar_id": "",
+      "url": "https://api.github.com/users/geraldb",
+      "html_url": "https://github.com/geraldb",
+      "followers_url": "https://api.github.com/users/geraldb/followers",
+      "following_url": "https://api.github.com/users/geraldb/following{/other_user}",
+      "gists_url": "https://api.github.com/users/geraldb/gists{/gist_id}",
+      "starred_url": "https://api.github.com/users/geraldb/starred{/owner}{/repo}",
+      "subscriptions_url": "https://api.github.com/users/geraldb/subscriptions",
+      "organizations_url": "https://api.github.com/users/geraldb/orgs",
+      "repos_url": "https://api.github.com/users/geraldb/repos",
+      "events_url": "https://api.github.com/users/geraldb/events{/privacy}",
+      "received_events_url": "https://api.github.com/users/geraldb/received_events",
+      "type": "User",
+      "site_admin": false
+    },
+    "private": false,
+    "html_url": "https://github.com/geraldb/austria",
+    "description": "open data and scripts for austria (österreich)",
+    "fork": false,
+    "url": "https://api.github.com/repos/geraldb/austria",
+    "forks_url": "https://api.github.com/repos/geraldb/austria/forks",
+    "keys_url": "https://api.github.com/repos/geraldb/austria/keys{/key_id}",
+    "collaborators_url": "https://api.github.com/repos/geraldb/austria/collaborators{/collaborator}",
+    "teams_url": "https://api.github.com/repos/geraldb/austria/teams",
+    "hooks_url": "https://api.github.com/repos/geraldb/austria/hooks",
+    "issue_events_url": "https://api.github.com/repos/geraldb/austria/issues/events{/number}",
+    "events_url": "https://api.github.com/repos/geraldb/austria/events",
+    "assignees_url": "https://api.github.com/repos/geraldb/austria/assignees{/user}",
+    "branches_url": "https://api.github.com/repos/geraldb/austria/branches{/branch}",
+    "tags_url": "https://api.github.com/repos/geraldb/austria/tags",
+    "blobs_url": "https://api.github.com/repos/geraldb/austria/git/blobs{/sha}",
+    "git_tags_url": "https://api.github.com/repos/geraldb/austria/git/tags{/sha}",
+    "git_refs_url": "https://api.github.com/repos/geraldb/austria/git/refs{/sha}",
+    "trees_url": "https://api.github.com/repos/geraldb/austria/git/trees{/sha}",
+    "statuses_url": "https://api.github.com/repos/geraldb/austria/statuses/{sha}",
+    "languages_url": "https://api.github.com/repos/geraldb/austria/languages",
+    "stargazers_url": "https://api.github.com/repos/geraldb/austria/stargazers",
+    "contributors_url": "https://api.github.com/repos/geraldb/austria/contributors",
+    "subscribers_url": "https://api.github.com/repos/geraldb/austria/subscribers",
+    "subscription_url": "https://api.github.com/repos/geraldb/austria/subscription",
+    "commits_url": "https://api.github.com/repos/geraldb/austria/commits{/sha}",
+    "git_commits_url": "https://api.github.com/repos/geraldb/austria/git/commits{/sha}",
+    "comments_url": "https://api.github.com/repos/geraldb/austria/comments{/number}",
+    "issue_comment_url": "https://api.github.com/repos/geraldb/austria/issues/comments{/number}",
+    "contents_url": "https://api.github.com/repos/geraldb/austria/contents/{+path}",
+    "compare_url": "https://api.github.com/repos/geraldb/austria/compare/{base}...{head}",
+    "merges_url": "https://api.github.com/repos/geraldb/austria/merges",
+    "archive_url": "https://api.github.com/repos/geraldb/austria/{archive_format}{/ref}",
+    "downloads_url": "https://api.github.com/repos/geraldb/austria/downloads",
+    "issues_url": "https://api.github.com/repos/geraldb/austria/issues{/number}",
+    "pulls_url": "https://api.github.com/repos/geraldb/austria/pulls{/number}",
+    "milestones_url": "https://api.github.com/repos/geraldb/austria/milestones{/number}",
+    "notifications_url": "https://api.github.com/repos/geraldb/austria/notifications{?since,all,participating}",
+    "labels_url": "https://api.github.com/repos/geraldb/austria/labels{/name}",
+    "releases_url": "https://api.github.com/repos/geraldb/austria/releases{/id}",
+    "created_at": "2015-03-31T15:16:05Z",
+    "updated_at": "2015-03-31T21:03:02Z",
+    "pushed_at": "2015-03-31T21:03:02Z",
+    "git_url": "git://github.com/geraldb/austria.git",
+    "ssh_url": "git@github.com:geraldb/austria.git",
+    "clone_url": "https://github.com/geraldb/austria.git",
+    "svn_url": "https://github.com/geraldb/austria",
+    "homepage": null,
+    "size": 552,
+    "stargazers_count": 1,
+    "watchers_count": 1,
+    "language": "Ruby",
+    "has_issues": true,
+    "has_downloads": true,
+    "has_wiki": false,
+    "has_pages": false,
+    "forks_count": 0,
+    "mirror_url": null,
+    "open_issues_count": 0,
+    "forks": 0,
+    "open_issues": 0,
+    "watchers": 1,
+    "default_branch": "master"
+  },
+  {
+    "id": 31158327,
+    "name": "auto",
+    "full_name": "geraldb/auto",
+    "owner": {
+      "login": "geraldb",
+      "id": 53281,
+      "avatar_url": "https://avatars.githubusercontent.com/u/53281?v=3",
+      "gravatar_id": "",
+      "url": "https://api.github.com/users/geraldb",
+      "html_url": "https://github.com/geraldb",
+      "followers_url": "https://api.github.com/users/geraldb/followers",
+      "following_url": "https://api.github.com/users/geraldb/following{/other_user}",
+      "gists_url": "https://api.github.com/users/geraldb/gists{/gist_id}",
+      "starred_url": "https://api.github.com/users/geraldb/starred{/owner}{/repo}",
+      "subscriptions_url": "https://api.github.com/users/geraldb/subscriptions",
+      "organizations_url": "https://api.github.com/users/geraldb/orgs",
+      "repos_url": "https://api.github.com/users/geraldb/repos",
+      "events_url": "https://api.github.com/users/geraldb/events{/privacy}",
+      "received_events_url": "https://api.github.com/users/geraldb/received_events",
+      "type": "User",
+      "site_admin": false
+    },
+    "private": false,
+    "html_url": "https://github.com/geraldb/auto",
+    "description": "auto - scripts to automate building databases, books, etc.",
+    "fork": false,
+    "url": "https://api.github.com/repos/geraldb/auto",
+    "forks_url": "https://api.github.com/repos/geraldb/auto/forks",
+    "keys_url": "https://api.github.com/repos/geraldb/auto/keys{/key_id}",
+    "collaborators_url": "https://api.github.com/repos/geraldb/auto/collaborators{/collaborator}",
+    "teams_url": "https://api.github.com/repos/geraldb/auto/teams",
+    "hooks_url": "https://api.github.com/repos/geraldb/auto/hooks",
+    "issue_events_url": "https://api.github.com/repos/geraldb/auto/issues/events{/number}",
+    "events_url": "https://api.github.com/repos/geraldb/auto/events",
+    "assignees_url": "https://api.github.com/repos/geraldb/auto/assignees{/user}",
+    "branches_url": "https://api.github.com/repos/geraldb/auto/branches{/branch}",
+    "tags_url": "https://api.github.com/repos/geraldb/auto/tags",
+    "blobs_url": "https://api.github.com/repos/geraldb/auto/git/blobs{/sha}",
+    "git_tags_url": "https://api.github.com/repos/geraldb/auto/git/tags{/sha}",
+    "git_refs_url": "https://api.github.com/repos/geraldb/auto/git/refs{/sha}",
+    "trees_url": "https://api.github.com/repos/geraldb/auto/git/trees{/sha}",
+    "statuses_url": "https://api.github.com/repos/geraldb/auto/statuses/{sha}",
+    "languages_url": "https://api.github.com/repos/geraldb/auto/languages",
+    "stargazers_url": "https://api.github.com/repos/geraldb/auto/stargazers",
+    "contributors_url": "https://api.github.com/repos/geraldb/auto/contributors",
+    "subscribers_url": "https://api.github.com/repos/geraldb/auto/subscribers",
+    "subscription_url": "https://api.github.com/repos/geraldb/auto/subscription",
+    "commits_url": "https://api.github.com/repos/geraldb/auto/commits{/sha}",
+    "git_commits_url": "https://api.github.com/repos/geraldb/auto/git/commits{/sha}",
+    "comments_url": "https://api.github.com/repos/geraldb/auto/comments{/number}",
+    "issue_comment_url": "https://api.github.com/repos/geraldb/auto/issues/comments{/number}",
+    "contents_url": "https://api.github.com/repos/geraldb/auto/contents/{+path}",
+    "compare_url": "https://api.github.com/repos/geraldb/auto/compare/{base}...{head}",
+    "merges_url": "https://api.github.com/repos/geraldb/auto/merges",
+    "archive_url": "https://api.github.com/repos/geraldb/auto/{archive_format}{/ref}",
+    "downloads_url": "https://api.github.com/repos/geraldb/auto/downloads",
+    "issues_url": "https://api.github.com/repos/geraldb/auto/issues{/number}",
+    "pulls_url": "https://api.github.com/repos/geraldb/auto/pulls{/number}",
+    "milestones_url": "https://api.github.com/repos/geraldb/auto/milestones{/number}",
+    "notifications_url": "https://api.github.com/repos/geraldb/auto/notifications{?since,all,participating}",
+    "labels_url": "https://api.github.com/repos/geraldb/auto/labels{/name}",
+    "releases_url": "https://api.github.com/repos/geraldb/auto/releases{/id}",
+    "created_at": "2015-02-22T09:27:17Z",
+    "updated_at": "2015-04-06T14:16:32Z",
+    "pushed_at": "2015-04-06T14:16:32Z",
+    "git_url": "git://github.com/geraldb/auto.git",
+    "ssh_url": "git@github.com:geraldb/auto.git",
+    "clone_url": "https://github.com/geraldb/auto.git",
+    "svn_url": "https://github.com/geraldb/auto",
+    "homepage": null,
+    "size": 288,
+    "stargazers_count": 1,
+    "watchers_count": 1,
+    "language": "Ruby",
+    "has_issues": true,
+    "has_downloads": true,
+    "has_wiki": false,
+    "has_pages": false,
+    "forks_count": 0,
+    "mirror_url": null,
+    "open_issues_count": 0,
+    "forks": 0,
+    "open_issues": 0,
+    "watchers": 1,
+    "default_branch": "master"
+  },
+  {
+    "id": 33404369,
+    "name": "backup",
+    "full_name": "geraldb/backup",
+    "owner": {
+      "login": "geraldb",
+      "id": 53281,
+      "avatar_url": "https://avatars.githubusercontent.com/u/53281?v=3",
+      "gravatar_id": "",
+      "url": "https://api.github.com/users/geraldb",
+      "html_url": "https://github.com/geraldb",
+      "followers_url": "https://api.github.com/users/geraldb/followers",
+      "following_url": "https://api.github.com/users/geraldb/following{/other_user}",
+      "gists_url": "https://api.github.com/users/geraldb/gists{/gist_id}",
+      "starred_url": "https://api.github.com/users/geraldb/starred{/owner}{/repo}",
+      "subscriptions_url": "https://api.github.com/users/geraldb/subscriptions",
+      "organizations_url": "https://api.github.com/users/geraldb/orgs",
+      "repos_url": "https://api.github.com/users/geraldb/repos",
+      "events_url": "https://api.github.com/users/geraldb/events{/privacy}",
+      "received_events_url": "https://api.github.com/users/geraldb/received_events",
+      "type": "User",
+      "site_admin": false
+    },
+    "private": false,
+    "html_url": "https://github.com/geraldb/backup",
+    "description": "backup - scripts to backup repos, etc.",
+    "fork": false,
+    "url": "https://api.github.com/repos/geraldb/backup",
+    "forks_url": "https://api.github.com/repos/geraldb/backup/forks",
+    "keys_url": "https://api.github.com/repos/geraldb/backup/keys{/key_id}",
+    "collaborators_url": "https://api.github.com/repos/geraldb/backup/collaborators{/collaborator}",
+    "teams_url": "https://api.github.com/repos/geraldb/backup/teams",
+    "hooks_url": "https://api.github.com/repos/geraldb/backup/hooks",
+    "issue_events_url": "https://api.github.com/repos/geraldb/backup/issues/events{/number}",
+    "events_url": "https://api.github.com/repos/geraldb/backup/events",
+    "assignees_url": "https://api.github.com/repos/geraldb/backup/assignees{/user}",
+    "branches_url": "https://api.github.com/repos/geraldb/backup/branches{/branch}",
+    "tags_url": "https://api.github.com/repos/geraldb/backup/tags",
+    "blobs_url": "https://api.github.com/repos/geraldb/backup/git/blobs{/sha}",
+    "git_tags_url": "https://api.github.com/repos/geraldb/backup/git/tags{/sha}",
+    "git_refs_url": "https://api.github.com/repos/geraldb/backup/git/refs{/sha}",
+    "trees_url": "https://api.github.com/repos/geraldb/backup/git/trees{/sha}",
+    "statuses_url": "https://api.github.com/repos/geraldb/backup/statuses/{sha}",
+    "languages_url": "https://api.github.com/repos/geraldb/backup/languages",
+    "stargazers_url": "https://api.github.com/repos/geraldb/backup/stargazers",
+    "contributors_url": "https://api.github.com/repos/geraldb/backup/contributors",
+    "subscribers_url": "https://api.github.com/repos/geraldb/backup/subscribers",
+    "subscription_url": "https://api.github.com/repos/geraldb/backup/subscription",
+    "commits_url": "https://api.github.com/repos/geraldb/backup/commits{/sha}",
+    "git_commits_url": "https://api.github.com/repos/geraldb/backup/git/commits{/sha}",
+    "comments_url": "https://api.github.com/repos/geraldb/backup/comments{/number}",
+    "issue_comment_url": "https://api.github.com/repos/geraldb/backup/issues/comments{/number}",
+    "contents_url": "https://api.github.com/repos/geraldb/backup/contents/{+path}",
+    "compare_url": "https://api.github.com/repos/geraldb/backup/compare/{base}...{head}",
+    "merges_url": "https://api.github.com/repos/geraldb/backup/merges",
+    "archive_url": "https://api.github.com/repos/geraldb/backup/{archive_format}{/ref}",
+    "downloads_url": "https://api.github.com/repos/geraldb/backup/downloads",
+    "issues_url": "https://api.github.com/repos/geraldb/backup/issues{/number}",
+    "pulls_url": "https://api.github.com/repos/geraldb/backup/pulls{/number}",
+    "milestones_url": "https://api.github.com/repos/geraldb/backup/milestones{/number}",
+    "notifications_url": "https://api.github.com/repos/geraldb/backup/notifications{?since,all,participating}",
+    "labels_url": "https://api.github.com/repos/geraldb/backup/labels{/name}",
+    "releases_url": "https://api.github.com/repos/geraldb/backup/releases{/id}",
+    "created_at": "2015-04-04T12:14:24Z",
+    "updated_at": "2015-06-28T11:55:10Z",
+    "pushed_at": "2015-11-10T08:58:28Z",
+    "git_url": "git://github.com/geraldb/backup.git",
+    "ssh_url": "git@github.com:geraldb/backup.git",
+    "clone_url": "https://github.com/geraldb/backup.git",
+    "svn_url": "https://github.com/geraldb/backup",
+    "homepage": null,
+    "size": 184,
+    "stargazers_count": 1,
+    "watchers_count": 1,
+    "language": "Ruby",
+    "has_issues": true,
+    "has_downloads": true,
+    "has_wiki": true,
+    "has_pages": false,
+    "forks_count": 0,
+    "mirror_url": null,
+    "open_issues_count": 0,
+    "forks": 0,
+    "open_issues": 0,
+    "watchers": 1,
+    "default_branch": "master"
+  }
+]

data/test/helper.rb

@@ -0,0 +1,9 @@
+# encoding: utf-8
+
+# minitest setup
+require 'minitest/autorun'
+
+
+## our own code
+require 'hubba'
+

data/test/test_cache.rb

@@ -0,0 +1,46 @@
+# encoding: utf-8
+
+###
+#  to run use
+#     ruby -I ./lib -I ./test test/test_cache.rb
+
+
+require 'helper'
+
+
+class TestCache < MiniTest::Test
+
+  def setup
+    @cache = Hubba::Cache.new( "#{Hubba.root}/test/cache" )
+  end
+
+  def test_basename
+    mappings = [['/users/geraldb',                    'users~geraldb'],
+                ['/users/geraldb/repos',              'users~geraldb~repos'],
+                ['/users/geraldb/repos?per_page=100', 'users~geraldb~repos'],
+                ['/users/geraldb/orgs',               'users~geraldb~orgs'],
+                ['/users/geraldb/orgs?per_page=100',  'users~geraldb~orgs'],
+                ['/orgs/wikiscript/repos',            'orgs~wikiscript~repos'],
+                ['/orgs/planetjekyll/repos',          'orgs~planetjekyll~repos'],
+                ['/orgs/vienna-rb/repos',             'orgs~vienna-rb~repos']]
+
+    mappings.each do |mapping|
+      assert_equal mapping[1], @cache.request_uri_to_basename( mapping[0] )
+    end
+  end  # method test_basename
+
+  def test_cache
+     orgs  = @cache.get( '/users/geraldb/orgs' )
+     assert_equal 4, orgs.size
+     
+     repos = @cache.get( '/users/geraldb/repos' )
+     assert_equal 3, repos.size
+  end  # method test_cache
+
+  def test_cache_miss
+     assert_equal nil, @cache.get( '/test/hello' )
+     assert_equal nil, @cache.get( '/test/hola' )
+  end  # method test_cache_miss
+
+end # class TestCache
+

metadata

@@ -0,0 +1,103 @@
+--- !ruby/object:Gem::Specification
+name: hubba
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Gerald Bauer
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-11-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: logutils
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: hoe
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.14'
+description: hubba -  (yet) another (lite) GitHub HTTP API client / library
+email: ruby-talk@ruby-lang.org
+executables: []
+extensions: []
+extra_rdoc_files:
+- HISTORY.md
+- Manifest.txt
+- README.md
+files:
+- HISTORY.md
+- Manifest.txt
+- README.md
+- Rakefile
+- lib/hubba.rb
+- lib/hubba/cache.rb
+- lib/hubba/client.rb
+- lib/hubba/github.rb
+- lib/hubba/version.rb
+- test/cache/users~geraldb~orgs.json
+- test/cache/users~geraldb~repos.json
+- test/helper.rb
+- test/test_cache.rb
+homepage: https://github.com/rubylibs/hubba
+licenses:
+- Public Domain
+metadata: {}
+post_install_message: 
+rdoc_options:
+- "--main"
+- README.md
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.9.2
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.3
+signing_key: 
+specification_version: 4
+summary: hubba -  (yet) another (lite) GitHub HTTP API client / library
+test_files: []