zayef 0.2.0 → 0.2.0.1

data/examples/refactored_usage.rb

@@ -0,0 +1,85 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative '../lib/zayef'
+
+puts "🎉 Zayef Generator - Refactored Version Demo"
+puts "=" * 50
+
+# Example 1: Basic usage with generic helpers
+puts "\n1️⃣ Basic Data Generation:"
+puts "Name: #{Zayef::Generator.name}"
+puts "Email: #{Zayef::Generator.email}"
+puts "Phone: #{Zayef::Generator.phone}"
+puts "City: #{Zayef::Generator.city}"
+puts "CNI: #{Zayef::Generator.cni_number}"
+
+# Example 2: Parameterized profile generation
+puts "\n2️⃣ Parameterized Profile (25-year-old from Rabat):"
+profile = Zayef::Generator.profile(age_min: 25, age_max: 25, city: "Rabat")
+puts "Name: #{profile[:name]}"
+puts "Age: #{profile[:age]}"
+puts "City: #{profile[:city]}"
+puts "District: #{profile[:district]}"
+puts "Email: #{profile[:email]}"
+
+# Example 3: Gender-specific first names
+puts "\n3️⃣ Gender-Specific Names:"
+puts "Male name: #{Zayef::Generator.first_name('male')}"
+puts "Female name: #{Zayef::Generator.first_name('female')}"
+
+# Example 4: Business profile with consistency
+puts "\n4️⃣ Business Profile:"
+business = Zayef::Generator.business_profile(city: "Casablanca")
+puts "Company: #{business[:company_name]}"
+puts "City: #{business[:city]}"
+puts "Address: #{business[:address]}"
+
+# Example 5: Medical profile (perfect for DabaDoc)
+puts "\n5️⃣ Medical Profile:"
+medical = Zayef::Generator.medical_profile(age_min: 30, age_max: 50)
+puts "Patient: #{medical[:patient_name]}"
+puts "Age: #{medical[:age]}"
+puts "Specialty: #{medical[:medical_specialty]}"
+puts "Clinic: #{medical[:clinic_address]}"
+
+# Example 6: Bulk data generation with options
+puts "\n6️⃣ Bulk Data Generation:"
+profiles = Zayef::Generator.bulk_data(3, 'personal', age_min: 20, age_max: 30, city: "Marrakech")
+profiles.each_with_index do |profile, index|
+  puts "Profile #{index + 1}: #{profile[:name]} (#{profile[:age]} years, #{profile[:city]})"
+end
+
+# Example 7: Weighted nationality distribution
+puts "\n7️⃣ Nationality Distribution (10 samples):"
+10.times { puts "Nationality: #{Zayef::Generator.nationality}" }
+
+# Example 8: Export to JSON
+puts "\n8️⃣ JSON Export:"
+json_data = Zayef::Generator.export_to_json(2, 'cultural', city: "Fès")
+puts "JSON length: #{json_data.length} characters"
+
+# Example 9: Data loader direct access
+puts "\n9️⃣ Direct Data Access:"
+puts "Available cities: #{Zayef::DataLoader.cities.length}"
+puts "Available male names: #{Zayef::DataLoader.first_names('male').length}"
+puts "Available female names: #{Zayef::DataLoader.first_names('female').length}"
+
+# Example 10: Streaming for large datasets
+puts "\n🔟 Streaming Example (first 3 records):"
+count = 0
+Zayef::Generator.stream_csv(100, 'business') do |line|
+  puts line.chomp if count < 3
+  count += 1
+  break if count >= 3
+end
+
+puts "\n✅ Refactoring Complete!"
+puts "Key improvements:"
+puts "- Generic helper methods (pick, random_number, random_code)"
+puts "- External data files for easy maintenance"
+puts "- Parameterized methods with constraints"
+puts "- Consistent profile generation"
+puts "- Weighted sampling for realistic distributions"
+puts "- Streaming support for large datasets"
+puts "- Cached data loading for performance"

data/lib/zayef/data_loader.rb

