user_agent_parser 2.4.0 → 2.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 862bbfc92a30de199a32fd1dbebae607551298fa
-  data.tar.gz: 303212057c5fad5ce4279a21a966ec27bae860a1
+  metadata.gz: 11927dac3bd4e88a9a7be095093a664fd96b8111
+  data.tar.gz: 21b998a0a2f0016ad4e75b6e8678e855369dadee
 SHA512:
-  metadata.gz: 023e8a39eed689f3a0dbfb958ad90e0023fe4f469fae924248e7eda016930e1519428ebeb087e99f92777cbb7dbce1a468143ab3399a3bf6b0476384e055e448
-  data.tar.gz: 70978a580d745b38fe07af2e4580696b4fc6200018e522261bd19ec13b3748a6e5d0742002104eed17667e4f00e29625ae1ca902303893577b339c616fe94709
+  metadata.gz: 9e374cd5e96daca43ef27002052edb5e1101d35c77a1f18dda370b1c28702709a86a9a2b36d830162b9a068a5259ac2d3d2a1532ae2efaf294d4a955224bcfd6
+  data.tar.gz: 020cef494b4307e0921978e213c7c243cbb70c075f17a6f238e95a40dfd999d38c896abae12d17cf1afd834fea9f3be533d308f08e607127b07be1b82a1ed5b5

data/bin/user_agent_parser

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby
+# frozen_string_literal: true
 
 require 'optparse'
 

data/lib/user_agent_parser.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'user_agent_parser/parser'
 require 'user_agent_parser/user_agent'
 require 'user_agent_parser/version'
@@ -5,10 +7,10 @@ require 'user_agent_parser/operating_system'
 require 'user_agent_parser/device'
 
 module UserAgentParser
-  DefaultPatternsPath = File.join(File.dirname(__FILE__), "../vendor/uap-core/regexes.yaml")
+  DefaultPatternsPath = File.join(File.dirname(__FILE__), '../vendor/uap-core/regexes.yaml')
 
   # Parse the given +user_agent_string+, returning a +UserAgent+
-  def self.parse(user_agent_string, options={})
+  def self.parse(user_agent_string, options = {})
     Parser.new(options).parse(user_agent_string)
   end
 end

data/lib/user_agent_parser/cli.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module UserAgentParser
   class Cli
     def initialize(user_agent, options = {})
@@ -11,9 +13,7 @@ module UserAgentParser
       elsif @options[:name]
         @user_agent.name
       elsif @options[:version]
-        with_version do |version|
-          version.to_s
-        end
+        with_version(&:to_s)
       elsif @options[:major]
         major
       elsif @options[:minor]
@@ -21,13 +21,13 @@ module UserAgentParser
       elsif @options[:os]
         @user_agent.os.to_s
       elsif format = @options[:format]
-        format.
-          gsub('%f', @user_agent.family).
-          gsub('%n', @user_agent.name).
-          gsub('%v', version.to_s).
-          gsub('%M', major.to_s).
-          gsub('%m', minor.to_s).
-          gsub('%o', @user_agent.os.to_s)
+        format
+          .gsub('%f', @user_agent.family)
+          .gsub('%n', @user_agent.name)
+          .gsub('%v', version.to_s)
+          .gsub('%M', major.to_s)
+          .gsub('%m', minor.to_s)
+          .gsub('%o', @user_agent.os.to_s)
       else
         @user_agent.to_s
       end
@@ -36,15 +36,11 @@ module UserAgentParser
     private
 
     def major
-      with_version do |version|
-        version.major
-      end
+      with_version(&:major)
     end
 
     def minor
-      with_version do |version|
-        version.minor
-      end
+      with_version(&:minor)
     end
 
     def version

data/lib/user_agent_parser/device.rb

@@ -1,8 +1,10 @@
+# frozen_string_literal: true
+
 module UserAgentParser
   class Device
     attr_reader :family, :model, :brand
 
-    alias_method :name, :family
+    alias name family
 
     def initialize(family = nil, model = nil, brand = nil)
       @family = family || 'Other'
@@ -15,13 +17,13 @@ module UserAgentParser
     end
 
     def inspect
-      "#<#{self.class} #{to_s}>"
+      "#<#{self.class} #{self}>"
     end
 
     def eql?(other)
       self.class.eql?(other.class) && family == other.family
     end
 
