hubba-reports 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 7ee2141ffe85e3b014a6daa85aabad4e5af114db
-  data.tar.gz: f85975570218c0524741c6e2e5e07bb5aee1d81a
+  metadata.gz: 70dc07063bf62e795d5108be9264de6775e03d98
+  data.tar.gz: 2cd758aeb541c1b5681f424d3114a2fbb157d8fc
 SHA512:
-  metadata.gz: 56a8b905a23cf89f4769b16d19fde1dd8af53fbc35c964a64a5aacce7de0e7cecc2adbce6dbfcafed6aaa31bb24b79248dcec67ba3f2e7de00efdff67cc8adc0
-  data.tar.gz: 822cac3ce1638e3eb539c0517989711e218c6773b4570891cee26fc57d2e2f08c5c9d58e3b5fba2a18f9b10c10eaf47808e80e380f67fdb03d410dca371f3640
+  metadata.gz: 55d57dabc6cd034c292ae3d25d1b31d65a065e5604c50894417754ca060e14124b66d07d82ae0f3df9adef3bfcbb70e90cf0aec0dd80a2a06edc682518a03504
+  data.tar.gz: 21c0b6274481cab436da6d43961e7fd8fad508069793525324fa501d07e47201283eef510080d0af1a7f386b4113b0ddc482cc850481c953eb203cac37217ba5

data/Manifest.txt

@@ -6,6 +6,7 @@ lib/hubba/reports.rb
 lib/hubba/reports/folio.rb
 lib/hubba/reports/reports/base.rb
 lib/hubba/reports/reports/catalog.rb
+lib/hubba/reports/reports/languages.rb
 lib/hubba/reports/reports/size.rb
 lib/hubba/reports/reports/stars.rb
 lib/hubba/reports/reports/summary.rb

data/README.md

