ivanvr-faker_es_mx 0.1.0

data/LICENSE

@@ -0,0 +1,4 @@
+This work is licensed under the Creative Commons Attribution-Share Alike 2.5 Mexico License.
+
+To view a copy of this license, visit http://creativecommons.org/licenses/by-sa/2.5/mx/
+or send a letter to Creative Commons, 171 Second Street, Suite 300, San Francisco, California, 94105, USA.

data/README

@@ -0,0 +1,17 @@
+I was using the Faker gem (http://faker.rubyforge.org/) to generate test data
+for an application, but since the application is in spanish, the test data
+looked weird.
+
+So I created this small extension to address that.
+
+Many of Faker's method have their mx_ prefixed counterpart in this extension.
+
+I hope you find this as useful as I have.
+
+To use:
+
+gem install faker
+gem install ivanvr-faker_es_mx --source=http://gems.github.com
+
+require 'faker'
+require 'faker_es_mx'

data/Rakefile

@@ -0,0 +1,42 @@
+require 'rubygems'
+require 'rake'
+require 'rake/clean'
+require 'rake/gempackagetask'
+require 'rake/rdoctask'
+require 'rake/testtask'
+
+Dir['tasks/*.rake'].each {|t| load t }
+
+spec = Gem::Specification.new do |s|
+  s.name = 'faker_es_mx'
+  s.version = '0.1.0'
+  s.has_rdoc = true
+  s.extra_rdoc_files = ['README', 'LICENSE']
+  s.summary = 'Faker extension for es_MX fakings!'
+  s.description = s.summary
+  s.author = 'Ivan Vega'
+  s.email = ''
+  # s.executables = ['your_executable_here']
+  s.files = %w(LICENSE README Rakefile) + Dir.glob("{bin,lib,spec}/**/*")
+  s.require_path = "lib"
+  s.bindir = "bin"
+end
+
+Rake::GemPackageTask.new(spec) do |p|
+  p.gem_spec = spec
+  p.need_tar = true
+  p.need_zip = true
+end
+
+Rake::RDocTask.new do |rdoc|
+  files =['README', 'LICENSE', 'lib/**/*.rb']
+  rdoc.rdoc_files.add(files)
+  rdoc.main = "README" # page to start on
+  rdoc.title = "faker_es_mx Docs"
+  rdoc.rdoc_dir = 'doc/rdoc' # rdoc output folder
+  rdoc.options << '--line-numbers'
+end
+
+Rake::TestTask.new do |t|
+  t.test_files = FileList['test/**/*.rb']
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/lib/faker_es_mx/address.rb

@@ -0,0 +1,71 @@
+module Faker
+  class Address
+    MX_STATES = {
+      :AGU => { :abbr => 'Ags',   :post_codes => 20..20, :name => 'Aguascalientes' },
+      :BCN => { :abbr => 'BC',    :post_codes => 21..22, :name => 'Baja California' },
+      :BCS => { :abbr => 'BCS',   :post_codes => 23..23, :name => 'Baja California Sur' },
+      :CAM => { :abbr => 'Camp',  :post_codes => 24..24, :name => 'Campeche' },
+      :CHP => { :abbr => 'Coah',  :post_codes => 25..27, :name => 'Coahuila' },
+      :CHH => { :abbr => 'Col',   :post_codes => 28..28, :name => 'Colima' },
+      :COA => { :abbr => 'Chis',  :post_codes => 29..30, :name => 'Chiapas' },
+      :COL => { :abbr => 'Chih',  :post_codes => 31..33, :name => 'Chihuahua' },
+      :DIF => { :abbr => 'DF',    :post_codes => 00..16, :name => 'Distrito Federal' },
+      :DUR => { :abbr => 'Dgo',   :post_codes => 34..35, :name => 'Durango' },
+      :GUA => { :abbr => 'Gto',   :post_codes => 36..38, :name => 'Guanajuato' },
+      :GRO => { :abbr => 'Gro',   :post_codes => 39..41, :name => 'Guerrero' },
+      :HID => { :abbr => 'Hgo',   :post_codes => 42..43, :name => 'Hidalgo' },
+      :JAL => { :abbr => 'Jal',   :post_codes => 44..48, :name => 'Jalisco' },
+      :MEX => { :abbr => 'Mex',   :post_codes => 50..57, :name => 'Estado de México' },
+      :MIC => { :abbr => 'Mich',  :post_codes => 58..61, :name => 'Michoacán' },
+      :MOR => { :abbr => 'Mor',   :post_codes => 62..62, :name => 'Morelos' },
+      :NAY => { :abbr => 'Nay',   :post_codes => 63..63, :name => 'Nayarit' },
+      :NLE => { :abbr => 'NL',    :post_codes => 64..67, :name => 'Nuevo León' },
+      :OAX => { :abbr => 'Oax',   :post_codes => 68..71, :name => 'Oaxaca' },
+      :PUE => { :abbr => 'Pue',   :post_codes => 72..75, :name => 'Puebla' },
+      :QUE => { :abbr => 'Qro',   :post_codes => 76..76, :name => 'Querétaro' },
+      :ROO => { :abbr => 'QRoo',  :post_codes => 77..77, :name => 'Quintana Roo' },
+      :SLP => { :abbr => 'SLP',   :post_codes => 78..79, :name => 'San Luis Potosí' },
+      :SIN => { :abbr => 'Sin',   :post_codes => 80..82, :name => 'Sinaloa' },
+      :SON => { :abbr => 'Son',   :post_codes => 83..85, :name => 'Sonora' },
+      :TAB => { :abbr => 'Tab',   :post_codes => 86..86, :name => 'Tabasco' },
+      :TAM => { :abbr => 'Tamps', :post_codes => 87..89, :name => 'Tamaulipas' },
+      :TLA => { :abbr => 'Tlax',  :post_codes => 90..90, :name => 'Tlaxcala' },
+      :VER => { :abbr => 'Ver',   :post_codes => 91..96, :name => 'Veracruz' },
+      :YUC => { :abbr => 'Yuc',   :post_codes => 97..97, :name => 'Yucatán' },
+      :ZAC => { :abbr => 'Zac',   :post_codes => 98..99, :name => 'Zacatecas'}
+    }
+
+    @mx_states_iso = MX_STATES.keys
+
+    class << self
+      # Returns a state in Mexico.
+      # Optionally ask for a specific state by its ISO code.
+      def mx_state(iso = nil)
+        iso ||= @mx_states_iso.rand
+        MX_STATES[iso][:name]
+      end
+
+      # Returns the abbreviation of a state according to INEGI.
+      # Optionally ask for a specific state by its ISO code.
+      def mx_state_abbr(iso = nil)
+        iso ||= @mx_states_iso.rand
+        MX_STATES[iso][:abbr]
+      end
+
+      # Returns the abbreviation of a state by its ISO code.
+      def mx_state_abbr_iso
+        @mx_states_iso.rand.to_s
+      end
+
+      # Returns a five digit postal code.
+      # Use the iso parameter to generate a valid
+      # post code for the specified ISO state.
+      #   mx_postcode(mx_state_abbr_iso)
+      def mx_postcode(iso = nil)
+        iso ||= @mx_states_iso.rand
+        code = MX_STATES[iso][:post_codes].to_a.rand
+        "%05d" % (code * 1000 + rand(1000))
+      end
+    end
+  end
+end

data/lib/faker_es_mx/name.rb

@@ -0,0 +1,81 @@
+module Faker
+  class Name
+    MX_NAMES = {
+      :female => %w(
+        Maria Guadalupe Carmen Rosa Claudia Fernanda Sofia Ana Karla Laura
+        Martha Alejandra Andrea Silvia Patricia Veronica Monica Margarita
+        Gabriela Isabel Alicia Gloria Elena Rosario Mariana Yolanda Julia
+        Cecilia Angelica Carolina
+      ),
+      :male => %w(
+        Juan Jose Carlos Luis Jesus Manuel Antonio Alberto Francisco Alejandro
+        Fernando Roberto Jorge Eduardo Mario Marco Miguel Victor Rogelio Daniel
+        Sergio Arturo Alfredo Martin Armando Eduardo Enrique Hector
+      )
+    }
+
+    MX_LAST_NAMES = %w(
+      Hernandez Garcia Martinez Lopez Gonzalez Gomez Rodriguez Perez Sanchez
+      Rivera Ramirez Flores Villegas Guerrero Monroy Naranjo Vega Fernandez
+      Jimenez Ruiz Diaz Moreno Alvarez Munoz Romero Gutierrez Navarro Torres
+      Vazquez Ramos Serrano Castro Molina Morales Ortega Delgado Rubio Iglesias
+      Santos Castillo Cruz Nunez Garrido Medina Lozano Leon
+    )
+
+    MxFormats = [
+      Proc.new { [ mx_prefix, mx_first_name_f, mx_last_name ] },
+      Proc.new { [ mx_prefix, mx_first_name_m, mx_last_name ] },
+      Proc.new { [ mx_first_name_f, mx_last_name ] },
+      Proc.new { [ mx_first_name_f, mx_last_name ] },
+      Proc.new { [ mx_first_name_f, mx_last_name ] },
+      Proc.new { [ mx_first_name_f, mx_last_name ] },
+      Proc.new { [ mx_first_name_m, mx_last_name ] },
+      Proc.new { [ mx_first_name_m, mx_last_name ] },
+      Proc.new { [ mx_first_name_m, mx_last_name ] },
+      Proc.new { [ mx_first_name_m, mx_last_name ] }
+    ]
+
+    MX_PREFIXES = {
+      :female => %w(Sra. Srta. Dr. Prof.),
+      :male => %w(Sr. Dr. Prof.)
+    }
+
+    class << self
+      # Returns a random full name using any of _MxFormats_.
+      def mx_name
+        MxFormats.rand.call.join ' '
+      end
+
+      # Returns a random first name.
+      def mx_first_name(gender = nil, double = false)
+        gender ||= [ :male, :female ].rand
+        name = MX_NAMES[gender].rand
+        name += ' ' + MX_NAMES[gender].rand if double
+        name
+      end
+
+      # Returns a random female first name.
+      def mx_first_name_f(double = false)
+        mx_first_name(:female, double)
+      end
+
+      # Returns a random male first name.
+      def mx_first_name_m(double = false)
+        mx_first_name(:male, double)
+      end
+
+      # Returns a random last name.
+      def mx_last_name(double = false)
+        name = MX_LAST_NAMES.rand
+        name += ' ' + MX_LAST_NAMES.rand if double
+        name
+      end
+
+      # Returns a random prefix.
+      def mx_prefix(gender = nil)
+        gender ||= [ :male, :female ].rand
+        MX_PREFIXES[gender].rand
+      end
+    end
+  end
+end

data/lib/faker_es_mx.rb

@@ -0,0 +1,4 @@
+$:.unshift File.dirname(__FILE__)
+require 'faker'
+require 'faker_es_mx/address'
+require 'faker_es_mx/name'