hubba 0.6.2 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0c7c4d9d7af183756855559bc03b8910bdcb1ace
-  data.tar.gz: 4cfd725ee9c1a3138370cbcb61e1bd900d689012
+  metadata.gz: 6dfdf158420e74f4a2810c18e46cab065aa2dcce
+  data.tar.gz: 51357a2974422d2e9c4c0bb7b961d08ee43297bd
 SHA512:
-  metadata.gz: a6cb53226a5a73777bc9ad86d82a22a39ea56710514233d5530b489d9fcce1bd9cc67b65f6d41f488d3ee4a266e0be5cbcbeef9231cef9007427928d60785214
-  data.tar.gz: 38395c69b0e45a174a1629029803f41b3e5d1ca7dba27d893dfcebd70f59ed4f17e60e6ec1715c331b61d8e49ef727de564aba14a03b0dfe75a6c15850e3bdc8
+  metadata.gz: 7388e0646b07392b35ad13ea738c440b49f37cca283b4abf380071069ce48ef22bbe2d9fe293e266056ee1c7c386c92547740bb84a74cf3c03651a1f48ac48b2
+  data.tar.gz: 4ffbc0a84814db71694e6f0d750c7269916ae30f46a64ca79679976de222e06cbb63918b73b47c679ef8b92fa4fc9abce86f2cc3128903c1e2c8da634cfd96e2

data/Manifest.txt

@@ -4,19 +4,11 @@ README.md
 Rakefile
 lib/hubba.rb
 lib/hubba/config.rb
-lib/hubba/folio.rb
 lib/hubba/github.rb
-lib/hubba/hubba.rb
-lib/hubba/reports.rb
+lib/hubba/reposet.rb
 lib/hubba/stats.rb
 lib/hubba/update.rb
 lib/hubba/update_traffic.rb
 lib/hubba/version.rb
 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_config.rb
-test/test_stats.rb
-test/test_stats_tmp.rb

data/README.md

@@ -87,6 +87,8 @@ account that are forks get auto-excluded.
 ### Step 2: Update repo statistics (daily / weekly / monthly)
 
 
+#### Basics (commits, stars, forks, topics, etc.)
+
 Use `update_stats` to
 to get the latest commit, star count and more for all your repos
 listed in `./repos.yml` via the GitHub API:
@@ -99,150 +101,27 @@ Note: By default the datafiles (one per repo)
 get stored in the `./data` directory.
 
 
+#### Traffic (page views, clones, referrers, etc.)
 
-
-### Step 3: Generate some statistics / reports
-
-
-Hubba has four built-in reports (for now):
-
-- `ReportSummary`  - A-Z list of your repos by orgs with stars and size in kb
-- `ReportStars`    - your repos ranked by stars
-- `ReportTimeline` - your repos in reverse chronological order by creation
-- `ReportUpdates`  - your repos in reverse chronological order by last commit
-
-
-If you only generate a single report, use:
-
-``` ruby
-report = Hubba::ReportSummary.new( './repos.yml' )
-report.save( './SUMMARY.md' )
-```
-
-
-If you generate more reports, (re)use the in-memory statistics cache / object:
+Use `update_traffic` to
+to get the latest traffic stats (page views, clones, referrers, etc.)
+for all your repos listed in `./repos.yml` via the GitHub API.
 
 ``` ruby
-stats = Hubba.stats( './repos.yml' )
-
-report = Hubba::ReportSummary.new( stats )
-report.save( './SUMMARY.md' )
-
-report = Hubba::ReportStars.new( stats )
-report.save( './STARS.md' )
-
-report = Hubba::ReportTimeline.new( stats )
-report.save( './TIMELINE.md' )
-
-report = Hubba::ReportUpdates.new( stats )
-report.save( './UPDATES.md' )
+Hubba.update_traffic( './repos.yml' )
 ```
 
+Note: Access to traffic statistics via the GitHub API
+requires push access for your GitHub (personal access) token.
 
