tlaw 0.0.2 → 0.1.0.pre

data/examples/experimental/omdb.rb

@@ -0,0 +1,68 @@
+require_relative '../demo_base'
+#http://docs.themoviedb.apiary.io/#reference/movies/movielatest
+
+class OMDB < TLAW::API
+  define do
+    base 'http://www.omdbapi.com'
+    param :api_key, field: :apikey, required: true
+
+    SPLIT = ->(v) { v.split(/\s*,\s*/) }
+
+    shared_def :imdb do
+      post_process('imdbRating', &:to_f)
+      post_process('imdbVotes') { |v| v.gsub(',', '').to_i }
+    end
+
+    post_process do |response|
+      response.delete('Response') == 'False' and fail(response['Error'])
+    end
+
+    endpoint :by_id, path: '/?i={imdb_id}' do
+      param :imdb_id, required: true
+
+      param :type, enum: %i[movie series episode]
+      param :year, :to_i, field: :y
+      param :plot, enum: %i[short full]
+      param :tomatoes, enum: [true, false]
+
+      post_process('Released', &Date.method(:parse))
+      post_process('totalSeasons', &:to_i)
+      use_def :imdb
+    end
+
+    endpoint :by_title, path: '/?t={title}' do
+      param :title, required: true
+
+      param :type, enum: %i[movie series episode]
+      param :year, :to_i, field: :y
+      param :plot, enum: %i[short full]
+      param :tomatoes, enum: [true, false]
+
+      post_process('Released', &Date.method(:parse))
+      use_def :imdb
+
+      post_process('Metascore', &:to_i)
+
+      post_process('totalSeasons', &:to_i)
+
+      post_process('Genre', &SPLIT)
+      post_process('Country', &SPLIT)
+      post_process('Writer', &SPLIT)
+      post_process('Actors', &SPLIT)
+    end
+
+    endpoint :search, path: '/?s={search}' do
+      param :search, required: true
+
+      param :type, enum: %i[movie series episode]
+      param :year, :to_i, field: :y
+      param :page, :to_i
+    end
+  end
+end
+
+o = OMDB.new(api_key: ENV.fetch('OMDB'))
+
+#pp o.by_id("tt0944947")
+pp o.by_title('Suicide Squad', tomatoes: true, plot: :full)
+#pp o.search('Game of')['Search'].first

data/examples/experimental/open_exchange_rates.rb

@@ -0,0 +1,36 @@
+require_relative '../demo_base'
+
+class OpenExchangeRate < TLAW::API
+  define do
+    base 'https://openexchangerates.org/api'
+
+    param :app_id, required:  true
+
+    post_process { |h|
+      h['rates'] = h
+        .select { |k, v| k.start_with?('rates.') }
+        .map { |k, v| {'to' => k.sub('rates.', ''), 'rate' => v} }
+
+      h.reject! { |k, v| k.start_with?('rates.') }
+    }
+    post_process 'timestamp', &Time.method(:at)
+
+    endpoint :currencies, path: '/currencies.json'
+
+    endpoint :latest, path: '/latest.json'
+
+    endpoint :historical, path: '/historical/{date}.json' do
+      param :date, :to_date, format: ->(v) { v.strftime('%Y-%m-%d') }
+    end
+
+    endpoint :usage, path: '/usage.json'
+  end
+end
+
+api = OpenExchangeRate.new(app_id: ENV['OPEN_EXCHANGE_RATES'])
+
+#pp api.latest['rates'].first(3)
+#pp api.historical(Date.parse('2016-05-01'))['rates'].detect { |r| r['to'] == 'INR' } #, base: 'USD')
+#pp api.convert(100, 'INR', 'USD')
+#pp api.usage
+pp api.latest['rates'].detect { |r| r['to'] == 'INR' }

data/examples/experimental/open_route.rb

@@ -0,0 +1,27 @@
+require_relative '../demo_base'
+require 'geo/coord'
+
+class OpenRouteService < TLAW::API
+  define do
+    base 'https://api.openrouteservice.org'
+
+    param :api_key
+
+    endpoint :directions do
+      post_process { |res|
+        res['route'] = res['routes'].first
+      }
+      param :coordinates, :to_a, keyword: false,
+        format: ->(coords) { coords.map { |c| c.latlng.join(',') }.join('|') }
+      param :profile
+      param :geometry
+      param :geometry_format
+    end
+  end
+end
+
+osm = OpenRouteService.new(api_key: ENV['OPEN_ROUTE_SERVICE'])
+kharkiv = Geo::Coord.new(50.004444,36.231389)
+kyiv = Geo::Coord.new(50.450000,30.523333)
+
+pp osm.directions([kharkiv, kyiv], profile: 'driving-car', geometry_format: 'geojson')['route.segments'].first['steps']

data/examples/experimental/open_street_map.rb

@@ -0,0 +1,16 @@
+require 'pp'
+
+$:.unshift 'lib'
+require 'tlaw'
+
+class OpenStreetMap < TLAW::API
+  define do
+    base 'http://api.openstreetmap.org/api/0.6'
+
+    endpoint :relation, '/relation/{id}', xml: true
+  end
+end
+
+osm = OpenStreetMap.new
+
+pp osm.relation(1543125)["osm.relation.tag"].to_a