-    alias_method :==, :eql?
+    alias == eql?
   end
 end

data/lib/user_agent_parser/operating_system.rb

@@ -1,8 +1,10 @@
+# frozen_string_literal: true
+
 module UserAgentParser
   class OperatingSystem
     attr_reader :family, :version
 
-    alias_method :name, :family
+    alias name family
 
     def initialize(family = 'Other', version = nil)
       @family = family
@@ -18,7 +20,7 @@ module UserAgentParser
     end
 
     def inspect
-      "#<#{self.class} #{to_s}>"
+      "#<#{self.class} #{self}>"
     end
 
     def eql?(other)
@@ -27,6 +29,6 @@ module UserAgentParser
         version == other.version
     end
 
-    alias_method :==, :eql?
+    alias == eql?
   end
 end

data/lib/user_agent_parser/parser.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'yaml'
 
 module UserAgentParser
@@ -5,7 +7,7 @@ module UserAgentParser
   class Parser
     attr_reader :patterns_path
 
-    def initialize(options={})
+    def initialize(options = {})
       @patterns_path = options[:patterns_path] || UserAgentParser::DefaultPatternsPath
       @ua_patterns, @os_patterns, @device_patterns = load_patterns(patterns_path)
     end
@@ -24,11 +26,11 @@ module UserAgentParser
       # Parse all the regexs
       yml.each_pair do |type, patterns|
         patterns.each do |pattern|
-          pattern["regex"] = Regexp.new(pattern["regex"], pattern["regex_flag"] == 'i')
+          pattern['regex'] = Regexp.new(pattern['regex'], pattern['regex_flag'] == 'i')
         end
       end
 
-      [ yml["user_agent_parsers"], yml["os_parsers"], yml["device_parsers"] ]
+      [yml['user_agent_parsers'], yml['os_parsers'], yml['device_parsers']]
     end
 
     def parse_ua(user_agent, os = nil, device = nil)
@@ -63,7 +65,7 @@ module UserAgentParser
 
     def first_pattern_match(patterns, value)
       patterns.each do |pattern|
-        if match = pattern["regex"].match(value)
+        if match = pattern['regex'].match(value)
           return [pattern, match]
         end
       end
@@ -73,24 +75,24 @@ module UserAgentParser
     def user_agent_from_pattern_match(pattern, match, os = nil, device = nil)
       family, v1, v2, v3, v4 = match[1], match[2], match[3], match[4], match[5]
 
-      if pattern["family_replacement"]
-        family = pattern["family_replacement"].sub('$1', family || '')
+      if pattern['family_replacement']
+        family = pattern['family_replacement'].sub('$1', family || '')
       end
 
-      if pattern["v1_replacement"]
-        v1 = pattern["v1_replacement"].sub('$2', v1 || '')
+      if pattern['v1_replacement']
+        v1 = pattern['v1_replacement'].sub('$2', v1 || '')
       end
 
-      if pattern["v2_replacement"]
-        v2 = pattern["v2_replacement"].sub('$3', v2 || '')
+      if pattern['v2_replacement']
+        v2 = pattern['v2_replacement'].sub('$3', v2 || '')
       end
 
-      if pattern["v3_replacement"]
-        v3 = pattern["v3_replacement"].sub('$4', v3 || '')
+      if pattern['v3_replacement']
+        v3 = pattern['v3_replacement'].sub('$4', v3 || '')
       end
 
-      if pattern["v4_replacement"]
-        v4 = pattern["v4_replacement"].sub('$5', v4 || '')
+      if pattern['v4_replacement']
+        v4 = pattern['v4_replacement'].sub('$5', v4 || '')
       end
 
       version = version_from_segments(v1, v2, v3, v4)
@@ -101,24 +103,24 @@ module UserAgentParser
     def os_from_pattern_match(pattern, match)
       os, v1, v2, v3, v4 = match[1], match[2], match[3], match[4], match[5]
 
-      if pattern["os_replacement"]
-        os = pattern["os_replacement"].sub('$1', os || '')
+      if pattern['os_replacement']
+        os = pattern['os_replacement'].sub('$1', os || '')
       end
 