@@ -17,18 +17,24 @@ See the [hubba gem](https://github.com/rubycoco/git/tree/master/hubba) on how to
 
 
 
-###  Generate some statistics / reports
+###  Statistics / reports
 
 
-Hubba has four built-in reports (for now):
+Hubba has about a dozen 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
+- ...
 
+Look into the [/reports](https://github.com/rubycoco/git/tree/master/hubba-reports/lib/hubba/reports/reports)
+directory for all reports and, yes, you can - on how to code your very own.
 
-If you only generate a single report, use:
+
+#### Generate statistic / reports
+
+If you only generate a single built-in report, use:
 
 ``` ruby
 require 'hubba/reports'
@@ -54,6 +60,8 @@ report.save( './TIMELINE.md' )
 
 report = Hubba::ReportUpdates.new( stats )
 report.save( './UPDATES.md' )
+
+# ...
 ```
 
 

data/lib/hubba/reports.rb

@@ -9,6 +9,7 @@ require 'hubba/reports/folio'
 
 require 'hubba/reports/reports/base'
 require 'hubba/reports/reports/catalog'
+require 'hubba/reports/reports/languages'
 require 'hubba/reports/reports/size'
 require 'hubba/reports/reports/stars'
 require 'hubba/reports/reports/summary'

data/lib/hubba/reports/reports/languages.rb

@@ -0,0 +1,97 @@
+module Hubba
+
+
+class ReportLanguages < Report
+
+def build
+
+## note: orgs is orgs+users e.g. geraldb, yorobot etc
+buf = String.new('')
+buf << "# Languages"
+buf << " - #{@stats.repos.size} Repos @ #{@stats.orgs.size} Orgs"
+buf << "\n\n"
+
+
+buf << "language lines in byte / language used in repos (count)"
+buf << "\n\n"
+
+
+### note: skip repos WITHOUT languages stats e.g. empty hash {}
+repos = @stats.repos.select do |repo|
+  langs = repo.stats.languages
+  res   = langs && langs.size > 0  ## return true if present and non-empty hash too
+  puts "    no languages - skipping >#{repo.full_name}<..."   unless res
+  res
+end
+
+
+## collect all langs with refs to repos
+##  note/warn: do NOT use langs as local variable - will RESET this langs here!!!
+langs = {}
+
+repos.each do |repo|
+  puts "#{repo.full_name}:"
+  pp repo.stats.languages
+  repo.stats.languages.each do |lang,bytes|
+     # note: keep using all string (NOT symbol) keys - why? why not?
+     line = langs[ lang ] ||= { 'count' => 0, 'bytes' => 0 }
+     line[ 'count' ] += 1
+     line[ 'bytes' ] += bytes
+  end
+end
+
+langs_by_bytes = langs.sort {|(llang,lline),(rlang,rline)|
+                       res = rline['bytes'] <=> lline['bytes']
+                       res = llang <=> rlang   if res == 0
+                       res
+                     }
+               .to_h    # convert back to hash (from array)
+
+
+bytes_total = langs.reduce(0) {|sum,(lang,line)| sum+line['bytes'] }
+langs_by_bytes.each_with_index do |(lang, line),i|
+  bytes = line['bytes']
+  percent = Float(100*bytes)/Float(bytes_total)
+
+  buf << "#{i+1}. "
+  buf << "#{bytes} (#{('%2.2f' % percent)}%) "
+  buf << "**#{lang}** "
+  buf << "_(#{line['count']})_"
+  buf << "\n"
+end
+buf << "<!-- break -->\n"   ## markdown hack: add a list end marker
+buf << "\n\n"
+
+
+buf << "Languages used in repos (count):"
+buf << "\n\n"
+
+
+langs_by_count = langs.sort {|(llang,lline),(rlang,rline)|
+                       res = rline['count'] <=> lline['count']
+                       res = llang <=> rlang   if res == 0
+                       res
+                     }
+               .to_h    # convert back to hash (from array)
+
+
+count_total =  repos.size   # note: use (filtered) repos for count total
+langs_by_count.each_with_index do |(lang, line),i|
+  count = line['count']
+  percent = Float(100*count)/Float(count_total)
+
+  buf << "#{i+1}. "
+  buf << "#{count} (#{('%2.2f' % percent)}%) "
+  buf << "**#{lang}** "
+  buf << "(#{line['bytes']} bytes)"
+  buf << "\n"
+end
+buf << "<!-- break -->\n"   ## markdown hack: add a list end marker
+buf << "\n\n"
+
+
+buf
+end  # method build
+end  # class ReportLanguages
+
+end # module Hubba

data/lib/hubba/reports/reports/traffic.rb

@@ -60,6 +60,24 @@ repos_by_org = repos.group_by { |repo|
                         .to_h  ## convert back to hash
 
 
+### start with summary
+##  limit to top 10 or top 20 - why? why not?
+repos_by_org.each_with_index do |(owner, repos),i|
+  views  = repos.reduce(0) {|sum,repo| sum+repo.stats.traffic['summary']['views']['count'] }
+  clones = repos.reduce(0) {|sum,repo| sum+repo.stats.traffic['summary']['clones']['count'] }
+
+  buf << "#{i+1}. **#{owner}** views: #{views}, clones: #{clones}  _(#{repos.size})_"
+  buf << "\n"
+end
+
+buf << "<!-- break -->\n"   ## markdown hack: add a list end marker
+buf << "\n\n"
+
+
+
+buf << "Details:"   ## markdown hack: add a list end marker
+buf << "\n\n"
+
 repos_by_org.each_with_index do |(owner, repos),i|
   views  = repos.reduce(0) {|sum,repo| sum+repo.stats.traffic['summary']['views']['count'] }
   clones = repos.reduce(0) {|sum,repo| sum+repo.stats.traffic['summary']['clones']['count'] }

data/lib/hubba/reports/reports/traffic_pages.rb

@@ -85,6 +85,22 @@ lines_by_path = lines.group_by { |line|
                         .to_h  ## convert back to hash
 
 
+### start with summary
+##  limit to top 10 or top 20 - why? why not?
+lines_by_path.each_with_index do |(path, lines),i|
+  count   = lines.reduce(0) {|sum,line| sum+line['count']}
+  buf << "#{i+1}. **#{path}** #{count}   _(#{lines.size})_"
+  buf << "\n"
+end
+
+buf << "<!-- break -->\n"   ## markdown hack: add a list end marker
+buf << "\n\n"
+
+
+
+buf << "Details:"
+buf << "\n\n"
+
 lines_by_path.each_with_index do |(path, lines),i|
   count   = lines.reduce(0) {|sum,line| sum+line['count']}
   buf << "#{i+1}. **#{path}** #{count}   _(#{lines.size})_"

data/lib/hubba/reports/reports/traffic_referrers.rb

@@ -76,6 +76,23 @@ lines_by_referrer = lines.group_by { |line| line['referrer'] }
                           .to_h  ## convert back to hash
 
 
+### start with summary
+##  limit to top 10 or top 20 - why? why not?
+lines_by_referrer.each_with_index do |(referrer, lines),i|
+  count   = lines.reduce(0) {|sum,line| sum+line['count']}
+  buf << "#{i+1}. **#{referrer}** #{count}  _(#{lines.size})_"
+  buf << "\n"
+end
+
+buf << "<!-- break -->\n"   ## markdown hack: add a list end marker
+buf << "\n\n"
+
+
+
+buf << "Details:"
+buf << "\n\n"
+
+
 lines_by_referrer.each_with_index do |(referrer, lines),i|
   count   = lines.reduce(0) {|sum,line| sum+line['count']}
   buf << "#{i+1}. **#{referrer}** #{count}  _(#{lines.size})_"

data/lib/hubba/reports/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hubba-reports
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-10-15 00:00:00.000000000 Z
+date: 2020-10-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: hubba
@@ -76,6 +76,7 @@ files:
 - lib/hubba/reports/folio.rb
 - lib/hubba/reports/reports/base.rb
 - lib/hubba/reports/reports/catalog.rb
+- lib/hubba/reports/reports/languages.rb
 - lib/hubba/reports/reports/size.rb
 - lib/hubba/reports/reports/stars.rb
 - lib/hubba/reports/reports/summary.rb