android-devices 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 10867c7e75f189159d21ff97a362a552f64e730e
+  data.tar.gz: 002e326e0d72e3741096c9eed3d0907f3610ff31
+SHA512:
+  metadata.gz: e0eb6fbb954b14ae1c9720f066da34b7802efe4f352401ff16833798742fac8940b19e78917817cd6bd57bbee103ca0cb9e8b90bad67cf1d56bc49b845d76f60
+  data.tar.gz: db1df57f64a557b99482c24c0c3111fb821bc052c0a3894e350d40301c81b74a4c4ad455e55d73d69889aa76beb2d7b820318fbb560208795120306f40c6f90c

data/.gitignore

@@ -0,0 +1,52 @@
+
+*.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
+
+## 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
+.idea

data/.travis.yml

@@ -0,0 +1,6 @@
+language: ruby
+rvm:
+  - 2.2
+  - jruby
+  - rbx-2
+script: bundle exec rspec

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2016 BBC
+
+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,55 @@
+# Android::Devices
+
+Gem used to convert android model numbers (e.g. GT-I9507) into something more human readable (e.g. Samsung Galaxy S4)
+
+## Installation
+
+Add the following into your application's Gemfile:
+
+`gem android-devices`
+
+Then execute:
+
+`bundle install`
+
+
+## Usage
+
+This gem uses the devices list provided by the Google Play store as it's information store. When you first run the gem it
+will attempt to automatically download the list, if you wish to re-download the list you can use the following command:
+
+` Android::Devices.update_devices`
+
+To then search for a device, you can do something similar to the following:
+
+```
+device = Android::Devices.search_by_model('GT-I9507')
+=> #<Android::Devices::Model:0x007fadd9582d28 @manufacturer="Samsung", @brand="Galaxy S4", @device="jftdd", @model="GT-I9507">
+
+device.name
+=> "Samsung Galaxy S4"
+
+device.brand
+=> "Galaxy S4"
+
+```
+
+If a brand name isn't available it will make use the manufacturer and model as the name:
+
+```
+device = Android::Devices.search_by_model('GT-S5820')
+=> #<Android::Devices::Model:0x007f93889a4700 @manufacturer="Samsung", @brand=nil, @device="GT-S5820", @model="GT-S5820">
+
+device.name
+=> "Samsung GT-S5820"
+```
+
+Finally, if you want a list of devices by a certain manufacturer you can:
+
+```
+devices = Android::Devices.search_by_manufacturer('Samsung')
+=> [#<Android::Devices::Model:0x007f9388864278 @manufacturer="Samsung", @brand="Galaxy Core Prime", @device="coreprimeltetfnvzw", @model="SM-S820L">,
+    #<Android::Devices::Model:0x007f9388864250 @manufacturer="Samsung", @brand="Galaxy Core Prime", @device="coreprimeltevzw", @model="SM-G360V">,
+    #<Android::Devices::Model:0x007f9388864228 @manufacturer="Samsung", @brand="Galaxy Core Prime", @device="coreprimeve3g", @model="SM-G361H">,
+    etc.
+```

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/android-devices.gemspec

@@ -0,0 +1,21 @@
+lib = File.expand_path('../lib', __FILE__)
+
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require 'android/devices'
+
+Gem::Specification.new do |spec|
+  spec.name		= 'android-devices'
+  spec.version		= Android::Devices::VERSION
+  spec.authors		= ['Jon Wilson']
+  spec.email		= ['jon.wilson01@bbc.co.uk']
+  spec.summary		= %q{Human readable Android device names}
+
+  spec.files 		= `git ls-files -z`.split("\x0")
+  spec.require_paths	= ['lib']
+  
+  spec.add_development_dependency 'bundler'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'pry'
+  spec.add_development_dependency 'rspec'
+end

data/config.yml

@@ -0,0 +1 @@
+url: http://storage.googleapis.com/play_public/supported_devices.csv

data/lib/android/devices.rb

