article_json 0.3.2 → 0.3.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 0f9222cb3d5c6c6c17776ac0c2ac71a1201367c6
-  data.tar.gz: 0f474e416aed216896f2d2dbb5230670c73efc44
+SHA256:
+  metadata.gz: baf39dbf5fb3f225088927c3ea9f7d58a59a502c6c70da1546829d857760ee6a
+  data.tar.gz: f9c60e3a2e8aadffda6525eb9acd085ee5ffcc53697cc7fec4a3c204209a571e
 SHA512:
-  metadata.gz: ebf75ee9a5d5e5c23a348efaa550c0f96dc29ad97d96e2d4792737d27c6816b0abbb1fa4945bbf1297493b4c2f30ff1aa465663d0be197b274378707c2bf3a49
-  data.tar.gz: 3ce371166ea56f2e474abfafd0d1d03ce040fc21f00c73d506166031d82825859459c83ce075ea60a10009ce079da284e64e8a1e603c5aa10155eca5a0061418
+  metadata.gz: 28783003b3b27d4eca2e5141dd59967f0f2ee44f077726bd5935a8e9dfa49fbd482cac67d49f2bc69e66797cb6dff7c67093124887215423117df6bbed8c5840
+  data.tar.gz: 0ee51b7975ed3621a99abe34a4d2180c327e3a1a678539aa58ed40171d8bf0cf812c0b1478c49886418fb410eb8634ac3b20c8a00ed881da2edeb5f5e7bc469f

data/CHANGELOG.md

@@ -1,4 +1,27 @@
 # Changelog
+## 0.3.8 - 2020/7/31
+- **Improvements:**
+- Add a script to update oembed stubs fixtures.
+- Support for `alt` attribute in images.
+
+- **Fix:** Fix a bug when using the `[image-link-to: ]` tag.
+
+## 0.3.7 - 2019/8/21
+- **Fix:** Only use https for soundcloud oembed api
+
+## 0.3.6 - 2019/8/6
+- **Improvement** Add tags support in text_box element.
+
+## 0.3.5 - 2018/12/12
+- **Improvements** to import and export image links from Google Docs
+- Import image `href` from caption text using a custom tag
+- Export the image element href attribute as a link
+
+## 0.3.4 - 2018/5/10
+- **Fix:** Only include slug from the soundcloud URL in google doc parser
+
+## 0.3.3 - 2018/4/12
+- Support embedding SoundCloud
 
 ## 0.3.2 - 2017/12/06
 - Another **fix** to prevent `nil` elements when placing additional elements on articles that end with empty paragraphs
@@ -43,7 +66,7 @@ One potentially **breaking change** was added:
 
 ## 0.1.0 - 2017/09/20
 This is the very first release, with the following functionality:
-- article-json format that supports several basic elements; like headings, 
+- article-json format that supports several basic elements; like headings,
   paragraphs, images or lists
 - Resolving of embedded elements like videos or tweets via OEmbed standard
 - Conversion from and to JSON (or ruby hashes)

data/README.md

