oui 0.0.1

data/lib/oui.rb

@@ -0,0 +1,6 @@
+require "oui/version"
+require "oui/mac_address"
+require "oui/database"
+require "oui/address"
+require "oui/organization"
+

data/lib/oui/address.rb

@@ -0,0 +1,5 @@
+module OUI
+  class Address
+    attr_accessor :country, :lines
+  end
+end

data/lib/oui/database.rb

@@ -0,0 +1,30 @@
+module OUI
+  class Database
+
+    def initialize
+      @@file = File.read(File.expand_path('../../../data/oui.txt', __FILE__))
+      @@oui_to_organization_names = {}
+
+      @@file.each_line do |line|
+        regex = /(#{MACAddress.oui_regex_string})\s+\(hex\)\s+(.+)/
+        if line =~ regex
+          @@oui_to_organization_names[$1] = $2
+        end
+      end
+    end
+
+    def look_up_organization_by_oui(oui)
+      organization = Organization.new
+      organization.name = @@oui_to_organization_names[oui.upcase]
+      organization
+    end
+
+    class << self
+      def look_up_organization_by_oui(oui)
+        @@instance ||= new
+
+        @@instance.look_up_organization_by_oui(oui)
+      end
+    end
+  end
+end

data/lib/oui/mac_address.rb

@@ -0,0 +1,40 @@
+module OUI
+  class MACAddress
+    attr_accessor :oui, :organization
+
+    @@part = '[\d|[a-f]|[A-F]][\d|[a-f]|[A-F]]'
+
+    def self.parse(string)
+      new(string)
+    end
+
+    def self.oui_regex
+      /#{self.oui_regex_string}/
+    end
+
+    def self.oui_regex_string
+      "#{@@part}-#{@@part}-#{@@part}"
+    end
+
+    def self.part
+      @@part
+    end
+
+    def initialize(string)
+      string =~ /(#{@@part})[:-]?(#{@@part})[:-]?(#{@@part})[:-]?(#{@@part})[:-]?(#{@@part})[:-]?(#{@@part})/
+
+      @address = "#{$1}:#{$2}:#{$3}:#{$4}:#{$5}:#{$6}"
+      @oui = "#{$1}-#{$2}-#{$3}"
+
+      raise 'illegal format' if @address == ':::::'
+    end
+
+    def organization
+      unless @organization
+        @organization = Database.look_up_organization_by_oui(@oui)
+      end
+
+      @organization
+    end
+  end
+end

data/lib/oui/organization.rb

@@ -0,0 +1,13 @@
+module OUI
+  class Organization
+    attr_accessor :name, :address, :chinese_name
+
+    def initialize
+      yield self if block_given?
+    end
+
+    def self.parse(string)
+      raise 'not implemented yet'
+    end
+  end
+end

data/lib/oui/version.rb

@@ -0,0 +1,3 @@
+module OUI
+  VERSION = "0.0.1"
+end

data/oui.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'oui/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "oui"
+  spec.version       = OUI::VERSION
+  spec.authors       = ["Forrest Ye"]
+  spec.email         = ["afu@forresty.com"]
+  spec.description   = %q{look up OUI information /w Chinese translation using MAC addresses}
+  spec.summary       = %q{look up OUI information /w Chinese translation using MAC addresses}
+  spec.homepage      = "https://github.com/modouwifi/oui-gem"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "pry"
+end

data/spec/oui/address_spec.rb

@@ -0,0 +1,10 @@
+require "spec_helper"
+
+module OUI
+  describe Address do
+    subject { Address.new }
+
+    it { should respond_to :country }
+    it { should respond_to :lines }
+  end
+end

data/spec/oui/database_spec.rb

@@ -0,0 +1,9 @@
+require "spec_helper"
+
+module OUI
+  describe Database do
+    subject { Database }
+
+    it { should respond_to :look_up_organization_by_oui }
+  end
+end

data/spec/oui/mac_address_spec.rb

@@ -0,0 +1,61 @@
+require "spec_helper"
+
+module OUI
+  describe MACAddress do
+    subject { MACAddress }
+
+    it { should respond_to :parse }
+    it { should respond_to :oui_regex }
+
+    describe "parse" do
+      subject { MACAddress }
+
+      it "parses MAC address like 001122334455" do
+        expect(subject.parse('001122334455')).not_to be_nil
+      end
+
+      it "parses MAC address like 00-11-22-33-44-55" do
+        expect(subject.parse('00-11-22-33-44-55')).not_to be_nil
+      end
+
+      it "parses MAC address like 00:11:22:33:44:55" do
+        expect(subject.parse('00:11:22:33:44:55')).not_to be_nil
+      end
+
+      it "does not parse MAC address like 00:11:22:3344" do
+        expect { subject.parse('00:11:22:3344') }.to raise_error
+      end
+
+      it "parses MAC address like 00:11:22:33:aa:bb" do
+        expect(subject.parse('00:11:22:33:aa:bb')).not_to be_nil
+      end
+
+      it "parses MAC address like 00:11:22:33:AA:BB" do
+        expect(subject.parse('00:11:22:33:AA:BB')).not_to be_nil
+      end
+    end
+
+    describe "instance methods" do
+      subject { MACAddress.parse('001122334455') }
+
+      it { should respond_to :oui }
+      it { should respond_to :organization }
+
+      describe "oui" do
+        it "extracts oui from mac address" do
+          expect(subject.oui).to eq('00-11-22')
+        end
+
+        it "parses organization from database" do
+          real_mac_address = '14:10:9f:ea:49:3e'
+
+          expect(Database).to receive(:look_up_organization_by_oui).and_return(Organization.new { |o| o.name = 'Apple' })
+
+          organization = MACAddress.parse(real_mac_address).organization
+
+          expect(organization.name).to eq('Apple')
+        end
+      end
+    end
+  end
+end

data/spec/oui/organization_spec.rb

@@ -0,0 +1,17 @@
+require "spec_helper"
+
+module OUI
+  describe Organization do
+    subject { Organization }
+
+    it { should respond_to :parse }
+
+    describe "instance methods" do
+      subject { Organization.new }
+
+      it { should respond_to :name }
+      it { should respond_to :address }
+      it { should respond_to :chinese_name }
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,2 @@
+require "oui"
+

metadata

@@ -0,0 +1,122 @@
+--- !ruby/object:Gem::Specification
+name: oui
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Forrest Ye
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-07-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: &70292318938300 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: *70292318938300
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &70292318937300 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70292318937300
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70292318936260 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70292318936260
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: &70292318934680 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70292318934680
+description: look up OUI information /w Chinese translation using MAC addresses
+email:
+- afu@forresty.com
+executables:
+- oui
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/oui
+- data/oui.txt
+- data/translations.yml
+- lib/oui.rb
+- lib/oui/address.rb
+- lib/oui/database.rb
+- lib/oui/mac_address.rb
+- lib/oui/organization.rb
+- lib/oui/version.rb
+- oui.gemspec
+- spec/oui/address_spec.rb
+- spec/oui/database_spec.rb
+- spec/oui/mac_address_spec.rb
+- spec/oui/organization_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/modouwifi/oui-gem
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 4091341631570692659
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: 4091341631570692659
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.11
+signing_key: 
+specification_version: 3
+summary: look up OUI information /w Chinese translation using MAC addresses
+test_files:
+- spec/oui/address_spec.rb
+- spec/oui/database_spec.rb
+- spec/oui/mac_address_spec.rb
+- spec/oui/organization_spec.rb
+- spec/spec_helper.rb