-      if pattern["os_v1_replacement"]
-        v1 = pattern["os_v1_replacement"].sub('$2', v1 || '')
+      if pattern['os_v1_replacement']
+        v1 = pattern['os_v1_replacement'].sub('$2', v1 || '')
       end
 
-      if pattern["os_v2_replacement"]
-        v2 = pattern["os_v2_replacement"].sub('$3', v2 || '')
+      if pattern['os_v2_replacement']
+        v2 = pattern['os_v2_replacement'].sub('$3', v2 || '')
       end
 
-      if pattern["os_v3_replacement"]
-        v3 = pattern["os_v3_replacement"].sub('$4', v3 || '')
+      if pattern['os_v3_replacement']
+        v3 = pattern['os_v3_replacement'].sub('$4', v3 || '')
       end
 
-      if pattern["os_v4_replacement"]
-        v4 = pattern["os_v4_replacement"].sub('$5', v4 || '')
+      if pattern['os_v4_replacement']
+        v4 = pattern['os_v4_replacement'].sub('$5', v4 || '')
       end
 
       version = version_from_segments(v1, v2, v3, v4)
@@ -131,8 +133,8 @@ module UserAgentParser
       family = model = match[1]
       brand = nil
 
-      if pattern["device_replacement"]
-        family = pattern["device_replacement"]
+      if pattern['device_replacement']
+        family = pattern['device_replacement']
         match.each_with_index { |m,i| family = family.sub("$#{i}", m) }
       end
       if pattern["model_replacement"]

data/lib/user_agent_parser/user_agent.rb

@@ -1,8 +1,10 @@
+# frozen_string_literal: true
+
 module UserAgentParser
   class UserAgent
     attr_reader :family, :version, :os, :device
 
-    alias_method :name, :family
+    alias name family
 
     def initialize(family = nil, version = nil, os = nil, device = nil)
       @family = family || 'Other'
@@ -26,11 +28,11 @@ module UserAgentParser
 
     def eql?(other)
       self.class.eql?(other.class) &&
-      family == other.family &&
+        family == other.family &&
         version == other.version &&
         os == other.os
     end
 
-    alias_method :==, :eql?
+    alias == eql?
   end
 end

data/lib/user_agent_parser/version.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module UserAgentParser
   class Version
 
@@ -6,14 +8,14 @@ module UserAgentParser
     SEGMENTS_REGEX = /\d+\-\d+|\d+[a-zA-Z]+$|\d+|[A-Za-z][0-9A-Za-z-]*$/
 
     attr_reader :version
-    alias :to_s :version
+    alias to_s version
 
     def initialize(*args)
       if args.length == 1 && args.first.is_a?(String)
         @version = args.first.to_s.strip
       else
         @segments = args.map(&:to_s).map(&:strip)
-        @version = segments.join(".")
+        @version = segments.join('.')
       end
     end
 
@@ -34,7 +36,7 @@ module UserAgentParser
     end
 
     def inspect
-      "#<#{self.class} #{to_s}>"
+      "#<#{self.class} #{self}>"
     end
 
     def eql?(other)
@@ -42,7 +44,7 @@ module UserAgentParser
         version == other.version
     end
 
-    alias_method :==, :eql?
+    alias == eql?
 
     # Private
     def segments

data/vendor/uap-core/regexes.yaml

@@ -1,6 +1,27 @@
 user_agent_parsers:
   #### SPECIAL CASES TOP ####
 
+  # CFNetwork Podcast catcher Applications
+  - regex: '(ESPN)[%20| ]+Radio/(\d+)\.(\d+)\.(\d+) CFNetwork'
+  - regex: '(Antenna)/(\d+) CFNetwork'
+    family_replacement: 'AntennaPod'
+  - regex: '(TopPodcasts)Pro/(\d+) CFNetwork'
+  - regex: '(MusicDownloader)Lite/(\d+)\.(\d+)\.(\d+) CFNetwork'
+  - regex: '^(.*)-iPad/(\d+)\.?(\d+)?.?(\d+)?.?(\d+)? CFNetwork'
+  - regex: '^(.*)-iPhone/(\d+)\.?(\d+)?.?(\d+)?.?(\d+)? CFNetwork'
+  - regex: '^(.*)/(\d+)\.?(\d+)?.?(\d+)?.?(\d+)? CFNetwork'
+
+  # Podcast catchers
+  - regex: '(espn\.go)'
+    family_replacement: 'ESPN'
+  - regex: '(espnradio\.com)'
+    family_replacement: 'ESPN'
+  - regex: 'ESPN APP$'
+    family_replacement: 'ESPN'
+  - regex: '(audioboom\.com)'
+    family_replacement: 'AudioBoom'
+  - regex: ' (Rivo) RHYTHM'
+
   # @note: iOS / OSX Applications
   - regex: '(CFNetwork)(?:/(\d+)\.(\d+)\.?(\d+)?)?'
     family_replacement: 'CFNetwork'
