codeforces 0.0.1 → 0.0.2

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    NmNjYTgwZDYzOGY5MjQ4ZjJiNzRhZDdkMTQyYmRlMjBhYjQ3ZDA4MA==
+    YzViOGFiNTI0MjVlMTFmMTNkYTk2YmViZGYxMDhmMmM5OWVlYTQwMw==
   data.tar.gz: !binary |-
-    MzhiNzZhYWM3OGZhYThkMDU3YWE4MDU2ZGIxNzI0MjBhYmZiZjdlMw==
+    NDRlNGM3ZTVmN2FiMDRlNGMxMmY0YmI1OTJiNDhmMjEwZWMzYjNlNA==
 SHA512:
   metadata.gz: !binary |-
-    N2UyZmM1NDJjYTgxZDZkNWFmZjU4YjY5NDgxMzhlZjEzZjg0OGI0NDVhNzEx
-    ODQ0ZDljYjhkNDI2MzJlYmQwYTc4ZDRlZmNlYjc2NDMxMzk5ZDM4NWU2MTU2
-    N2JmMGU0ZDQ0MjU2NzEzZThmOTE1NmEzNDMzYmIyMDY2MWVkZTg=
+    YzM3ZTZkZTAyOTczZTdiNWIyYTM1YzUwMzJkZjViZjdjOWNmYzBiMDI5Njdl
+    MWVlNDg2MDQxM2E1YzNjZWVmOTJiZDlmZDI4ODcxYWJiYzk0M2ViMDQ2YzUy
+    NGYyOWUzZTIyZDU0Y2FkZDhmYzkzNzZlMWRjMWZjYjQ2MDk0ODc=
   data.tar.gz: !binary |-
-    MzZlOTZiYTk3YWUyZjNhNTY3Y2EzOGM3YzcwMjdkYzQ1OThlYmFiZWM0Nzdm
-    OTljNTNhNWQ2YmJlMTUxNzljNDNlMTM1ODI3ZWZjM2JhMWZjY2MxOTRhNWNm
-    NGI5ZWE0OGI1Yzg5NDEyZThhZDZjNDg0OGNjNTAzMmViYmQ0MmY=
+    MTM0ZGQ0MzQ5YmRkMzhkYTA5ZjE0NDQzODYxNjJjMGZlZWViZDA3YTFkNDAw
+    NTU4NmZjYWU0Yzk0MjI5NzdhNTIwYzU0MTBmYmQwMTIxOGI5MjNkYzg3YjE4
+    MGRkZWRkZmE2YzI0ODEyNTYzYTE2YWQ2M2IwZDQyNmYyNDIwYWY=

data/.travis.yml

@@ -8,9 +8,15 @@ rvm:
 
 sudo: false
 
-install: echo install
+install:
+  - bundle install -j4 --path vendor/bundle
 
-script: echo script
+script:
+  - bundle exec rake spec
+
+cache:
+  directories:
+    - vendor/bundle
 
 deploy:
   provider: rubygems

data/README.md

@@ -1,13 +1,13 @@
-# Codeforces
+# Codeforces API Client Library
 
