data_masker 0.1.0

data/data_masker.gemspec

@@ -0,0 +1,29 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'data_masker/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'data_masker'
+  spec.version       = DataMasker::VERSION
+  spec.authors       = ['Peak Xu']
+  spec.email         = ['peak.xu@gmail.com']
+
+  spec.summary       = 'Fast way to mask user data for testing or demos'
+  spec.description   = 'Mask user data like names in a quick and deterministic'\
+                       ' way'
+  spec.homepage      = 'https://github.com/peakxu/data_masker'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |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']
+
+  spec.add_development_dependency 'bundler', '~> 1.8'
+  spec.add_development_dependency 'pry', '~> 0.10.3'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.4.0'
+  spec.add_development_dependency 'rubocop', '~> 0.35.1'
+end

data/lib/data_masker.rb

@@ -0,0 +1,9 @@
+require 'data_masker/version'
+require 'data_masker/masked_name'
+
+#
+module DataMasker
+  class << self
+    attr_accessor :salt # Can be set to seed randomization
+  end
+end

data/lib/data_masker/masked_name.rb

@@ -0,0 +1,55 @@
+require 'digest'
+
+#
+module DataMasker
+  # Mask common names using names from US census
+  class MaskedName
+    class << self
+      def first_names
+        return @first_names if @first_names
+        file = File.expand_path('../../../data/us_first_names.txt', __FILE__)
+        @first_names = File.readlines(file).map(&:strip)
+      end
+
+      def last_names
+        return @last_names if @last_names
+        file = File.expand_path('../../../data/us_last_names.txt', __FILE__)
+        @last_names = File.readlines(file).map(&:strip)
+      end
+
+      def initials
+        @initials ||= ('A'..'Z').to_a
+      end
+    end
+
+    def initialize(name = nil)
+      @hash = Digest::MD5.hexdigest("#{DataMasker.salt}#{name}")
+    end
+
+    def to_s
+      "#{first_name} #{initial}. #{last_name}"
+    end
+
+    def first_name
+      return @first_name if @first_name
+      # First 3 hex digits provide 4096 possibilities, we have 2048 first names
+      first_name_idx = @hash[0..2].hex / 2
+      @first_name = self.class.first_names[first_name_idx]
+    end
+
+    def initial
+      return @initial if @initial
+      # Next 2 hex digits provide 256 possibilities, divide by 10 to distribute
+      # over 26 initials
+      initial_idx = @hash[3..4].hex / 10
+      @initial = self.class.initials[initial_idx]
+    end
+
+    def last_name
+      return @last_name if @last_name
+      # Next 3 hex digits provide 4096 possibilites, we have 4096 last names
+      last_name_idx = @hash[5..7].hex
+      @last_name = self.class.last_names[last_name_idx]
+    end
+  end
+end

data/lib/data_masker/version.rb

@@ -0,0 +1,4 @@
+#
+module DataMasker
+  VERSION = '0.1.0'
+end

metadata

@@ -0,0 +1,127 @@
+--- !ruby/object:Gem::Specification
+name: data_masker
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Peak Xu
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2015-12-31 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.10.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.10.3
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.4.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.4.0
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.35.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.35.1
+description: Mask user data like names in a quick and deterministic way
+email:
+- peak.xu@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- data/us_first_names.txt
+- data/us_last_names.txt
+- data_masker.gemspec
+- lib/data_masker.rb
+- lib/data_masker/masked_name.rb
+- lib/data_masker/version.rb
+homepage: https://github.com/peakxu/data_masker
+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.4.5
+signing_key: 
+specification_version: 4
+summary: Fast way to mask user data for testing or demos
+test_files: []