@@ -48,6 +69,10 @@ user_agent_parsers:
   # Downloader ...
   - regex: '(Google-HTTP-Java-Client|Apache-HttpClient|http%20client|Python-urllib|HttpMonitor|TLSProber|WinHTTP|JNLP|okhttp)(?:[ /](\d+)(?:\.(\d+)(?:\.(\d+))?)?)?'
 
+  # Pinterestbot
+  - regex: '(Pinterest(?:bot)?)/(\d+)(?:\.(\d+)(?:\.(\d+))?)?[;\s\(]+\+https://www.pinterest.com/bot.html'
+    family_replacement: 'Pinterestbot'
+
   # Bots
   - regex: '(1470\.net crawler|50\.nu|8bo Crawler Bot|Aboundex|Accoona-[A-z]+-Agent|AdsBot-Google(?:-[a-z]+)?|altavista|AppEngine-Google|archive.*?\.org_bot|archiver|Ask Jeeves|[Bb]ai[Dd]u[Ss]pider(?:-[A-Za-z]+)*|bingbot|BingPreview|blitzbot|BlogBridge|Bloglovin|BoardReader(?: [A-Za-z]+)*|boitho.com-dc|BotSeer|\b\w*favicon\w*\b|\bYeti(?:-[a-z]+)?|Catchpoint(?: bot)?|[Cc]harlotte|Checklinks|clumboot|Comodo HTTP\(S\) Crawler|Comodo-Webinspector-Crawler|ConveraCrawler|CRAWL-E|CrawlConvera|Daumoa(?:-feedfetcher)?|Feed Seeker Bot|Feedbin|findlinks|Flamingo_SearchEngine|FollowSite Bot|furlbot|Genieo|gigabot|GomezAgent|gonzo1|(?:[a-zA-Z]+-)?Googlebot(?:-[a-zA-Z]+)?|Google SketchUp|grub-client|gsa-crawler|heritrix|HiddenMarket|holmes|HooWWWer|htdig|ia_archiver|ICC-Crawler|Icarus6j|ichiro(?:/mobile)?|IconSurf|IlTrovatore(?:-Setaccio)?|InfuzApp|Innovazion Crawler|InternetArchive|IP2[a-z]+Bot|jbot\b|KaloogaBot|Kraken|Kurzor|larbin|LEIA|LesnikBot|Linguee Bot|LinkAider|LinkedInBot|Lite Bot|Llaut|lycos|Mail\.RU_Bot|masscan|masidani_bot|Mediapartners-Google|Microsoft .*? Bot|mogimogi|mozDex|MJ12bot|msnbot(?:-media *)?|msrbot|Mtps Feed Aggregation System|netresearch|Netvibes|NewsGator[^/]*|^NING|Nutch[^/]*|Nymesis|ObjectsSearch|Orbiter|OOZBOT|PagePeeker|PagesInventory|PaxleFramework|Peeplo Screenshot Bot|PlantyNet_WebRobot|Pompos|Qwantify|Read%20Later|Reaper|RedCarpet|Retreiver|Riddler|Rival IQ|scooter|Scrapy|Scrubby|searchsight|seekbot|semanticdiscovery|Simpy|SimplePie|SEOstats|SimpleRSS|SiteCon|Slackbot-LinkExpanding|Slack-ImgProxy|Slurp|snappy|Speedy Spider|Squrl Java|Stringer|TheUsefulbot|ThumbShotsBot|Thumbshots\.ru|Tiny Tiny RSS|TwitterBot|WhatsApp|URL2PNG|Vagabondo|VoilaBot|^vortex|Votay bot|^voyager|WASALive.Bot|Web-sniffer|WebThumb|WeSEE:[A-z]+|WhatWeb|WIRE|WordPress|Wotbox|www\.almaden\.ibm\.com|Xenu(?:.s)? Link Sleuth|Xerka [A-z]+Bot|yacy(?:bot)?|Yahoo[a-z]*Seeker|Yahoo! Slurp|Yandex\w+|YodaoBot(?:-[A-z]+)?|YottaaMonitor|Yowedo|^Zao|^Zao-Crawler|ZeBot_www\.ze\.bz|ZooShot|ZyBorg)(?:[ /]v?(\d+)(?:\.(\d+)(?:\.(\d+))?)?)?'
 
