hubba 0.1.2 → 0.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4a82adab1dd587bb3d9604b7ca60737747fe22f9
-  data.tar.gz: 637d4e8a7714b3a6868e070cd064ed7a9f27d233
+  metadata.gz: 84577f7d76ee6b6e2b0c1dd2c747536bede539fe
+  data.tar.gz: 9f42b72e4402d148eaccbfd635f316161a50a857
 SHA512:
-  metadata.gz: 2cef2397c74486671a6ac559e5ebe89dfe7d98efefe025c5f68694cbaa8809de279efe6bbc3aa7388426b01c198aea81214147a1f3d568ac8652d730a041e75f
-  data.tar.gz: d5b460db26d282e941292bc7c1d030a7ee9b3d98502a39f12f659517a744f55913c85f7dc5b093d9494e7124ff7ba0ba17e9406805ccfab0a8ec82c55dc9be33
+  metadata.gz: 94e26559d4d814411a5537f879f58132c906ef7a3b2f7a61cc8f83d0e5f282b143d68f37a5462e5aef5e25daa86072b40e94c1b5177ab57023b80260f503b054
+  data.tar.gz: b9f03dba1f8861edbec94fb3411b2383dc1e12744387b9c6480b43a75ee6fa7331b57d81199a084cec742f0b35abf09167409d0328fd00a7da4fe3f15343a167

data/Manifest.txt

@@ -1,4 +1,4 @@
-HISTORY.md
+CHANGELOG.md
 Manifest.txt
 README.md
 Rakefile
@@ -6,9 +6,16 @@ lib/hubba.rb
 lib/hubba/cache.rb
 lib/hubba/client.rb
 lib/hubba/github.rb
+lib/hubba/stats.rb
 lib/hubba/version.rb
 test/cache/users~geraldb~orgs.json
 test/cache/users~geraldb~repos.json
 test/helper.rb
+test/stats/jekyll~minima.json
+test/stats/openblockchains~awesome-blockchains.json
+test/stats/opendatajson~factbook.json.json
+test/stats/poole~hyde.json
 test/test_cache.rb
 test/test_config.rb
+test/test_stats.rb
+test/test_stats_tmp.rb

data/README.md