@@ -53,6 +53,21 @@ $ ./bin/article_json_export_google_doc.rb $DOC_ID \
     | ./bin/article_json_export_html.rb
 ```
 
+You can also update all the different exported versions of the reference
+document (html, json, amp, facebook instant article and plain txt) by
+running the following command:
+
+```
+$ ./bin/update_reference_document.sh
+```
+
+When running the tests, we use some fixtures to mock the responses for oembed
+request, but these may change over time. To update them, run:
+
+```
+$ ./bin/update_oembed_request-stubs.sh
+```
+
 ### Configuration
 There are some configuration options that allow a more tailored usage of the
 `article_json` gem. The following code snippet gives an example for every

data/bin/article_json_export_amp.rb

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+#
+# Simple script to read a JSON document and export it to AMP.
+#
+# Usage:
+#
+#   ./bin/article_json_export_amp.rb < my_document.json
+#
+# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+
+require_relative '../lib/article_json'
+puts ArticleJSON::Article.from_json(ARGF.read).to_amp

data/bin/article_json_export_facebook.rb

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+
+# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+#
+# Simple script to read a JSON document and export it to Facebook Instant
+# Article.
+#
+# Usage:
+#
+#   ./bin/article_json_export_facebook.rb < my_document.json
+#
+# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+
+require_relative '../lib/article_json'
+puts ArticleJSON::Article.from_json(ARGF.read).to_facebook_instant_article

data/bin/article_json_export_plain_text.rb

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+#
+# Simple script to read a JSON document and export it to plain text.
+#
+# Usage:
+#
+#   ./bin/article_json_export_plain_text.rb < my_document.json
+#
+# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
+
+require_relative '../lib/article_json'
+puts ArticleJSON::Article.from_json(ARGF.read).to_plain_text

data/bin/update_oembed_request-stubs.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env sh
+
+curl -X GET "https://vimeo.com/api/oembed.json?url=https://vimeo.com/42315417" | jq > spec/fixtures/vimeo_video_oembed.json
+
+curl -X GET "http://www.youtube.com/oembed?format=json&url=https://www.youtube.com/watch?v=_ZG8HBuDjgc" | jq > spec/fixtures/youtube_video_oembed.json
+
+curl -X GET "https://www.slideshare.net/api/oembed/2?format=json&url=https://www.slideshare.net/Devex/the-best-global-development-quotes-of-2012" |  jq > spec/fixtures/slideshare_oembed.json
+
+curl -X GET "https://api.twitter.com/1/statuses/oembed.json?align=center&url=https://twitter.com/d3v3x/status/554608639030599681" | jq > spec/fixtures/tweet_oembed.json
+
+curl -X GET 'https://soundcloud.com/oembed?format=json&url=https://soundcloud.com/rich-the-kid/plug-walk-1' | jq > spec/fixtures/soundcloud_oembed.json
+
+curl -X GET  'https://www.facebook.com/plugins/video/oembed.json?url=https://www.facebook.com/facebook/videos/1814600831891266'  | jq > spec/fixtures/facebook_video_oembed.json

data/bin/update_reference_document.sh

@@ -7,6 +7,9 @@ DOC_ID="1E4lncZE2jDkbE34eDyYQmXKA9O26BHUiwguz4S9qyE8"
 SOURCE_HTML_FILE="spec/fixtures/reference_document.html"
 JSON_FILE="spec/fixtures/reference_document_parsed.json"
 HTML_EXPORT_FILE="spec/fixtures/reference_document_exported.html"
+AMP_EXPORT_FILE="spec/fixtures/reference_document_exported.amp.html"
+FACEBOOK_EXPORT_FILE="spec/fixtures/reference_document_exported.facebook.html"
+PLAIN_TEXT_EXPORT_FILE="spec/fixtures/reference_document_exported.txt"
 
 # export the google doc to HTML
 ./bin/article_json_export_google_doc.rb ${DOC_ID} > ${SOURCE_HTML_FILE}
@@ -16,3 +19,12 @@ HTML_EXPORT_FILE="spec/fixtures/reference_document_exported.html"
 
 # convert the JSON export to HTML
 ./bin/article_json_export_html.rb < ${JSON_FILE} > ${HTML_EXPORT_FILE}
+
+# convert the JSON export to AMP
+./bin/article_json_export_amp.rb < ${JSON_FILE} > ${AMP_EXPORT_FILE}
+
+# convert the JSON export to Facebook Instant Article
+./bin/article_json_export_facebook.rb < ${JSON_FILE} > ${FACEBOOK_EXPORT_FILE}
+
+# convert the JSON export to plain text
+./bin/article_json_export_plain_text.rb < ${JSON_FILE} > ${PLAIN_TEXT_EXPORT_FILE}

data/lib/article_json.rb

@@ -37,6 +37,7 @@ require_relative 'article_json/import/google_doc/html/embedded_vimeo_video_parse
 require_relative 'article_json/import/google_doc/html/embedded_youtube_video_parser'
 require_relative 'article_json/import/google_doc/html/embedded_slideshare_parser'
 require_relative 'article_json/import/google_doc/html/embedded_tweet_parser'
+require_relative 'article_json/import/google_doc/html/embedded_soundcloud_parser'
 require_relative 'article_json/import/google_doc/html/parser'
 
 require_relative 'article_json/export/common/elements/base'

data/lib/article_json/elements/image.rb

@@ -1,16 +1,20 @@
 module ArticleJSON
   module Elements
     class Image < Base
-      attr_reader :source_url, :caption, :float
+      attr_reader :source_url, :caption, :float, :href, :alt
 
       # @param [String] source_url
       # @param [Array[ArticleJSON::Elements::Text]] caption
       # @param [Symbol] float
-      def initialize(source_url:, caption:, float: nil)
+      # @param [String] href
+      # @param [String] alt
+      def initialize(source_url:, caption:, float: nil, href: nil, alt: nil)
         @type = :image
         @source_url = source_url
         @caption = caption
         @float = float
+        @href = href
+        @alt = alt
       end
 
       # Hash representation of this image element
@@ -21,6 +25,8 @@ module ArticleJSON
           source_url: source_url,
           float: float,
           caption: caption.map(&:to_h),
+          href: href,
+          alt: alt,
         }
       end
 
@@ -31,7 +37,9 @@ module ArticleJSON
           new(
             source_url: hash[:source_url],
             caption: parse_hash_list(hash[:caption]),
-            float: hash[:float]&.to_sym
+            float: hash[:float]&.to_sym,
+            href: hash[:href],
+            alt: hash[:alt]
           )
         end
       end

data/lib/article_json/elements/text_box.rb

@@ -1,14 +1,16 @@
 module ArticleJSON
   module Elements
     class TextBox < Base
-      attr_reader :content, :float
+      attr_reader :content, :float, :tags
 
       # @param [Array[Paragraph|Heading|List]] content
       # @param [Symbol] float
-      def initialize(content:, float: nil)
+      # @param [Array] tags
+      def initialize(content:, float: nil, tags: [])
         @type = :text_box
         @content = content
         @float = float
+        @tags = tags
       end
 
       # Hash representation of this text box element
@@ -18,6 +20,7 @@ module ArticleJSON
           type: type,
           float: float,
           content: content.map(&:to_h),
+          tags: tags,
         }
       end
 
@@ -27,7 +30,8 @@ module ArticleJSON
         def parse_hash(hash)
           new(
             content: parse_hash_list(hash[:content]),
-            float: hash[:float]&.to_sym
+            float: hash[:float]&.to_sym,
+            tags: hash[:tags]
           )
         end
       end

data/lib/article_json/export/amp/custom_element_library_resolver.rb

@@ -26,8 +26,8 @@ module ArticleJSON
         def script_tags
           sources.map do |custom_element_tag, src|
             <<-HTML.gsub(/\s+/, ' ').strip
-                <script async 
-                        custom-element="#{custom_element_tag}" 
+                <script async
+                        custom-element="#{custom_element_tag}"
                         src="#{src}"></script>
             HTML
           end
@@ -46,6 +46,8 @@ module ArticleJSON
             'amp-vimeo': 'https://cdn.ampproject.org/v0/amp-vimeo-0.1.js',
             'amp-facebook':
               'https://cdn.ampproject.org/v0/amp-facebook-0.1.js',
+            'amp-soundcloud':
+              'https://cdn.ampproject.org/v0/amp-soundcloud-0.1.js',
           }[custom_element_tag]
         end
       end

data/lib/article_json/export/amp/elements/embed.rb

@@ -14,6 +14,7 @@ module ArticleJSON
             when :facebook_video then %i(amp-facebook)
             when :tweet then %i(amp-twitter)
             when :slideshare then %i(amp-iframe)
+            when :soundcloud then %i(amp-soundcloud)
             else []
             end
           end
@@ -33,7 +34,9 @@ module ArticleJSON
             when :tweet
               tweet_node
             when :slideshare
-              slideshare_node
+              iframe_node
+            when :soundcloud
+              soundcloud_node
             end
           end
 
@@ -74,8 +77,20 @@ module ArticleJSON
                            height: default_height)
           end
 
+          def soundcloud_node
+            src = Nokogiri::HTML(@element.oembed_data[:html])
+              .xpath('//iframe/@src').first.value
+            track_id = src.match(/tracks%2F(\d+)/)[1]
+            create_element('amp-soundcloud',
+                           layout: 'fixed-height',
+                           'data-trackid': track_id,
+                           'data-visual': true,
+                           width: 'auto',
+                           height: default_height)
+          end
+
           # @return [Nokogiri::XML::Element]
-          def slideshare_node
+          def iframe_node
             node = Nokogiri::HTML(@element.oembed_data[:html]).xpath('//iframe')
             create_element('amp-iframe',
                            src: node.attribute('src').value,

data/lib/article_json/export/common/html/elements/image.rb

@@ -7,22 +7,36 @@ module ArticleJSON
             include ArticleJSON::Export::Common::HTML::Elements::Shared::Caption
             include ArticleJSON::Export::Common::HTML::Elements::Shared::Float
 
-            # Generate the `<figure>` node containing the image and caption
+            # Generate the `<figure>` node containing the image and caption or
+            # an `<a>` node containing the `<figure>` node if href is present.
             # @return [Nokogiri::XML::Element]
             def export
+              figure_node
+            end
+
+            private
+
+            # @return [Nokogiri::XML::NodeSet]
+            def figure_node
               create_element(:figure, node_opts) do |figure|
-                figure.add_child(image_node)
+                node =  @element&.href ? href_node : image_node
+                figure.add_child(node)
                 if @element.caption&.any?
                   figure.add_child(caption_node(:figcaption))
                 end
               end
             end
 
-            private
-
             # @return [Nokogiri::XML::NodeSet]
             def image_node
-              create_element(:img, src: @element.source_url)
+              create_element(:img, src: @element.source_url, alt: @element.alt)
+            end
+
+            # @return [Nokogiri::XML::NodeSet]
+            def href_node
+              create_element(:a, href: @element.href) do |a|
+                a.add_child(image_node)
+              end
             end
 
             # @return [Hash]

data/lib/article_json/import/google_doc/html/embedded_parser.rb

@@ -94,6 +94,7 @@ module ArticleJSON
                 EmbeddedYoutubeVideoParser,
                 EmbeddedTweetParser,
                 EmbeddedSlideshareParser,
+                EmbeddedSoundcloudParser,
               ]
             end
 

data/lib/article_json/import/google_doc/html/embedded_soundcloud_parser.rb

@@ -0,0 +1,28 @@
+module ArticleJSON
+  module Import
+    module GoogleDoc
+      module HTML
+        class EmbeddedSoundcloudParser < EmbeddedParser
+          # The type of this embedded element
+          # @return [Symbol]
+          def embed_type
+            :soundcloud
+          end
+
+          class << self
+            # Regular expression to check if a given string is a Soundcloud URL
+            # Also used to extract the ID from the URL.
+            # @return [Regexp]
+            def url_regexp
+              %r{
+                ^\S*                    # all protocols & sub domains
+                soundcloud\.com/        # domain
+                (?<id>[-/0-9a-z]+)      # the slug of the user / track
+              }xi
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/article_json/import/google_doc/html/image_parser.rb

@@ -12,12 +12,19 @@ module ArticleJSON
           def initialize(node:, caption_node:, css_analyzer:)
             @node = node
             @caption_node = caption_node
+            @href = href
             @css_analyzer = css_analyzer
 
             # Main node indicates the floating behavior
             @float_node = @node
           end
 
+          # The value of the image's `alt` attribute
+          # @return [String]
+          def alt
+            image_node.attribute('alt')&.value || ''
+          end
+
           # The value of the image's `src` attribute
           # @return [String]
           def source_url
@@ -36,17 +43,43 @@ module ArticleJSON
             super if floatable_size?
           end
 
+          # Extracts an href from the tag [image-link-to: url]) if present
+          # in the caption node.
+          # @return [String]
+          def href
+            return if @caption_node.nil?
+            match = @caption_node.content.strip.match(href_regexp)
+            return if match.nil?
+            remove_image_link_tag
+            match[:url]
+          end
+
           # @return [ArticleJSON::Elements::Image]
           def element
             ArticleJSON::Elements::Image.new(
               source_url: source_url,
               float: float,
-              caption: caption
+              caption: caption,
+              href: @href,
+              alt: alt
             )
           end
 
           private
 
+          # Removes the [image-link-to: url] tag from the caption node
+          def remove_image_link_tag
+            @caption_node
+              .children
+              .first
+              .content = @caption_node.content.sub(href_regexp, '').strip
+          end
+
+          # Regular expression to check if there's a [image-link-to: url] tag
+          # @return [Regexp]
+          def href_regexp
+            %r{\[image-link-to:\s+(?<url>.*?)\]}
+          end
           # Check if the image's width can be determined and is less than 500px
           # This is about 3/4 of the google document width...
           # @return [Boolean]

data/lib/article_json/import/google_doc/html/node_analyzer.rb

@@ -17,6 +17,14 @@ module ArticleJSON
             node.inner_text.strip.downcase == text.strip.downcase
           end
 
+          # Check if the node text begins with a certain text
+          # @param [String]
+          # @return [Boolean]
+          def begins_with?(text)
+            first_word = node.inner_text.strip.downcase.split(' ').first
+            first_word == text.strip.downcase
+          end
+
           # Check if the node is empty, i.e. not containing any text
           # Given that images are the only nodes without text, we have to make
           # sure that it's not an image.
@@ -65,7 +73,7 @@ module ArticleJSON
           # @return [Boolean]
           def text_box?
             return @is_text_box if defined? @is_text_box
-            @is_text_box = has_text?('textbox:') || has_text?('highlight:')
+            @is_text_box = begins_with?('textbox:') || begins_with?('highlight:')
           end
 
           # Check if the node starts a quote

data/lib/article_json/import/google_doc/html/parser.rb

@@ -83,7 +83,11 @@ module ArticleJSON
           # @return [ArticleJSON::Elements::TextBox]
           def parse_text_box
             TextBoxParser
-              .new(nodes: nodes_until_hr, css_analyzer: @css_analyzer)
+              .new(
+                type_node: @current_node.node,
+                nodes: nodes_until_hr,
+                css_analyzer: @css_analyzer
+              )
               .element
           end
 

data/lib/article_json/import/google_doc/html/text_box_parser.rb

@@ -5,14 +5,18 @@ module ArticleJSON
         class TextBoxParser
           include Shared::Float
 
+          # @param [Nokogiri::HTML::Node] type_node Document node that states
+          #                                         that this is a textbox.
+          #                                         May contain tags, too.
           # @param [Array[Nokogiri::HTML::Node]] nodes
           # @param [ArticleJSON::Import::GoogleDoc::HTML::CSSAnalyzer] css_analyzer
-          def initialize(nodes:, css_analyzer:)
+          def initialize(type_node: ,nodes:, css_analyzer:)
             @nodes = nodes.reject { |node| NodeAnalyzer.new(node).empty? }
             @css_analyzer = css_analyzer
 
             # First node of the text box indicates floating behavior
             @float_node = @nodes.first
+            @type_node = type_node
           end
 
           # Parse the text box's nodes to get a list of sub elements
@@ -22,10 +26,23 @@ module ArticleJSON
             @nodes.map { |node| parse_sub_node(node) }.compact
           end
 
+          # Extract any potential tags, specified in brackets after the Textbox definition
+          # @return [Array[Symbol]]
+          def tags
+            match = /(.*?)[\s\u00A0]+\[(?<tags>.*)\]/
+                      .match(@type_node.inner_text)
+            return [] unless match
+            match[:tags].split(' ')
+          end
+
           # Hash representation of this text box
           # @return [ArticleJSON::Elements::TextBox]
           def element
-            ArticleJSON::Elements::TextBox.new(float: float, content: content)
+            ArticleJSON::Elements::TextBox.new(
+              float: float,
+              content: content,
+              tags: tags
+            )
           end
 
           private

data/lib/article_json/utils.rb

@@ -9,4 +9,5 @@ require_relative 'utils/o_embed_resolver/slideshare'
 require_relative 'utils/o_embed_resolver/tweet'
 require_relative 'utils/o_embed_resolver/vimeo_video'
 require_relative 'utils/o_embed_resolver/youtube_video'
+require_relative 'utils/o_embed_resolver/soundcloud'
 require_relative 'utils/additional_element_placer'

data/lib/article_json/utils/o_embed_resolver/base.rb

@@ -85,6 +85,7 @@ module ArticleJSON
               tweet: Tweet,
               vimeo_video: VimeoVideo,
               youtube_video: YoutubeVideo,
+              soundcloud: Soundcloud,
             }[type.to_sym]
           end
         end

data/lib/article_json/utils/o_embed_resolver/soundcloud.rb

@@ -0,0 +1,25 @@
+module ArticleJSON
+  module Utils
+    module OEmbedResolver
+      class Soundcloud < Base
+        # Human readable name of the resolver
+        # @return [String]
+        def name
+          'Soundcloud'
+        end
+
+        # The URL for the oembed API call
+        # @return [String]
+        def oembed_url
+          "https://soundcloud.com/oembed?url=#{source_url}&format=json"
+        end
+
+        # The URL of the element
+        # @return [String]
+        def source_url
+          "https://soundcloud.com/#{@element.embed_id}"
+        end
+      end
+    end
+  end
+end

data/lib/article_json/version.rb

@@ -1,3 +1,3 @@
 module ArticleJSON
-  VERSION = '0.3.2'
+  VERSION = '0.3.8'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: article_json
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.3.8
 platform: ruby
 authors:
 - Daniel Sager
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-12-07 00:00:00.000000000 Z
+date: 2020-07-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
@@ -111,9 +111,13 @@ files:
 - CODE_OF_CONDUCT.md
 - LICENSE
 - README.md
+- bin/article_json_export_amp.rb
+- bin/article_json_export_facebook.rb
 - bin/article_json_export_google_doc.rb
 - bin/article_json_export_html.rb
+- bin/article_json_export_plain_text.rb
 - bin/article_json_parse_google_doc.rb
+- bin/update_oembed_request-stubs.sh
 - bin/update_reference_document.sh
 - lib/article_json.rb
 - lib/article_json/article.rb
@@ -185,6 +189,7 @@ files:
 - lib/article_json/import/google_doc/html/embedded_facebook_video_parser.rb
 - lib/article_json/import/google_doc/html/embedded_parser.rb
 - lib/article_json/import/google_doc/html/embedded_slideshare_parser.rb
+- lib/article_json/import/google_doc/html/embedded_soundcloud_parser.rb
 - lib/article_json/import/google_doc/html/embedded_tweet_parser.rb
 - lib/article_json/import/google_doc/html/embedded_vimeo_video_parser.rb
 - lib/article_json/import/google_doc/html/embedded_youtube_video_parser.rb
@@ -204,6 +209,7 @@ files:
 - lib/article_json/utils/o_embed_resolver/base.rb
 - lib/article_json/utils/o_embed_resolver/facebook_video.rb
 - lib/article_json/utils/o_embed_resolver/slideshare.rb
+- lib/article_json/utils/o_embed_resolver/soundcloud.rb
 - lib/article_json/utils/o_embed_resolver/tweet.rb
 - lib/article_json/utils/o_embed_resolver/vimeo_video.rb
 - lib/article_json/utils/o_embed_resolver/youtube_video.rb
@@ -227,8 +233,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.12
+rubygems_version: 3.0.8
 signing_key: 
 specification_version: 4
 summary: JSON Format for News Articles & Ruby Gem