@@ -68,11 +93,11 @@ user_agent_parsers:
 
   # Social Networks
   # Facebook
-  - regex: '\[FB.*;(FBAV)/(\d+)(?:\.(\d+)(?:\.(\d)+)?)?'
+  - regex: '\[FB.*;(FBAV)/(\d+)(?:\.(\d+)(?:\.(\d+))?)?'
     family_replacement: 'Facebook'
   # Pinterest
   - regex: '\[(Pinterest)/[^\]]+\]'
-  - regex: '(Pinterest)(?: for Android(?: Tablet)?)?/(\d+)(?:\.(\d+)(?:\.(\d)+)?)?'
+  - regex: '(Pinterest)(?: for Android(?: Tablet)?)?/(\d+)(?:\.(\d+)(?:\.(\d+))?)?'
 
   # Pale Moon
   - regex: '(PaleMoon)/(\d+)\.(\d+)\.?(\d+)?'
@@ -307,6 +332,9 @@ user_agent_parsers:
   # AOL Browser (IE-based)
   - regex: '(AOL) (\d+)\.(\d+); AOLBuild (\d+)'
 
+  # Podcast catcher Applications using iTunes
+  - regex: '(PodCruncher|Downcast)[ /]?(\d+)\.?(\d+)?\.?(\d+)?\.?(\d+)?'
+
   #### END SPECIAL CASES TOP ####
 
   #### MAIN CASES - this catches > 50% of all browsers ####
@@ -412,6 +440,54 @@ user_agent_parsers:
   # Baca Berita App News Reader
   - regex: '(BacaBerita App)\/(\d+)\.(\d+)\.(\d+)'
 
