sphere_engine 1.1.0.pre → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 19dd5822f35e71acf45b5a681638263f902fb5ac
-  data.tar.gz: 4ec00eef5296ed39f3d7a4eecf215354aadcfa9c
+  metadata.gz: 5b3ca098e7a4a9a7c1f4e26e57c1b26dda122f0e
+  data.tar.gz: f5cac2729b6692aced04e82d4f779a3c9810f28e
 SHA512:
-  metadata.gz: 68eadff2c3fb4b4069d0efcb88a5722007b6317d9af36e7352a40eb7f41654d81297c015e69021c64be3051a8666ea426dc4d800cfb4c4d00f3f160a04dfe917
-  data.tar.gz: 4180592fef9526408906a01b7be6247c1922191c6bcca97b1bf2bee1ca9565f63da7cf90cdf0ec801a16917c9a7455cc19de4fa4d67c215abf58375196624035
+  metadata.gz: 3421580af61881a0ef3d119d8bf1e8aae84dcd16c95fb1dba637f42b5ab0fb2bbee00bbef677c78ef9f57e7060b39889a9943aaaae1ec05d6ca259b69405ad88
+  data.tar.gz: 7e58c0bdef13bf8ca3644840c91d2e687b848a3c058b42d64f27c16b6851dbf7abc096bd088ed493a512f9d0895e6acc3035ce9deba9fe3052f6bb6dc0469885

data/README.md

@@ -1,6 +1,15 @@
 # SphereEngine
 
