zayef 0.1.1 → 0.2.0.1

data/data/moroccan_names.json

@@ -0,0 +1,65 @@
+{
+  "first_names": {
+    "male": [
+      "Ayoub", "Youssef", "Mohamed", "Ahmed", "Omar", "Hassan", "Ali", "Khalid", "Rachid",
+      "Abdelkader", "Abdelmoumen", "Abdelhak", "Abdelaziz", "Abdelouahed",
+      "Mustapha", "Brahim", "Reda", "Karim", "Anas", "Adil", "Yassine", "Nabil",
+      "Said", "Ismail", "Jamal", "Saad", "Soufiane", "Hamza", "Bilal", "Mehdi",
+      "Younes", "Ilyas", "Zakaria", "Ilyesse", "Tarik", "Noureddine", "Abdelilah",
+      "Mohammed", "Brahim", "Idriss", "Abdeljalil", "Abdelghani", "Abdelmajid",
+      "Othmane", "Amine", "Marouane", "Hicham", "Fouad", "Mourad", "Samir", "Imad",
+      "Hatim", "Rayan", "Ayman", "Idris", "Nacer", "Nizar", "Achraf", "Walid",
+      "Yassir", "Ihab", "Lotfi", "Chafik", "Abderrahim", "Abderrazak",
+      "Abdeslam", "Abdessamad"
+    ],
+    "female": [
+      "Fatima", "Zahra", "Aicha", "Khadija", "Malika", "Noura", "Salma", "Imane",
+      "Amina", "Soukaina", "Kawtar", "Houda", "Naima", "Hanane", "Latifa", "Zineb",
+      "Jamila", "Zakia", "Samira", "Nadia", "Farida", "Rachida", "Hakima",
+      "Laila", "Leila", "Hind", "Sana", "Sanaa", "Leila", "Sabah", "Meryem",
+      "Karima", "Fatiha", "Najat", "Hayat", "Hayat", "Rabia", "Asmaa",
+      "Nouria", "Badia", "Bahia", "Faiza", "Widad", "Wafa", "Asma",
+      "Rahma", "Safia", "Halima", "Abla", "Basma", "Loubna", "Nouha",
+      "Safaa", "Najwa", "Najiba", "Mouna", "Mounia", "Raja", "Rajaa",
+      "Sabah", "Sabah", "Racha", "Racha", "Rima", "Rim", "Lina", "Lyna",
+      "Sara", "Sarah", "Yasmina", "Yasmeen", "Lamia", "Lamya", "Laila",
+      "Ghita", "Chaimae", "Amal", "Siham", "Souad", "Ikram", "Saloua", "Rokia",
+      "Sonia", "Ilham", "Fadoua", "Kawthar", "Rania", "Meriem", "Houaria",
+      "Oumayma", "Yousra", "Douaa", "Iman", "Houdaifa", "Najoua", "Oumaima",
+      "Samah", "Nissrine"
+    ]
+  },
+  "last_names": [
+    "Amqor"," Amkor", "Alaoui", "Bennani", "El Fassi", "Idrissi", "Kabbaj", "Lamrani", "Mansouri",
+    "Benjelloun", "Chakir", "El Idrissi", "Haddouchi", "Kettani", "Laraki",
+    "Belhaj", "Belkadi", "Benkirane", "Benchekroun", "Benabdellah",
+    "Cherkaoui", "El Moutawakil", "El Amrani", "El Ouafi", "El Bachiri",
+    "Benali", "Benmansour", "Benhassan", "Benbrahim", "Benmoussa",
+    "El Khadiri", "El Yousfi", "El Haddadi", "El Kabbaj", "El Mansouri",
+    "Chraibi", "Berrada", "El Amraoui", "El Haouzi", "El Ouazzani",
+    "Tazi", "Alaoui", "Bennouna", "El Glaoui", "Bouazza",
+    "Bouabid", "Bouazza", "El Azzouzi", "El Arrousi",
+    "El Malki", "El Mansouri", "El Ouardi", "El Ouazzani",
+    "Benabbou", "Benabdeljalil", "Benachour", "Benadada",
+    "Benallal", "Benamara", "Benamghar", "Benanou",
+    "Benbachir", "Benbarka", "Benbouazza", "Benbrahim",
+    "Benchekroun", "Bendaoud", "Bendriss", "Benfares",
+    "Benhaddou", "Benhamou", "Benharbit", "Benjelloun",
+    "Benkirane", "Benmoha", "Benmoussa", "Bennani",
+    "Bennouna", "Benomar", "Benouhoud", "Bensalem",
+    "Benslimane", "Bentaleb", "Berada", "Berrada",
+    "Bouachrine", "Bouazza", "Bouazzati", "Boudraa",
+    "Boufous", "Bouhaddou", "Bouhlal", "Boujemaa",
+    "Boukhalef", "Boukhris", "Boulaich", "Boulahfa",
+    "Boumakh", "Boumediene", "Bounaim", "Bououid",
+    "Boussaid", "Boussetta", "Boutaleb", "Bouyaghchi",
+    "Chahboun", "Chahine", "Chaoui", "Cherkaoui",
+    "Chraibi", "Dahbi", "Dahmani", "Darif",
+    "Dkhissi", "Doukkali", "Echkoun", "El Adraoui",
+    "El Alaoui", "El Amraoui", "El Amrani", "El Azzouzi",
+    "El Bachiri", "El Bakkali", "El Barkani", "El Bouhali",
+    "El Fadili", "El Fassi", "El Glaoui", "El Hachimi",
+    "El Idrissi", "El Kadiri", "El Khattabi", "El Malki",
+    "El Mansouri", "El Ouafi", "El Ouazzani", "El Yamani"
+  ]
+}