+  # Podcast catchers
+  - regex: '^(bPod|Pocket Casts|Player FM)$'
+  - regex: '^(AlexaMediaPlayer|VLC)/(\d+)\.(\d+)\.([^.\s]+)'
+  - regex: '^(AntennaPod|WMPlayer|Zune|Podkicker|Radio|ExoPlayerDemo|Overcast|PocketTunes|NSPlayer|okhttp|DoggCatcher|QuickNews|QuickTime|Peapod|Podcasts|GoldenPod|VLC|Spotify|Miro|MediaGo|Juice|iPodder|gPodder|Banshee)/(\d+)\.(\d+)\.?(\d+)?\.?(\d+)?'
+  - regex: '^(Peapod|Liferea)/([^.\s]+)\.([^.\s]+)?\.?([^.\s]+)?'
+  - regex: '^(bPod|Player FM) BMID/(\S+)'
+  - regex: '^(Podcast ?Addict)/v(\d+) '
+  - regex: '^(Podcast ?Addict) '
+    family_replacement: 'PodcastAddict'
+  - regex: '(Replay) AV'
+  - regex: '(VOX) Music Player'
+  - regex: '(CITA) RSS Aggregator/(\d+)\.(\d+)'
+  - regex: '(Pocket Casts)$'
+  - regex: '(Player FM)$'
+  - regex: '(LG Player|Doppler|FancyMusic|MediaMonkey|Clementine) (\d+)\.(\d+)\.?([^.\s]+)?\.?([^.\s]+)?'
+  - regex: '(philpodder)/(\d+)\.(\d+)\.?([^.\s]+)?\.?([^.\s]+)?'
+  - regex: '(Player FM|Pocket Casts|DoggCatcher|Spotify|MediaMonkey|MediaGo|BashPodder)'
+  - regex: '(QuickTime)\.(\d+)\.(\d+)\.(\d+)'
+  - regex: '(Kinoma)(\d+)'
+  - regex: '(Fancy) Cloud Music (\d+)\.(\d+)'
+    family_replacement: 'FancyMusic'
+  - regex: 'EspnDownloadManager'
+    family_replacement: 'ESPN'
+  - regex: '(ESPN) Radio (\d+)\.(\d+)\.?(\d+)? ?[rv:]?(\d+)? '
+  - regex: '(podracer|jPodder) v ?(\d+)\.(\d+)\.?(\d+)?'
+  - regex: '(ZDM)/(\d+)\.(\d+)[; ]?'
+  - regex: '(Zune|BeyondPod) (\d+)\.?(\d+)?[\);]'
+  - regex: '(WMPlayer)/(\d+)\.(\d+)\.(\d+)\.(\d+)'
+  - regex: '^(Lavf)'
+    family_replacement: 'WMPlayer'
+  - regex: '^(RSSRadio)[ /]?(\d+)?'
+  - regex: '(RSS_Radio) (\d+)\.(\d+)'
+    family_replacement: 'RSSRadio'
+  - regex: '(Podkicker) \S+/(\d+)\.(\d+)\.(\d+)'
+    family_replacement: 'Podkicker'
+  - regex: '^(HTC) Streaming Player \S+ / \S+ / \S+ / (\d+)\.(\d+)\.?(\d+)?'
+  - regex: '^(Stitcher)/iOS'
+  - regex: '^(Stitcher)/Android'
+  - regex: '^(VLC) .*version (\d+)\.(\d+)\.(\d+)'
+  - regex: ' (VLC) for'
+  - regex: '(vlc)/(\d+)\.(\d+)\.(\d+)'
+    family_replacement: 'VLC'
+  - regex: '^(foobar)\S+/([^.\s]+)\.([^.\s]+)?\.?([^.\s]+)?'
+  - regex: '^(Clementine)\S+ ([^.\s]+)\.([^.\s]+)?\.?([^.\s]+)?'
+  - regex: '(amarok)/([^.\s]+)\.([^.\s]+)?\.?([^.\s]+)?'
+    family_replacement: 'Amarok'
+  - regex: '(Custom)-Feed Reader'
+
   # Browser major_version.minor_version.beta_version (space instead of slash)
   - regex: '(iRider|Crazy Browser|SkipStone|iCab|Lunascape|Sleipnir|Maemo Browser) (\d+)\.(\d+)\.(\d+)'
   # Browser major_version.minor_version (space instead of slash)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: user_agent_parser
 version: !ruby/object:Gem::Version
-  version: 2.4.0
+  version: 2.4.1
 platform: ruby
 authors:
 - Tim Lucas
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-09-11 00:00:00.000000000 Z
+date: 2017-10-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: coveralls
@@ -33,7 +33,6 @@ extensions: []
 extra_rdoc_files: []
 files:
 - MIT-LICENSE
-- Readme.md
 - bin/user_agent_parser
 - lib/user_agent_parser.rb
 - lib/user_agent_parser/cli.rb

data/Readme.md