-### Report Examples
-
-#### Report Example - Summary
-
-A-Z list of your repos by orgs with stars and size in kb.
-Results in:
-
----
-
-> 593 repos @ 83 orgs
->
-> ### geraldb _(11)_
->
-> **austria** ★1 (552 kb) · **catalog** ★3 (156 kb) · **chelitas** ★1 (168 kb) · **geraldb.github.io** ★1 (520 kb) · **logos** ★1 (363 kb) · **sandbox** ★2 (529 kb) · **talks** ★200 (16203 kb) · **web-proxy-win** ★8 (152 kb) · **webcomponents** ★1 (164 kb) · **webpub-reader** ★3 (11 kb) · **wine.db.tools** ★1 (252 kb)
->
-> ...
-
----
-
-(Live Example - [`SUMMARY.md`](https://github.com/yorobot/backup/blob/master/SUMMARY.md))
-
-
-#### Report Example - Stars
-
-Your repos ranked by stars. Results in:
-
----
-
-> 593 repos @ 83 orgs
->
-> 1. ★2936 **openblockchains/awesome-blockchains** (2514 kb)
-> 2. ★851 **planetjekyll/awesome-jekyll-plugins** (148 kb)
-> 3. ★604 **factbook/factbook.json** (7355 kb)
-> 4. ★593 **openfootball/football.json** (2135 kb)
-> 5. ★570 **openmundi/world.db** (1088 kb)
-> 6. ★552 **openblockchains/programming-blockchains** (552 kb)
-> 7. ★547 **mundimark/awesome-markdown** (83 kb)
-> 8. ★532 **planetjekyll/awesome-jekyll** (110 kb)
-> 9. ★489 **cryptocopycats/awesome-cryptokitties** (4154 kb)
-> 10. ★445 **openfootball/world-cup** (638 kb)
->
-> ...
-
----
-
-(Live Example: [`STARS.md`](https://github.com/yorobot/backup/blob/master/STARS.md))
-
-
-#### Report Example - Timeline
-
-Your repos in reverse chronological order by creation.
-Results in:
-
----
-
-> 593 repos @ 83 orgs
->
-> ## 2020
->
-> ### 9
->
-> - 2020-09-18 ★1 **yorobot/workflow** (83 kb)
->
-> ### 6
->
-> - 2020-06-27 ★2 **yorobot/sport.db.more** (80 kb)
-> - 2020-06-24 ★1 **yorobot/stage** (554 kb)
-> - 2020-06-11 ★1 **yorobot/cache.csv** (336 kb)
->
-> ...
-
----
-
-(Live Example: [`TIMELINE.md`](https://github.com/yorobot/backup/blob/master/TIMELINE.md))
-
-
-
-#### Report Example - Updates
 
-Your repos in reverse chronological order by last commit. Results in:
 
----
 
-> 593 repos @ 83 orgs
->
-> committed / pushed / updated / created
->
-> - (1d) **yorobot/backup** ★4 - 2020-10-08 (=/=) / 2020-10-08 (=) / 2020-10-08 / 2015-04-04 - ‹› (1595 kb)
-> - (1d) **yorobot/logs** ★1 - 2020-10-08 (=/=) / 2020-10-08 (=) / 2020-10-08 / 2016-09-13 - ‹› (172 kb)
-> - (1d) **rubycoco/git** ★9 - 2020-10-08 (=/=) / 2020-10-08 (=) / 2020-10-08 / 2015-11-16 - ‹› (88 kb)
-> - (1d) **openfootball/football.json** ★593 - 2020-10-08 (=/=) / 2020-10-08 (=) / 2020-10-08 / 2015-09-17 - ‹› (2135 kb)
-> - (2d) **yorobot/workflow** ★1 - 2020-10-07 (=/=) / 2020-10-07 (=) / 2020-10-07 / 2020-09-18 - ‹› (83 kb)
-> - (2d) **rubycoco/webclient** ★5 - 2020-10-07 (=/=) / 2020-10-07 (=) / 2020-10-07 / 2012-06-02 - ‹› (39 kb)
-> - (3d) **footballcsv/belgium** ★1 - 2020-10-06 (=/=) / 2020-10-06 (=) / 2020-10-06 / 2014-07-25 - ‹› (314 kb)
-> - (3d) **footballcsv/england** ★105 - 2020-10-06 (=/=) / 2020-10-06 (=) / 2020-10-06 / 2014-07-23 - ‹› (8666 kb)
-> - (3d) **footballcsv/austria** ★1 - 2020-10-06 (=/=) / 2020-10-06 (=) / 2020-10-06 / 2018-07-16 - ‹› (91 kb)
-> - (3d) **footballcsv/espana** ★15 - 2020-10-06 (=/=) / 2020-10-06 (=) / 2020-10-06 / 2014-07-23 - ‹› (1107 kb)
-> - (3d) **footballcsv/deutschland** ★5 - 2020-10-06 (=/=) / 2020-10-06 (=) / 2020-10-06 / 2014-07-25 - ‹› (1343 kb)
->
-> ...
+### Step 3: Generate some statistics / analytics reports
 
----
 
-(Live Example: [`UPDATES.md`](https://github.com/yorobot/backup/blob/master/UPDATES.md))
+See the [hubba-reports gem](https://github.com/rubycoco/git/tree/master/hubba-reports) on how to use pre-built/pre-packaged ready-to-use
+github statistics / analytics reports.
 
 
 

data/lib/hubba.rb

@@ -23,15 +23,14 @@ end
 require 'hubba/version'   # note: let version always go first
 require 'hubba/config'
 require 'hubba/github'
-require 'hubba/stats'
+require 'hubba/reposet'
 
-## "higher level" porcelain services / helpers for easy (re)use
-require 'hubba/folio'     ## "access layer" for reports
-require 'hubba/hubba'
+### update stats (github data) machinery
+require 'hubba/stats'
 require 'hubba/update'
 require 'hubba/update_traffic'
 
-require 'hubba/reports'
+
 
 
 ############
@@ -42,4 +41,6 @@ end
 
 
 # say hello
-puts Hubba.banner    if defined?($RUBYCOCO_DEBUG)
+puts Hubba.banner
+
+

data/lib/hubba/{hubba.rb → reposet.rb}

@@ -80,18 +80,4 @@ def self.reposet( *users, orgs: true,
   h
 end  ## method reposet
 
-
-def self.stats( hash_or_path='./repos.yml' )   ## use read_stats or such - why? why not?
-  h = if hash_or_path.is_a?( String )    ## assume it is a file path!!!
-        path = hash_or_path
-        YAML.load_file( path )
-      else
-        hash_or_path  # assume its a hash / reposet already!!!
-      end
-
-  Folio.new( h )  ## wrap in "easy-access" facade / wrapper
-end  ## method stats
-
-
 end # module Hubba
-

data/lib/hubba/stats.rb

@@ -5,227 +5,16 @@ module Hubba
 
   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.
 
-      @cache = {}
-    end
-
-
-    def full_name() @data['full_name']; end
-
-
-    ## note: return datetime objects (NOT strings); if not present/available return nil/null
-    def created_at() @cache['created_at'] ||= parse_datetime( @data['created_at'] ); end
-    def updated_at() @cache['updated_at'] ||= parse_datetime( @data['updated_at'] ); end
-    def pushed_at()  @cache['pushed_at']  ||= parse_datetime( @data['pushed_at'] );  end
-
-    ## date (only) versions
-    def created() @cache['created'] ||= parse_date( @data['created_at'] ); end
-    def updated() @cache['updated'] ||= parse_date( @data['updated_at'] ); end
-    def pushed()  @cache['pushed']  ||= parse_date( @data['pushed_at'] ); end
-
-    def size
-      # size of repo in kb (as reported by github api)
-      @data['size'] || 0   ## return 0 if not found - why? why not? (return nil - why? why not??)
-    end
-
-
-    def history
-      @cache['history'] ||= begin
-                              if @data['history']
-                                build_history( @data['history'] )
-                              else
-                                nil
-                              end
-                            end
-    end
-
-
-    def stars
-      ## return last stargazers_count entry (as number; 0 if not found)
-      @cache['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)
-      @cache['committed'] ||= parse_date( last_commit_author_date )
-    end
-
-    def committed_at()   ## last commit date (from author NOT committer)
-      @cache['committed_at'] ||= parse_datetime( last_commit_author_date )
-    end
-
-    def last_commit_author_date
-      h = last_commit
-      h ? h['author']['date'] : nil
+      @cache = {}  ## keep a lookup cache - why? why not?
     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
-
-
-
-    ###
-    # helpers
-    def parse_datetime( str ) str ? DateTime.strptime( str, '%Y-%m-%dT%H:%M:%S') : nil; end
-    def parse_date( str )     str ? Date.strptime( str, '%Y-%m-%d') : 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  ## todo/check: rename/change to format_history or fmt_history - why? why not?
-    ## 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
-
-
-
 ##################
 ## update
-
 def update_traffic( clones:    nil,
                     views:     nil,
                     paths:     nil,
@@ -415,25 +204,28 @@ end  # method update_traffic
 
 ########################################
 ## read / write methods / helpers
-
     def write
-      basename = full_name.gsub( '/', '~' )   ## e.g. poole/hyde become poole~hyde
-      data_dir = Hubba.config.data_dir
+      basename = @data['full_name'].gsub( '/', '~' )   ## e.g. poole/hyde become poole~hyde
+      letter   = basename[0]  ## use first letter as index dir e.g. p/poole~hyde
+      data_dir = "#{Hubba.config.data_dir}/#{letter}"
+      path     = "#{data_dir}/#{basename}.json"
+
       puts "  writing stats to #{basename} (#{data_dir})..."
 
-      ## todo/fix: add FileUtils.makepath_r or such!!!
-      File.open( "#{data_dir}/#{basename}.json", 'w:utf-8' ) do |f|
-          f.write JSON.pretty_generate( data )
+      FileUtils.mkdir_p( File.dirname( path ))  ## make sure path exists
+      File.open( path, 'w:utf-8' ) do |f|
+          f.write( JSON.pretty_generate( @data ))
       end
       self   ## return self for (easy chaining)
-    end
+    end # method write
 
 
     def read
       ## note: skip reading if file not present
-      basename = full_name.gsub( '/', '~' )   ## e.g. poole/hyde become poole~hyde
-      data_dir = Hubba.config.data_dir
-      path = "#{data_dir}/#{basename}.json"
+      basename = @data['full_name'].gsub( '/', '~' )   ## e.g. poole/hyde become poole~hyde
+      letter   = basename[0]  ## use first letter as index dir e.g. p/poole~hyde
+      data_dir = "#{Hubba.config.data_dir}/#{letter}"
+      path     = "#{data_dir}/#{basename}.json"
 
       if File.exist?( path )
         puts "  reading stats from #{basename} (#{data_dir})..."
@@ -447,8 +239,7 @@ end  # method update_traffic
         puts "!! WARN: - skipping reading stats from #{basename} -- file not found"
       end
       self   ## return self for (easy chaining)
-    end
-
+    end # method read
   end # class Stats
 
 

data/lib/hubba/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hubba
 version: !ruby/object:Gem::Version
-  version: 0.6.2
+  version: 0.7.0
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-10-11 00:00:00.000000000 Z
+date: 2020-10-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: webclient
@@ -73,22 +73,14 @@ files:
 - Rakefile
 - lib/hubba.rb
 - lib/hubba/config.rb
-- lib/hubba/folio.rb
 - lib/hubba/github.rb
-- lib/hubba/hubba.rb
-- lib/hubba/reports.rb
+- lib/hubba/reposet.rb
 - lib/hubba/stats.rb
 - lib/hubba/update.rb
 - lib/hubba/update_traffic.rb
 - lib/hubba/version.rb
 - 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_config.rb
-- test/test_stats.rb
-- test/test_stats_tmp.rb
 homepage: https://github.com/rubycoco/git
 licenses:
 - Public Domain

data/lib/hubba/folio.rb

@@ -1,60 +0,0 @@
-module Hubba
-
-class Folio    # todo/check: use a different name e.g (Port)Folio, Cache, Summary, (Data)Base, Census, Catalog, Collection, Index, Register or such???
-class Repo  ## (nested) class
-
-  attr_reader :owner,
-              :name
-
-  def initialize( owner, name )
-    @owner = owner   ## rename to login, username - why? why not?
-    @name  = name    ## rename to reponame ??
-  end
-
-  def full_name() "#{owner}/#{name}"; end
-
-  def stats
-    ## note: load stats on demand only (first access) for now - why? why not?
-    @stats ||= begin
-                 stats = Stats.new( full_name )
-                 stats.read
-                 stats
-               end
-  end
-
-  def diff
-    @diff ||= stats.calc_diff_stars( samples: 3, days: 30 )
-  end
-end  # (nested) class Repo
-
-
-attr_reader :orgs, :repos
-
-def initialize( h )
-  @orgs     = []    # orgs and users -todo/check: use better name - logins or owners? why? why not?
-  @repos    = []
-  add( h )
-
-  puts "#{@repos.size} repos @ #{@orgs.size} orgs"
-end
-
-#############
-## private helpes
-def add( h )   ## add repos.yml set
-  h.each do |org_with_counter, names|
-    ## remove optional number from key e.g.
-    ##   mrhydescripts (3)    =>  mrhydescripts
-    ##   footballjs (4)       =>  footballjs
-    ##   etc.
-    org = org_with_counter.sub( /\([0-9]+\)/, '' ).strip
-    repos = []
-    names.each do |name|
-      repo = Repo.new( org, name )
-      repos << repo
-    end
-    @orgs << [org, repos]
-    @repos += repos
-  end
-end
-end  # class Folio
-end  # module Hubba

data/lib/hubba/reports.rb

@@ -1,249 +0,0 @@
-module Hubba
-
-
-class Report
-  def initialize( stats_or_hash_or_path=Hubba.stats )
-    ## puts "[debug] Report#initialize:"
-    ## pp  stats_or_hash_or_path   if stats_or_hash_or_path.is_a?( String )
-
-    @stats = if stats_or_hash_or_path.is_a?( String ) ||
-                stats_or_hash_or_path.is_a?( Hash )
-                  hash_or_path = stats_or_hash_or_path
-                  Hubba.stats( hash_or_path )
-             else
-                  stats_or_hash_or_path  ## assume Summary/Stats - todo/fix: double check!!!
-             end
-  end
-
-  def save( path )
-    buf = build
-    puts "writing report >#{path}< ..."
-    File.open( path, "w:utf-8" ) do |f|
-      f.write( buf )
-    end
-  end
-end  ## class Report
-
-
-
-class ReportSummary < Report
-
-def build
-## create a (summary report)
-##
-##  add stars, last_updates, etc.
-##  org description etc??
-
-## note: orgs is orgs+users e.g. geraldb, yorobot etc
-buf = String.new('')
-buf << "# #{@stats.repos.size} repos @ #{@stats.orgs.size} orgs\n"
-buf << "\n"
-
-
-@stats.orgs.each do |org|
-  name  = org[0]
-  repos = org[1]
-  buf << "### #{name} _(#{repos.size})_\n"
-  buf << "\n"
-
-  ### add stats for repos
-  entries = []
-  repos.each do |repo|
-    entries << "**#{repo.name}** ★#{repo.stats.stars} (#{repo.stats.size} kb)"
-  end
-
-  buf << entries.join( ' · ' )   ## use interpunct? - was: • (bullet)
-  buf << "\n"
-  buf << "\n"
-end
-
-buf
-end  # method build
-end  # class ReportSummary
-
-
-
-class ReportStars < Report
-
-def build
-
-##  add stars, last_updates, etc.
-##  org description etc??
-
-## note: orgs is orgs+users e.g. geraldb, yorobot etc
-buf = String.new('')
-buf << "# #{@stats.repos.size} repos @ #{@stats.orgs.size} orgs\n"
-buf << "\n"
-
-
-repos = @stats.repos.sort do |l,r|
-  ## note: use reverse sort (right,left) - e.g. most stars first
-  r.stats.stars <=> l.stats.stars
-end
-
-## pp repos
-
-repos.each_with_index do |repo,i|
-  buf << "#{i+1}. ★#{repo.stats.stars} **#{repo.full_name}** (#{repo.stats.size} kb)\n"
-end
-
-buf
-end  # method build
-end  # class ReportStars
-
-
-
-class ReportTimeline < Report
-
-def build
-## create a (timeline report)
-
-## note: orgs is orgs+users e.g. geraldb, yorobot etc
-buf = String.new('')
-buf << "# #{@stats.repos.size} repos @ #{@stats.orgs.size} orgs\n"
-buf << "\n"
-
-
-repos = @stats.repos.sort do |l,r|
-  ## note: use reverse sort (right,left) - e.g. most stars first
-  ## r[:stars] <=> l[:stars]
-
-  ## sort by created_at (use julian days)
-  r.stats.created.jd <=> l.stats.created.jd
-end
-
-
-## pp repos
-
-
-last_year  = -1
-last_month = -1
-
-repos.each_with_index do |repo,i|
-  year       = repo.stats.created.year
-  month      = repo.stats.created.month
-
-  if last_year != year
-    buf << "\n## #{year}\n\n"
-  end
-
-  if last_month != month
-    buf << "\n### #{month}\n\n"
-  end
-
-  last_year  = year
-  last_month = month
-
-  buf << "- #{repo.stats.created_at.strftime('%Y-%m-%d')} ★#{repo.stats.stars} **#{repo.full_name}** (#{repo.stats.size} kb)\n"
-end
-
-buf
-end  # method build
-end  # class ReportTimeline
-
-
-
-class ReportTrending < Report
-
-def build
-
-## note: orgs is orgs+users e.g. geraldb, yorobot etc
-buf = String.new('')
-buf << "# #{@stats.repos.size} repos @ #{@stats.orgs.size} orgs\n"
-buf << "\n"
-
-###
-## todo:
-##   use calc per month (days: 30)
-##   per week is too optimistic (e.g. less than one star/week e.g. 0.6 or something)
-
-repos = @stats.repos.sort do |l,r|
-  ## note: use reverse sort (right,left) - e.g. most stars first
-  ## r[:stars] <=> l[:stars]
-
-  ## sort by created_at (use julian days)
-  ## r[:created_at].to_date.jd <=> l[:created_at].to_date.jd
-
-  res = r.diff <=> l.diff
-  res = r.stats.stars <=> l.stats.stars  if res == 0
-  res = r.stats.created.jd <=> l.stats.created.jd  if res == 0
-  res
-end
-
-
-## pp repos
-
-
-repos.each_with_index do |repo,i|
-  if repo.diff == 0
-    buf << "-  -/- "
-  else
-    buf << "- #{repo.diff}/month "
-  end
-
-  buf <<  " ★#{repo.stats.stars} **#{repo.full_name}** (#{repo.stats.size} kb) - "
-  buf <<  "#{repo.stats.history_str}\n"
-end
-
-
-buf
-end  # method build
-end  # class ReportTrending
-
-
-
-class ReportUpdates < Report
-
-def build
-
-## note: orgs is orgs+users e.g. geraldb, yorobot etc
-buf = String.new('')
-buf << "# #{@stats.repos.size} repos @ #{@stats.orgs.size} orgs\n"
-buf << "\n"
-
-repos = @stats.repos.sort do |l,r|
-  r.stats.committed.jd <=> l.stats.committed.jd
-end
-
-## pp repos
-
-
-buf << "committed / pushed / updated / created\n\n"
-
-today = Date.today
-
-repos.each_with_index do |repo,i|
-
-  days_ago = today.jd - repo.stats.committed.jd
-
-  diff1 = repo.stats.committed.jd - repo.stats.pushed.jd
-  diff2 = repo.stats.committed.jd - repo.stats.updated.jd
-  diff3 = repo.stats.pushed.jd    - repo.stats.updated.jd
-
-  buf <<  "- (#{days_ago}d) **#{repo.full_name}** ★#{repo.stats.stars} - "
-  buf <<  "#{repo.stats.committed} "
-  buf <<  "("
-  buf <<  (diff1==0 ? '=' : "#{diff1}d")
-  buf <<  "/"
-  buf <<  (diff2==0 ? '=' : "#{diff2}d")
-  buf <<  ")"
-  buf <<  " / "
-  buf <<  "#{repo.stats.pushed} "
-  buf <<  "("
-  buf <<  (diff3==0 ? '=' : "#{diff3}d")
-  buf <<  ")"
-  buf <<  " / "
-  buf <<  "#{repo.stats.updated} / "
-  buf <<  "#{repo.stats.created} - "
-  buf <<  "‹#{repo.stats.last_commit_message}›"
-  buf <<  " (#{repo.stats.size} kb)"
-  buf <<  "\n"
-end
-
-
-buf
-end  # method build
-end  # class ReportUpdates
-
-
-end # module Hubba

data/test/stats/jekyll~minima.json

@@ -1,25 +0,0 @@
-{
-  "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

@@ -1,27 +0,0 @@
-{
-  "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

@@ -1,39 +0,0 @@
-{
-  "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

@@ -1,21 +0,0 @@
-{
-  "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_stats.rb

@@ -1,125 +0,0 @@
-###
-#  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
-
-    Hubba.config.data_dir = "#{Hubba.root}/test/stats"
-    stats.read
-
-    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
-
-    Hubba.config.data_dir = "#{Hubba.root}/test/stats"
-    stats.read
-
-    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
-
-    Hubba.config.data_dir = "#{Hubba.root}/test/stats"
-    stats.read
-
-    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

@@ -1,44 +0,0 @@
-###
-#  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
-  end
-
-  def test_stats
-    repos = [
-      'poole/hyde',
-      'jekyll/minima'
-    ]
-
-
-    repos.each do |repo|
-      stats = Hubba::Stats.new( repo )
-
-      Hubba.config.data_dir = "#{Hubba.root}/test/stats"
-      stats.read()
-
-      puts "stars before fetch: #{stats.stars}"
-      puts "size  before fetch: #{stats.size} kb"
-
-      ## note/todo: enable for "live" online testing
-      ## @gh.update( stats )
-
-      puts "stars after fetch: #{stats.stars}"
-      puts "size  after fetch: #{stats.size} kb"
-
-      Hubba.config.data_dir = './tmp'
-      stats.write()
-    end
-
-    assert true    # for now everything ok if we get here
-  end
-
-end # class TestStatsTmp