flyyer 2.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: ef1404087856253e14da6d226113d736d21cd5abb60cd8f52dfeb11f483bc8e1
+  data.tar.gz: 830b066c275d67436ef02dc16ea5f4deb75cefa2ce1a710d18963918947dcdc9
+SHA512:
+  metadata.gz: e5a9a5f581151cf0f7c5dde17a7bec9c24be0efe260bcf4632583aec215857a019a39fd4e245406e8490cb7709fa3630171bd44062ea98af9be7120dccc1ce2b
+  data.tar.gz: 8d258f240f0a74a37d7a0c06f2eeeda1fe165c4fb2b71b4d6f908f7c65e4aedb77c6b77b8ba8ca24b49183d244ade6482a76f91b0026360cd6719e11b29371ec

data/.github/workflows/ruby.yml

@@ -0,0 +1,36 @@
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+# This workflow will download a prebuilt Ruby version, install dependencies and run tests with Rake
+# For more information see: https://github.com/marketplace/actions/setup-ruby-jruby-and-truffleruby
+
+name: Ruby
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  test:
+
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-18.04, macos-latest]
+        ruby: [2.5, 2.6, 2.7]
+    runs-on: ${{ matrix.os }}
+
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: ${{ matrix.ruby }}
+        bundler-cache: true # runs 'bundle install' and caches installed gems automatically
+    - name: Install dependencies
+      run: bundle install
+    - name: Run tests
+      run: bundle exec rake spec

data/.gitignore

@@ -0,0 +1,147 @@
+# Custom
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status
+
+# Created by https://www.toptal.com/developers/gitignore/api/ruby,osx,windows,linux
+# Edit at https://www.toptal.com/developers/gitignore?templates=ruby,osx,windows,linux
+
+### Linux ###
+*~
+
+# temporary files which can be created if a process still has a handle open of a deleted file
+.fuse_hidden*
+
+# KDE directory preferences
+.directory
+
+# Linux trash folder which might appear on any partition or disk
+.Trash-*
+
+# .nfs files are created when an open file is removed but is still being accessed
+.nfs*
+
+### OSX ###
+# General
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# Icon must end with two \r
+Icon
+
+# Thumbnails
+._*
+
+# Files that might appear in the root of a volume
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+
+# Directories potentially created on remote AFP share
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+
+### Ruby ###
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+# Used by dotenv library to load environment variables.
+# .env
+
+# Ignore Byebug command history file.
+.byebug_history
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+*.bridgesupport
+build-iPhoneOS/
+build-iPhoneSimulator/
+
+## Specific to RubyMotion (use of CocoaPods):
+#
+# We recommend against adding the Pods directory to your .gitignore. However
+# you should judge for yourself, the pros and cons are mentioned at:
+# https://guides.cocoapods.org/using/using-cocoapods.html#should-i-check-the-pods-directory-into-source-control
+# vendor/Pods/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalization:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+
+# Used by RuboCop. Remote config files pulled in from inherit_from directive.
+# .rubocop-https?--*
+
+### Ruby Patch ###
+# Used by RuboCop. Remote config files pulled in from inherit_from directive.
+# .rubocop-https?--*
+
+### Windows ###
+# Windows thumbnail cache files
+Thumbs.db
+Thumbs.db:encryptable
+ehthumbs.db
+ehthumbs_vista.db
+
+# Dump file
+*.stackdump
+
+# Folder config file
+[Dd]esktop.ini
+
+# Recycle Bin used on file shares
+$RECYCLE.BIN/
+
+# Windows Installer files
+*.cab
+*.msi
+*.msix
+*.msm
+*.msp
+
+# Windows shortcuts
+*.lnk
+
+# End of https://www.toptal.com/developers/gitignore/api/ruby,osx,windows,linux

data/.rspec

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

data/.travis.yml

@@ -0,0 +1,6 @@
+---
+language: ruby
+cache: bundler
+rvm:
+  - 2.5.7
+before_install: gem install bundler -v 2.1.4

data/Gemfile

@@ -0,0 +1,10 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in flyyer.gemspec
+gemspec
+
+gem 'rake', '~> 12.0'
+group :test do
+  gem 'rspec', '~> 3.0'
+end
+gem 'jwt'