@@ -1,143 +0,0 @@
-# UserAgentParser [![Build Status](https://secure.travis-ci.org/ua-parser/uap-ruby.png?branch=master)](http://travis-ci.org/ua-parser/uap-ruby) [![Coverage Status](https://coveralls.io/repos/github/ua-parser/uap-ruby/badge.svg)](https://coveralls.io/github/ua-parser/uap-ruby)
-
-UserAgentParser is a simple, comprehensive Ruby gem for parsing user agent strings. It uses [BrowserScope](http://www.browserscope.org/)'s [parsing patterns](https://github.com/ua-parser/uap-core).
-
-## Supported Rubies
-
-* Ruby 2.4
-* Ruby 2.3
-* Ruby 2.2
-* Ruby 2.1
-* Ruby 2.0
-* Ruby 1.9.3
-* Ruby 1.9.2
-* JRuby
-
-## Installation
-
-```bash
-$ gem install user_agent_parser
-```
-
-## Example usage
-
-```ruby
-require 'user_agent_parser'
-=> true
-user_agent = UserAgentParser.parse 'Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.0;)'
-=> #<UserAgentParser::UserAgent IE 9.0 (Windows Vista)>
-user_agent.to_s
-=> "IE 9.0"
-user_agent.family
-=> "IE"
-user_agent.version.to_s
-=> "9.0"
-user_agent.version.major
-=> "9"
-user_agent.version.minor
-=> "0"
-operating_system = user_agent.os
-=> #<UserAgentParser::OperatingSystem Windows Vista>
-operating_system.to_s
-=> "Windows Vista"
-
-# Device information can also be determined from some devices
-user_agent = UserAgentParser.parse "Mozilla/5.0 (Linux; Android 7.0; SAMSUNG SM-G930T Build/NRD90M) AppleWebKit/537.36 (KHTML, like Gecko) SamsungBrowser/5.0 Chrome/51.0.2704.106 Mobile Safari/537.36"
-=> #<UserAgentParser::UserAgent Samsung Internet 5.0 (Android 7.0) (Samsung SM-G930T)>
-user_agent.device.family
-=> "Samsung SM-G930T"
-user_agent.device.brand
-=> "Samsung"
-user_agent.device.model
-=> "SM-G930T"
-
-user_agent = UserAgentParser.parse "Mozilla/5.0 (iPad; CPU OS 10_2_1 like Mac OS X) AppleWebKit/600.1.4 (KHTML, like Gecko) GSA/23.1.148956103 Mobile/14D27 Safari/600.1.4"
-=> #<UserAgentParser::UserAgent Mobile Safari 10.2.1 (iOS 10.2.1) (iPad)>
-irb(main):026:0> user_agent.device.family
-=> "iPad"
-irb(main):027:0> user_agent.device.brand
-=> "Apple"
-irb(main):028:0> user_agent.device.model
-=> "iPad"
-
-
-# The parser database will be loaded and parsed on every call to
-# UserAgentParser.parse. To avoid this, instantiate your own Parser instance.
-parser = UserAgentParser::Parser.new
-parser.parse 'Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.0;)'
-=> #<UserAgentParser::UserAgent IE 9.0 (Windows Vista)>
-parser.parse 'Opera/9.80 (Windows NT 5.1; U; ru) Presto/2.5.24 Version/10.53'
-=> #<UserAgentParser::UserAgent Opera 10.53 (Windows XP)>
-```
-
-In a larger application, you could store a parser in a global to avoid repeat pattern loading:
-
-```ruby
-module MyApplication
-
-  # Instantiate the parser on load as it's quite expensive
-  USER_AGENT_PARSER = UserAgentParser::Parser.new
-
-  def self.user_agent_parser
-    USER_AGENT_PARSER
-  end
-
-end
-```
-
-## The pattern database
-
-The [ua-parser database](https://github.com/ua-parser/uap-core/blob/master/regexes.yaml) is included via a [git submodule](http://help.github.com/submodules/). To update the database the submodule needs to be updated and the gem re-released (pull requests for this are very welcome!).
-
-You can also specify the path to your own, updated and/or customised `regexes.yaml` file as a second argument to `UserAgentParser.parse`:
-
-```ruby
-UserAgentParser.parse(ua_string, patterns_path: '/some/path/to/regexes.yaml')
-```
-
-or when instantiating a `UserAgentParser::Parser`:
-
-```ruby
-UserAgentParser::Parser.new(patterns_path: '/some/path/to/regexes.yaml').parse(ua_string)
-```
-
-## Command line tool
-
-The gem incldes a `user_agent_parser` bin command which will read from
-standard input, parse each line and print the result, for example:
-
-```bash
-$ cat > SOME-FILE-WITH-USER-AGENTS.txt
-USER_AGENT_1
-USER_AGENT_2
-...
-$ cat SOME-FILE-WITH-USER-AGENTS.txt | user_agent_parser --format '%f %M' | distribution
-```
-
-See `user_agent_parser -h` for more information.
-
-## Contributing
-
-1. Fork
-2. Hack
-3. `rake test`
-4. Send a pull request
-
-All accepted pull requests will earn you commit and release rights.
-
-## Releasing a new version
-
-1. Update the version in `user_agent_parser.gemspec`
-2. `git commit user_agent_parser.gemspec` with the following message format:
-
-        Version x.x.x
-
-        Changelog:
-        * Some new feature
-        * Some new bug fix
-3. `rake release`
-4. Create a [new Github release](https://github.com/ua-parser/uap-ruby/releases/new)
-
-## License
-
-MIT