htmlcsstoimage-api 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e31f5dd0bf4da3319b38ffc93f91859b65345b424b08bf750aed94a99f35fac3
+  data.tar.gz: 18fb9f5a694c1f35d1b4d502c94f0ae61df5d199fffdab3defb11c216bd46156
+SHA512:
+  metadata.gz: 66237da8da333169cac3bdb38c1dbd722fe66012a9d280f318a0c1c2cd4835f1905fb6cc2fa5cfe86974c38bfb9699bf0119e2c006144eb70c0c79f462f6e57c
+  data.tar.gz: 21b6b6d5006672aa27f55425eb6f91cee86c3ecaafa303d5a35e19ad8d3cd01466ad857c1bdb68af683d464bb00fcb3593185f56d9d31360b58c0297bbeb3df6

data/.gitignore

@@ -0,0 +1,13 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status
+
+*.gem

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.ruby-version

@@ -0,0 +1 @@
+2.6.5

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+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, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at coutermarsh.mike@gmail.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/Gemfile

@@ -0,0 +1,6 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in htmlcsstoimage.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,68 @@
+PATH
+  remote: .
+  specs:
+    htmlcsstoimage-api (0.1.0)
+      httparty (> 0.10)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.7.0)
+      public_suffix (>= 2.0.2, < 5.0)
+    byebug (11.1.3)
+    coderay (1.1.3)
+    crack (0.4.3)
+      safe_yaml (~> 1.0.0)
+    diff-lcs (1.4.4)
+    hashdiff (1.0.1)
+    httparty (0.18.1)
+      mime-types (~> 3.0)
+      multi_xml (>= 0.5.2)
+    method_source (1.0.0)
+    mime-types (3.3.1)
+      mime-types-data (~> 3.2015)
+    mime-types-data (3.2020.0512)
+    multi_xml (0.6.0)
+    pry (0.13.1)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    pry-byebug (3.9.0)
+      byebug (~> 11.0)
+      pry (~> 0.13.0)
+    public_suffix (4.0.5)
+    rake (10.5.0)
+    rspec (3.9.0)
+      rspec-core (~> 3.9.0)
+      rspec-expectations (~> 3.9.0)
+      rspec-mocks (~> 3.9.0)
+    rspec-core (3.9.2)
+      rspec-support (~> 3.9.3)
+    rspec-expectations (3.9.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.9.0)
+    rspec-mocks (3.9.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.9.0)
+    rspec-support (3.9.3)
+    safe_yaml (1.0.5)
+    vcr (6.0.0)
+    webmock (3.8.3)
+      addressable (>= 2.3.6)
+      crack (>= 0.3.2)
+      hashdiff (>= 0.4.0, < 2.0.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (> 2.0)
+  htmlcsstoimage-api!
+  pry
+  pry-byebug
+  rake (~> 10.0)
+  rspec (~> 3.0)
+  vcr
+  webmock
+
+BUNDLED WITH
+   2.1.4

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2020 Code Happy, LLC
+
+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,83 @@
+# HTML/CSS to Image - Ruby
+
+Ruby client for the [HTML/CSS to Image API](https://htmlcsstoimage.com).
+
+Generate a png, jpg or webp images with Ruby. Renders exactly like Google Chrome.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'htmlcsstoimage-api'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install htmlcsstoimage-api
+
+## Usage
+
+Create a new instance of the API client.
+
+```ruby
+# Retrieve your user id and api key from https://htmlcsstoimage.com/dashboard
+client = HTMLCSSToImage.new(user_id: "user-id", api_key: "api-key")
+```
+
+Alternatively, you can set `ENV["HCTI_USER_ID"]` and `ENV["HCTI_API_KEY"]`. These will be loaded automatically.
+
+```ruby
+client = HTMLCSSToImage.new
+```
+
+### Create an image
+
+```ruby
+image = client.create_image("<div>Hello, world</div>",
+                            css: "div { background-color: red; font-family: Roboto; }",
+                            google_fonts: "Roboto")
+
+image
+=> #<HTMLCSSToImage::ApiResponse url="https://hcti.io/v1/image/254b444c-dd82-4cc1-94ef-aa4b3a6870a6", id="254b444c-dd82-4cc1-94ef-aa4b3a6870a6">
+image.url
+=> "https://hcti.io/v1/image/254b444c-dd82-4cc1-94ef-aa4b3a6870a6"
+```
+
+### Delete an image
+```Ruby
+client.delete_image("254b444c-dd82-4cc1-94ef-aa4b3a6870a6")
+```
+
+### URL to image
+```ruby
+image = client.url_to_image("https://github.com", viewport_width: 800, viewport_height: 1200)
+```
+
+## Available parameters
+For detailed information on all the available parameters, visit the docs: https://docs.htmlcsstoimage.com/getting-started/using-the-api/
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Support
+For help with the API, you can also contact `support@htmlcsstoimage.com`.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/htmlcsstoimage/ruby-client/contributor-covenant.org) code of conduct.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/htmlcsstoimage/ruby-client/blob/main/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "htmlcsstoimage"
+
+# 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(__FILE__)

data/bin/setup

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

data/cassettes/HTMLCSSToImage/_create_image/accepts_additional_params.yml

@@ -0,0 +1,66 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://hcti.io/v1/image?includeId=true
+    body:
+      encoding: UTF-8
+      string: '{"html":"<div>test</div>","css":"body { background-color: orange }","ms_delay":500,"google_fonts":"Roboto"}'
+    headers:
+      Content-Type:
+      - application/json
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+      User-Agent:
+      - Ruby
+      Authorization:
+      - Basic authentication-header
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Fri, 07 Aug 2020 16:26:02 GMT
+      Content-Type:
+      - application/json; charset=utf-8
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - keep-alive
+      Set-Cookie:
+      - __cfduid=d2514bf66b55358e89144d7ce2e05ca431596817562; expires=Sun, 06-Sep-20
+        16:26:02 GMT; path=/; domain=.hcti.io; HttpOnly; SameSite=Lax
+      Cf-Ray:
+      - 5bf25b63d9e06d52-SJC
+      Access-Control-Allow-Origin:
+      - "*"
+      Age:
+      - '235'
+      Cache-Control:
+      - max-age=14400, 31536000
+      Vary:
+      - Accept-Encoding
+      Cf-Cache-Status:
+      - HIT
+      Cf-Request-Id:
+      - 046b57726600006d5284153200000001
+      Expect-Ct:
+      - max-age=604800, report-uri="https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct"
+      Request-Context:
+      - appId=cid-v1:ef200074-f922-49b8-a889-360bb27d5561
+      X-Is-Overage:
+      - 'False'
+      X-Renders-Allowed:
+      - '500000'
+      X-Renders-Used:
+      - '4539'
+      Server:
+      - cloudflare
+    body:
+      encoding: ASCII-8BIT
+      string: '{"url":"https://hcti.io/v1/image/254b444c-dd82-4cc1-94ef-aa4b3a6870a6","id":"254b444c-dd82-4cc1-94ef-aa4b3a6870a6"}'
+  recorded_at: Fri, 07 Aug 2020 16:26:02 GMT
+recorded_with: VCR 6.0.0

data/cassettes/HTMLCSSToImage/_create_image/creates_an_image.yml

@@ -0,0 +1,64 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://hcti.io/v1/image?includeId=true
+    body:
+      encoding: UTF-8
+      string: '{"html":"<div>test</div>"}'
+    headers:
+      Content-Type:
+      - application/json
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+      User-Agent:
+      - Ruby
+      Authorization:
+      - Basic authentication-header
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Fri, 07 Aug 2020 16:26:01 GMT
+      Content-Type:
+      - application/json; charset=utf-8
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - keep-alive
+      Set-Cookie:
+      - __cfduid=d3a44d4dbf2273232e5acce7284a8582e1596817561; expires=Sun, 06-Sep-20
+        16:26:01 GMT; path=/; domain=.hcti.io; HttpOnly; SameSite=Lax
+      Cf-Ray:
+      - 5bf25b61183a93be-SJC
+      Access-Control-Allow-Origin:
+      - "*"
+      Cache-Control:
+      - max-age=public, 31536000
+      Vary:
+      - Accept-Encoding
+      Cf-Cache-Status:
+      - DYNAMIC
+      Cf-Request-Id:
+      - 046b5770aa000093be5f243200000001
+      Expect-Ct:
+      - max-age=604800, report-uri="https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct"
+      Request-Context:
+      - appId=cid-v1:ef200074-f922-49b8-a889-360bb27d5561
+      X-Is-Overage:
+      - 'False'
+      X-Renders-Allowed:
+      - '500000'
+      X-Renders-Used:
+      - '4539'
+      Server:
+      - cloudflare
+    body:
+      encoding: ASCII-8BIT
+      string: '{"url":"https://hcti.io/v1/image/b1021edd-0af3-4764-9a1c-6d9eae18985d","id":"b1021edd-0af3-4764-9a1c-6d9eae18985d"}'
+  recorded_at: Fri, 07 Aug 2020 16:26:02 GMT
+recorded_with: VCR 6.0.0

data/cassettes/HTMLCSSToImage/_delete_image/deletes_an_image.yml

@@ -0,0 +1,60 @@
+---
+http_interactions:
+- request:
+    method: delete
+    uri: https://hcti.io/v1/image/254b444c-dd82-4cc1-94ef-aa4b3a6870a6
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Content-Type:
+      - application/json
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+      User-Agent:
+      - Ruby
+      Authorization:
+      - Basic authentication-header
+  response:
+    status:
+      code: 202
+      message: Accepted
+    headers:
+      Date:
+      - Fri, 07 Aug 2020 16:51:36 GMT
+      Content-Length:
+      - '0'
+      Connection:
+      - keep-alive
+      Set-Cookie:
+      - AWSALB=HZiSeVcPpOrp8Cnv2US5zfSSk4zfNJf/1l6T3PqVI3TgleMUP0b2nZb4TVAApvvUUVtxSVFXNdHGp+1mFZbuW/HdLu5+oJhsQGABcpZB1/81jltlZ915zAZsPiqQ;
+        Expires=Fri, 14 Aug 2020 16:51:36 GMT; Path=/
+      - AWSALBCORS=HZiSeVcPpOrp8Cnv2US5zfSSk4zfNJf/1l6T3PqVI3TgleMUP0b2nZb4TVAApvvUUVtxSVFXNdHGp+1mFZbuW/HdLu5+oJhsQGABcpZB1/81jltlZ915zAZsPiqQ;
+        Expires=Fri, 14 Aug 2020 16:51:36 GMT; Path=/; SameSite=None
+      - __cfduid=d2ba84d953b71c6632e925836ec9c13981596819096; expires=Sun, 06-Sep-20
+        16:51:36 GMT; path=/; domain=.hcti.io; HttpOnly; SameSite=Lax
+      - __cflb=0H28vWzHFPHZw4TS8VrB813a2Y9bcaFsXduaPonfK5N; SameSite=Lax; path=/;
+        expires=Sat, 08-Aug-20 15:51:36 GMT; HttpOnly
+      Cf-Ray:
+      - 5bf280d648daed17-SJC
+      Access-Control-Allow-Origin:
+      - "*"
+      Cf-Cache-Status:
+      - DYNAMIC
+      Cf-Request-Id:
+      - 046b6ed9eb0000ed17e9360200000001
+      Expect-Ct:
+      - max-age=604800, report-uri="https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct"
+      Request-Context:
+      - appId=cid-v1:ef200074-f922-49b8-a889-360bb27d5561
+      Vary:
+      - Accept-Encoding
+      Server:
+      - cloudflare
+    body:
+      encoding: UTF-8
+      string: ''
+  recorded_at: Fri, 07 Aug 2020 16:51:36 GMT
+recorded_with: VCR 6.0.0

data/cassettes/HTMLCSSToImage/_templates/retrieves_templates.yml

@@ -0,0 +1,110 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://hcti.io/v1/template
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Content-Type:
+      - application/json
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+      User-Agent:
+      - Ruby
+      Authorization:
+      - Basic authentication-header
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Thu, 06 Aug 2020 21:25:39 GMT
+      Content-Type:
+      - application/json; charset=utf-8
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - keep-alive
+      Set-Cookie:
+      - AWSALB=lVKuyuNFEjqfNaDkDxgqrzytNUb+WNwbEoJYuWl/uaVFNut/FpixcciblHfX4vzn/LdoTZU+RnIgjBB90kY7SUhcqudTAr7X7/ubSM65lP7WykpDrr5CphMc0mkC;
+        Expires=Thu, 13 Aug 2020 21:25:38 GMT; Path=/
+      - AWSALBCORS=lVKuyuNFEjqfNaDkDxgqrzytNUb+WNwbEoJYuWl/uaVFNut/FpixcciblHfX4vzn/LdoTZU+RnIgjBB90kY7SUhcqudTAr7X7/ubSM65lP7WykpDrr5CphMc0mkC;
+        Expires=Thu, 13 Aug 2020 21:25:38 GMT; Path=/; SameSite=None
+      - __cfduid=d24954ff54b38cb9910836fadcf6542f01596749138; expires=Sat, 05-Sep-20
+        21:25:38 GMT; path=/; domain=.hcti.io; HttpOnly; SameSite=Lax
+      - __cflb=02DiuGMQFf4rnadqPFSDhdmYgHrhp7JS62YACr3aZ9wsz; SameSite=Lax; path=/;
+        expires=Fri, 07-Aug-20 20:25:39 GMT; HttpOnly
+      Cf-Ray:
+      - 5bebd4e51d7aeb89-LAX
+      Access-Control-Allow-Origin:
+      - "*"
+      Vary:
+      - Accept-Encoding
+      Cf-Cache-Status:
+      - DYNAMIC
+      Cf-Request-Id:
+      - 046743632d0000eb8931ba9200000001
+      Expect-Ct:
+      - max-age=604800, report-uri="https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct"
+      Request-Context:
+      - appId=cid-v1:ef200074-f922-49b8-a889-360bb27d5561
+      Server:
+      - cloudflare
+    body:
+      encoding: ASCII-8BIT
+      string: '{"data":[{"css":".code-example {\n  background-color: white;\n  background-image:
+        linear-gradient(0deg,rgba(225,228,232,0),rgba(225,228,232,0) 7px,#e1e4e8 ,rgba(225,228,232,0)
+        8px),linear-gradient(90deg,rgba(225,228,232,0),rgba(225,228,232,0) 7px,#e1e4e8
+        ,rgba(225,228,232,0) 8px);\n  background-position: center center;\n  background-size:
+        45px 45px;\n  border: 1px solid #eeebee;\n  border-radius: 4px;\n  box-sizing:
+        border-box;\n  height: 300px;\n  margin: 30px;\n  padding: 30px;\n  width:
+        600px;\n  display: flex;\n  align-items: center; justify-content: center;
+        flex-direction: column;\n  -webkit-box-shadow: 5px 5px 15px -1px rgba(0,0,0,0.36);
+        \nbox-shadow: 5px 5px 15px -1px rgba(0,0,0,0.36);\n}\n.hcti-container {\n  box-sizing:
+        border-box;\n  padding: 5px;\n  display: flex;\n  align-items:center;\n}\nh1
+        {\n  text-align: center;\n  font-size: 40px;  \n  margin-top: auto;\n}\n.logo-text
+        {\n  margin-left: 6px;\n  font-size: 16px;\n}\n.w-border {\n  border: 1px
+        dashed #2869e6;\n  padding: 5px;\n  justify-content: center;\n  text-align:
+        center;\n  vertical-align: middle;\n  margin-top: auto;\n  margin-bottom:
+        10px;\n}\nimg {\n  border: 1px solid #eeebee;\n  box-sizing: border-box;\n  height:
+        auto;\n  margin: 0;\n  max-width: 100%;\n  padding: 0;\n  vertical-align:
+        bottom;\n}\n:root {\n  --bg-angle: 10deg; \n}\nbody {\nfont-family: -apple-system,
+        BlinkMacSystemFont, \"helvetica neue\", helvetica, Rubik, noto, \"segoe ui\",
+        arial, sans-serif;\n      background: linear-gradient(var(--bg-angle),#f79533,#f37055,#ef4e7b,#a166ab,#5073b8,#1098ad,#07b39b,#6fba82);\n}","created_at":"2020-08-02T20:01:56.762+00:00","description":null,"device_scale":null,"google_fonts":"Rubik","html":"<div
+        class=\"code-example\">\n  <h1>{{title}}</h1>\n  <div class=\"w-border\">\n    <div
+        class=\"hcti-container\"><img width=\"45\" src=\"https://docs.htmlcsstoimage.com/assets/images/HCTI.png\"><span
+        class=\"logo-text\">HTML/CSS to Image API</span>\n    </div>\n  </div>\n</div>\n<script>\n  //
+        Randomly change background color direction.\n  var random = Math.floor(Math.random()
+        * Math.floor(360))\n  var body = document.body;\n  body.style.setProperty(''--bg-angle'',
+        random + ''deg'');\n</script>","id":"t-9f6526a7-aa2c-4fbb-8723-06eff1c60e89","max_wait_ms":null,"ms_delay":null,"name":null,"render_when_ready":null,"updated_at":"2020-08-02T20:01:56.763+00:00","version":1596398516763,"viewport_height":null,"viewport_width":null},{"css":".code-example
+        {\n  background-color: white;\n  background-image: linear-gradient(0deg,rgba(225,228,232,0),rgba(225,228,232,0)
+        7px,#e1e4e8 ,rgba(225,228,232,0) 8px),linear-gradient(90deg,rgba(225,228,232,0),rgba(225,228,232,0)
+        7px,#e1e4e8 ,rgba(225,228,232,0) 8px);\n  background-position: center center;\n  background-size:
+        45px 45px;\n  border: 1px solid #eeebee;\n  border-radius: 4px;\n  box-sizing:
+        border-box;\n  height: 300px;\n  margin: 30px;\n  padding: 30px;\n  width:
+        600px;\n  display: flex;\n  align-items: center; justify-content: center;
+        flex-direction: column;\n  -webkit-box-shadow: 5px 5px 15px -1px rgba(0,0,0,0.36);
+        \nbox-shadow: 5px 5px 15px -1px rgba(0,0,0,0.36);\n}\n.hcti-container {\n  box-sizing:
+        border-box;\n  padding: 5px;\n  display: flex;\n  align-items:center;\n}\nh1
+        {\n  text-align: center;\n  font-size: 40px;  \n  margin-top: auto;\n}\n.logo-text
+        {\n  margin-left: 6px;\n  font-size: 16px;\n}\n.w-border {\n  border: 1px
+        dashed #2869e6;\n  padding: 5px;\n  justify-content: center;\n  text-align:
+        center;\n  vertical-align: middle;\n  margin-top: auto;\n  margin-bottom:
+        10px;\n}\nimg {\n  border: 1px solid #eeebee;\n  box-sizing: border-box;\n  height:
+        auto;\n  margin: 0;\n  max-width: 100%;\n  padding: 0;\n  vertical-align:
+        bottom;\n}\n:root {\n  --bg-angle: 10deg; \n}\nbody {\nfont-family: -apple-system,
+        BlinkMacSystemFont, \"helvetica neue\", helvetica, Rubik, noto, \"segoe ui\",
+        arial, sans-serif;\n      background: linear-gradient(var(--bg-angle),#f79533,#f37055,#ef4e7b,#a166ab,#5073b8,#1098ad,#07b39b,#6fba82);\n}","created_at":"2020-08-02T20:02:01.544+00:00","description":null,"device_scale":null,"google_fonts":"Rubik","html":"<div
+        class=\"code-example\">\n  <h1>{{title}}</h1>\n  <div class=\"w-border\">\n    <div
+        class=\"hcti-container\"><img width=\"45\" src=\"https://docs.htmlcsstoimage.com/assets/images/HCTI.png\"><span
+        class=\"logo-text\">HTML/CSS to Image API</span>\n    </div>\n  </div>\n</div>\n<script>\n  //
+        Randomly change background color direction.\n  var random = Math.floor(Math.random()
+        * Math.floor(360))\n  var body = document.body;\n  body.style.setProperty(''--bg-angle'',
+        random + ''deg'');\n</script>","id":"t-fc18eff2-6e43-4c10-963a-0be753db4065","max_wait_ms":null,"ms_delay":null,"name":null,"render_when_ready":null,"updated_at":"2020-08-02T20:02:01.544+00:00","version":1596398521544,"viewport_height":null,"viewport_width":null}],"pagination":{"next_page_start":null}}'
+  recorded_at: Thu, 06 Aug 2020 21:25:39 GMT
+recorded_with: VCR 6.0.0

data/cassettes/HTMLCSSToImage/_url_to_image/accepts_additional_params.yml

@@ -0,0 +1,64 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://hcti.io/v1/image?includeId=true
+    body:
+      encoding: UTF-8
+      string: '{"url":"https://hcti.io","viewport_width":800,"viewport_height":1200,"ms_delay":500}'
+    headers:
+      Content-Type:
+      - application/json
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+      User-Agent:
+      - Ruby
+      Authorization:
+      - Basic authentication-header
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Fri, 07 Aug 2020 16:26:02 GMT
+      Content-Type:
+      - application/json; charset=utf-8
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - keep-alive
+      Set-Cookie:
+      - __cfduid=d3c6239ef3863b255e584197f6109aa701596817562; expires=Sun, 06-Sep-20
+        16:26:02 GMT; path=/; domain=.hcti.io; HttpOnly; SameSite=Lax
+      Cf-Ray:
+      - 5bf25b65bce50252-SJC
+      Access-Control-Allow-Origin:
+      - "*"
+      Cache-Control:
+      - max-age=public, 31536000
+      Vary:
+      - Accept-Encoding
+      Cf-Cache-Status:
+      - DYNAMIC
+      Cf-Request-Id:
+      - 046b57739000000252bcac6200000001
+      Expect-Ct:
+      - max-age=604800, report-uri="https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct"
+      Request-Context:
+      - appId=cid-v1:ef200074-f922-49b8-a889-360bb27d5561
+      X-Is-Overage:
+      - 'False'
+      X-Renders-Allowed:
+      - '500000'
+      X-Renders-Used:
+      - '4541'
+      Server:
+      - cloudflare
+    body:
+      encoding: ASCII-8BIT
+      string: '{"url":"https://hcti.io/v1/image/62157984-dfc9-4ec9-956a-de8931749215","id":"62157984-dfc9-4ec9-956a-de8931749215"}'
+  recorded_at: Fri, 07 Aug 2020 16:26:03 GMT
+recorded_with: VCR 6.0.0

data/cassettes/HTMLCSSToImage/_url_to_image/creates_an_image_from_a_url.yml

@@ -0,0 +1,64 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: https://hcti.io/v1/image?includeId=true
+    body:
+      encoding: UTF-8
+      string: '{"url":"https://hcti.io"}'
+    headers:
+      Content-Type:
+      - application/json
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+      User-Agent:
+      - Ruby
+      Authorization:
+      - Basic authentication-header
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Fri, 07 Aug 2020 16:26:02 GMT
+      Content-Type:
+      - application/json; charset=utf-8
+      Transfer-Encoding:
+      - chunked
+      Connection:
+      - keep-alive
+      Set-Cookie:
+      - __cfduid=d733844fdf4b2d3fe0551a030daf2ef991596817562; expires=Sun, 06-Sep-20
+        16:26:02 GMT; path=/; domain=.hcti.io; HttpOnly; SameSite=Lax
+      Cf-Ray:
+      - 5bf25b64699fed23-SJC
+      Access-Control-Allow-Origin:
+      - "*"
+      Cache-Control:
+      - max-age=public, 31536000
+      Vary:
+      - Accept-Encoding
+      Cf-Cache-Status:
+      - DYNAMIC
+      Cf-Request-Id:
+      - 046b5772c10000ed23cc811200000001
+      Expect-Ct:
+      - max-age=604800, report-uri="https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct"
+      Request-Context:
+      - appId=cid-v1:ef200074-f922-49b8-a889-360bb27d5561
+      X-Is-Overage:
+      - 'False'
+      X-Renders-Allowed:
+      - '500000'
+      X-Renders-Used:
+      - '4540'
+      Server:
+      - cloudflare
+    body:
+      encoding: ASCII-8BIT
+      string: '{"url":"https://hcti.io/v1/image/a8a9dda4-2c6e-41ab-9c7e-f851ed923274","id":"a8a9dda4-2c6e-41ab-9c7e-f851ed923274"}'
+  recorded_at: Fri, 07 Aug 2020 16:26:02 GMT
+recorded_with: VCR 6.0.0

data/htmlcsstoimage.gemspec

@@ -0,0 +1,34 @@
+
+lib = File.expand_path("../lib", __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "htmlcsstoimage/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "htmlcsstoimage-api"
+  spec.version       = HTMLCSSToImage::VERSION
+  spec.authors       = ["Mike Coutermarsh", "Jeffrey Needles"]
+  spec.email         = ["support@htmlcsstoimage.com"]
+
+  spec.summary       = %q{Ruby wrapper for the HTML/CSS to Image API.}
+  spec.description   = %q{Generate images using HTML/CSS and Ruby.}
+  spec.homepage      = "https://docs.htmlcsstoimage.com/example-code/ruby"
+  spec.license       = "MIT"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "httparty", "> 0.10"
+  spec.add_development_dependency "bundler", "> 2.0"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "pry"
+  spec.add_development_dependency "pry-byebug"
+  spec.add_development_dependency "vcr"
+  spec.add_development_dependency "webmock"
+end

data/lib/htmlcsstoimage.rb

@@ -0,0 +1,115 @@
+require "htmlcsstoimage/version"
+require "httparty"
+require "addressable"
+
+class HTMLCSSToImage
+  include HTTParty
+  base_uri 'https://hcti.io'
+  headers 'Content-Type' => 'application/json'
+  format :json
+
+  SIGNED_URL_TEMPLATE = Addressable::Template.new("https://hcti.io/v1/image/{template_id}/{signed_token}{/format*}{?query*}")
+
+  class ApiResponse < OpenStruct
+  end
+
+  parser(
+    proc do |body, format|
+      case format
+      when :json
+        JSON.parse(body, object_class: ApiResponse)
+      else
+        body
+      end
+    end
+  )
+
+  # Creates an instance of HTMLCSSToImage with API credentials.
+  #   If credentials are not provided, will try to use environment variables.
+  #   `HCTI_USER_ID` and `HCTI_API_KEY`.
+  #
+  # @see {https://htmlcsstoimage.com/dashboard}
+  #
+  # @param user_id [String] the user_id for the account.
+  # @param api_key [String] the api_key for the account.
+  # @return [HTMLCSSToImage] an instance of the api client.
+  def initialize(user_id: ENV["HCTI_USER_ID"], api_key: ENV["HCTI_API_KEY"])
+    @auth = { username: user_id, password: api_key }
+  end
+
+  # Converts HTML/CSS to an image with the API
+  #
+  # @see {https://docs.htmlcsstoimage.com/getting-started/using-the-api}
+  #
+  # @param html [String] This is the HTML you want to render. You can send an HTML snippet (`<div>Your content</div>`) or an entire webpage.
+  #
+  # @option params [String] :css The CSS for your image.
+  # @option params [String] :google_fonts [Google fonts](https://docs.htmlcsstoimage.com/guides/using-google-fonts/) to be loaded. Example: `Roboto`. Multiple fonts can be loaded like this: `Roboto|Open Sans`
+  # @option params [String] :selector A CSS selector for an element on the webpage. We'll crop the image to this specific element. For example: `section#complete-toolkit.container-lg`
+  # @option params [Integer] :ms_delay The number of milliseconds the API should delay before generating the image. This is useful when waiting for JavaScript. We recommend starting with `500`. Large values slow down the initial render time.
+  # @option params [Double] :device_scale This adjusts the pixel ratio for the screenshot. Minimum: `1`, Maximum: `3`.
+  # @option params [Boolean] :render_when_ready Set to true to control when the image is generated. Call `ScreenshotReady()` from JavaScript to generate the image. [Learn more](https://docs.htmlcsstoimage.com/guides/render-when-ready/).
+  # @option params [Integer] :viewport_width Set the width of Chrome's viewport. This will disable automatic cropping. Both height and width parameters must be set if using either.
+  # @option params [Integer] :viewport_height Set the height of Chrome's viewport. This will disable automatic cropping. Both height and width parameters must be set if using either.
+  #
+  # @return [HTMLCSSToImage::ApiResponse] image URL available at `.url`.
+  def create_image(html, params = {})
+    body = { html: html }.merge(params).to_json
+    options = { basic_auth: @auth, body: body, query: { includeId: true } }
+
+    self.class.post("/v1/image", options)
+  end
+
+  # Deletes an image
+  #
+  # @see {https://docs.htmlcsstoimage.com/getting-started/using-the-api}
+  #
+  # @param image_id [String] The ID for the image you would like to delete
+  def delete_image(image_id)
+    response = self.class.delete("/v1/image/#{image_id}", basic_auth: @auth)
+
+    return true if response.success?
+
+    response
+  end
+
+
+  # Creates a signed URL for generating an image from a template
+  # This URL contains the template_values in it. It is signed with HMAC so that it cannot be changed
+  # by anyone without the API Key.
+  #
+  # Does not make any network requests.
+  #
+  # @see {https://docs.htmlcsstoimage.com/getting-started/using-the-api}
+  #
+  # @param template_id [String] The ID for the template
+  # @param template_values [Hash] A hash containing the values to replace in the template
+  def create_image_from_template(template_id, template_values = {}, params = {})
+    template = SIGNED_URL_TEMPLATE.partial_expand({
+      template_id: template_id,
+      query: template_values
+    })
+
+    query = Addressable::URI.parse(template.generate).query
+    digest = OpenSSL::Digest.new('sha256')
+    signed_token = OpenSSL::HMAC.hexdigest(digest, @auth[:password], CGI.unescape(query))
+
+    url = template.expand({
+      signed_token: signed_token
+    }).to_s
+
+    ApiResponse.new(url: url)
+  end
+
+  def url_to_image(url, params = {})
+    body = { url: url }.merge(params).to_json
+    options = { basic_auth: @auth, body: body, query: { includeId: true } }
+
+    self.class.post("/v1/image", options)
+  end
+
+  def templates(params = {})
+    options = params.merge({ basic_auth: @auth })
+    self.class.get("/v1/template", options)
+  end
+end

data/lib/htmlcsstoimage/version.rb

@@ -0,0 +1,3 @@
+class HTMLCSSToImage
+  VERSION = "0.1.0"
+end

metadata

@@ -0,0 +1,176 @@
+--- !ruby/object:Gem::Specification
+name: htmlcsstoimage-api
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Mike Coutermarsh
+- Jeffrey Needles
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2020-08-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !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.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry-byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Generate images using HTML/CSS and Ruby.
+email:
+- support@htmlcsstoimage.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".ruby-version"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- cassettes/HTMLCSSToImage/_create_image/accepts_additional_params.yml
+- cassettes/HTMLCSSToImage/_create_image/creates_an_image.yml
+- cassettes/HTMLCSSToImage/_delete_image/deletes_an_image.yml
+- cassettes/HTMLCSSToImage/_templates/retrieves_templates.yml
+- cassettes/HTMLCSSToImage/_url_to_image/accepts_additional_params.yml
+- cassettes/HTMLCSSToImage/_url_to_image/creates_an_image_from_a_url.yml
+- htmlcsstoimage.gemspec
+- lib/htmlcsstoimage.rb
+- lib/htmlcsstoimage/version.rb
+homepage: https://docs.htmlcsstoimage.com/example-code/ruby
+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: []
+rubygems_version: 3.0.3
+signing_key: 
+specification_version: 4
+summary: Ruby wrapper for the HTML/CSS to Image API.
+test_files: []