data/Gemfile.lock

@@ -0,0 +1,36 @@
+PATH
+  remote: .
+  specs:
+    flyyer (2.0.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    diff-lcs (1.4.4)
+    jwt (2.2.2)
+    rake (12.3.3)
+    rspec (3.10.0)
+      rspec-core (~> 3.10.0)
+      rspec-expectations (~> 3.10.0)
+      rspec-mocks (~> 3.10.0)
+    rspec-core (3.10.0)
+      rspec-support (~> 3.10.0)
+    rspec-expectations (3.10.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-mocks (3.10.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.10.0)
+    rspec-support (3.10.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  flyyer!
+  jwt
+  rake (~> 12.0)
+  rspec (~> 3.0)
+
+BUNDLED WITH
+   2.1.4

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2021 Flyyer
+
+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,204 @@
+# flyyer-ruby
+
+The AI-powered preview system built from your website (no effort required).
+
+![Flyyer live image](https://github.com/useflyyer/create-flyyer-app/blob/master/.github/assets/website-to-preview.png?raw=true&v=1)
+
+**This gem is agnostic to any Ruby framework.**
+
+## Index
+
+- [Get started (5 minutes)](#get-started-5-minutes)
+- [Advanced usage](#advanced-usage)
+- [Flyyer Render](#flyyer-render)
+- [Development](#development)
+- [Test](#test)
+
+## Get started (5 minutes)
+
+Haven't registered your website yet? Go to [Flyyer.io](https://flyyer.io?ref=flyyer-ruby) and create a project (e.g. `website-com`).
+
+### 1. Install the library
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'flyyer'
+```
+
+And then execute:
+
+```sh
+bundle install
+```
+
+Or install it yourself as:
+
+```sh
+gem install flyyer
+```
+
+### 2. Get your Flyyer.io smart image link
+
+In your website code (e.g. your landing or product/post view file), set the following:
+
+```ruby
+flyyer = Flyyer::Flyyer.create do |f|
+  # Your project slug
+  f.project = 'website-com'
+  # The current path of your website
+  f.path = '/path/to/product' # In Ruby on Rails you can use `request.env['PATH_INFO']`
+end
+
+# Check:
+puts flyyer.href
+# > https://cdn.flyyer.io/v2/website-com/_/__v=1618281823/path/to/product
+```
+
+### 3. Put your smart image link in your `<head>` tags
+
+You'll get the best results like this:
+
+```ruby
+# .haml
+%meta{ property: 'og:image', content: flyyer.href }
+%meta{ name: 'twitter:image', content: flyyer.href }
+%meta{ name: 'twitter:card', content: 'summary_large_image' }
+
+# .erb
+<meta property="og:image" content='<%= flyyer.href %>'>
+<meta name="twitter:image" content='<%= flyyer.href %>'>
+<meta name="twitter:card" content="summary_large_image">
+
+# IMPORTANT: if you're using Ruby on Rails, please use `flyyer.href.html_safe` to prevent double serialization
+```
+
+### 4. Create a `rule` for your project
+
+Login at [Flyyer.io](https://flyyer.io?ref=flyyer-ruby) > Go to your Dashboard > Manage rules and create a rule like the following:
+
+[![Flyyer basic rule example](https://github.com/useflyyer/create-flyyer-app/blob/master/.github/assets/rule-example.png?raw=true&v=1)](https://flyyer.io/dashboard)
+
+Voilà!
+
+## Advanced usage
+
+Advanced features include:
+
+- Custom variables: additional information for your preview that is not present in your website. [Note: if you need customization you should take a look at [Flyyer Render](#flyyer-render)]
+- Custom metadata: set custom width, height, resolution, and more (see example).
+- Signed URLs.
+
+Here you have a detailed full example for project `website-com` and path `/path/to/product`.
+
+```ruby
+flyyer = Flyyer::Flyyer.create do |f|
+  # [Required] Your project slug, find it in your dashboard https://flyyer.io/dashboard/.
+  f.project = 'website-com'
+  # [Recommended] The current path of your website (by default it's `/`).
+  f.path = '/path/to/product'
+  # [Optional] In case you want to provide information that is not present in your page set it here.
+  f.variables = {
+    'title': 'Product name',
+    'img': 'https://flyyer.io/img/marketplace/flyyer-banner.png',
+  }
+  # [Optional] Custom metadata for rendering the image. ID is recommended so we provide you with better statistics.
+  f.meta = {
+    'id': 'jeans-123', # recommended for better stats
+    'v': '12369420123', # specific handler version, by default it's a random number to circumvent platforms' cache,
+    'width': 1200,
+    'height': 600,
+    'resolution': 0.9, # from 0.0 to 1.0
+    'agent': 'whatsapp', # force dimensions for specific platform
+  }
+end
+
+# Use this image in your <head/> tags (og:image & twitter:image)
+puts flyyer.href
+# > https://cdn.flyyer.io/v2/website-com/_/__id=jeans-123&__v=1618281823&img=https%3A%2F%2Fflyyer.io%2Fimg%2Fmarketplace%2Fflyyer-banner.png&title=Product+name/path/to/product
+
+# IMPORTANT: if you're using Ruby on Rails, please use `flyyer.href.html_safe` to prevent double serialization
+```
+
+For signed URLs, just provide your secret (find it in Dashboard > Project > Advanced settings) and choose a strategy (`HMAC` or `JWT`).
+
+```ruby
+flyyer = Flyyer::Flyyer.create do |f|
+  f.project = 'website-com'
+  f.path = '/path/to/product'
+  f.secret = 'your-secret-key'
+  f.strategy = 'JWT' # or 'HMAC'
+end
+
+url = flyyer.href
+# > https://cdn.flyyer.io/v2/website-com/jwt-eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJwYXJhbXMiOnsiX19pZCI6ImplYW5zLTEyMyJ9LCJwYXRoIjoiXC9wYXRoXC90b1wvcHJvZHVjdCJ9.X8Vs5SGEA1-3M6bH-h24jhQnbwH95V_G0f-gPhTBTzE?__v=1618283086
+
+# IMPORTANT: if you're using Ruby on Rails, please prevent double serialization like the following:
+url = flyyer.href.html_safe
+```
+
+## Flyyer Render
+
+As you probably realized, **Flyyer** uses the [rules defined on your dashboard](https://flyyer.io/dashboard/_/projects) to decide how to handle every image based on path patterns. It analyses your website to obtain information and then render a content-rich image with no effort. Let's say _"Flyyer delivers images based on the content of this route"_.
+
+**Flyyer Render** instead requires you to explicitly declare template and variables for the images to render, **giving you more control for customization**. Let's say _"FlyyerRender delivers an image using this template and these explicit variables"_.
+
+```ruby
+require 'flyyer'
+
+flyyer = Flyyer::FlyyerRender.create do |f|
+  f.tenant = 'tenant'
+  f.deck = 'deck'
+  f.template = 'template'
+  f.variables = {
+      title: 'Hello world!'
+  }
+end
+
+# Use this image in your <head/> tags
+url = flyyer.href
+# > https://cdn.flyyer.io/render/v2/tenant/deck/template.jpeg?__v=1596906866&title=Hello+world%21
+
+# IMPORTANT: if you're using Ruby on Rails, please prevent double serialization like the following:
+url = flyyer.href.html_safe
+```
+
+Variables can be complex arrays and hashes.
+
+```ruby
+flyyer = Flyyer::FlyyerRender.create do |f|
+  # ...
+  f.variables = {
+      items: [
+          { text: 'Oranges', count: 12 },
+          { text: 'Apples', count: 14 },
+      ],
+  }
+  f.meta = {
+    id: 'slug-or-id', # To identify the resource in our analytics report
+  }
+end
+```
+
+**IMPORTANT: variables must be serializable.**
+
+To decode the URL for debugging purposes:
+
+```ruby
+print(CGI.unescape(url))
+# > https://cdn.flyyer.io/render/v2/tenant/deck/template.jpeg?title=Hello+world!&__v=123
+```
+
+## 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).
+
+## Test
+
+Run Rake tests with:
+
+```sh
+rake spec
+```

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 "flyyer"
+
+# 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/flyyer.gemspec

@@ -0,0 +1,31 @@
+require_relative 'lib/flyyer/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'flyyer'
+  spec.version       = Flyyer::VERSION
+  spec.authors       = ['Patricio López Juri', 'Franco Méndez Z']
+  spec.email         = ['patricio@flyyer.io', 'franco@flyyer.io']
+
+  spec.summary       = 'FLYYER.io helper classes and methods'
+  # spec.summary       = %q{TODO: Write a short summary, because RubyGems requires one.}
+  spec.description   = 'FLYYER.io helper classes and methods'
+  # spec.description   = %q{TODO: Write a longer description or delete this line.}
+  spec.homepage      = 'https://github.com/useflyyer/flyyer-ruby'
+  spec.license       = 'MIT'
+  spec.required_ruby_version = Gem::Requirement.new('>= 2.3.0')
+
+  # spec.metadata['allowed_push_host'] = 'TODO: Set to 'http://mygemserver.com''
+
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = 'https://github.com/useflyyer/flyyer-ruby'
+  spec.metadata['changelog_uri'] = 'https://github.com/useflyyer/flyyer-ruby'
+
+  # 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']
+end

data/lib/flyyer.rb

@@ -0,0 +1,171 @@
+require 'flyyer/version'
+require 'uri'
+require 'openssl'
+require 'jwt'
+
+module Flyyer
+  class Error < StandardError; end
+
+  class Flyyer
+    attr_accessor :project, :path, :variables, :meta, :secret, :strategy
+
+    def self.create(&block)
+      self.new(&block)
+    end
+
+    def initialize(project = nil, path = nil, variables = {}, meta = {}, secret = nil, strategy = nil)
+      @project = project
+      @path = path || "/"
+      @variables = variables
+      @meta = meta
+      @secret = secret
+      @strategy = strategy
+      yield(self) if block_given?
+    end
+
+    def path_safe
+      @path.start_with?("/") ? @path : "/#{@path}"
+    end
+
+    def params_hash(ignoreV)
+      defaults = {
+        __v: @meta[:v] || Time.now.to_i, # This forces crawlers to refresh the image
+        __id: @meta[:id] || nil,
+        _w: @meta[:width] || nil,
+        _h: @meta[:height] || nil,
+        _res: @meta[:resolution] || nil,
+        _ua: @meta[:agent] || nil
+      }
+      defaults.delete(:__v) if ignoreV
+      @variables.nil? ? defaults : defaults.merge(@variables)
+    end
+
+    def querystring(ignoreV = false)
+      # Allow accesing the keys of @meta with symbols and strings
+      # https://stackoverflow.com/a/10786575
+      @meta.default_proc = proc do |h, k|
+        case k
+        when String then sym = k.to_sym; h[sym] if h.key?(sym)
+        when Symbol then str = k.to_s; h[str] if h.key?(str)
+        end
+      end
+
+      defaults = self.params_hash(ignoreV)
+      result = FlyyerHash.new(defaults)
+      result.to_query.split("&").sort().join("&")
+    end
+
+    def sign
+      return '_' if @strategy.nil? and @secret.nil?
+      raise Error.new('Got `strategy` but missing `secret`. You can find it in your project in Advanced settings.') if @secret.nil?
+      raise Error.new('Got `secret` but missing `strategy`.  Valid options are `HMAC` or `JWT`.') if @strategy.nil?
+      key = @secret
+      data = "#{@project}#{self.path_safe}#{self.querystring(true)}"
+      if strategy.downcase == "hmac" then
+        mac = OpenSSL::HMAC.hexdigest('SHA256', key, data)
+        mac[0..15]
+      elsif strategy.downcase == "jwt"
+        payload = { "params": self.params_hash(true).compact, "path": self.path_safe}
+        JWT.encode(payload, key, 'HS256')
+      else
+        raise Error.new('Invalid `strategy`. Valid options are `HMAC` or `JWT`.')
+      end
+    end
+
+    # Create a https://FLAYYER.com string.
+    # If you are on Ruby on Rails please use .html_safe when rendering this string into the HTML
+    def href
+      raise Error.new('Missing "project" property') if @project.nil?
+
+      signature = self.sign
+      params = self.querystring
+      if strategy.nil? || strategy != "JWT" then
+        "https://cdn.flyyer.io/v2/#{@project}/#{signature}/#{params}#{self.path_safe}"
+      else
+        "https://cdn.flyyer.io/v2/#{@project}/jwt-#{signature}?__v=#{@meta[:v] || Time.now.to_i}"
+      end
+    end
+  end
+
+  class FlyyerRender
+    attr_accessor :version, :tenant, :deck, :template, :extension, :variables, :meta
+
+    def self.create(&block)
+      self.new(&block)
+    end
+
+    def initialize(tenant = nil, deck = nil, template = nil, version = nil, extension = 'jpeg', variables = {}, meta = {})
+      @tenant = tenant
+      @deck = deck
+      @template = template
+      @version = version
+      @extension = extension
+      @variables = variables
+      @meta = meta
+      yield(self) if block_given?
+    end
+
+    def querystring
+      # Allow accesing the keys of @meta with symbols and strings
+      # https://stackoverflow.com/a/10786575
+      @meta.default_proc = proc do |h, k|
+        case k
+          when String then sym = k.to_sym; h[sym] if h.key?(sym)
+          when Symbol then str = k.to_s; h[str] if h.key?(str)
+        end
+      end
+
+      defaults = {
+        __v: @meta[:v].nil? ? Time.now.to_i : @meta[:v], # This forces crawlers to refresh the image
+        __id: @meta[:id] || nil,
+        _w: @meta[:width] || nil,
+        _h: @meta[:height] || nil,
+        _res: @meta[:resolution] || nil,
+        _ua: @meta[:agent] || nil
+      }
+      result = FlyyerHash.new(@variables.nil? ? defaults : defaults.merge(@variables))
+      result.to_query
+    end
+
+    # Create a https://flyyer.io string.
+    # If you are on Ruby on Rails please use .html_safe when rendering this string into the HTML
+    def href
+      raise Error.new('Missing "tenant" property') if @tenant.nil?
+      raise Error.new('Missing "deck" property') if @deck.nil?
+      raise Error.new('Missing "template" property') if @template.nil?
+
+      if @version.nil?
+        "https://cdn.flyyer.io/render/v2/#{@tenant}/#{@deck}/#{@template}.#{@extension}?#{self.querystring}"
+      else
+        "https://cdn.flyyer.io/render/v2/#{@tenant}/#{@deck}/#{@template}.#{@version}.#{@extension}?#{self.querystring}"
+      end
+    end
+  end
+
+  # A compatible qs stringify/parse (https://github.com/ljharb/qs)
+  class FlyyerHash
+    @hash = {}
+    def initialize(hash)
+      @hash = hash
+    end
+
+    def to_query_hash(key)
+      @hash.reduce({}) do |h, (k, v)|
+        new_key = key.nil? ? k : "#{key}[#{k}]"
+        v = Hash[v.each_with_index.to_a.map(&:reverse)] if v.is_a?(Array)
+        if v.is_a?(Hash)
+          h.merge!(FlyyerHash.new(v).to_query_hash(new_key))
+        elsif v.nil?
+          # skip null values
+        else
+          h[new_key] = v
+        end
+        h
+      end
+    end
+
+    def to_query(key = nil)
+      URI.encode_www_form(self.to_query_hash(key))
+    end
+  end
+end

data/lib/flyyer/version.rb

@@ -0,0 +1,3 @@
+module Flyyer
+  VERSION = '2.0.0'
+end

metadata

@@ -0,0 +1,62 @@
+--- !ruby/object:Gem::Specification
+name: flyyer
+version: !ruby/object:Gem::Version
+  version: 2.0.0
+platform: ruby
+authors:
+- Patricio López Juri
+- Franco Méndez Z
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2021-07-11 00:00:00.000000000 Z
+dependencies: []
+description: FLYYER.io helper classes and methods
+email:
+- patricio@flyyer.io
+- franco@flyyer.io
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/ruby.yml"
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- flyyer.gemspec
+- lib/flyyer.rb
+- lib/flyyer/version.rb
+homepage: https://github.com/useflyyer/flyyer-ruby
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/useflyyer/flyyer-ruby
+  source_code_uri: https://github.com/useflyyer/flyyer-ruby
+  changelog_uri: https://github.com/useflyyer/flyyer-ruby
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.6
+signing_key:
+specification_version: 4
+summary: FLYYER.io helper classes and methods
+test_files: []