@@ -0,0 +1,52 @@
+require 'android/devices/version'
+require 'android/devices/model'
+require 'csv'
+
+module Android
+  module Devices
+
+    def self.update_devices(url = '')
+      csv_url = url.nil? || url.empty? ? 'http://storage.googleapis.com/play_public/supported_devices.csv' : url
+      begin
+        devices = CSV.parse(open(csv_url).read)
+        File.open('devices.csv','w') {|f| f.write(devices.inject([]) { |csv,row| csv << CSV.generate_line(row) }.join('').encode('UTF-8'))}
+        return true
+      rescue Exception
+        raise 'Unable to update devices'
+      end
+    end
+
+    def self.list_exists
+      return File.exists?('devices.csv')
+    end
+
+    def self.old_list?
+      return (File.mtime('devices.csv') < Time.parse((DateTime.now - 30).to_s))
+    end
+
+    def self.search_by_model(model)
+      models.select { |device| device.model == model}.first
+    end
+
+    def self.search_by_manufacturer(manufacturer)
+      models.select { |device| device.manufacturer == manufacturer}
+    end
+
+    def self.models
+      return @models unless @models.nil?
+      @models = []
+      devices.shift
+      devices.each do |device|
+        @models << Model.new(device[0], device[1], device[2], device[3])
+      end
+      @models
+    end
+
+    def self.devices
+      return @devices unless @devices.nil?
+      update_devices unless list_exists
+      @devices = CSV.read('devices.csv')
+      @devices
+    end
+  end
+end

data/lib/android/devices/model.rb

@@ -0,0 +1,19 @@
+module Android
+  module Devices
+    class Model
+      attr_accessor :manufacturer, :brand, :device, :model
+
+      def initialize(manufacturer, brand, device, model)
+        @manufacturer = manufacturer
+        @brand = brand
+        @device = device
+        @model = model
+      end
+
+      def name
+        return "#{@manufacturer} #{@brand}" if @brand
+        "#{@manufacturer} #{@model}"
+      end
+    end
+  end
+end

data/lib/android/devices/version.rb

@@ -0,0 +1,5 @@
+module Android
+  module Devices
+    VERSION = '1.0.0'
+  end
+end

data/spec/android_devices_spec.rb

@@ -0,0 +1,36 @@
+describe Android::Devices do
+  describe 'check' do
+
+    it 'should check if the devices list exists' do
+      File.delete('devices.csv') if File.exists? 'devices.csv'
+      expect(Android::Devices.list_exists).to be(false)
+    end
+
+    it 'should warn if the devices list is over 30 days old' do
+      FileUtils.touch 'devices.csv', :mtime => Time.parse((DateTime.now - 31).to_s)
+      expect(Android::Devices.old_list?).to be(true)
+    end
+  end
+
+  describe 'update' do
+    it 'should be able to update itself' do
+      expect(Android::Devices.update_devices('spec/test_devices.csv')).to be(true)
+      expect(Android::Devices.list_exists).to be(true)
+      expect(CSV.read('devices.csv').count).to be(4)
+    end
+  end
+
+  describe 'search' do
+    before(:all) do
+      Android::Devices.update_devices('spec/test_devices.csv')
+    end
+
+    it 'should search by model' do
+      expect(Android::Devices.search_by_model('GT-I9507').manufacturer).to eq('Samsung')
+    end
+
+    it 'should search by manufacturer' do
+      expect(Android::Devices.search_by_manufacturer('Samsung').count).to be(3)
+    end
+  end
+end

data/spec/test_devices.csv

@@ -0,0 +1,4 @@
+Retail Branding,Marketing Name,Device,Model
+Samsung,Galaxy S4,jftdd,GT-I9507
+Samsung,Galaxy S5,klte,SM-G900M
+Samsung,Galaxy S7,herolteskt,SM-G930S

metadata

@@ -0,0 +1,112 @@
+--- !ruby/object:Gem::Specification
+name: android-devices
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Jon Wilson
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-10-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  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: rake
+  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
+  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: rspec
+  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: 
+email:
+- jon.wilson01@bbc.co.uk
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- android-devices.gemspec
+- config.yml
+- lib/android/devices.rb
+- lib/android/devices/model.rb
+- lib/android/devices/version.rb
+- spec/android_devices_spec.rb
+- spec/test_devices.csv
+homepage: 
+licenses: []
+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: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: Human readable Android device names
+test_files: []