-TODO: Write a gem description
+The wrapper library for Codeforces API written in Ruby.
 
 ## Installation
 
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'codeforces'
+gem "codeforces"
 ```
 
 And then execute:
@@ -20,12 +20,43 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+```ruby
+require "codeforces"
+
+Codeforces.each_contest do |contest|
+  puts contest.name
+end
+```
+
+```ruby
+require "codeforces"
+
+tourist = Codeforces.user("tourist")
+
+puts tourist.rating
+# -> 3254
+
+puts tourist.rank
+# -> international grandmaster
+```
+
+### API Access
+
+```ruby
+require "codeforces"
+
+Codeforces.api.contest.list.each do |contest|
+  puts contest.name
+end
+```
+
+See also: http://codeforces.com/api/help/methods
 
 ## Contributing
 
-1. Fork it ( https://github.com/[my-github-username]/codeforces/fork )
+1. Fork it ( https://github.com/sh19910711/codeforces-api-client/fork )
 2. Create your feature branch (`git checkout -b my-new-feature`)
 3. Commit your changes (`git commit -am 'Add some feature'`)
 4. Push to the branch (`git push origin my-new-feature`)
 5. Create a new Pull Request
+

data/Rakefile

@@ -1,2 +1,19 @@
 require "bundler/gem_tasks"
 
+require "rspec/core/rake_task"
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.rspec_opts = [
+    "--format doc",
+    "--color",
+  ]
+end
+
+require "rspec/core/rake_task"
+RSpec::Core::RakeTask.new(:spec_current) do |t|
+  t.rspec_opts = [
+    "--format doc",
+    "--color",
+    "--tag current",
+  ]
+end
+

data/codeforces.gemspec

@@ -8,8 +8,8 @@ Gem::Specification.new do |spec|
   spec.version       = Codeforces::VERSION
   spec.authors       = ["Hiroyuki Sano"]
   spec.email         = ["sh19910711@gmail.com"]
-  spec.summary       = %q{}
-  spec.homepage      = ""
+  spec.summary       = %q{The wrapper library for Codeforces API.}
+  spec.homepage      = "https://github.com/sh19910711/codeforces-api-client"
   spec.license       = "MIT"
 
   spec.files         = `git ls-files -z`.split("\x0")
@@ -17,6 +17,18 @@ Gem::Specification.new do |spec|
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ["lib"]
 
+  spec.required_ruby_version = ">= 1.9.3"
+
+  spec.add_runtime_dependency "sawyer", "~> 0.6"
+  spec.add_runtime_dependency "addressable", "~> 2.3.6"
+
   spec.add_development_dependency "bundler", "~> 1.7"
   spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "vcr"
+  spec.add_development_dependency "webmock"
+
+  if ENV["CODEFORCES_DEBUG"] === "yes"
+    spec.add_development_dependency "byebug"
+  end
 end

data/lib/codeforces.rb

@@ -1,5 +1,22 @@
+require "codeforces/client"
 require "codeforces/version"
 
 module Codeforces
-  # Your code goes here...
+
+  class << self
+
+    def client
+      @client ||= Client.new
+    end
+
+    private
+
+    def method_missing(method, *args, &block)
+      super unless client.respond_to?(method)
+      client.send method, *args, &block
+    end
+
+  end
+
 end
+

data/lib/codeforces/api.rb

@@ -0,0 +1,25 @@
+require "codeforces/api/contest"
+require "codeforces/api/problem_set"
+require "codeforces/api/user"
+
+class Codeforces::Api
+
+  attr_reader :client
+
+  def initialize(new_client)
+    @client = new_client
+  end
+
+  def contest
+    @contest ||= ::Codeforces::Api::Contest.new(client)
+  end
+
+  def problemset
+    @problem_set ||= ::Codeforces::Api::ProblemSet.new(client)
+  end
+
+  def user
+    @user ||= ::Codeforces::Api::User.new(client)
+  end
+
+end

data/lib/codeforces/api/contest.rb

@@ -0,0 +1,44 @@
+class Codeforces::Api
+
+  class Contest
+
+    attr_reader :client
+
+    def initialize(base_client)
+      @client = base_client
+    end
+
+    def hacks(contest_id, options = {})
+      options[:query] ||= {}
+      options[:query].merge! :contestId => contest_id
+      get("contest.hacks", options)
+    end
+
+    def list(options = {})
+      get("contest.list", options)
+    end
+
+    def standings(contest_id, options = {})
+      options[:query] ||= {}
+      options[:query].merge! :contestId => contest_id
+      options[:query].merge! paginate(options[:offset])
+      get("contest.standings", options).rows
+    end
+
+    def status(contest_id, options = {})
+      options[:query] ||= {}
+      options[:query].merge! :contestId => contest_id
+      options[:query].merge! paginate(options[:offset])
+      get("contest.status", options)
+    end
+
+    private
+
+    def method_missing(method, *args, &block)
+      client.send method, *args, &block
+    end
+
+  end
+
+end
+

data/lib/codeforces/api/problem_set.rb

@@ -0,0 +1,38 @@
+class Codeforces::Api
+
+  class ProblemSet
+
+    attr_reader :client
+
+    def initialize(base_client)
+      @client = base_client
+    end
+
+    def problems(options = {})
+      options[:query] ||= {}
+      options[:query][:tags] = multi_values(options[:query][:tags]) unless options[:query][:tags].nil?
+      get("problemset.problems", options).problems
+    end
+
+    def problem_statistics(options = {})
+      options[:query] ||= {}
+      options[:query][:tags] = multi_values(options[:query][:tags]) unless options[:query][:tags].nil?
+      get("problemset.problems", options).problemStatistics
+    end
+
+    def recent_status(options = {})
+      options[:query] ||= {}
+      options[:query].merge! paginate(0)
+      get("problemset.recentStatus", options)
+    end
+
+    private
+
+    def method_missing(method, *args, &block)
+      client.send method, *args, &block
+    end
+
+  end
+
+end
+

data/lib/codeforces/api/user.rb

@@ -0,0 +1,44 @@
+class Codeforces::Api
+
+  class User
+
+    attr_reader :client
+
+    def initialize(base_client)
+      @client = base_client
+    end
+
+    def info(handles, options = {})
+      handles = [handles] unless handles.is_a?(Array)
+      options[:query] ||= {}
+      options[:query][:handles] = multi_values(handles)
+      get("user.info", options)
+    end
+
+    def rated_list(options = {})
+      get("user.ratedList", options)
+    end
+
+    def rating(handle, options = {})
+      options[:query] ||= {}
+      options[:query].merge! :handle => handle
+      get("user.rating", options)
+    end
+
+    def status(handle, options = {})
+      options[:query] ||= {}
+      options[:query].merge! :handle => handle
+      options[:query].merge! paginate(options[:offset])
+      get("user.status", options)
+    end
+
+    private
+
+    def method_missing(method, *args, &block)
+      client.send method, *args, &block
+    end
+
+  end
+
+end
+

data/lib/codeforces/client.rb

@@ -0,0 +1,81 @@
+require "sawyer"
+require "logger"
+require "addressable/uri"
+require "codeforces/api"
+require "codeforces/client"
+require "codeforces/helper"
+require "codeforces/models"
+
+class Codeforces::Client
+
+  include Codeforces::Helper
+
+  DEFAULT_ENDPOINT = "http://codeforces.com/api/"
+  DEFAULT_PAGE_COUNT = 50
+
+  attr_reader :endpoint
+
+  def initialize(endpoint = DEFAULT_ENDPOINT)
+    @endpoint = endpoint
+  end
+
+  def logger
+    @logger ||= new_logger
+  end
+
+  def agent
+    @agent ||= ::Sawyer::Agent.new(DEFAULT_ENDPOINT)
+  end
+
+  def last_response
+    @last_response
+  end
+
+  def get(path, options = {})
+    request_uri = ::Addressable::URI.new
+    options[:query] ||= {}
+    request_uri.query_values = options[:query]
+    request(:get, "#{path}#{request_uri.query.empty? ? "" : "?#{request_uri.query}"}", options[:data], options).result
+  end
+
+  def request(method, path, data, options = {})
+    logger.debug "#{method.upcase} #{URI.join endpoint, path}"
+    @last_response = agent.call(method, path, data)
+
+    unless last_response.data.status === "OK"
+      raise "Error: #{last_response.data.status}"
+    end
+
+    last_response.data
+  end
+
+  def paginate(offset)
+    offset = 0 if offset.nil?
+    result = {
+      :from => DEFAULT_PAGE_COUNT * offset + 1,
+      :count => DEFAULT_PAGE_COUNT,
+    }
+  end
+
+  def multi_values(values)
+    values.join ";"
+  end
+
+  def api
+    @api ||= ::Codeforces::Api.new(self)
+  end
+
+  def submission(status)
+    ::Codeforces::Models::Submission.new self, status
+  end
+
+  private
+
+  def new_logger
+    logger = ::Logger.new(STDOUT)
+    logger.level = ::Logger::INFO
+    logger
+  end
+
+end
+

data/lib/codeforces/helper.rb

@@ -0,0 +1,15 @@
+module Codeforces::Helper
+
+  def each_contest
+    api.contest.list.each {|contest| yield(contest) if block_given? }
+  end
+
+  def user(handle)
+    api.user.info(handle).first
+  end
+
+  def each_status
+    api.problemset.recent_status.map {|status| submission status }.each {|status| yield(status) if block_given? }
+  end
+
+end

data/lib/codeforces/models.rb

@@ -0,0 +1,5 @@
+require "codeforces/models/base"
+require "codeforces/models/submission"
+
+module Codeforces::Models; end
+

data/lib/codeforces/models/base.rb

@@ -0,0 +1,14 @@
+module Codeforces::Models
+
+  class Base
+
+    attr_reader :client
+
+    def initialize(client)
+      @client = client
+    end
+
+  end
+
+end
+