-I'm working right now!
+A Ruby interface to SphereEngine API. This gem was made as an interface to the SphereEngine API. It abstract in the best way all his methods that SphereEngine give us. This gem separates the requests into two types (compilers and problems), according to the SphereEngine documentation. For more information about SphereEngine visit this [Link](http://sphere-engine.com)
+
+## Prerequisites
+
+You need the following tokens:
+
+* Token for Compilers API
+* Token for problems API
+
+[SphereEngine Tokens](http://sphere-engine.com/tokens)
 
 ## Installation
 
@@ -18,9 +27,170 @@ Or install it yourself as:
 
     $ gem install sphere_engine
 
-## Usage
+## Configuration
+
+SphereEngine provide two services, one for compilers and another for problems. To start using a SpherEengine client do the following:
+
+```ruby
+client = SphereEngine::REST::Client.new do |config|
+  config.access_token_compilers = "YOUR_ACCESS_TOKEN_COMPILERS"
+  config.access_token_problems  = "YOUR_ACCESS_TOKEN_PROBLEMS"
+end
+```
+
+## Usage Examples
+After configuring a client, you can do the following things:
+
+### Compilers Service
+
+#### Get languages
+```ruby
+client.all_languages
+```
+
+#### Get compilers
+```ruby
+client.all_compilers
+```
 
-TODO: Write usage instructions here
+#### Create a submission
+
+This method return a submission_id
+```ruby
+client.create_submission_compiler(
+    language: 11, #LanguageID
+    sourceCode: "#include <iostream>\n using namespace std;\n int main()\n {\n cout << \"Hello World\" << endl;\n return 0;\n }" #Code example
+)
+```
+
+*Other params: input [string]*
+
+#### Fetch a submission
+```ruby
+client.fetch_submission_compilers(submission_id)
+```
+
+### Problems service
+
+#### Create a problem
+
+This method return a "code" is like a problem_id
+```ruby
+client.create_problem(
+    code: "RUBY_001", # Unique problem code. consist of 3 up to 16 capital letters. numbers and underscore
+    name: "Problem_Name", #String
+    body: "Write the fibonacci sequence" #String
+)
+```
+
+#### Fetch a problem
+```ruby
+client.get_problem(problem_id)
+```
+
+#### Update a problem
+
+```ruby
+client.update_problem("PROBLEM_ID", name: "NEW_NAME")
+```
+
+*Other params: type [string], interactive [boolean], masterjudgeId [integer], activeTestcases [array]*
+
+#### Create testcase to problem
+
+```ruby
+client.create_problem_testcase(
+    "PROBLEM_ID",
+    input: "input content",
+    timelimit: 10,
+    output: "output content"
+)
+```
+
+#### Update a testcase
+
+```ruby
+client.update_problem_testcase(
+  "PROBLEM_ID",
+  "TESTCASE_ID",
+  name: "NEW_NAME"
+  input: "new input content",
+  output: "new output content"
+)
+```
+
+#### Get a list testcases of a problem
+
+```ruby
+client.list_testcases("PROBLEM_ID")
+```
+
+#### Get a testcase of a problem
+
+```ruby
+client.get_testcase("PROBLEM_ID", "TESTCASE_ID")
+```
+
+#### Get a file testcases of a problem
+```ruby
+client.get_testcase_file("PROBLEM_ID", "TESTCASE_ID", "FILENAME")
+```
+
+*Filename is obtained from get_testcase request in uri params*
+
+#### Get judge list
+
+```ruby
+client.all_judges()
+```
+
+*Other params: limit [Integer], offset [Integer], type [String]*
+
+#### Create judge
+
+```ruby
+client.create_judge(
+  name: "NameJudge",
+  source: "<source code>"
+)
+```
+
+*Other params: type [String], compilerId [Integer]*
+
+#### Get judge details
+
+```ruby
+client..get_judge("JUDGE_ID")
+```
+
+#### Update judge
+
+```ruby
+client.update_judge(
+  "JUDGE_ID",
+  name: "NewNameJudge",
+)
+```
+
+*Other params: source [String], compilerId [Integer]*
+
+#### Create a submission
+
+```ruby
+client.create_submission_problem(
+  problemCode: "RUBY_001", #problem_id
+  compilerId: 1, # get of all_request
+  source: "#include <iostream>\n using namespace std;\n int main()\n {\n cout << \"Hello World\" << endl;\n return 0;\n }" #Example
+)
+```
+
+*Other params: userId [Integer]*
+
+#### Fetch a submission
+
+```ruby
+client.fetch_submission_problems("SUBMISSION_ID")
+```
 
 ## Development
 
@@ -32,8 +202,8 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/14tinchov/sphere_engine. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
 
-
 ## License
 
 The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
 
+    

data/bin/console

@@ -8,7 +8,7 @@ require "sphere_engine"
 
 # (If you use this, don't forget to add pry to your Gemfile!)
 require "pry"
-Pry.start
+# Pry.start
 
 require "irb"
 IRB.start(__FILE__)

data/lib/sphere_engine/client.rb

@@ -31,7 +31,7 @@ module SphereEngine
     # @return[String]
     def get_token(service)
       return case service
-      when :compillers
+      when :compilers
         access_token_compilers
       when :problems
         access_token_problems

data/lib/sphere_engine/error.rb

@@ -43,19 +43,8 @@ module SphereEngine
       def parse_error(body)
         if body.nil? || body.empty?
           ['', nil]
-        elsif body[:message]
-          [body[:message], nil]
-        elsif body[:errors]
-          extract_message_from_errors(body)
-        end
-      end
-
-      def extract_message_from_errors(body)
-        first = Array(body[:errors]).first
-        if first.is_a?(Hash)
-          [first[:message].chomp, first[:code]]
-        else
-          [first.chomp, nil]
+        elsif  body["message"] || body[:message]
+          [ body["message"] || body[:message], nil]
         end
       end
     end

data/lib/sphere_engine/rest/api.rb

@@ -1,12 +1,22 @@
 require 'sphere_engine/rest/access'
+require 'sphere_engine/rest/languages'
 require 'sphere_engine/rest/compilers'
+require 'sphere_engine/rest/submissions'
+require 'sphere_engine/rest/problems'
+require 'sphere_engine/rest/test_cases'
+require 'sphere_engine/rest/judges'
 
 module SphereEngine
   module REST
     # @note All methods have been separated into modules and follow the same grouping used in {http://sphere-engine.com/services the SphereEngine API Documentation}.
     module API
       include SphereEngine::REST::Access
+      include SphereEngine::REST::Languages
       include SphereEngine::REST::Compilers
+      include SphereEngine::REST::Submissions
+      include SphereEngine::REST::Problems
+      include SphereEngine::REST::TestCases
+      include SphereEngine::REST::Judges
     end
   end
 end

data/lib/sphere_engine/rest/judges.rb

@@ -0,0 +1,28 @@
+module SphereEngine
+  module REST
+    module Judges
+      include SphereEngine::REST::Utils
+
+      # @options [Hash]
+      def all_judges(options = {})
+        perform_get_requests_of_problems_service("/judges", options)
+      end
+
+      # @options [Hash]
+      def create_judge(options = {})
+        perform_post_requests_of_problems_service("/judges", options)
+      end
+
+      # @judge_id [String]
+      def get_judge(judge_id)
+        perform_get_requests_of_problems_service("/judges/#{judge_id}")
+      end
+
+      # @judge_id [String]
+      # @options [Hash]
+      def update_judge(judge_id, options = {})
+        perform_put_requests_of_problems_service("/judges/#{judge_id}", options)
+      end
+    end
+  end
+end

data/lib/sphere_engine/rest/languages.rb

@@ -0,0 +1,11 @@
+module SphereEngine
+  module REST
+    module Languages
+      include SphereEngine::REST::Utils
+
+      def all_languages
+        perform_get_requests_of_compílers_service('/languages')
+      end
+    end
+  end
+end

data/lib/sphere_engine/rest/problems.rb

@@ -0,0 +1,30 @@
+module SphereEngine
+  module REST
+    module Problems
+      include SphereEngine::REST::Utils
+
+      # @param options [Hash]
+      # This request you could send a limit and offset
+      def all_problems(options = {})
+        perform_get_requests_of_problems_service('/problems', options)
+      end
+
+      # @param options [Hash]
+      # This request you could send a limit and offset
+      def create_problem(options = {})
+        perform_post_requests_of_problems_service('/problems', options)
+      end
+
+      # @param code [String]
+      def get_problem(code)
+        perform_get_requests_of_problems_service("/problems/#{code}")
+      end
+
+      # @param code [String]
+      # @param options [Hash]
+      def update_problem(code, options = {})
+        perform_put_requests_of_problems_service("/problems/#{code}", options)
+      end
+    end
+  end
+end

data/lib/sphere_engine/rest/request.rb

@@ -1,10 +1,11 @@
 require 'addressable/uri'
 require 'http'
+require 'json'
 
 module SphereEngine
   module REST
     class Request
-      BASE_URL_COMPILERS_SERVICE = 'https://09de42b6.compilers.sphere-engine.com/api/V3/'.freeze
+      BASE_URL_COMPILERS_SERVICE = 'https://09de42b6.compilers.sphere-engine.com/api/V3'.freeze
       BASE_URL_PROBLEMS_SERVICE  = 'https://09de42b6.problems.sphere-engine.com/api/v3'.freeze
       attr_accessor :client, :headers, :options, :service, :path, :request_method, :uri
 
@@ -17,6 +18,7 @@ module SphereEngine
         @client = client
         @token  = client.get_token(service)
         @service = service
+        @request_method = request_method
         @uri = Addressable::URI.parse(path.start_with?('http') ? path : build_base_url + path)
         @path = uri.path
         @options = options
@@ -24,11 +26,19 @@ module SphereEngine
 
       # @return [Array, Hash]
       def perform
-        response = HTTP.get(uri, :params => {:access_token => @token})
-        response_body = response.body.empty? ? '' : symbolize_keys!(response.parse)
+        response = build_http_request
+        response_body = response.body.empty? ? '' : format_to_response(response)
         fail_or_return_response_body(response.code, response_body)
       end
 
+      def format_to_response(response)
+        begin
+          JSON.parse(response.to_s)
+        rescue JSON::ParserError
+          response.to_s
+        end
+      end
+
       def fail_or_return_response_body(code, body)
         error = error(code, body)
         raise(error) if error
@@ -42,27 +52,31 @@ module SphereEngine
         end
       end
 
-      def symbolize_keys!(object)
-        if object.is_a?(Array)
-          object.each_with_index do |val, index|
-            object[index] = symbolize_keys!(val)
-          end
-        elsif object.is_a?(Hash)
-          object.keys.each do |key|
-            object[key.to_sym] = symbolize_keys!(object.delete(key))
-          end
-        end
-        object
-      end
-
       def build_base_url
         return case @service
-        when :compillers
+        when :compilers
           BASE_URL_COMPILERS_SERVICE
         when :problems
           BASE_URL_PROBLEMS_SERVICE
         end
       end
+
+      def build_http_request
+        return case @request_method
+        when :get
+          HTTP.get(uri, params: build_request_params)
+        when :post
+          HTTP.post(uri, params: build_request_params)
+        when :put
+          HTTP.put(uri, params: build_request_params)
+        end
+      end
+
+      def build_request_params
+        {
+          access_token: @token
+        }.merge(options)
+      end
     end
   end
 end

data/lib/sphere_engine/rest/submissions.rb

@@ -0,0 +1,29 @@
+module SphereEngine
+  module REST
+    module Submissions
+      include SphereEngine::REST::Utils
+
+      # @param options [Hash]
+      # This request you should send a compilerId and source
+      def create_submission_compiler(options = {})
+        perform_post_requests_of_compílers_service('/submissions', options)
+      end
+
+      # @param options [Hash]
+      # This request you should send a submissionId
+      def fetch_submission_compilers(submission_id, options = {})
+        perform_get_requests_of_compílers_service("/submissions/#{submission_id}")
+      end
+
+      # @param options [Hash]
+      def create_submission_problem(options = {})
+        perform_post_requests_of_problems_service('/submissions', options)
+      end
+
+      # @param options [Hash]
+      def fetch_submission_problems(submission_id)
+        perform_get_requests_of_problems_service("/submissions/#{submission_id}")
+      end
+    end
+  end
+end

data/lib/sphere_engine/rest/test_cases.rb

@@ -0,0 +1,40 @@
+module SphereEngine
+  module REST
+    module TestCases
+      include SphereEngine::REST::Utils
+
+      # @param problem_id [String]
+      def list_testcases(problem_id)
+        perform_get_requests_of_problems_service("/problems/#{problem_id}/testcases")
+      end
+
+      # @param problem_id [String]
+      # @options [Hash]
+      def create_problem_testcase(problem_id, options = {})
+        perform_post_requests_of_problems_service("/problems/#{problem_id}/testcases", options)
+      end
+
+      # @param problem_id  [String]
+      # @param testcase_id [String]
+      # @param options [Hash]
+      def update_problem_testcase(problem_id, testcase_id, options = {})
+        perform_put_requests_of_problems_service("/problems/#{problem_id}/testcases/#{testcase_id}", options)
+      end
+
+      # @param problem_id  [String]
+      # @param testcase_id [String]
+      def get_testcase(problem_id, testcase_id)
+        perform_get_requests_of_problems_service("/problems/#{problem_id}/testcases/#{testcase_id}")
+      end
+
+      # @param problem_id  [String]
+      # @param testcase_id [String]
+      # @param filename    [String]
+      def get_testcase_file(problem_id, testcase_id, filename)
+        perform_get_requests_of_problems_service(
+          "/problems/#{problem_id}/testcases/#{testcase_id}/#{filename}"
+        )
+      end
+    end
+  end
+end

data/lib/sphere_engine/rest/utils.rb

@@ -12,6 +12,18 @@ module SphereEngine
         perform_request(:get, :compilers, path, options)
       end
 
+      def perform_post_requests_of_problems_service(path, options = {})
+        perform_request(:post, :problems, path, options)
+      end
+
+      def perform_post_requests_of_compílers_service(path, options = {})
+        perform_request(:post, :compilers, path, options)
+      end
+
+      def perform_put_requests_of_problems_service(path, options = {})
+        perform_request(:put, :problems, path, options)
+      end
+
       def perform_request(request_method, service, path, options = {})
         SphereEngine::REST::Request.new(self, request_method, service, path, options).perform
       end

data/lib/sphere_engine/version.rb

@@ -1,5 +1,5 @@
 module SphereEngine
   unless defined?(SphereEngine::VERSION)
-    VERSION = "1.1.0.pre".freeze
+    VERSION = "1.1.0".freeze
   end
 end

data/sphere_engine.gemspec

@@ -16,8 +16,8 @@ Gem::Specification.new do |spec|
   spec.email         = ["14tinchov@gmail.com"]
 
   spec.summary       = %q{A Ruby interface to the SphereEngine API.}
-  spec.description   = spec.summary
-  spec.homepage      = "https://github.com/14tinchov/sphere-engine.git"
+  spec.description   = %q{This gem was made as an interface to the SphereEngine API. I try to abstract in the best way all his methods that SphereEngine give us.}
+  spec.homepage      = "https://github.com/14tinchov/sphere-engine"
   spec.license       = "MIT"
 
   # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sphere_engine
 version: !ruby/object:Gem::Version
-  version: 1.1.0.pre
+  version: 1.1.0
 platform: ruby
 authors:
 - Martin Villalba
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-04-14 00:00:00.000000000 Z
+date: 2017-04-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -80,7 +80,8 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.0'
-description: A Ruby interface to the SphereEngine API.
+description: This gem was made as an interface to the SphereEngine API. I try to abstract
+  in the best way all his methods that SphereEngine give us.
 email:
 - 14tinchov@gmail.com
 executables: []
@@ -104,11 +105,16 @@ files:
 - lib/sphere_engine/rest/api.rb
 - lib/sphere_engine/rest/client.rb
 - lib/sphere_engine/rest/compilers.rb
+- lib/sphere_engine/rest/judges.rb
+- lib/sphere_engine/rest/languages.rb
+- lib/sphere_engine/rest/problems.rb
 - lib/sphere_engine/rest/request.rb
+- lib/sphere_engine/rest/submissions.rb
+- lib/sphere_engine/rest/test_cases.rb
 - lib/sphere_engine/rest/utils.rb
 - lib/sphere_engine/version.rb
 - sphere_engine.gemspec
-homepage: https://github.com/14tinchov/sphere-engine.git
+homepage: https://github.com/14tinchov/sphere-engine
 licenses:
 - MIT
 metadata:
@@ -124,9 +130,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubyforge_project: 
 rubygems_version: 2.6.10