footty 2024.5.10 → 2024.9.27

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 34ac44dbe56d51fad5a516b69331ab594243cbac79f5c4b63f69271455773cd5
-  data.tar.gz: 428605f76f7713f3e61f8cf53cf80d5c8c3d6add43f649a0d701e9ca465d4259
+  metadata.gz: 2254b1fa1cf0832e403b6bc0e6509d1ffee06e0f552fec2b805b124c0a867c0d
+  data.tar.gz: 8c8182dabe0e72801b580e46bed8471baacd01080fedac360b2532b63673d9cb
 SHA512:
-  metadata.gz: 359ab0cc33ca8b8482a1d2e9cb60ea58e96c95c5494dc35232018dba09fe164f22a8a167afc1536e90ed9dabb600fe412fab6d0c7aa1a4afa3e3967e3c857907
-  data.tar.gz: 344366274d54e0721d8a718af983dd555009db88a8d11f89e56149bef17cb24ff23e17c772ca133a31bef0e0ac65a1dc68207b45e3c9a4c9c429241d30398599
+  metadata.gz: 3e7421b9f2bf8ec572a55075970301343604a4dbaaabfeceec10827df9a712184fa9372a72c34e0f79811a4ae47b8a773115916e0e195d46def89a9e509b509d
+  data.tar.gz: 4ef82377e9caead4e3ec0048b8eac6120fe77c8de4018e69e74faec2842f33909626234a5bc2ccef137661f999c7825f9ef834c64cab292bcf4e9c357467d645

data/CHANGELOG.md

@@ -1,4 +1,4 @@
-### 2024.5.10
+### 2024.9.27
 ### 1.0.0 / 2018-06-09
 
 * Everything is new (again). First release.

data/Manifest.txt

@@ -3,6 +3,7 @@ Manifest.txt
 README.md
 Rakefile
 bin/footty
+bin/ftty
 lib/footty.rb
-lib/footty/client.rb
+lib/footty/dataset.rb
 lib/footty/version.rb

data/README.md