data/demo.rb

@@ -4,23 +4,177 @@
 require './lib/zayef'
 
 puts '🚀 ZAYEF - Moroccan Data Generator Demo 🚀'
-puts '=' * 60
+puts '=' * 80
 
-# Show that quotes work correctly
-puts '📋 Sample Data with Quoted Names & Cities:'
+# Show basic data generation
+puts '📋 Basic Data Generation:'
 puts ''
-
 3.times do |i|
   puts "Sample #{i+1}:"
   puts "  Name: #{Zayef.name}"
   puts "  City: #{Zayef.city}"
   puts "  Email: #{Zayef.email}"
+  puts "  Phone: #{Zayef.phone}"
   puts "  Specialty: #{Zayef.medical_specialty}"
   puts "  Dish: #{Zayef.traditional_dish}"
   puts "  Bank: #{Zayef.bank}"
   puts ''
 end
 
-puts '✅ MOROCCAN_LAST_NAMES and MOROCCAN_CITIES now have quotes!'
-puts '✅ All 300+ Moroccan data entries working perfectly!'
-puts '=' * 60
+puts '🆕 NEW NAMES DEMO:'
+puts ''
+puts '👨‍🦱 Masculin Names:'
+5.times { puts "  #{Zayef.first_name}" }
+puts ''
+puts '👩‍🦱 Féminin Names:'
+5.times { puts "  #{Zayef.first_name}" }
+puts ''
+
+puts '=' * 80
+puts '🆕 NEW FEATURES DEMO:'
+puts ''
+
+# Personal Data
+puts '👤 Personal Data:'
+puts "  Age: #{Zayef.age}"
+puts "  Gender: #{Zayef.gender}"
+puts "  Marital Status: #{Zayef.marital_status}"
+puts "  Blood Type: #{Zayef.blood_type}"
+puts "  Height: #{Zayef.height}cm"
+puts "  Weight: #{Zayef.weight}kg"
+puts "  Eye Color: #{Zayef.eye_color}"
+puts "  Hair Color: #{Zayef.hair_color}"
+puts "  Religion: #{Zayef.religion}"
+puts "  Nationality: #{Zayef.nationality}"
+puts "  Education: #{Zayef.education_level}"
+puts "  Income: #{Zayef.income_range}"
+puts ''
+
+# Business Data
+puts '💼 Business Data:'
+puts "  Industry: #{Zayef.industry}"
+puts "  Job Title: #{Zayef.job_title}"
+puts "  Company Size: #{Zayef.company_size}"
+puts "  Work Experience: #{Zayef.work_experience} years"
+puts "  Salary: #{Zayef.salary} MAD"
+puts "  Work Schedule: #{Zayef.work_schedule}"
+puts "  Business Type: #{Zayef.business_type}"
+puts "  Tax ID: #{Zayef.tax_id}"
+puts "  Trade Register: #{Zayef.trade_register}"
+puts ''
+
+# Cultural Data
+puts '🎭 Cultural & Lifestyle Data:'
+puts "  Hobby: #{Zayef.hobby}"
+puts "  Sport: #{Zayef.sport}"
+puts "  Music Genre: #{Zayef.music_genre}"
+puts "  Movie Genre: #{Zayef.movie_genre}"
+puts "  Social Media: #{Zayef.social_media}"
+puts "  Transportation: #{Zayef.transportation}"
+puts "  Pet: #{Zayef.pet}"
+puts "  Favorite Color: #{Zayef.favorite_color}"
+puts ''
+
+# Geographic Data
+puts '🗺️ Geographic Data:'
+puts "  Province: #{Zayef.province}"
+puts "  District: #{Zayef.district}"
+puts "  Landmark: #{Zayef.landmark}"
+puts "  Climate: #{Zayef.climate}"
+puts "  Timezone: #{Zayef.timezone}"
+puts "  Currency: #{Zayef.currency}"
+puts ''
+puts '🏙️ Enhanced District Demo:'
+puts "  Random district: #{Zayef.district}"
+puts "  Casablanca district: #{Zayef.district(city: 'Casablanca')}"
+puts "  Rabat district: #{Zayef.district(city: 'Rabat')}"
+puts "  Marrakech district: #{Zayef.district(city: 'Marrakech')}"
+puts ''
+
+puts '=' * 80
+puts '📊 PROFILE GENERATION:'
+puts ''
+
+# Complete Profiles
+puts '👤 Complete Personal Profile:'
+profile = Zayef.profile
+puts "  Name: #{profile[:name]}"
+puts "  Age: #{profile[:age]} (#{profile[:gender]})"
+puts "  Location: #{profile[:city]}, #{profile[:region]}"
+puts "  Profession: #{profile[:profession]}"
+puts "  Education: #{profile[:education_level]}"
+puts "  Income: #{profile[:income_range]}"
+puts "  Hobby: #{profile[:hobby]}"
+puts ''
+
+puts '🏥 Medical Profile (Perfect for DabaDoc):'
+medical = Zayef.medical_profile
+puts "  Patient: #{medical[:patient_name]}"
+puts "  Age: #{medical[:age]} (#{medical[:gender]})"
+puts "  Blood Type: #{medical[:blood_type]}"
+puts "  Height: #{medical[:height]}cm, Weight: #{medical[:weight]}kg"
+puts "  Specialty: #{medical[:medical_specialty]}"
+puts "  Doctor: #{medical[:doctor_name]}"
+puts "  Clinic: #{medical[:clinic_address]}"
+puts ''
+
+puts '🏢 Business Profile:'
+business = Zayef.business_profile
+puts "  Company: #{business[:company_name]}"
+puts "  Industry: #{business[:industry]}"
+puts "  Size: #{business[:company_size]}"
+puts "  Type: #{business[:business_type]}"
+puts "  Location: #{business[:city]}, #{business[:region]}"
+puts "  Tax ID: #{business[:tax_id]}"
+puts ''
+
+puts '🎨 Cultural Profile:'
+cultural = Zayef.cultural_profile
+puts "  Name: #{cultural[:name]}"
+puts "  City: #{cultural[:city]}"
+puts "  University: #{cultural[:university]}"
+puts "  Traditional Dish: #{cultural[:traditional_dish]}"
+puts "  Music: #{cultural[:music_genre]}"
+puts "  Festival: #{cultural[:festival]}"
+puts ''
+
+puts '=' * 80
+puts '🛠️ UTILITY FEATURES:'
+puts ''
+
+# Bulk Data Generation
+puts '📦 Bulk Data Generation:'
+puts "  Generating 3 personal profiles..."
+profiles = Zayef.bulk_data(3, 'personal')
+profiles.each_with_index do |profile, i|
+  puts "    Profile #{i+1}: #{profile[:name]} (#{profile[:age]} years, #{profile[:profession]})"
+end
+puts ''
+
+# Export Features
+puts '📤 Export Features:'
+puts "  JSON Export: #{Zayef.export_to_json(2, 'business').length} characters"
+puts "  CSV Export: #{Zayef.export_to_csv(2, 'medical').split('\n').length} lines"
+puts ''
+
+puts '=' * 80
+puts '✅ ZAYEF ENHANCED FEATURES SUMMARY:'
+puts ''
+puts '🎯 NEW DATA CATEGORIES:'
+puts '  • Personal: Age, gender, marital status, physical attributes, etc.'
+puts '  • Business: Industry, job titles, company info, tax IDs, etc.'
+puts '  • Cultural: Hobbies, sports, music, movies, social media, etc.'
+puts '  • Geographic: Provinces, districts, landmarks, climate, etc.'
+puts ''
+puts '🛠️ NEW UTILITY FEATURES:'
+puts '  • Complete profile generation (personal, business, medical, cultural)'
+puts '  • Bulk data generation with customizable counts'
+puts '  • Export to JSON and CSV formats'
+puts '  • Random data generation by category'
+puts ''
+puts '📊 TOTAL DATA POINTS: 500+ authentic Moroccan entries'
+puts '🏥 Perfect for DabaDoc medical system integration'
+puts '🇲🇦 100% authentic Moroccan data'
+puts '=' * 80
+
+

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