@@ -1,20 +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.
-
+# hubba
+
+hubba gem - (yet) another (lite) GitHub HTTP API client / library
+
+* home  :: [github.com/rubycoco/git](https://github.com/rubycoco/git)
+* bugs  :: [github.com/rubycoco/git/issues](https://github.com/rubycoco/git/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

@@ -5,26 +5,26 @@ Hoe.spec 'hubba' do
 
   self.version = Hubba::VERSION
 
-  self.summary = 'hubba -  (yet) another (lite) GitHub HTTP API client / library'
+  self.summary = 'hubba - (yet) another (lite) GitHub HTTP API client / library'
   self.description = summary
 
-  self.urls    = ['https://github.com/rubylibs/hubba']
+  self.urls    = { home: 'https://github.com/rubycoco/git' }
 
   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.history_file = 'CHANGELOG.md'
 
   self.extra_deps = [
-    ['logutils' ],
+    ['webclient', '>= 0.1.1']
   ]
 
   self.licenses = ['Public Domain']
 
   self.spec_extras = {
-   required_ruby_version: '>= 1.9.2'
+   required_ruby_version: '>= 2.2.2'
   }
 
 end

data/lib/hubba.rb

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

data/lib/hubba/cache.rb

@@ -1,5 +1,3 @@
-# encoding: utf-8
-
 module Hubba
 
 class Cache    ## lets you work with  GitHub api "offline" using just a local cache of stored json
@@ -14,7 +12,7 @@ class Cache    ## lets you work with  GitHub api "offline" using just a local ca
     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
+      text = File.open( path, 'r:utf-8') { |f| f.read }
       json = JSON.parse( text )
       json
     else
@@ -32,8 +30,8 @@ class Cache    ## lets you work with  GitHub api "offline" using just a local ca
       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 )
+    File.open( path, 'w:utf-8' ) do |f|
+      f.write( JSON.pretty_generate( data ))
     end
   end
 
@@ -42,6 +40,7 @@ class Cache    ## lets you work with  GitHub api "offline" using just a local ca
     ## 1) cut off leading /
     ## 2) convert / to ~
     ## 3) remove (optional) query string (for now) - why? why not?
+    ##      e.g.  /users/#{name}/orgs?per_page=100  or such
     ##
     ## e.g.
     ##  '/users/geraldb'           => 'users~geraldb',

data/lib/hubba/client.rb

@@ -1,53 +1,76 @@
-# encoding: utf-8
-
 module Hubba
 
 
 class Client
 
-def initialize( user: nil, password: nil )
-  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
+BASE_URL = 'https://api.github.com'
+
+
+def initialize( token: nil,
+                user:  nil, password: nil )
+  ## add support for (personal access) token
+  @token     = token
 
   ## add support for basic auth - defaults to no auth (nil/nil)
+  ##   remove - deprecated (use token) - why? why not?
   @user      = user    ## use login like Oktokit - why? why not?
   @password  = password
 end # method initialize
 
+
+
 def get( request_uri )
+  ###
+  # e.g. /users/geraldb
+  #      /users/geraldb/repos
+
   puts "GET #{request_uri}"
+  url = "#{BASE_URL}/#{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/hubba"                  ## required by GitHub API
-  req["Accept" ]    = "application/vnd.github.v3+json"  ## recommend by GitHub API
+  headers = {}
+  headers['User-Agent'] = 'ruby/hubba'                      ## required by GitHub API
+  headers['Accept']     = 'application/vnd.github.v3+json'  ## recommend by GitHub API
 
+  auth = []
   ## check if credentials (user/password) present - if yes, use basic auth
-  if @user && @password
+  if @token
+    puts "  using (personal access) token - starting with: #{@token[0..6]}**********"
+    headers['Authorization'] = "token #{@token}"
+    ## token works like:
+    ##  curl -H 'Authorization: token my_access_token' https://api.github.com/user/repos
+  elsif @user && @password
     puts "  using basic auth - user: #{@user}, password: ***"
-    req.basic_auth( @user, @password )
+    ## use credential auth "tuple" (that is, array with two string items) for now
+    ##  or use Webclient::HttpBasicAuth or something - why? why not?
+    auth = [@user, @password]
+    # req.basic_auth( @user, @password )
+  else
+    puts "  using no credentials (no token, no user/password)"
   end
 
-  res = @http.request(req)
+  res = Webclient.get( url,
+                       headers: headers,
+                       auth:    auth )
 
   # Get specific header
   # response["content-type"]
   # => "text/html; charset=UTF-8"
 
   # Iterate all response headers.
-  res.each_header do |key, value|
-    p "#{key} => #{value}"
+  res.headers.each do |key, value|
+    puts "#{key} => #{value}"
   end
   # => "location => http://www.google.com/"
   # => "content-type => text/html; charset=UTF-8"
   # ...
 
-  json = JSON.parse( res.body )
-  ## pp json
-  json
+  if res.status.ok?
+    res.json
+  else
+    puts "!! HTTP ERROR: #{res.status.code} #{res.status.message}:"
+    pp res.raw
+    exit 1
+  end
 end  # methdo get
 
 end  ## class Client

data/lib/hubba/github.rb

@@ -1,13 +1,15 @@
-# encoding: utf-8
-
 module Hubba
 
 class Configuration
+   attr_accessor :token
+
    attr_accessor :user
    attr_accessor :password
 
    def initialize
      # try default setup via ENV variables
+     @token    = ENV[ 'HUBBA_TOKEN' ]
+
      @user     = ENV[ 'HUBBA_USER' ]    ## use HUBBA_LOGIN - why? why not?
      @password = ENV[ 'HUBBA_PASSWORD' ]
    end
@@ -15,6 +17,8 @@ end
 
 ## lets you use
 ##   Hubba.configure do |config|
+##      config.token    = 'secret'
+##      #-or-
 ##      config.user     = 'testdada'
 ##      config.password = 'secret'
 ##   end
@@ -61,8 +65,16 @@ class Github
 
 def initialize( cache_dir: './cache' )
    @cache  = Cache.new( cache_dir )
-   @client = Client.new( user:     Hubba.configuration.user,
-                         password: Hubba.configuration.password )
+
+   @client = if Hubba.configuration.token
+               Client.new( token: Hubba.configuration.token )
+             elsif Hubba.configuration.user &&
+                   Hubba.configuration.password
+               Client.new( user:     Hubba.configuration.user,
+                           password: Hubba.configuration.password )
+             else
+               Client.new
+             end
 
    @offline = false
 end
@@ -104,6 +116,16 @@ def org_repos( name )
 end
 
 
+
+def repo( full_name )   ## full_name (handle) e.g. henrythemes/jekyll-starter-theme
+  Resource.new( get "/repos/#{full_name}" )
+end
+
+def repo_commits( full_name )
+  Resource.new( get "/repos/#{full_name}/commits" )
+end
+
+
 private
 def get( request_uri )
   if offline?

data/lib/hubba/stats.rb

@@ -0,0 +1,301 @@
+module Hubba
+
+  ####
+  #  keep track of repo stats over time (with history hash)
+
+  class Stats     ## todo/check: rename to GithubRepoStats or RepoStats - why? why not?
+
+    attr_reader :data
+
+    def initialize( full_name )
+      @data = {}
+      @data['full_name'] = full_name  # e.g. poole/hyde etc.
+    end
+
+
+    def full_name() @full_name ||= @data['full_name']; end
+
+    ## note: return datetime objects (NOT strings); if not present/available return nil/null
+    def created_at() @created_at ||= @data['created_at'] ? DateTime.strptime( @data['created_at'], '%Y-%m-%dT%H:%M:%S') : nil; end
+    def updated_at() @updated_at ||= @data['updated_at'] ? DateTime.strptime( @data['updated_at'], '%Y-%m-%dT%H:%M:%S') : nil; end
+    def pushed_at()  @pushed_at  ||= @data['pushed_at']  ? DateTime.strptime( @data['pushed_at'],  '%Y-%m-%dT%H:%M:%S') : nil; end
+
+    ## date (only) versions
+    def created() @created ||= @data['created_at'] ? Date.strptime( @data['created_at'], '%Y-%m-%d') : nil; end
+    def updated() @updated ||= @data['updated_at'] ? Date.strptime( @data['updated_at'], '%Y-%m-%d') : nil; end
+    def pushed()  @pushed  ||= @data['pushed_at']  ? Date.strptime( @data['pushed_at'],  '%Y-%m-%d') : nil; end
+
+
+
+    def history()    @history ||= @data['history'] ? build_history( @data['history'] ) : nil; end
+
+    def size
+      # size of repo in kb (as reported by github api)
+      @size ||= @data['size'] || 0   ## return 0 if not found - why? why not? (return nil - why? why not??)
+    end
+
+    def stars
+      ## return last stargazers_count entry (as number; 0 if not found)
+      @stars ||= history ? history[0].stars : 0
+    end
+
+
+    def commits() @data['commits']; end
+
+    def last_commit()   ## convenience shortcut; get first/last commit (use [0]) or nil
+      if @data['commits'] && @data['commits'][0]
+         @data['commits'][0]
+      else
+        nil
+      end
+    end
+
+    def committed()   ## last commit date (from author NOT committer)
+      @committed ||= last_commit ? Date.strptime( last_commit['author']['date'], '%Y-%m-%d') : nil
+    end
+
+    def committed_at()   ## last commit date (from author NOT committer)
+      @committed_at ||= last_commit ? DateTime.strptime( last_commit['author']['date'], '%Y-%m-%dT%H:%M:%S') : nil
+    end
+
+
+    def last_commit_message() ## convenience shortcut; last commit message
+      h = last_commit
+
+      committer_name = h['committer']['name']
+      author_name    = h['author']['name']
+      message        = h['message']
+
+      buf = ""
+      buf << message
+      buf << " by #{author_name}"
+
+      if committer_name != author_name
+        buf << " w/ #{committer_name}"
+      end
+    end  # method commit_message
+
+
+
+    def reset_cache
+      ## reset (invalidate) cached values from data hash
+      ##   use after reading or fetching
+      @full_name    = nil
+      @created_at   = @updated_at = @pushed_at = nil
+      @created      = @updated    = @pused     = nil
+      @history      = nil
+      @size         = nil
+      @stars        = nil
+
+      @committed_at = nil
+      @committed    = nil
+    end
+
+
+########
+## build history items (structs)
+
+    class HistoryItem
+
+      attr_reader   :date, :stars    ## read-only attributes
+      attr_accessor :prev, :next     ## read/write attributes (for double linked list/nodes/items)
+
+      def initialize( date:, stars: )
+        @date  = date
+        @stars = stars
+        @next  = nil
+      end
+
+      ## link items (append item at the end/tail)
+      def append( item )
+        @next = item
+        item.prev = self
+      end
+
+      def diff_days
+        if @next
+          ## note: use jd=julian days for calculation
+          @date.jd - @next.date.jd
+        else
+          nil   ## last item (tail)
+        end
+      end
+
+      def diff_stars
+        if @next
+          @stars - @next.stars
+        else
+          nil   ## last item (tail)
+        end
+      end
+    end  ## class HistoryItem
+
+
+    def build_history( timeseries )
+      items = []
+
+      keys  = timeseries.keys.sort.reverse   ## newest (latest) items first
+      keys.each do |key|
+        h = timeseries[ key ]
+
+        item = HistoryItem.new(
+                 date:  Date.strptime( key, '%Y-%m-%d' ),
+                 stars: h['stargazers_count'] || 0 )
+
+        ## link items
+        last_item = items[-1]
+        last_item.append( item )   if last_item     ## if not nil? append (note first item has no prev item)
+
+        items << item
+      end
+
+      ## todo/check: return [] for empty items array (items.empty?) - why?? why not??
+      if items.empty?
+        nil
+      else
+        items
+      end
+    end  ## method build_history
+
+
+
+  def calc_diff_stars( samples: 3, days: 30 )
+    ## samples: use n history item samples e.g. 3 samples
+    ## days e.g. 7 days (per week), 30 days (per month)
+
+    if history.nil?
+      nil   ## todo/check: return 0.0 too - why? why not?
+    elsif history.size == 1
+      ## just one item; CANNOT calc diff; return zero
+      0.0
+    else
+      idx   = [history.size, samples].min   ## calc last index
+      last  = history[idx-1]
+      first = history[0]
+
+      diff_days  = first.date.jd - last.date.jd
+      diff_stars = first.stars   - last.stars
+
+      ## note: use factor 1000 for fixed integer division
+      ##  converts to float at the end
+
+      ##  todo: check for better way (convert to float upfront - why? why not?)
+
+      diff = (diff_stars * days * 1000) / diff_days
+      puts "diff=#{diff}:#{diff.class.name}"    ## check if it's a float
+      (diff.to_f/1000.0)
+    end
+  end
+
+  def history_str
+    ## returns "pretty printed" history as string buffer
+    buf = ''
+    buf << "[#{history.size}]: "
+
+    history.each do |item|
+      buf << "#{item.stars}"
+
+      diff_stars = item.diff_stars
+      diff_days  = item.diff_days
+      if diff_stars && diff_days  ## note: last item has no diffs
+        if diff_stars > 0 || diff_stars < 0
+          if diff_stars > 0
+            buf << " (+#{diff_stars}"
+          else
+            buf << " (#{diff_stars}"
+          end
+          buf << " in #{diff_days}d) "
+        else  ## diff_stars == 0
+          buf << " (#{diff_days}d) "
+        end
+      end
+    end
+    buf
+  end # method history_str
+
+
+###############################
+## fetch / read / write methods
+
+    def fetch( gh )   ## update stats / fetch data from github via api
+      puts "fetching #{full_name}..."
+      repo = gh.repo( full_name )
+
+      ## e.g. 2015-05-11T20:21:43Z
+      ## puts Time.iso8601( repo.data['created_at'] )
+      @data['created_at'] = repo.data['created_at']
+      @data['updated_at'] = repo.data['updated_at']
+      @data['pushed_at']  = repo.data['pushed_at']
+
+      @data['size']       = repo.data['size']  # size in kb (kilobyte)
+
+      rec = {}
+
+      puts "stargazers_count"
+      puts repo.data['stargazers_count']
+      rec['stargazers_count'] = repo.data['stargazers_count']
+
+      today = Date.today.strftime( '%Y-%m-%d' )   ## e.g. 2016-09-27
+      puts "add record #{today} to history..."
+      pp rec      # check if stargazers_count is a number (NOT a string)
+
+      @data[ 'history' ] ||= {}
+      @data[ 'history' ][ today ] = rec
+
+      ##########################
+      ## also check / keep track of (latest) commit
+      commits = gh.repo_commits( full_name )
+      puts "last commit/update:"
+      ## pp commits
+      commit = {
+        'committer' => {
+          'date' => commits.data[0]['commit']['committer']['date'],
+          'name' => commits.data[0]['commit']['committer']['name']
+        },
+        'author' => {
+          'date' => commits.data[0]['commit']['author']['date'],
+          'name' => commits.data[0]['commit']['author']['name']
+        },
+        'message' => commits.data[0]['commit']['message']
+      }
+
+      ## for now store only the latest commit (e.g. a single commit in an array)
+      @data[ 'commits' ] = [commit]
+
+      pp @data
+
+      reset_cache
+      self   ## return self for (easy chaining)
+    end
+
+
+
+    def write( data_dir: './data' )
+      basename = full_name.gsub( '/', '~' )   ## e.g. poole/hyde become poole~hyde
+      puts "writing stats to #{basename}..."
+      File.open( "#{data_dir}/#{basename}.json", 'w:utf-8' ) do |f|
+          f.write JSON.pretty_generate( data )
+      end
+      self   ## return self for (easy chaining)
+    end
+
+
+    def read( data_dir: './data' )
+      ## note: skip reading if file not present
+      basename = full_name.gsub( '/', '~' )   ## e.g. poole/hyde become poole~hyde
+      filename = "#{data_dir}/#{basename}.json"
+      if File.exist?( filename )
+        puts "reading stats from #{basename}..."
+        json = File.open( filename, 'r:utf-8' ) { |file| file.read }   ## todo/fix: use read_utf8
+        @data = JSON.parse( json )
+        reset_cache
+      else
+        puts "skipping reading stats from #{basename} -- file not found"
+      end
+      self   ## return self for (easy chaining)
+    end
+
+  end # class Stats
+
+
+end # module Hubba

data/lib/hubba/version.rb

@@ -1,9 +1,7 @@
-# encoding: utf-8
-
 module Hubba
   MAJOR = 0    ## todo: namespace inside version or something - why? why not??
-  MINOR = 1
-  PATCH = 2
+  MINOR = 5
+  PATCH = 1
   VERSION = [MAJOR,MINOR,PATCH].join('.')
 
   def self.version

data/test/helper.rb

@@ -1,5 +1,3 @@
-# encoding: utf-8
-
 # minitest setup
 require 'minitest/autorun'
 

data/test/stats/jekyll~minima.json

@@ -0,0 +1,25 @@
+{
+  "full_name": "jekyll/minima",
+  "created_at": "2016-05-20T23:07:56Z",
+  "updated_at": "2018-02-11T16:13:33Z",
+  "pushed_at": "2018-02-07T22:14:11Z",
+  "size": 321,
+  "history": {
+    "2018-02-12": {
+      "stargazers_count": 717
+    }
+  },
+  "commits": [
+    {
+      "author": {
+        "name": "ashmaroli",
+        "date": "2018-02-21T19:35:59Z"
+      },
+      "committer": {
+        "name": "Frank Taillandier",
+        "date": "2018-02-21T19:35:59Z"
+      },
+      "message": "social icons should resolve baseurl properly (#201)"
+    }
+  ]
+}

data/test/stats/openblockchains~awesome-blockchains.json

@@ -0,0 +1,27 @@
+{
+  "full_name": "openblockchains/awesome-blockchains",
+  "created_at": "2017-09-13T22:33:56Z",
+  "size": 1620,
+  "history": {
+    "2017-12-10": {
+      "stargazers_count": 1084
+    },
+    "2018-01-28": {
+      "stargazers_count": 1411
+    },
+    "2018-02-08": {
+      "stargazers_count": 1526
+    }
+  },
+  "commits": [
+    {
+      "committer": {
+        "date": "2018-02-08T09:33:28Z",
+        "name": "Gerald Bauer"
+      },
+      "message": "Update README.md\n\nJust a little typo cryto -> crypto."
+    }
+  ],
+  "updated_at": "2018-02-08T19:26:35Z",
+  "pushed_at": "2018-02-08T09:33:29Z"
+}

data/test/stats/opendatajson~factbook.json.json

@@ -0,0 +1,39 @@
+{
+  "full_name": "opendatajson/factbook.json",
+  "created_at": "2014-07-12T12:43:52Z",
+  "history": {
+    "2017-02-11": {
+      "stargazers_count": 457
+    },
+    "2017-02-12": {
+      "stargazers_count": 457
+    },
+    "2017-06-18": {
+      "stargazers_count": 505
+    },
+    "2017-07-28": {
+      "stargazers_count": 512
+    },
+    "2017-12-10": {
+      "stargazers_count": 533
+    },
+    "2018-01-28": {
+      "stargazers_count": 536
+    },
+    "2018-02-08": {
+      "stargazers_count": 539
+    }
+  },
+  "commits": [
+    {
+      "committer": {
+        "date": "2017-03-29T17:23:29Z",
+        "name": "GitHub"
+      },
+      "message": "Update MONGO.md"
+    }
+  ],
+  "size": 7355,
+  "updated_at": "2018-02-01T12:35:19Z",
+  "pushed_at": "2017-03-29T17:23:30Z"
+}

data/test/stats/poole~hyde.json

@@ -0,0 +1,21 @@
+{
+  "full_name": "poole/hyde",
+  "created_at": "2013-02-07T07:01:38Z",
+  "updated_at": "2018-02-12T05:44:07Z",
+  "pushed_at": "2018-01-14T02:41:16Z",
+  "size": 28428,
+  "history": {
+    "2018-02-12": {
+      "stargazers_count": 2125
+    }
+  },
+  "commits": [
+    {
+      "committer": {
+        "date": "2015-05-11T20:21:43Z",
+        "name": "Mark Otto"
+      },
+      "message": "Merge pull request #91 from pborreli/patch-1\n\nFixed typo"
+    }
+  ]
+}

data/test/test_cache.rb

@@ -1,5 +1,3 @@
-# encoding: utf-8
-
 ###
 #  to run use
 #     ruby -I ./lib -I ./test test/test_cache.rb
@@ -32,15 +30,14 @@ class TestCache < MiniTest::Test
   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' )
+     assert_nil @cache.get( '/test/hello' )
+     assert_nil @cache.get( '/test/hola' )
   end  # method test_cache_miss
 
 end # class TestCache
-

data/test/test_config.rb

@@ -1,5 +1,3 @@
-# encoding: utf-8
-
 ###
 #  to run use
 #     ruby -I ./lib -I ./test test/test_config.rb

data/test/test_stats.rb

@@ -0,0 +1,122 @@
+###
+#  to run use
+#     ruby -I ./lib -I ./test test/test_stats.rb
+
+
+require 'helper'
+
+
+class TestStats < MiniTest::Test
+
+
+  def test_jekyll_minima
+
+    stats = Hubba::Stats.new( 'jekyll/minima' )
+
+    assert_equal 0, stats.size
+    assert_equal 0, stats.stars
+    assert_nil      stats.history
+
+    stats.read( data_dir: "#{Hubba.root}/test/stats" )
+
+    assert_equal 321, stats.size
+    assert_equal 717, stats.stars
+    assert_equal 717, stats.history[0].stars
+    assert_equal 1,   stats.history.size
+
+    assert_equal Date.new(2018,  2,  12 ), stats.history[0].date
+
+    assert_nil   stats.history[0].diff_days
+
+    assert_equal Date.new(2018, 2, 21 ), stats.committed
+    assert_equal Date.new(2016, 5, 20 ), stats.created
+    assert_equal Date.new(2018, 2, 11 ), stats.updated
+    assert_equal Date.new(2018, 2,  7 ), stats.pushed
+
+    assert_equal DateTime.new(2018, 2, 21, 19, 35, 59 ), stats.committed_at
+    assert_equal DateTime.new(2016, 5, 20, 23,  7, 56 ), stats.created_at
+    assert_equal DateTime.new(2018, 2, 11, 16, 13, 33 ), stats.updated_at
+    assert_equal DateTime.new(2018, 2,  7, 22, 14, 11 ), stats.pushed_at
+
+
+    pp stats.last_commit
+    pp stats.last_commit_message
+    pp stats.history_str   ## pp history pretty printed to string (buffer)
+  end
+
+
+
+  def test_awesome_blockchains
+
+    stats = Hubba::Stats.new( 'openblockchains/awesome-blockchains' )
+
+    assert_equal 0, stats.size
+    assert_equal 0, stats.stars
+    assert_nil      stats.history
+
+    stats.read( data_dir: "#{Hubba.root}/test/stats" )
+
+    assert_equal 1620, stats.size
+    assert_equal 1526, stats.stars
+    assert_equal 1526, stats.history[0].stars
+    assert_equal 1411, stats.history[1].stars
+    assert_equal 1084, stats.history[2].stars
+    assert_equal 1084, stats.history[-1].stars
+    assert_equal 3,    stats.history.size
+
+    assert_equal Date.new(2018,  2,  8 ), stats.history[0].date
+    assert_equal Date.new(2018,  1, 28 ), stats.history[1].date
+    assert_equal Date.new(2017, 12, 10 ), stats.history[2].date
+
+    assert_equal 11, stats.history[0].diff_days
+    assert_equal 49, stats.history[1].diff_days
+    assert_nil       stats.history[2].diff_days
+
+    assert_equal 115, stats.history[0].diff_stars
+    assert_equal 327, stats.history[1].diff_stars
+    assert_nil        stats.history[2].diff_stars
+
+    assert_equal 221.0,   stats.calc_diff_stars    ## defaults to samples: 3, days: 30
+    assert_equal  51.566, stats.calc_diff_stars( samples: 5, days: 7 )
+
+    pp stats.history_str   ## pp history pretty printed to string (buffer)
+  end
+
+
+  def test_factbook_json
+
+    stats = Hubba::Stats.new( 'opendatajson/factbook.json' )
+
+    assert_equal 0, stats.size
+    assert_equal 0, stats.stars
+    assert_nil      stats.history
+
+    stats.read( data_dir: "#{Hubba.root}/test/stats" )
+
+    assert_equal 7355, stats.size
+    assert_equal 539, stats.stars
+    assert_equal 539, stats.history[0].stars
+    assert_equal 536, stats.history[1].stars
+    assert_equal 533, stats.history[2].stars
+    assert_equal 457, stats.history[-1].stars
+    assert_equal 7,    stats.history.size
+
+    assert_equal Date.new(2018,  2,  8 ), stats.history[0].date
+    assert_equal Date.new(2018,  1, 28 ), stats.history[1].date
+    assert_equal Date.new(2017, 12, 10 ), stats.history[2].date
+
+    assert_equal 11, stats.history[0].diff_days
+    assert_equal 49, stats.history[1].diff_days
+    assert_nil       stats.history[-1].diff_days
+
+    assert_equal 3, stats.history[0].diff_stars
+    assert_equal 3, stats.history[1].diff_stars
+    assert_nil      stats.history[-1].diff_stars
+
+    assert_equal 3.0,   stats.calc_diff_stars    ## defaults to samples: 3, days: 30
+    assert_equal 1.012, stats.calc_diff_stars( samples: 5, days: 7 )
+
+    pp stats.history_str   ## pp history pretty printed to string (buffer)
+  end
+
+end # class TestStats

data/test/test_stats_tmp.rb

@@ -0,0 +1,41 @@
+###
+#  to run use
+#     ruby -I ./lib -I ./test test/test_stats_tmp.rb
+
+
+require 'helper'
+
+
+class TestStatsTmp < MiniTest::Test
+
+  def setup
+    @gh = Hubba::Github.new( cache_dir: "#{Hubba.root}/test/cache" )
+  end
+
+  def test_stats
+    repos = [
+      'poole/hyde',
+      'jekyll/minima'
+    ]
+
+    repos.each do |repo|
+      stats = Hubba::Stats.new( repo )
+      # stats.read( data_dir: './tmp' )
+      stats.read( data_dir: "#{Hubba.root}/test/stats" )
+
+      puts "stars before fetch: #{stats.stars}"
+      puts "size  before fetch: #{stats.size} kb"
+
+      ## note/todo: enable for "live" online testing
+      ## stats.fetch( @gh )
+
+      puts "stars after fetch: #{stats.stars}"
+      puts "size  after fetch: #{stats.size} kb"
+
+      stats.write( data_dir: './tmp' )
+    end
+
+    assert true    # for now everything ok if we get here
+  end
+
+end # class TestStatsTmp

metadata

@@ -1,67 +1,73 @@
 --- !ruby/object:Gem::Specification
 name: hubba
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.5.1
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-08-17 00:00:00.000000000 Z
+date: 2020-10-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: logutils
+  name: webclient
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.1.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.1.1
 - !ruby/object:Gem::Dependency
   name: rdoc
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '4.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '4.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7'
 - !ruby/object:Gem::Dependency
   name: hoe
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.14'
+        version: '3.22'
   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
+        version: '3.22'
+description: hubba - (yet) another (lite) GitHub HTTP API client / library
 email: ruby-talk@ruby-lang.org
 executables: []
 extensions: []
 extra_rdoc_files:
-- HISTORY.md
+- CHANGELOG.md
 - Manifest.txt
 - README.md
 files:
-- HISTORY.md
+- CHANGELOG.md
 - Manifest.txt
 - README.md
 - Rakefile
@@ -69,13 +75,20 @@ files:
 - lib/hubba/cache.rb
 - lib/hubba/client.rb
 - lib/hubba/github.rb
+- lib/hubba/stats.rb
 - lib/hubba/version.rb
 - test/cache/users~geraldb~orgs.json
 - test/cache/users~geraldb~repos.json
 - test/helper.rb
+- test/stats/jekyll~minima.json
+- test/stats/openblockchains~awesome-blockchains.json
+- test/stats/opendatajson~factbook.json.json
+- test/stats/poole~hyde.json
 - test/test_cache.rb
 - test/test_config.rb
-homepage: https://github.com/rubylibs/hubba
+- test/test_stats.rb
+- test/test_stats_tmp.rb
+homepage: https://github.com/rubycoco/git
 licenses:
 - Public Domain
 metadata: {}
@@ -89,7 +102,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 1.9.2
+      version: 2.2.2
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -97,8 +110,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.3
+rubygems_version: 2.5.2
 signing_key: 
 specification_version: 4
-summary: hubba -  (yet) another (lite) GitHub HTTP API client / library
+summary: hubba - (yet) another (lite) GitHub HTTP API client / library
 test_files: []