@@ -0,0 +1,245 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'yaml'
+
+module Zayef
+  class DataLoader
+    DATA_DIR = File.join(__dir__, '..', '..', 'data').freeze
+
+    class << self
+      def load_json(filename)
+        file_path = File.join(DATA_DIR, filename)
+        return {} unless File.exist?(file_path)
+        
+        JSON.parse(File.read(file_path), symbolize_names: true)
+      rescue JSON::ParserError => e
+        warn "Error parsing #{filename}: #{e.message}"
+        {}
+      end
+
+      def load_yaml(filename)
+        file_path = File.join(DATA_DIR, filename)
+        return {} unless File.exist?(file_path)
+        
+        YAML.safe_load(File.read(file_path), symbolize_names: true)
+      rescue Psych::SyntaxError => e
+        warn "Error parsing #{filename}: #{e.message}"
+        {}
+      end
+
+      # Cached data loading
+      def names_data
+        @names_data ||= load_json('moroccan_names.json')
+      end
+
+      def geography_data
+        @geography_data ||= load_json('moroccan_geography.json')
+      end
+
+      def culture_data
+        @culture_data ||= load_json('moroccan_culture.json')
+      end
+
+      def business_data
+        @business_data ||= load_json('moroccan_business.json')
+      end
+
+      # Convenience methods for specific data
+      def first_names(gender = nil)
+        names = names_data[:first_names] || {}
+        return names.values.flatten if gender.nil?
+        
+        case gender.to_s.downcase
+        when 'male', 'm'
+          names[:male] || []
+        when 'female', 'f'
+          names[:female] || []
+        else
+          names.values.flatten
+        end
+      end
+
+      def last_names
+        names_data[:last_names] || []
+      end
+
+      def cities
+        geography_data[:cities] || []
+      end
+
+      def regions
+        geography_data[:regions] || []
+      end
+
+      def districts_by_city
+        geography_data[:districts_by_city] || {}
+      end
+
+      def neighborhoods
+        geography_data[:neighborhoods] || []
+      end
+
+      def landmarks
+        geography_data[:landmarks] || []
+      end
+
+      def traditional_dishes
+        culture_data[:traditional_dishes] || []
+      end
+
+      def spices
+        culture_data[:spices] || []
+      end
+
+      def souks
+        culture_data[:souks] || []
+      end
+
+      def restaurants
+        culture_data[:restaurants] || []
+      end
+
+      def hotels
+        culture_data[:hotels] || []
+      end
+
+      def mosques
+        culture_data[:mosques] || []
+      end
+
+      def schools
+        culture_data[:schools] || []
+      end
+
+      def universities
+        culture_data[:universities] || []
+      end
+
+      def newspapers
+        culture_data[:newspapers] || []
+      end
+
+      def festivals
+        culture_data[:festivals] || []
+      end
+
+      def music_genres
+        culture_data[:music_genres] || []
+      end
+
+      def movie_genres
+        culture_data[:movie_genres] || []
+      end
+
+      def hobbies
+        culture_data[:hobbies] || []
+      end
+
+      def sports
+        culture_data[:sports] || []
+      end
+
+      def social_media
+        culture_data[:social_media] || []
+      end
+
+      def transportation
+        culture_data[:transportation] || []
+      end
+
+      def pets
+        culture_data[:pets] || []
+      end
+
+      def colors
+        culture_data[:colors] || []
+      end
+
+      def banks
+        business_data[:banks] || []
+      end
+
+      def industries
+        business_data[:industries] || []
+      end
+
+      def company_sizes
+        business_data[:company_sizes] || []
+      end
+
+      def business_types
+        business_data[:business_types] || []
+      end
+
+      def job_titles
+        business_data[:job_titles] || []
+      end
+
+      def professions
+        business_data[:professions] || []
+      end
+
+      def work_schedules
+        business_data[:work_schedules] || []
+      end
+
+      def medical_specialties
+        business_data[:medical_specialties] || []
+      end
+
+      def education_levels
+        business_data[:education_levels] || []
+      end
+
+      def income_ranges
+        business_data[:income_ranges] || []
+      end
+
+      def languages
+        business_data[:languages] || []
+      end
+
+      def marital_statuses
+        business_data[:marital_statuses] || []
+      end
+
+      def blood_types
+        business_data[:blood_types] || []
+      end
+
+      def eye_colors
+        business_data[:eye_colors] || []
+      end
+
+      def hair_colors
+        business_data[:hair_colors] || []
+      end
+
+      def religions
+        business_data[:religions] || []
+      end
+
+      def nationality_weights
+        business_data[:nationalities] || {}
+      end
+
+      # Clear cache (useful for testing or when data files change)
+      def clear_cache!
+        @names_data = nil
+        @geography_data = nil
+        @culture_data = nil
+        @business_data = nil
+      end
+
+      # Reload all data
+      def reload!
+        clear_cache!
+        names_data
+        geography_data
+        culture_data
+        business_data
+      end
+    end
+  end
+end

data/lib/zayef/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Zayef
-  VERSION = "0.2.0"
+  VERSION = "0.2.0.1"
 end

data/test_user_code.rb