data/examples/experimental/quandl.rb

@@ -0,0 +1,50 @@
+require 'pp'
+
+$:.unshift 'lib'
+require 'tlaw'
+
+# https://www.quandl.com/docs/api?json#get-data
+class Quandl < TLAW::API
+  define do
+    base 'https://www.quandl.com/api/v3'
+
+    param :api_key, required: true
+
+    namespace :databases do
+      endpoint :list, path: '.json' do
+        param :per_page, :to_i
+      end
+
+      endpoint :search, '.json?query={query}' do
+        param :query, required: true
+      end
+
+      namespace :[], '/{code}' do
+        endpoint :meta, '.json'
+        endpoint :codes, '/codes.csv'
+
+        namespace :datasets, '/../../datasets/{code}' do
+          endpoint :[], '/{dataset_code}.json' do
+            param :code
+
+            post_process { |h|
+              columns = h['dataset.column_names']
+              h['dataset.data'] = h['dataset.data']
+                .map { |r| columns.zip(r).to_h }
+            }
+
+            post_process_items 'dataset.data' do
+              post_process 'Date', &Date.method(:parse)
+            end
+          end
+        end
+      end
+    end
+  end
+end
+
+q = Quandl.new(api_key: ENV['QUANDL'])
+
+#pp q.databases.search('ukraine')['databases'].first
+pp q.databases['WIKI'].datasets['AAPL', code: 'WIKI']['dataset.data']['Date'].min
+#pp q.databases['WIKI'].datasets.endpoint(:[]).construct_template

data/examples/experimental/reddit.rb

@@ -0,0 +1,25 @@
+require 'pp'
+
+$:.unshift 'lib'
+require 'tlaw'
+
+class Reddit < TLAW::API
+  define do
+    base 'https://www.reddit.com'
+
+    post_process_items 'data.children' do
+      post_process("data.permalink") { |v| "https://www.reddit.com#{v}" }
+      post_process("data.created", &Time.method(:at))
+    end
+
+    namespace :r, '/r/{subreddit}' do
+      endpoint :new, '/new.json' do
+      end
+    end
+  end
+end
+
+r = Reddit.new
+res = r.r(:ruby).new
+p res['data.children']['data.ups']
+p res['data.children']['data.num_comments']

data/examples/experimental/swapi.rb

@@ -0,0 +1,27 @@
+require 'pp'
+
+$:.unshift 'lib'
+require 'tlaw'
+
+class SWAPI < TLAW::API
+  define do
+    base 'http://swapi.co/api'
+
+    namespace :people do
+      endpoint :all, ''
+      endpoint :[], '/{id}/'
+      endpoint :search, '/?search={query}'
+    end
+
+    namespace :species do
+      endpoint :all, ''
+      endpoint :[], '/{id}/'
+      endpoint :search, '/?search={query}'
+    end
+  end
+end
+
+s = SWAPI.new
+
+pp s.people.search('r2')['results'].first
+pp s.species[2]

data/examples/experimental/tmdb.rb

@@ -0,0 +1,53 @@
+require 'pp'
+
+$:.unshift 'lib'
+require 'tlaw'
+
+#http://docs.themoviedb.apiary.io/#reference/movies/movielatest
+
+class TMDB < TLAW::API
+  define do
+    base 'http://api.themoviedb.org/3'
+    param :api_key, required: true
+    param :language, default: 'en'
+
+    namespace :movies, '/movie' do
+      namespace :[], '/{id}' do
+        param :id, required: true
+
+        endpoint :get, ''
+
+        endpoint :alt_titles
+
+        endpoint :images
+      end
+
+      endpoint :latest
+      endpoint :now_playing do
+        param :page, :to_i, default: 1 # TODO: validate: 1..1000
+      end
+
+      endpoint :upcoming
+    end
+
+    namespace :search do
+      endpoint :movie do
+        param :query, required: true, keyword: false
+
+        #post_process_items 'results', 'release_date', &Date.method(:parse)
+        # TODO: post-process image pathes!
+      end
+    end
+
+    # TODO: should work!
+    #post_process_items 'results', 'release_date', &Date.method(:parse)
+  end
+end
+
+tmdb = TMDB.new(api_key: ENV['TMDB'], language: 'uk')
+
+#pp tmdb.movies.upcoming['results'].columns(:release_date, :title).to_a
+#pp tmdb.movies[413898].images
+#p tmdb.describe
+#pp tmdb.search.movie('Terminator')['results'].first
+p tmdb.movies[1187043].get

data/examples/experimental/world_bank.rb

