Ruby client for Sema Media Data's image OCR API. Used for getting an estimated text to image ratio for validating images before being submitted to Facebook Ads.
Add this line to your application's Gemfile:
gem 'sema_api_ruby'And then execute:
$ bundle
Or install it yourself as:
$ gem install sema_api_ruby
Configure the client by providing an API token. Also tweak the configuration for any of the OCR settings.
SemaApiRuby.configure do |config|
config.access_token = 'myaccesstokenhere'
#optional - below are the defaults
config.ocr_settings = {
lang: 'en', # english language
outform: 'json', # output as json
sp: 'True', # perform spellcheck
mh: 'True', # multi-hypothesis... increases accuracy at slight performance cost
df: 'True', # dictionary based word filtering
noempty: 'True' # only return detected objects that are not empty
}
endPost a request to the ocr endpoint with the path to an image to get back a raw response from the api (post made using Faraday gem)
client = SemaApiRuby.new
file_path = '/path/to/your/image.jpg'
client.post_ocr_image(file_path)
# => #<Faraday::Response:0x007fcb641591e0 ...Use this method to both post to the ocr endpoint and return an text to image ratio
client = SemaApiRuby.new
file_path = '/path/to/your/image.jpg'
client.text_to_image_ratio(file_path)
# => 0.2123Copy the sample dotenv file to .env
$> cp .env.sample .env
Update it with a testing API token if you want to run specs against the live API rather than against the network stubs
Run the specs
$> bundle exec rspec spec
This gem uses a testing gem called VCR to record and replay HTTP requests. If the actual API has changed you will need to delete all "casettes" located in spec/cassettes/ so that requests will run against the live API
- Fork it ( https://github.com/[my-github-username]/sema_api_ruby/fork )
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create a new Pull Request