@@ -0,0 +1,41 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Test the user's code
+require 'zayef'
+
+puts "🎉 Testing Zayef Generator"
+puts "=" * 40
+
+# Generate a single profile
+puts "\n1️⃣ Single Profile:"
+profile = Zayef::Generator.profile
+puts "Generated profile with #{profile.keys.length} fields"
+
+# Generate 5 profiles
+puts "\n2️⃣ Bulk Data (5 profiles):"
+profiles = Zayef::Generator.bulk_data(5)
+puts "Generated #{profiles.length} profiles"
+profiles.first(3).each_with_index do |p, i|
+  puts "  Profile #{i+1}: #{p[:name]} (#{p[:age]} years, #{p[:city]})"
+end
+
+# Export 3 profiles to JSON
+puts "\n3️⃣ JSON Export (3 profiles):"
+json_data = Zayef::Generator.export_to_json(3)
+puts "JSON data length: #{json_data.length} characters"
+puts "Sample JSON: #{json_data[0..100]}..."
+
+puts "\n✅ All methods work correctly!"
+puts "\n📝 Additional Examples:"
+puts "Zayef.name                    # #{Zayef.name}"
+puts "Zayef.email                   # #{Zayef.email}"
+puts "Zayef.phone                   # #{Zayef.phone}"
+puts "Zayef.city                    # #{Zayef.city}"
+puts "Zayef.cni_number              # #{Zayef.cni_number}"
+
+# Test parameterized profiles
+puts "\n🔧 Parameterized Examples:"
+puts "Profile (25-35, Casablanca): #{Zayef.profile(age_min: 25, age_max: 35, city: 'Casablanca')[:name]}"
+puts "Business (Rabat): #{Zayef.business_profile(city: 'Rabat')[:company_name]}"
+puts "Medical (30-50): #{Zayef.medical_profile(age_min: 30, age_max: 50)[:medical_specialty]}"

data/user_example.rb

@@ -0,0 +1,34 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'zayef'
+
+puts "🎉 Zayef Generator - User Examples"
+puts "=" * 40
+
+# Generate a single profile
+puts "\n1️⃣ Single Profile:"
+profile = Zayef::Generator.profile
+puts "Generated profile with #{profile.keys.length} fields:"
+puts JSON.pretty_generate(profile)
+
+# Generate 5 profiles
+puts "\n2️⃣ Bulk Data (5 profiles):"
+profiles = Zayef::Generator.bulk_data(5)
+puts "Generated #{profiles.length} profiles:"
+profiles.first(3).each_with_index do |p, i|
+  puts "  Profile #{i+1}: #{p[:name]} (#{p[:age]} years, #{p[:city]})"
+end
+
+# Export 3 profiles to JSON
+puts "\n3️⃣ JSON Export (3 profiles):"
+json_data = Zayef::Generator.export_to_json(3)
+puts "JSON data length: #{json_data.length} characters"
+puts "Sample JSON: #{json_data[0..200]}..."
+
+puts "\n✅ Your code works perfectly!"
+puts "\n📚 More Examples:"
+puts "Zayef::Generator.profile(age_min: 25, age_max: 35, city: 'Casablanca')"
+puts "Zayef::Generator.business_profile(city: 'Rabat')"
+puts "Zayef::Generator.medical_profile(age_min: 30, age_max: 50)"
+puts "Zayef::Generator.cultural_profile(city: 'Fès')"

data/zayef.gemspec

@@ -19,6 +19,9 @@ Gem::Specification.new do |spec|
   spec.metadata["homepage_uri"] = spec.homepage
   spec.metadata["source_code_uri"] = "https://github.com/merouaneamqor/zayef"
   spec.metadata["changelog_uri"] = "https://github.com/merouaneamqor/zayef/blob/main/CHANGELOG.md"
+  spec.metadata["documentation_uri"] = "https://github.com/merouaneamqor/zayef/blob/main/README.md"
+  spec.metadata["bug_tracker_uri"] = "https://github.com/merouaneamqor/zayef/issues"
+  spec.metadata["rubygems_mfa_required"] = "true"
 
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: zayef
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.0.1
 platform: ruby
 authors:
 - Merouane AMQOR
@@ -54,13 +54,22 @@ files:
 - CHANGELOG.md
 - CONTRIBUTING.md
 - README.md
+- REFACTORING.md
 - Rakefile
 - cliff.toml
+- data/moroccan_business.json
+- data/moroccan_culture.json
+- data/moroccan_geography.json
+- data/moroccan_names.json
 - demo.rb
+- examples/refactored_usage.rb
 - lib/zayef.rb
+- lib/zayef/data_loader.rb
 - lib/zayef/generator.rb
 - lib/zayef/version.rb
 - sig/zayef.rbs
+- test_user_code.rb
+- user_example.rb
 - vendor/bundle/ruby/3.0.0/bin/htmldiff
 - vendor/bundle/ruby/3.0.0/bin/ldiff
 - vendor/bundle/ruby/3.0.0/bin/rake
@@ -1416,6 +1425,9 @@ metadata:
   homepage_uri: https://github.com/merouaneamqor/zayef
   source_code_uri: https://github.com/merouaneamqor/zayef
   changelog_uri: https://github.com/merouaneamqor/zayef/blob/main/CHANGELOG.md
+  documentation_uri: https://github.com/merouaneamqor/zayef/blob/main/README.md
+  bug_tracker_uri: https://github.com/merouaneamqor/zayef/issues
+  rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
 - lib