@@ -0,0 +1,85 @@
+require 'pp'
+
+$:.unshift 'lib'
+require 'tlaw'
+
+class WorldBank < TLAW::API
+  define do
+    base 'http://api.worldbank.org'
+
+    post_process_replace { |response|
+      if response.is_a?(Array) && response.size == 1 && response.first.is_a?(Hash)
+        response.first
+      elsif response.is_a?(Array) && response.size == 2
+        {'meta' => response.first, 'data' => response.last}
+      else
+        response
+      end
+    }
+
+    post_process_items('data') do
+      post_process 'longitude', &:to_f
+      post_process 'latitude', &:to_f
+      post_process 'value', &:to_f
+      # post_process 'date', &Date.method(:parse)
+    end
+
+    SINGULAR = ->(h) { h['data'].first }
+
+    namespace :countries, '/countries' do
+      endpoint :list, '?format=json' do
+        param :income_level, field: :incomeLevel
+        param :lending_type, field: :lendingType
+      end
+
+      namespace :[], '/{country}' do
+        #param :countries, :to_a, format: ->(c) { c.join(';') }
+        # TODO: splat
+
+        endpoint :get, '?format=json' do
+          #post_process_replace(&SINGULAR)
+        end
+
+        endpoint :indicator, '/indicators/{name}?format=json'
+        # TODO: filter indicator by date
+      end
+    end
+
+    namespace :dictionaries, '' do
+      endpoint :topics, '/topics?format=json'
+      #namespace :sources, '/sources?format=json' do
+
+      endpoint :income_levels, '/incomeLevels?format=json'
+      endpoint :lending_types, '/lendingTypes?format=json'
+
+      namespace :indicators do
+        endpoint :list, '?format=json'
+        endpoint :by_topic, '/../topic/{topic_id}/indicator?format=json'
+        endpoint :by_source, '/../source/{source_id}/indicators?format=json'
+
+        endpoint :[], '/{name}?format=json' do
+          post_process_replace(&SINGULAR)
+        end
+      end
+    end
+  end
+end
+
+wb = WorldBank.new
+
+#pp wb.dictionaries.indicators.list
+
+#pp wb.sources['data']['name'].reject(&:empty?)
+#pp wb.countries(income_level: 'LIC')['data']['name'].sort # ['message'].first
+#pp wb.indicators['NY.GDP.MKTP.CD'] #['data'].first
+#pp wb.sources[3].indicators #['data']['name']
+#pp wb.countries['ua'].indicator('NY.GDP.MKTP.CD')['data'].first(5)
+#pp wb.countries['ua'].get
+#pp wb.dictionaries.indicators.by_topic(5)['data'].last
+
+#pp wb.countries.list['data'].to_a
+#pp wb.countries['us'].indicator("EG.EGY.PRIM.PP.KD")['data'].first(10)
+
+#pp wb.countries['ukr'].get['data'].first
+#pp wb.dictionaries.indicators.list
+pp wb.countries['ukr'].indicator('SP.POP.TOTL')['data'].to_a.first(3)

data/examples/experimental/world_bank_climate.rb

@@ -0,0 +1,77 @@
+require 'pp'
+
+$:.unshift 'lib'
+require 'tlaw'
+
+class WorldBankClimate < TLAW::API
+  define do
+    base 'http://climatedataapi.worldbank.org/climateweb/rest/v1'
+
+    {
+      basin: :basinID,
+      country: :country_iso3
+    }.each do |namespace_name, param_name|
+      namespace namespace_name do
+        param param_name, keyword: false, required: true
+
+        {
+          :temperature => 'tas',
+          :precipation => 'pr'
+        }.each do |varname, var|
+          namespace varname, path: '' do
+            {
+              monthly: 'mavg',
+              annual: 'annualavg',
+              monthly_anomaly: 'manom',
+              annual_anomaly: 'annualanom'
+            }.each do |typename, type|
+              endpoint typename, path: "/#{type}/#{var}/{since}/{#{param_name}}.json" do
+                param :since, keyword: true, required: true,
+                  enum: {
+                    1920 => '1920/1939',
+                    1940 => '1940/1959',
+                    1960 => '1960/1979',
+                    1980 => '1980/1999',
+                    2020 => '2020/2039',
+                    2040 => '2040/2059',
+                    2060 => '2060/2079',
+                    2080 => '2080/2099',
+                  }
+
+                if typename.to_s.include?('monthly')
+                  post_process_replace do |res|
+                    {
+                      'variable' => res.first['variable'],
+                      'fromYear' => res.first['fromYear'],
+                      'toYear' => res.first['toYear'],
+                      'data' => TLAW::DataTable
+                        .from_columns(
+                          res.map { |r| r['gcm'] },
+                          res.map { |r| r['monthVals'] }
+                        )
+                    }
+                  end
+                else
+                  post_process_replace do |res|
+                    {
+                      'variable' => res.first['variable'],
+                      'fromYear' => res.first['fromYear'],
+                      'toYear' => res.first['toYear'],
+                      'gcm' => res.map { |res| [res['gcm'], res['annualData'].first] }.to_h
+                    }
+                  end
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end
+
+wbc = WorldBankClimate.new
+
+pp wbc.country('ukr').temperature.annual(since: 1980)
+pp wbc.country('ukr').precipation.monthly(since: 1980)['data']
+