two_captcha 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: ada135dad0428e66a55f12546ec887230eee89f4
+  data.tar.gz: 1cad1ca0f8021b9a9bc4d68e5e6e82e3c19f24b9
+SHA512:
+  metadata.gz: 11d19a82c8beb97d7f0f4f774c274eec6f823efbabf759f2a7ef7b1bc121d833b8a15e7d085336da32b30709d4070f751e08d4213342dccf90d0c9f3c4aee7f8
+  data.tar.gz: f846b785745c2d7eda62128f05da068df0832adf974dedb660745354c0643ca1f9cb2d2786024e27662d6e5e8b7a6f84534a08d16774c2b00eeab7b1e96e3436

data/.gitignore

@@ -0,0 +1,12 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/spec/credentials.yml
+/tmp/
+.ruby-version
+.ruby-gemset

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - 2.2.0

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,13 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free experience for everyone, regardless of level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, age, or religion.
+
+Examples of unacceptable behavior by participants include the use of sexual language or imagery, derogatory comments or personal attacks, trolling, public or private harassment, insults, or other unprofessional conduct.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct. Project maintainers who do not follow the Code of Conduct may be removed from the project team.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting one or more of the project maintainers.
+
+This Code of Conduct is adapted from the [Contributor Covenant](http:contributor-covenant.org), version 1.0.0, available at [http://contributor-covenant.org/version/1/0/0/](http://contributor-covenant.org/version/1/0/0/)

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in two_captcha.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Infosimples
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,183 @@
+Developed by [Infosimples](https://infosimples.com), a brazilian company that
+offers [data extraction solutions](https://infosimples.com/en/data-engineering)
+and [Ruby on Rails development](https://infosimples.com/en/software-development).
+
+# TwoCaptcha
+
+TwoCaptcha is a Ruby API for 2Captcha - https://2captcha.com.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'two_captcha'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install two_captcha
+
+## Usage
+
+1. **Create a client**
+
+  ```ruby
+  # Create a client
+  client = TwoCaptcha.new('my_captcha_key')
+  ```
+
+2. **Solve a captcha**
+
+  There are two methods available: **decode** and **decode!**
+    * **decode** doesn't raise exceptions.
+    * **decode!** may raise a *TwoCaptcha::Error* if something goes wrong.
+
+  If the solution is not available, an empty captcha object will be returned.
+
+  ```ruby
+  captcha = client.decode!(url: 'http://bit.ly/1xXZcKo')
+  captcha.text        # Solution of the captcha
+  captcha.id          # Numeric ID of the captcha solved by TwoCaptcha
+  ```
+
+  You can also specify *path*, *file*, *raw* and *raw64* when decoding an image.
+
+  ```ruby
+  client.decode(path: 'path/to/my/captcha/file')
+
+  client.decode(file: File.open('path/to/my/captcha/file', 'rb'))
+
+  client.decode(raw: File.open('path/to/my/captcha/file', 'rb').read)
+
+  client.decode(raw64: Base64.encode64(File.open('path/to/my/captcha/file', 'rb').read))
+  ```
+
+  > Internally, the gem will always convert the image to raw64 (binary base64 encoded).
+
+  You may also specify any POST parameters specified at
+  https://2captcha.com/setting.
+
+3. **Retrieve a previously solved captcha**
+
+  ```ruby
+  captcha = client.captcha('130920620') # with 130920620 as the captcha id
+  ```
+
+4. **Report incorrectly solved captcha for refund**
+
+  ```ruby
+  client.report!('130920620') # with 130920620 as the captcha id
+  # return true if successfully reported
+  ```
+
+  > ***Warning:*** *do not abuse on this method, otherwise you may get banned*
+
+5. **Get your balance on 2Captcha**
+
+  ```ruby
+  client.balance
+  # return a Float balance in USD.
+  ```
+
+6. **Get usage statistics for a specific date**
+
+  ```ruby
+  client.stats('2015-08-05')
+  # return an XML string with your usage statistics.
+  ```
+
+7. **Get current 2Captcha load**
+
+  ```ruby
+  client.load
+  # return an XML string with the current service load.
+  ```
+
+## New ReCaptcha
+
+To solve captchas similar to
+[reCAPTCHA v2](https://support.google.com/recaptcha/?hl=en#6262736), you can add
+the param 'id_constructor: 23' to your request.
+
+Please read the oficial documentation at https://2captcha.com/support/faq/30/ for
+more information.
+
+  ```ruby
+  client.decode(url: 'http://bit.ly/1xXZcKo', id_constructor: 23)
+  ```
+
+**Captcha (screenshot)**
+
+> the argument is passed as *url*, *path*, *file*, *raw* or *raw64*
+
+![Example of a captcha based on image clicks](captchas/2.jpg)
+
+The response will be an array containing the indexes for each image that should
+be clicked counting from left to right. For the captcha above it should look
+something like:
+
+```ruby
+# captcha.indexes
+[1, 9]
+```
+
+## Notes
+
+#### Thread-safety
+
+The API is thread-safe, which means it is perfectly fine to share a client
+instance between multiple threads.
+
+#### Ruby dependencies
+
+TwoCaptcha don't require specific dependencies. That saves you memory and
+avoid conflicts with other gems.
+
+#### Input image format
+
+Any format you use in the decode method (url, file, path, raw, raw64) will
+always be converted to a raw64, which is a binary base64 encoded string. So, if
+you already have this format available on your side, there's no need to do
+convertions before calling the API.
+
+> Our recomendation is to never convert your image format, unless needed. Let
+> the gem convert internally. It may save you resources (CPU, memory and IO).
+
+#### Versioning
+
+TwoCaptcha gem uses [Semantic Versioning](http://semver.org/).
+
+#### Ruby versions tested
+
+* MRI 2.2.2
+* MRI 2.2.0
+* MRI 2.1.4
+* MRI 2.0.0
+
+# Maintainers
+
+* [Marcelo Mita](http://github.com/marcelomita)
+* [Rafael Barbolo](http://github.com/barbolo)
+
+## Contributing
+
+1. Fork it ( https://github.com/infosimples/two_captcha/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. **Run/add tests (RSpec)**
+4. Commit your changes (`git commit -am 'Add some feature'`)
+5. Push to the branch (`git push origin my-new-feature`)
+6. Create a new Pull Request
+7. Yay. Thanks for contributing :)
+
+All contributors:
+https://github.com/infosimples/two_captcha/graphs/contributors
+
+
+# License
+
+MIT License. Copyright (C) 2011-2015 Infosimples. https://infosimples.com/

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "two_captcha"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/lib/two_captcha.rb

@@ -0,0 +1,32 @@
+require 'base64'
+require 'json'
+require 'net/http'
+
+# The module TwoCaptcha contains all the code for the two_captcha gem.
+# It acts as a safely namespace that isolates logic from TwoCaptcha from any
+# project that uses it.
+#
+module TwoCaptcha
+  # Instantiate TwoCaptcha API client. This is a shortcut to
+  # TwoCaptcha::Client.new
+  #
+  def self.new(key, options = {})
+    TwoCaptcha::Client.new(key, options)
+  end
+
+  # Base class of a model object returned by TwoCaptcha API.
+  #
+  class Model
+    def initialize(values = {})
+      values.each do |key, value|
+        send("#{key}=", value) if respond_to?("#{key}=")
+      end
+    end
+  end
+end
+
+require 'two_captcha/client'
+require 'two_captcha/errors'
+require 'two_captcha/http'
+require 'two_captcha/models/captcha'
+require 'two_captcha/version'

data/lib/two_captcha/client.rb

@@ -0,0 +1,225 @@
+module TwoCaptcha
+  # TwoCaptcha::Client is a client that communicates with the TwoCaptcha API:
+  # https://2captcha.com/.
+  #
+  class Client
+    BASE_URL = 'http://2captcha.com/:action.php'
+
+    attr_accessor :key, :timeout, :polling
+
+    # Create a TwoCaptcha API client.
+    #
+    # @param [String] Captcha key of the TwoCaptcha account.
+    # @param [Hash]   options  Options hash.
+    # @option options [Integer] :timeout (60) Seconds before giving up of a
+    #                                         captcha being solved.
+    # @option options [Integer] :polling  (5) Seconds before check_answer again
+    #
+    # @return [TwoCaptcha::Client] A Client instance.
+    #
+    def initialize(key, options = {})
+      self.key    = key
+      self.timeout  = options[:timeout] || 60
+      self.polling  = options[:polling] || 5
+    end
+
+    # Decode the text from an image (i.e. solve a captcha).
+    #
+    # @param [Hash] options Options hash. Check docs for the method decode!.
+    #
+    # @return [TwoCaptcha::Captcha] The captcha (with solution) or an empty
+    #                               captcha instance if something goes wrong.
+    #
+    def decode(options = {})
+      decode!(options)
+    rescue TwoCaptcha::Error => ex
+      TwoCaptcha::Captcha.new
+    end
+
+    # Decode the text from an image (i.e. solve a captcha).
+    #
+    # @param [Hash] options Options hash.
+    # @option options [String]  :url   URL of the image to be decoded.
+    # @option options [String]  :path  File path of the image to be decoded.
+    # @option options [File]    :file  File instance with image to be decoded.
+    # @option options [String]  :raw   Binary content of the image to be
+    #                                  decoded.
+    # @option options [String]  :raw64 Binary content encoded in base64 of the
+    #                                  image to be decoded.
+    # @option options [Integer] :phrase         (0) https://2captcha.com/setting
+    # @option options [Integer] :regsense       (0) https://2captcha.com/setting
+    # @option options [Integer] :numeric        (0) https://2captcha.com/setting
+    # @option options [Integer] :calc           (0) https://2captcha.com/setting
+    # @option options [Integer] :min_len        (0) https://2captcha.com/setting
+    # @option options [Integer] :max_len        (0) https://2captcha.com/setting
+    # @option options [Integer] :language       (0) https://2captcha.com/setting
+    # @option options [Integer] :header_acao    (0) https://2captcha.com/setting
+    # @option options [Integer] :id_constructor (0) 23 if new reCAPTCHA.
+    #
+    # @return [TwoCaptcha::Captcha] The captcha (with solution) if an error is
+    #                               not raised.
+    #
+    def decode!(options = {})
+      started_at = Time.now
+
+      raw64 = load_captcha(options)
+      fail(TwoCaptcha::InvalidCaptcha) if raw64.to_s.empty?
+
+      decoded_captcha = upload(options.merge(raw64: raw64))
+
+      # pool untill the answer is ready
+      while decoded_captcha.text.to_s.empty?
+        sleep(polling)
+        decoded_captcha = captcha(decoded_captcha.id)
+        fail DeathByCaptcha::Timeout if (Time.now - started_at) > timeout
+      end
+
+      decoded_captcha
+    end
+
+    # Upload a captcha to 2Captcha.
+    #
+    # This method will not return the solution. It helps on separating concerns.
+    #
+    # @return [TwoCaptcha::Captcha] The captcha object (not solved yet).
+    #
+    def upload(options = {})
+      args = {}
+      args[:body]   = options[:raw64]
+      args[:method] = 'base64'
+      [:phrase, :regsense, :numeric, :calc, :min_len, :max_len, :language,
+       :header_acao, :id_constructor].each do |key|
+        args[key] = options[key] if options[key]
+      end
+      response = request('in', :multipart, args)
+
+      unless response.match(/\AOK\|/)
+        fail(TwoCaptcha::Error, 'Unexpected API Response')
+      end
+
+      TwoCaptcha::Captcha.new(
+        id: response.split('|', 2)[1],
+        api_response: response
+      )
+    end
+
+    # Retrieve information from an uploaded captcha.
+    #
+    # @param [Integer] captcha_id Numeric ID of the captcha.
+    #
+    # @return [TwoCaptcha::Captcha] The captcha object.
+    #
+    def captcha(captcha_id)
+      response = request('res', :get, action: 'get', id: captcha_id)
+
+      decoded_captcha = TwoCaptcha::Captcha.new(id: captcha_id)
+      decoded_captcha.api_response = response
+
+      if response.match(/\AOK\|/)
+        decoded_captcha.text = response.split('|', 2)[1]
+      end
+
+      decoded_captcha
+    end
+
+    # Report incorrectly solved captcha for refund.
+    #
+    # @param [Integer] id Numeric ID of the captcha.
+    #
+    # @return [Boolean] true if correctly reported
+    #
+    def report!(captcha_id)
+      response = request('res', :get, action: 'reportbad', id: captcha_id)
+      response == 'OK_REPORT_RECORDED'
+    end
+
+    # Get balance from your account.
+    #
+    # @return [Float] Balance in USD.
+    #
+    def balance
+      request('res', :get, action: 'getbalance').to_f
+    end
+
+    # Get statistics from your account.
+    #
+    # @param [Date] date Date when the statistics were collected.
+    #
+    # @return [String] Statistics from date in an XML string.
+    #
+    def stats(date)
+      request('res', :get, action: 'getstats', date: date.strftime('%Y-%m-%d'))
+    end
+
+    # Get current load from 2Captcha.
+    #
+    # @return [String] Load in an XML string.
+    #
+    def load
+      request('load', :get)
+    end
+
+    private
+
+    # Load a captcha raw content encoded in base64 from options.
+    #
+    # @param [Hash] options Options hash.
+    # @option options [String]  :url   URL of the image to be decoded.
+    # @option options [String]  :path  File path of the image to be decoded.
+    # @option options [File]    :file  File instance with image to be decoded.
+    # @option options [String]  :raw   Binary content of the image to bedecoded.
+    # @option options [String]  :raw64 Binary content encoded in base64 of the
+    #                                  image to be decoded.
+    #
+    # @return [String] The binary image base64 encoded.
+    #
+    def load_captcha(options)
+      if options[:raw64]
+        options[:raw64]
+      elsif options[:raw]
+        Base64.encode64(options[:raw])
+      elsif options[:file]
+        Base64.encode64(options[:file].read)
+      elsif options[:path]
+        Base64.encode64(File.open(options[:path], 'rb').read)
+      elsif options[:url]
+        Base64.encode64(TwoCaptcha::HTTP.open_url(options[:url]))
+      else
+        fail TwoCaptcha::ArgumentError, 'Illegal image format'
+      end
+    rescue
+      raise TwoCaptcha::InvalidCaptcha
+    end
+
+    # Perform an HTTP request to the 2Captcha API.
+    #
+    # @param [String] action  API method name.
+    # @param [Symbol] method  HTTP method (:get, :post, :multipart).
+    # @param [Hash]   payload Data to be sent through the HTTP request.
+    #
+    # @return [String] Response from the TwoCaptcha API.
+    #
+    def request(action, method = :get, payload = {})
+      res = TwoCaptcha::HTTP.request(
+        url: BASE_URL.gsub(':action', action),
+        timeout: timeout,
+        method: method,
+        payload: payload.merge(key: key, soft_id: 800)
+      )
+      validate_response(res)
+      res
+    end
+
+    # Fail if the response has errors.
+    #
+    # @param [String] response The body response from TwoCaptcha API.
+    #
+    def validate_response(response)
+      if (error = TwoCaptcha::RESPONSE_ERRORS[response])
+        fail(error)
+      elsif response.to_s.empty? || response.match(/\AERROR\_/)
+        fail(TwoCaptcha::Error, response)
+      end
+    end
+  end
+end

data/lib/two_captcha/errors.rb

@@ -0,0 +1,116 @@
+module TwoCaptcha
+  # This is the base TwoCaptcha exception class. Rescue it if you want to
+  # catch any exception that might be raised.
+  #
+  class Error < Exception
+  end
+
+  class ArgumentError < Error
+  end
+
+  class InvalidCaptcha < Error
+    def initialize
+      super('The captcha is empty or invalid')
+    end
+  end
+
+  class WrongUserKey < Error
+    def initialize
+      super('Wrong “key” parameter format, it should contain 32 symbols')
+    end
+  end
+
+  class InvalidUserKey < Error
+    def initialize
+      super('The “key” doesn’t exist')
+    end
+  end
+
+  class ZeroBalance < Error
+    def initialize
+      super('You don’t have enought money on your account')
+    end
+  end
+
+  class NoSlotAvailable < Error
+    def initialize
+      super('The current bid is higher than the maximum bid set for your account.')
+    end
+  end
+
+  class SmallCaptchaFilesize < Error
+    def initialize
+      super('CAPTCHA size is less than 100 bytes')
+    end
+  end
+
+  class BigCaptchaFilesize < Error
+    def initialize
+      super('CAPTCHA size is more than 100 Kbytes')
+    end
+  end
+
+  class WrongFileExtension < Error
+    def initialize
+      super('The CAPTCHA has a wrong extension. Possible extensions are: jpg,jpeg,gif,png')
+    end
+  end
+
+  class ImageNotSupported < Error
+    def initialize
+      super('The server cannot recognize the CAPTCHA file type')
+    end
+  end
+
+  class IpNotAllowed < Error
+    def initialize
+      super('The request has sent from the IP that is not on the list of your IPs. Check the list of your IPs in the system')
+    end
+  end
+
+  class IpBanned < Error
+    def initialize
+      super('The IP address you\'re trying to access our server with is banned due to many frequent attempts to access the server using wrong authorization keys. To lift the ban, please, contact our support team via email: support@2captcha.com')
+    end
+  end
+
+  class WrongIdFormat < Error
+    def initialize
+      super('Wrong format ID CAPTCHA. ID must contain only numbers')
+    end
+  end
+
+  class CaptchaUnsolvable < Error
+    def initialize
+      super('Captcha could not solve three different employee. Funds for this captcha not')
+    end
+  end
+
+  class EmptyAction < Error
+    def initialize
+      super('No action passed')
+    end
+  end
+
+  class Timeout < Error
+    def initialize
+      super('The captcha was not solved in the expected time')
+    end
+  end
+
+  RESPONSE_ERRORS = {
+    'ERROR_WRONG_USER_KEY'           => TwoCaptcha::WrongUserKey,
+    'ERROR_KEY_DOES_NOT_EXIST'       => TwoCaptcha::InvalidUserKey,
+    'ERROR_ZERO_BALANCE'             => TwoCaptcha::ZeroBalance,
+    'ERROR_NO_SLOT_AVAILABLE'        => TwoCaptcha::NoSlotAvailable,
+    'ERROR_ZERO_CAPTCHA_FILESIZE'    => TwoCaptcha::SmallCaptchaFilesize,
+    'ERROR_TOO_BIG_CAPTCHA_FILESIZE' => TwoCaptcha::BigCaptchaFilesize,
+    'ERROR_WRONG_FILE_EXTENSION'     => TwoCaptcha::WrongFileExtension,
+    'ERROR_IMAGE_TYPE_NOT_SUPPORTED' => TwoCaptcha::ImageNotSupported,
+    'ERROR_IP_NOT_ALLOWED'           => TwoCaptcha::IpNotAllowed,
+    'IP_BANNED'                      => TwoCaptcha::IpBanned,
+    'ERROR_WRONG_ID_FORMAT'          => TwoCaptcha::WrongIdFormat,
+    'ERROR_CAPTCHA_UNSOLVABLE'       => TwoCaptcha::CaptchaUnsolvable,
+    'ERROR_EMPTY_ACTION'             => TwoCaptcha::EmptyAction
+  }
+end

data/lib/two_captcha/http.rb

@@ -0,0 +1,100 @@
+module TwoCaptcha
+  # TwoCaptcha::HTTP exposes common HTTP routines that can be used by the
+  # TwoCaptcha API client.
+  #
+  class HTTP
+    # Retrieve the contents of a captcha URL supporting HTTPS and redirects.
+    #
+    # @param [String] url The captcha URL.
+    #
+    # @return [String] The contents of the captcha URL.
+    #
+    def self.open_url(url)
+      uri = URI(url)
+
+      http = Net::HTTP.new(uri.host, uri.port)
+
+      if uri.scheme == 'https'
+        http.use_ssl = true
+        http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+      end
+
+      res = http.get(uri.request_uri)
+
+      if (redirect = res.header['location'])
+        open_url(redirect)
+      else
+        res.body
+      end
+    end
+
+    # Perform an HTTP request with support to multipart requests.
+    #
+    # @param [Hash] options Options hash.
+    # @param options [String] url      URL to be requested.
+    # @param options [Symbol] method   HTTP method (:get, :post, :multipart).
+    # @param options [Hash]   payload  Data to be sent through the HTTP request.
+    # @param options [Integer] timeout HTTP open/read timeout in seconds.
+    #
+    # @return [String] Response body of the HTTP request.
+    #
+    def self.request(options = {})
+      uri     = URI(options[:url])
+      method  = options[:method] || :get
+      payload = options[:payload] || {}
+      timeout = options[:timeout] || 60
+      headers = { 'User-Agent' => TwoCaptcha::USER_AGENT }
+
+      case method
+      when :get
+        uri.query = URI.encode_www_form(payload)
+        req = Net::HTTP::Get.new(uri.request_uri, headers)
+
+      when :post
+        req = Net::HTTP::Post.new(uri.request_uri, headers)
+        req.set_form_data(payload)
+
+      when :multipart
+        req = Net::HTTP::Post.new(uri.request_uri, headers)
+        boundary, body = prepare_multipart_data(payload)
+        req.content_type = "multipart/form-data; boundary=#{boundary}"
+        req.body = body
+
+      else
+        fail TwoCaptcha::ArgumentError, "Illegal HTTP method (#{method})"
+      end
+
+      http = Net::HTTP.new(uri.hostname, uri.port)
+      http.use_ssl = true if (uri.scheme == 'https')
+      http.open_timeout = timeout
+      http.read_timeout = timeout
+      res = http.request(req)
+      res.body
+
+    rescue Net::OpenTimeout, Net::ReadTimeout
+      raise TwoCaptcha::Timeout
+    end
+
+    # Prepare the multipart data to be sent via a :multipart request.
+    #
+    # @param [Hash] payload Data to be prepared via a multipart post.
+    #
+    # @return [String, String] Boundary and body for the multipart post.
+    #
+    def self.prepare_multipart_data(payload)
+      boundary = 'randomstr' + rand(1_000_000).to_s # a random unique string
+
+      content = []
+      payload.each do |param, value|
+        content << '--' + boundary
+        content << "Content-Disposition: form-data; name=\"#{param}\""
+        content << ''
+        content << value
+      end
+      content << '--' + boundary + '--'
+      content << ''
+
+      [boundary, content.join("\r\n")]
+    end
+  end
+end

data/lib/two_captcha/models/captcha.rb

@@ -0,0 +1,11 @@
+module TwoCaptcha
+  # Model of a Captcha returned by ZeroCaptcha API.
+  #
+  class Captcha < TwoCaptcha::Model
+    attr_accessor :id, :text, :api_response
+
+    def indexes
+      text.gsub('click:', '').split(/[^0-9]/).map(&:to_i)
+    end
+  end
+end

data/lib/two_captcha/version.rb

@@ -0,0 +1,4 @@
+module TwoCaptcha
+  VERSION = '1.0.0'
+  USER_AGENT = "TwoCaptcha/Ruby v#{VERSION}"
+end

data/spec/credentials.yml.sample

@@ -0,0 +1,3 @@
+key: my_captcha_key
+captcha_id: 123456789 # use an ID of a solved captcha on your account
+solution: abc123 # use the captcha_id solution

data/spec/lib/client_spec.rb

@@ -0,0 +1,72 @@
+require 'spec_helper'
+
+key              = CREDENTIALS['key']
+captcha_id       = CREDENTIALS['captcha_id']
+captcha_solution = CREDENTIALS['solution']
+image64          = Base64.encode64(File.open('captchas/1.png', 'rb').read)
+recaptcha64      = Base64.encode64(File.open('captchas/2.jpg', 'rb').read)
+
+describe TwoCaptcha::Client do
+  describe 'create' do
+    context 'default' do
+      let(:client) { TwoCaptcha.new(key) }
+      it { expect(client).to be_a(TwoCaptcha::Client) }
+      it { expect(client.timeout).to be > 0 }
+      it { expect(client.polling).to be > 0 }
+    end
+
+    context 'timeout = 30 seconds' do
+      let(:timeout_client) { TwoCaptcha.new(key, timeout: 30) }
+      it { expect(timeout_client).to be_a(TwoCaptcha::Client) }
+      it { expect(timeout_client.timeout).to eq(30) }
+    end
+
+    context 'polling = 3 seconds' do
+      let(:polling_client) { TwoCaptcha.new(key, polling: 3) }
+      it { expect(polling_client).to be_a(TwoCaptcha::Client) }
+      it { expect(polling_client.polling).to eq(3) }
+    end
+  end
+  context 'methods' do
+    before(:all) { @client = TwoCaptcha.new(key) }
+
+    describe '#load_captcha' do
+      it { expect(@client.send(:load_captcha, url: 'http://bit.ly/1xXZcKo')).to eq(image64) }
+      it { expect(@client.send(:load_captcha, path: 'captchas/1.png')).to eq(image64) }
+      it { expect(@client.send(:load_captcha, file: File.open('captchas/1.png', 'rb'))).to eq(image64) }
+      it { expect(@client.send(:load_captcha, raw: File.open('captchas/1.png', 'rb').read)).to eq(image64) }
+      it { expect(@client.send(:load_captcha, raw64: image64)).to eq(image64) }
+    end
+
+    describe '#captcha' do
+      before(:all) { @captcha = @client.captcha(captcha_id) }
+      it { expect(@captcha).to be_a(TwoCaptcha::Captcha) }
+      it { expect(@captcha.text).to eq(captcha_solution) }
+      it { expect(@captcha.id).to eq(captcha_id) }
+    end
+
+    describe '#decode!' do
+      before(:all) { @captcha = @client.decode!(raw64: image64) }
+      it { expect(@captcha).to be_a(TwoCaptcha::Captcha) }
+      it { expect(@captcha.text.downcase).to eq 'infosimples' }
+      it { expect(@captcha.id).to match(/[0-9]{9}/) }
+    end
+
+    describe '#balance' do
+      before(:all) { @balance = @client.balance }
+      it { expect(@balance).to be > 0 }
+    end
+  end
+
+  context 'new reCAPTCHA' do
+    before(:all) { @client = TwoCaptcha.new(key) }
+
+    describe '#decode!' do
+      before(:all) { @captcha = @client.decode!(raw64: recaptcha64, id_constructor: 23) }
+
+      it { expect(@captcha).to be_a(TwoCaptcha::Captcha) }
+      it { expect(@captcha.indexes).to eq([1, 9]) }
+      it { expect(@captcha.id).to match(/[0-9]{9}/) }
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,17 @@
+RSpec.configure do |config|
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = "random"
+
+  # Only accept the new syntax of "expect" instead of "should".
+  config.expect_with :rspec do |c|
+    c.syntax = :expect
+  end
+end
+
+require 'yaml'
+require 'two_captcha'
+
+CREDENTIALS = YAML.load_file('spec/credentials.yml')

data/two_captcha.gemspec

@@ -0,0 +1,24 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'two_captcha/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "two_captcha"
+  spec.version       = TwoCaptcha::VERSION
+  spec.authors       = ["Marcelo Mita", "Rafael Barbolo"]
+  spec.email         = ["team@infosimples.com.br"]
+  spec.summary       = %q{Ruby API for 2Captcha (Captcha Solver as a Service)}
+  spec.description   = %q{TwoCaptcha allows you to solve captchas with manual labor}
+  spec.homepage      = "https://github.com/infosimples/two_captcha"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.8"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.1"
+end

metadata

@@ -0,0 +1,114 @@
+--- !ruby/object:Gem::Specification
+name: two_captcha
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Marcelo Mita
+- Rafael Barbolo
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-09-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+description: TwoCaptcha allows you to solve captchas with manual labor
+email:
+- team@infosimples.com.br
+executables:
+- console
+- setup
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- captchas/1.png
+- captchas/2.jpg
+- lib/two_captcha.rb
+- lib/two_captcha/client.rb
+- lib/two_captcha/errors.rb
+- lib/two_captcha/http.rb
+- lib/two_captcha/models/captcha.rb
+- lib/two_captcha/version.rb
+- spec/credentials.yml.sample
+- spec/lib/client_spec.rb
+- spec/spec_helper.rb
+- two_captcha.gemspec
+homepage: https://github.com/infosimples/two_captcha
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.3
+signing_key: 
+specification_version: 4
+summary: Ruby API for 2Captcha (Captcha Solver as a Service)
+test_files:
+- spec/credentials.yml.sample
+- spec/lib/client_spec.rb
+- spec/spec_helper.rb