@@ -1,4 +1,5 @@
-# footty - football.db command line client for european ("euro") championship 2024 and more
+# footty - football.db command line tool for national & int'l football club leagues (& cups) from around the world (bonus - incl. world cup, euro and more)
+
 
 * home  :: [github.com/sportdb/footty](https://github.com/sportdb/footty)
 * bugs  :: [github.com/sportdb/footty/issues](https://github.com/sportdb/footty/issues)
@@ -11,15 +12,27 @@
 
 ## Usage - Who's playing today?
 
-The footty command line tool lets you query the online football.db HTTP JSON API services
+The footty command line tool lets you query the online football.db via HTTP
 for upcoming or past matches. For example:
 
-    $ footty              # Defaults to today's euro 2024 matches
+    $ footty         # Defaults to today's English Premier League 2024/25 matches
+
+prints on Sep 27, 2024:
+
+    Upcoming matches:
+    Sat Sep/28 12:30   (in 1d)    Newcastle United FC    vs    Manchester City FC     Matchday 6
+    Sat Sep/28 15:00   (in 1d)             Arsenal FC    vs    Leicester City FC      Matchday 6
+    Sat Sep/28 15:00   (in 1d)           Brentford FC    vs    West Ham United FC     Matchday 6
+    Sat Sep/28 15:00   (in 1d)             Chelsea FC    vs    Brighton & Hove Albion  Matchday 6
+    Sat Sep/28 15:00   (in 1d)             Everton FC    vs    Crystal Palace FC      Matchday 6
+    Sat Sep/28 15:00   (in 1d)   Nottingham Forest FC    vs    Fulham FC              Matchday 6
+    Sat Sep/28 17:30   (in 1d) Wolverhampton Wanderers FC    vs    Liverpool FC           Matchday 6
+    Sun Sep/29 14:00   (in 2d)        Ipswich Town FC    vs    Aston Villa FC         Matchday 6
+    Sun Sep/29 16:30   (in 2d)   Manchester United FC    vs    Tottenham Hotspur FC   Matchday 6
+    Mon Sep/30 20:00   (in 3d)        AFC Bournemouth    vs    Southampton FC         Matchday 6
+
 
-prints on Jun/14 2024:
 
-    #1 Fri Jun/14            Germany (GER)    vs    Scotland (SCO)         Group A / Matchday 1
-   
 Use `tomorrow` or `t` or `+1` to print tomorrow's matches e.g.:
 
     $ footty tomorrow    # -or-
@@ -41,9 +54,34 @@ Use `past` or `p` to print all past matches e.g.:
     $ footty p
 
 
+
 That's it. Enjoy the beautiful game.
 
 
+## Bonus - More Leagues & Cups  - Bundesliga, Serie A, Ligue 1, La Liga & More
+
+Pass in the league code to display the Germand Bundesliga, Spanish La Liga, etc:
+
+    $ footty de        #  who's playing in the bundesliga today?
+    $ footty es        #  who's playing in la liga today?
+    ...
+
+League codes include:
+
+- `de`  =>  Bundesliga
+- `es`  =>  La Liga
+- `it`  =>  Serie A
+- `fr`  =>  Ligue 1
+- ...
+
+More
+
+- `world`  =>  World Cup
+- `euro`   =>  "Euro" - European Championship
+
+See [footty/dataset](https://github.com/sportdb/footty/blob/master/lib/footty/dataset.rb) for the complete built-in list of data sources (and league keys).
+
+
 
 
 ## Trivia
@@ -66,7 +104,6 @@ Use it as you please with no restrictions whatsoever.
 
 
 
-
 ## Questions? Comments?
 
 Yes, you can. More than welcome.

data/Rakefile

@@ -2,29 +2,28 @@ require 'hoe'
 require './lib/footty/version.rb'
 
 Hoe.spec 'footty' do
-
   self.version = Footty::VERSION
 
-  self.summary = 'footty - football.db command line client for european "euro" championship 2024 and more - who is playing today?'
+  self.summary = "footty - football.db command line tool for national & int'l football club leagues (& cups) from around the world (bonus - incl. world cup, euro and more)"
   self.description = summary
 
   self.urls = { home: 'https://github.com/sportdb/footty' }
 
   self.author = 'Gerald Bauer'
-  self.email = 'opensport@googlegroups.com'
+  self.email  = 'gerald.bauer@gmail.com'
 
   # switch extension to .markdown for gihub formatting
   self.readme_file  = 'README.md'
   self.history_file = 'CHANGELOG.md'
 
   self.extra_deps = [
-    ['logutils' ],
-    ['fetcher']
+    ['sportdb-quick', '>= 0.2.0'],
+    ['webget'],
   ]
 
   self.licenses = ['Public Domain']
 
   self.spec_extras = {
-   required_ruby_version: '>= 2.3'
+   required_ruby_version: '>= 3.1.0'
   }
 end

data/bin/ftty

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+
+## tip: to test run:
+##   ruby -I ./lib bin/ftty
+
+require 'footty'
+
+Footty.main

data/lib/footty/dataset.rb

@@ -0,0 +1,189 @@
+module Footty
+
+
+  class Dataset
+    SOURCES = {
+      'world' => { '2022' => [ 'worldcup/2022--qatar/cup.txt',
+                               'worldcup/2022--qatar/cup_finals.txt'],
+                   '2018' => [ 'worldcup/2018--russia/cup.txt',
+                               'worldcup/2018--russia/cup_finals.txt']
+                 },
+      'euro' =>  { '2024' => 'euro/2024--germany/euro.txt',
+                   '2021' => 'euro/2021--europe/euro.txt'
+                 },
+      'de'  =>    'deutschland/$season$/1-bundesliga.txt',
+      'de2' =>   'deutschland/$season$/2-bundesliga2.txt',
+      'en'=>    'england/$season$/1-premierleague.txt',
+      'es'=>    'espana/$season$/1-liga.txt',
+      'it'=>    'italy/$season$/1-seriea.txt',
+      'at'=>    'austria/$season$/1-bundesliga.txt',
+      'at2'  =>   'austria/$season$/2-liga2.txt',
+      'at3o' =>   'austria/$season$/3-regionalliga-ost.txt',
+      'atcup' =>  'austria/$season$/cup.txt',
+
+      'fr'=>    'europe/france/$season$/1-ligue1.txt',
+      'nl'=>    'europe/netherlands/$season$/1-eredivisie.txt',
+      'be'=>    'europe/belgium/$season$/1-firstdivisiona.txt',
+
+      'champs'=> 'champions-league/$season$/cl.txt',
+
+      'br'    => 'south-america/brazil/$year$/1-seriea.txt',
+      'ar'    => 'south-america/argentina/$year$/1-primeradivision.txt',
+      'co'    => 'south-america/colombia/$year$/1-primeraa.txt',
+      ## use a different code for copa libertadores? why? why not?
+      'copa'  => 'south-america/copa-libertadores/$year$/libertadores.txt',
+
+      'mx'    => 'mexico/$season$/1-ligamx.txt',
+
+      'eg'    => 'africa/egypt/$season$/1-premiership.txt',
+      'ma'    => 'africa/morocco/$season$/1-botolapro1.txt',
+    }
+
+
+    ## return built-in league keys
+    def self.leagues()  SOURCES.keys; end
+
+
+    def initialize( league:,  year: nil )
+      @league = league
+
+      spec = SOURCES[ @league.downcase ]
+      urls = if spec.is_a?( Hash )  ## assume lookup by year
+                if year.nil?  ## lookup default first entry
+                     year = spec.keys[0].to_i
+                     spec.values[0]
+                else
+                     spec[ year.to_s ]
+                end
+              else  ## assume vanilla urls (no lookup by year)
+                   ## default to 2024 for now
+                   year = 2024  if year.nil?
+                   spec
+              end
+      raise ArgumentError, "no dataset (source) for league #{league} found"    if urls.nil?
+
+      ## wrap single sources (strings) in array
+      urls = urls.is_a?( Array ) ? urls : [urls]
+      ## expand shortened url and fill-in template vars
+      @urls = urls.map { |url| openfootball_url( url, year: year ) }
+    end
+
+
+    def openfootball_url( path, year: )
+       repo, local_path = path.split( '/',  2)
+       url = "https://raw.githubusercontent.com/openfootball/#{repo}/master/#{local_path}"
+       ## check for template vars too
+       season = Season( "#{year}/#{year+1}" )
+       url = url.gsub( '$year$', year.to_s )
+       url = url.gsub( '$season$', season.to_path )
+       url
+    end
+
+
+    ### note:
+    ##   cache ALL methods - only do one web request for match schedule & results
+    def matches
+      @data ||= begin
+                  matches = []
+                  @urls.each do |url|
+                    txt = get!( url )    ## use "memoized" / cached result
+                    matches += SportDb::QuickMatchReader.parse( txt )
+                  end
+                  data = matches.map {|match| match.as_json }  # convert to json
+                  ## quick hack to get keys as strings not symbols!!
+                  ##  fix upstream
+                  JSON.parse( JSON.generate( data ))
+                end
+    end
+
+
+    def end_date
+       @end_date ||= begin
+                        end_date = nil
+                        matches.each do |match|
+                           date = Date.strptime(match['date'], '%Y-%m-%d' )
+                           end_date = date  if end_date.nil? ||
+                                               date > end_date
+                        end
+                        end_date
+                     end
+    end
+
+    def start_date
+       @start_date ||= begin
+                        start_date = nil
+                        matches.each do |match|
+                           date = Date.strptime(match['date'], '%Y-%m-%d' )
+                           start_date = date  if start_date.nil? ||
+                                               date < start_date
+                        end
+                        start_date
+                       end
+    end
+
+    def todays_matches( date: Date.today )      matches_for( date ); end
+    def tomorrows_matches( date: Date.today )   matches_for( date+1 );  end
+    def yesterdays_matches( date: Date.today )  matches_for( date-1 );  end
+
+    def matches_for( date )
+      matches = select_matches { |match| date == Date.parse( match['date'] ) }
+      matches
+    end
+
+
+    def upcoming_matches( date: Date.today,
+                          limit: nil )
+      ## note: includes todays matches for now
+      matches = select_matches { |match| date <= Date.parse( match['date'] ) }
+
+      if limit
+        matches[0, limit]  ## cut-off
+      else
+        matches
+      end
+    end
+
+    def past_matches( date: Date.today )
+      matches = select_matches { |match| date > Date.parse( match['date'] ) }
+      ## note reveserve matches (chronological order/last first)
+      ## matches.reverse
+      matches
+    end
+
+
+private
+    def select_matches( &blk)
+      selected = []
+      matches.each do |match|
+         selected << match   if blk.call( match )
+      end
+
+      ## todo/fix:
+      ##  sort matches here; might not be chronologicial (by default)
+      selected
+    end  # method select_matches
+
+
+
+    def get!( url )
+        ##  use cached urls for 12h by default
+        ##  if expired in cache (or not present) than get/fetch
+       if Webcache.expired_in_12h?( url )
+         response = Webget.text( url )
+
+         if response.status.ok?
+           response.text   # note - return text (utf-8)
+         else
+           ## dump headers
+           response.headers.each do |key,value|
+             puts "   #{key}:  #{value}"
+           end
+           puts "!! HTTP ERROR - #{response.status.code} #{response.status.message}"
+           exit 1
+         end
+       else
+         Webcache.read( url )
+       end
+    end  # method get_txt!
+  end # class Dataset
+end # module Footty

data/lib/footty/version.rb

@@ -1,6 +1,6 @@
 
 module Footty
-   VERSION = '2024.5.10'
+   VERSION = '2024.9.27'
 
    def self.banner
      "footty/#{VERSION} on Ruby #{RUBY_VERSION} (#{RUBY_RELEASE_DATE}) [#{RUBY_PLATFORM}] in (#{root})"

data/lib/footty.rb

@@ -1,63 +1,75 @@
-## stdlibs
+require 'sportdb/quick'   ## note - pulls in cocos et al
+require 'webget'    ## add webcache support
 
-require 'net/http'
-require 'uri'
-require 'json'
-require 'pp'
-
-
-## 3rd party gems/libs
-## require 'props'
+# our own code
+require_relative 'footty/version' # let it always go first
+require_relative 'footty/dataset'
 
-require 'logutils'
-require 'fetcher'
 
 
-# our own code
-require 'footty/version' # let it always go first
-require 'footty/client'
+## set cache to local .cache dir for now - why? why not?
+Webcache.root = './cache'
+#  pp Webcache.root
+Webget.config.sleep = 1  ## set delay in secs (to 1 sec - default is/maybe 3)
 
 
 module Footty
+  def self.main( args=ARGV )
+    puts banner # say hello
 
-  def self.client
-    ## note: hard code tournament / league for now
-    @client ||= Client.new( league: 'euro', year: 2024 )    ## use "singelton" / shared client
-  end
+     league = 'en'
+     year   = nil
 
+     leagues = Dataset.leagues  ## e.g. ['world','euro',
+                                ##       'de','en','at']
 
+     ## filter args for league or year
+     args = args.select do |arg|
+                             if arg =~ /^\d{4}$/
+                                 year = arg.to_i(10)
+                                 false  ## eat-up
+                             elsif leagues.include?( arg )
+                                 league = arg
+                                 false
+                             else
+                                 true
+                             end
+                         end
 
-  def self.main
-    puts banner # say hello
 
-    what = ARGV[0] || 'today'
+    what = args[0] || 'today'
     what = what.downcase
 
+
+    # Dataset.new( league: 'euro', year: 2024 )
+    dataset = Dataset.new( league: league, year: year )
+
+
     ## in the future make today "configurable" as param - why? why not?
     today = Date.today
 
     if ['yesterday', 'y', '-1'].include?( what )
-      matches = client.yesterdays_matches
+      matches = dataset.yesterdays_matches
       if matches.empty?
          puts "** No matches played yesterday.\n"
       end
     elsif ['tomorrow', 't', '+1', '1'].include?( what )
-      matches = client.tomorrows_matches
+      matches = dataset.tomorrows_matches
       if matches.empty?
          puts "** No matches scheduled tomorrow.\n"
       end
     elsif ['past', 'p', 'prev'].include?( what )
-      matches = client.past_matches
+      matches = dataset.past_matches
       if matches.empty?
          puts "** No matches played yet.\n"
       end
     elsif ['upcoming', 'up', 'u', 'next', 'n'].include?( what )
-      matches = client.upcoming_matches
+      matches = dataset.upcoming_matches
       if matches.empty?
          puts "** No more matches scheduled.\n"
       end
     else
-       matches = client.todays_matches
+       matches = dataset.todays_matches
 
        ## no matches today
        if matches.empty?
@@ -65,50 +77,71 @@ module Footty
 
           ## note: was world cup 2018 - end date -- Date.new( 2018, 7, 11 )
           ## note: was euro 2020 (in 2021) - end date -- Date.new( 2021, 7, 11 )
-          if Date.today > Date.new( 2024, 7, 14 )     ## tournament is over, look back
+          if Date.today > dataset.end_date    ## tournament is over, look back
             puts "Past matches:"
-            matches = client.past_matches
+            matches = dataset.past_matches
           else  ## world cup is upcoming /in-progress,look forward
             puts "Upcoming matches:"
-            matches = client.upcoming_matches
+            matches = dataset.upcoming_matches( limit: 18 )
           end
        end
     end
 
-
-
     print_matches( matches )
   end
 
 
-
   def self.print_matches( matches )
     ## print games
 
     today = Date.today
 
     matches.each do |match|
-      print "   %5s" % "\##{match['num']} "
+      print "   %5s" % "\##{match['num']} "   if match['num']
 
-      date = Date.parse( match['date'] )
+      date = Date.strptime( match['date'], '%Y-%m-%d' )
       print "#{date.strftime('%a %b/%d')} "      ## e.g. Thu Jun/14
+      print "#{match['time']} "  if match['time']
+
       if date > today
          diff = (date - today).to_i
          print "%10s" % "(in #{diff}d) "
       end
 
-      print "%22s" % "#{match['team1']['name']} (#{match['team1']['code']})"
 
-      ## todo/fix: add support for knockout scores
-      ##                 with score1et/score1p  (extra time and penalty)
-      if match['score1'] && match['score2']
+      if match['team1'].is_a?( Hash )
+        print "%22s" % "#{match['team1']['name']} (#{match['team1']['code']})"
+      else
+        print "%22s" % "#{match['team1']}"
+      end
+
+
+      if match['score'].is_a?( Hash ) &&
+         match['score']['ft']
+          if match['score']['ft']
+             print " #{match['score']['ft'][0]}-#{match['score']['ft'][1]} "
+          end
+          if match['score']['et']
+            print "aet #{match['score']['et'][0]}-#{match['score']['et'][1]} "
+          end
+          if match['score']['p']
+            print "pen #{match['score']['p'][0]}-#{match['score']['p'][1]} "
+          end
+      elsif match['score1'] && match['score2']
+        ## todo/fix: add support for knockout scores
+        ##                 with score1et/score1p  (extra time and penalty)
         print " #{match['score1']}-#{match['score2']} "
         print "(#{match['score1i']}-#{match['score2i']}) "
       else
         print "    vs    "
       end
 
-      print "%-22s" % "#{match['team2']['name']} (#{match['team2']['code']})"
+      if match['team2'].is_a?( Hash )
+        print "%-22s" % "#{match['team2']['name']} (#{match['team2']['code']})"
+      else
+        print "%-22s" % "#{match['team2']}"
+      end
+
 
       if match['group']
         print " #{match['group']} /"    ## group phase/stage
@@ -149,8 +182,6 @@ module Footty
         end
         print "]\n"
       end
-
-
     end
   end
 

metadata

@@ -1,31 +1,31 @@
 --- !ruby/object:Gem::Specification
 name: footty
 version: !ruby/object:Gem::Version
-  version: 2024.5.10
+  version: 2024.9.27
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-05-10 00:00:00.000000000 Z
+date: 2024-09-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: logutils
+  name: sportdb-quick
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.2.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.2.0
 - !ruby/object:Gem::Dependency
-  name: fetcher
+  name: webget
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -72,11 +72,12 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '4.1'
-description: footty - football.db command line client for european "euro" championship
-  2024 and more - who is playing today?
-email: opensport@googlegroups.com
+description: footty - football.db command line tool for national & int'l football
+  club leagues (& cups) from around the world (bonus - incl. world cup, euro and more)
+email: gerald.bauer@gmail.com
 executables:
 - footty
+- ftty
 extensions: []
 extra_rdoc_files:
 - CHANGELOG.md
@@ -88,8 +89,9 @@ files:
 - README.md
 - Rakefile
 - bin/footty
+- bin/ftty
 - lib/footty.rb
-- lib/footty/client.rb
+- lib/footty/dataset.rb
 - lib/footty/version.rb
 homepage: https://github.com/sportdb/footty
 licenses:
@@ -105,7 +107,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.3'
+      version: 3.1.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -115,6 +117,6 @@ requirements: []
 rubygems_version: 3.4.10
 signing_key:
 specification_version: 4
-summary: footty - football.db command line client for european "euro" championship
-  2024 and more - who is playing today?
+summary: footty - football.db command line tool for national & int'l football club
+  leagues (& cups) from around the world (bonus - incl. world cup, euro and more)
 test_files: []

data/lib/footty/client.rb

@@ -1,106 +0,0 @@
-module Footty
-
-
-  class Client
-
-    include LogUtils::Logging
-
-
-    def initialize( league:, year: )
-      @worker = Fetcher::Worker.new
-
-      @league = league
-      @year   = year
-    end
-
-
-    APIS = {
-      worldcup: 'https://github.com/openfootball/worldcup.json/raw/master/$year$/worldcup.json',
-      euro:     'https://github.com/openfootball/euro.json/raw/master/$year$/euro.json'
-    }
-
-    ### note:
-    ##   cache ALL methods - only do one web request for match schedule & results
-    def get_matches
-      @data ||= begin
-                  str = APIS[ @league.downcase.to_sym ]
-                  str = str.gsub( '$year$', @year.to_s )
-
-                  get( str )    ## use "memoized" / cached result
-                end
-    end
-
-
-
-
-    ## for testing lets you use /round/1 etc.
-    def round( num )
-      h = get_matches
-      matches = h[ 'rounds' ][ num-1 ]    ## note: rounds hash starts with zero (not 1)
-      matches
-    end
-
-
-    def todays_matches( date: Date.today )      matches_for( date ); end
-    def tomorrows_matches( date: Date.today )   matches_for( date+1 );  end
-    def yesterdays_matches( date: Date.today )  matches_for( date-1 );  end
-
-    def matches_for( date )
-      hash  = get_matches
-      matches = select_matches( hash[ 'rounds' ] ) { |match| date == Date.parse( match['date'] ) }
-      matches
-    end
-
-
-    def upcoming_matches( date: Date.today )
-      ## note: includes todays matches for now
-      hash  = get_matches
-      matches = select_matches( hash[ 'rounds' ] ) { |match| date <= Date.parse( match['date'] ) }
-      matches
-    end
-
-    def past_matches( date: Date.today )
-      hash  = get_matches
-      matches = select_matches( hash[ 'rounds' ] ) { |match| date > Date.parse( match['date'] ) }
-      ## note reveserve matches (chronological order/last first)
-      matches.reverse
-    end
-
-private
-
-    def select_matches( rounds )
-      matches = []
-      rounds.each do |round|
-        round['matches'].each do |match|
-          if yield( match )
-            ## hack: add (outer) round to match
-            match['round'] = round['name']
-            matches << match
-          else
-            ## puts " skipping game   play_date #{play_date}"
-          end
-        end
-      end
-      matches
-    end
-
-
-    def get( str )
-      response = @worker.get_response( str )
-
-      if response.code == '200'
-        ##
-        ## fix/fix/todo/check:
-        ##  do we need to force utf-8 encoding? yes!!!!
-        ##   check for teams w/ non-ascii names
-        hash = JSON.parse( response.body )
-        ## pp hash
-        hash
-      else
-        logger.error "fetch HTTP - #{response.code} #{response.message}"
-        nil
-      end
-    end
-
-  end # class Client
-end # module Footty