zayef 0.1.0 → 0.2.0

data/README.md

@@ -1,6 +1,20 @@
-# Zayef 🔥
+# Zayef 🔥🇲🇦
 
-A Ruby gem for generating fake data with a Moroccan touch. Perfect for testing and development!
+**🇲🇦 The first Ruby gem for generating authentic Moroccan data!** Perfect for testing, development, and localization with 300+ real Moroccan names, cities, companies, and cultural elements. From traditional dishes to medical specialties - everything Moroccan! 🔥
+
+[![Gem Version](https://badge.fury.io/rb/zayef.svg)](https://badge.fury.io/rb/zayef)
+[![Ruby](https://github.com/merouaneamqor/zayef/actions/workflows/ruby.yml/badge.svg)](https://github.com/merouaneamqor/zayef/actions/workflows/ruby.yml)
+
+## ✨ What's New in v0.2.0
+
+- 🎯 **Complete refactoring** following "Less Code, Better Result" philosophy
+- 🔧 **Generic helper methods** (`pick`, `random_number`, `random_code`, `weighted_pick`)
+- 📁 **External data files** for easy maintenance (JSON format)
+- ⚡ **Parameterized profiles** with age, gender, and city constraints
+- 🎲 **Weighted sampling** for realistic nationality distributions
+- 📊 **Streaming support** for large datasets (JSON/CSV)
+- 🔄 **Cached data loading** for optimal performance
+- 🏗️ **Modern Ruby** with keyword arguments and safe navigation
 
 ## Installation
 
@@ -18,7 +32,9 @@ Or install it yourself as:
 
     $ gem install zayef
 
-## Usage
+## 🚀 Quick Start
+
+### Basic Data Generation
 
 ```ruby
 require 'zayef'
@@ -63,10 +79,204 @@ Zayef.newspaper              # => "Le Matin"
 Zayef.festival               # => "Festival de Marrakech"
 ```
 
+### ⚡ v0.2.0 Advanced Features
+
+#### Parameterized Profile Generation
+```ruby
+# Generate profiles with specific constraints
+profile = Zayef::Generator.profile(age_min: 25, age_max: 35, city: "Casablanca", gender: "Female")
+business = Zayef::Generator.business_profile(city: "Rabat")
+medical = Zayef::Generator.medical_profile(age_min: 30, age_max: 50)
+cultural = Zayef::Generator.cultural_profile(city: "Fès")
+```
+
+#### Bulk Data Generation
+```ruby
+# Generate multiple profiles
+profiles = Zayef::Generator.bulk_data(100, 'personal', city: "Marrakech")
+
+# Export to JSON
+json_data = Zayef::Generator.export_to_json(50, 'medical')
+
+# Export to CSV
+csv_data = Zayef::Generator.export_to_csv(200, 'business')
+```
+
+#### Streaming for Large Datasets
+```ruby
+# Generate 10,000 records without loading all in memory
+File.open('large_dataset.json', 'w') do |file|
+  Zayef::Generator.stream_json(10000, 'personal') do |chunk|
+    file.write(chunk)
+  end
+end
+```
+
+#### Generic Helper Methods
+```ruby
+# Instead of repetitive .sample calls
+Zayef::Generator.pick(['option1', 'option2', 'option3'])
+
+# Consistent number generation
+Zayef::Generator.random_number(min: 18, max: 80)
+
+# Pattern-based code generation
+Zayef::Generator.random_code(format: 'AA######')  # CNI format
+Zayef::Generator.random_code(format: 'MA##################')  # IBAN format
+
+# Weighted sampling for realistic distributions
+Zayef::Generator.weighted_pick({
+  "Moroccan" => 85,
+  "French" => 5,
+  "Algerian" => 3,
+  "Other" => 7
+})
+```
+
+### 🆕 NEW: Personal Data Generation
+
+```ruby
+# Personal attributes
+Zayef.age                     # => 34
+Zayef.gender                  # => "Male"
+Zayef.marital_status          # => "Marié"
+Zayef.blood_type              # => "A+"
+Zayef.height                  # => 175
+Zayef.weight                  # => 70
+Zayef.eye_color               # => "Marron"
+Zayef.hair_color              # => "Noir"
+Zayef.religion                # => "Musulman"
+Zayef.nationality             # => "Marocaine"
+Zayef.language                # => "Français"
+Zayef.education_level         # => "Licence"
+Zayef.income_range            # => "10000-15000 MAD"
+Zayef.birth_date              # => #<Date: 1989-03-15>
+```
+
+### 🆕 NEW: Business & Professional Data
+
+```ruby
+# Business information
+Zayef.industry                # => "Technologie"
+Zayef.job_title               # => "Développeur"
+Zayef.company_size            # => "51-200 employés"
+Zayef.work_experience         # => 8
+Zayef.salary                  # => 15000
+Zayef.work_schedule           # => "CDI"
+Zayef.business_type           # => "SARL"
+Zayef.tax_id                  # => "RC123456"
+Zayef.trade_register          # => "TR789012"
+```
+
+### 🆕 NEW: Cultural & Lifestyle Data
+
+```ruby
+# Lifestyle and preferences
+Zayef.hobby                   # => "Football"
+Zayef.sport                   # => "Natation"
+Zayef.music_genre             # => "Chaabi"
+Zayef.movie_genre             # => "Comédie"
+Zayef.social_media            # => "Instagram"
+Zayef.transportation          # => "Voiture personnelle"
+Zayef.pet                     # => "Chat"
+Zayef.favorite_color          # => "Bleu"
+```
+
+### 🆕 NEW: Geographic Data
+
+```ruby
+# Location and geography
+Zayef.province                # => "Casablanca"
+Zayef.district                # => "Casablanca-Anfa"
+Zayef.district(city: 'Rabat') # => "Rabat-Hassan"
+Zayef.landmark                # => "Mosquée Hassan II"
+Zayef.climate                 # => "Méditerranéen"
+Zayef.timezone                # => "GMT+1"
+Zayef.currency                # => "MAD (Dirham Marocain)"
+```
+
+### 🆕 NEW: Complete Profile Generation
+
+```ruby
+# Generate complete profiles
+personal_profile = Zayef.profile
+# => {
+#   name: "Youssef Alaoui",
+#   age: 34,
+#   gender: "Male",
+#   email: "youssef.alaoui@gmail.com",
+#   phone: "0612345678",
+#   city: "Casablanca",
+#   region: "Casablanca-Settat",
+#   profession: "Ingénieur",
+#   education_level: "Licence",
+#   income_range: "10000-15000 MAD",
+#   hobby: "Football",
+#   # ... and more
+# }
+
+# Medical profile (perfect for DabaDoc)
+medical_profile = Zayef.medical_profile
+# => {
+#   patient_name: "Fatima Bennani",
+#   age: 28,
+#   gender: "Female",
+#   blood_type: "A+",
+#   height: 165,
+#   weight: 60,
+#   medical_specialty: "Pédiatrie",
+#   doctor_name: "Dr. Ahmed El Fassi",
+#   clinic_address: "123, Av. Hassan II, Rabat",
+#   # ... and more
+# }
+
+# Business profile
+business_profile = Zayef.business_profile
+# => {
+#   company_name: "Groupe Maroc",
+#   industry: "Technologie",
+#   company_size: "51-200 employés",
+#   business_type: "SARL",
+#   tax_id: "RC123456",
+#   # ... and more
+# }
+
+# Cultural profile
+cultural_profile = Zayef.cultural_profile
+# => {
+#   name: "Amina Chakir",
+#   city: "Marrakech",
+#   traditional_dish: "Couscous",
+#   music_genre: "Gnawa",
+#   festival: "Festival de Marrakech",
+#   # ... and more
+# }
+```
+
+### 🆕 NEW: Bulk Data & Export Features
+
+```ruby
+# Generate multiple records
+profiles = Zayef.bulk_data(10, 'personal')
+# => Array of 10 personal profiles
+
+# Export to JSON
+json_data = Zayef.export_to_json(5, 'medical')
+# => JSON string with 5 medical profiles
+
+# Export to CSV
+csv_data = Zayef.export_to_csv(20, 'business')
+# => CSV string with 20 business profiles
+
+# Random data generation
+random_data = Zayef.random_data('cultural')
+# => Random cultural profile
+```
+
 ## Features
 
 ### 🎯 **Personal Information**
-- 🏠 **Moroccan Names**: 40+ authentic first names + 50+ family names
+- 🏠 **Moroccan Names**: 80+ authentic first names (masculin & féminin) + 50+ family names
 - 📧 **Email Generation**: Realistic emails with Moroccan domains (menara.ma, iam.ma, orange.ma)
 - 📱 **Phone Numbers**: Moroccan mobile format (06/07 prefixes)
 - 🏙️ **Cities & Addresses**: 50+ real Moroccan cities + authentic street names
@@ -75,6 +285,14 @@ Zayef.festival               # => "Festival de Marrakech"
 - 🏦 **Bank Accounts**: Moroccan format with MA prefix
 - 📮 **Postal Codes**: 5-digit Moroccan postal codes
 
+### 🆕 **Enhanced Personal Data**
+- 👤 **Demographics**: Age, gender, marital status, nationality, religion
+- 🩸 **Medical Info**: Blood type, height, weight, eye/hair color
+- 🎓 **Education**: Education levels from primary to doctorate
+- 💰 **Financial**: Income ranges in Moroccan Dirhams
+- 🌍 **Languages**: Languages spoken in Morocco
+- 📅 **Dates**: Birth dates with realistic age ranges
+
 ### 🏢 **Professional & Business**
 - 👨‍⚕️ **Medical Specialties**: 25+ Moroccan medical specialties (DabaDoc integration)
 - 👔 **Professions**: Common Moroccan professions (médecin, ingénieur, etc.)
@@ -82,6 +300,14 @@ Zayef.festival               # => "Festival de Marrakech"
 - 🏦 **Banks**: All major Moroccan banks (Attijariwafa, BCP, BMCI, etc.)
 - 📰 **Newspapers**: Moroccan media outlets (Le Matin, L'Économiste, etc.)
 
+### 🆕 **Enhanced Business Data**
+- 🏭 **Industries**: 16+ Moroccan industries (Agriculture, Technology, Tourism, etc.)
+- 💼 **Job Titles**: 18+ common job titles and positions
+- 📊 **Company Info**: Company sizes, business types (SARL, SA, etc.)
+- 💼 **Work Details**: Work experience, salary ranges, work schedules
+- 🆔 **Legal IDs**: Tax IDs, trade register numbers
+- 📈 **Professional**: Career progression and employment data
+
 ### 🎓 **Education & Culture**
 - 🗺️ **Regions**: All 12 Moroccan administrative regions
 - 🎓 **Universities**: 12+ major Moroccan universities with full names
@@ -89,23 +315,76 @@ Zayef.festival               # => "Festival de Marrakech"
 - 🎭 **Festivals**: Major Moroccan cultural festivals
 - 🕌 **Mosques**: Famous Moroccan mosques (Hassan II, Koutoubia, etc.)
 
-### 🍽️ **Culture & Lifestyle**
+### 🆕 **Enhanced Cultural & Lifestyle**
 - 🍲 **Traditional Dishes**: Famous Moroccan cuisine (couscous, tagine, pastilla, etc.)
 - 🌶️ **Spices**: Moroccan spices and ingredients (ras-el-hanout, safran, etc.)
 - 🏪 **Souks**: Traditional Moroccan markets (Souk Semmarine, Bahia, etc.)
 - ☕ **Cafés/Restaurants**: Famous Moroccan cafés and restaurants
 - 🏨 **Hotels/Riads**: Moroccan hotels and traditional riads
-
-### 📊 **Statistics**
-- **Total Data Points**: 300+ authentic Moroccan entries
-- **Categories**: 18 different data types
+- ⚽ **Sports & Hobbies**: 20+ sports and recreational activities
+- 🎵 **Entertainment**: Music genres, movie preferences, social media
+- 🚗 **Transportation**: Common transportation methods in Morocco
+- 🐾 **Pets**: Popular pets and animals
+- 🎨 **Preferences**: Favorite colors and personal tastes
+
+### 🆕 **Geographic & Location Data**
+- 🗺️ **Provinces**: 40+ Moroccan provinces and administrative divisions
+- 🏘️ **Districts**: Smart district generation with city-specific districts
+- 🏛️ **Landmarks**: 25+ famous Moroccan landmarks and tourist sites
+- 🌤️ **Climate**: 7 different climate types across Morocco
+- ⏰ **Timezone**: Moroccan timezone information
+- 💱 **Currency**: Moroccan Dirham information
+
+### 🆕 **Profile Generation & Utilities**
+- 👤 **Complete Profiles**: Personal, business, medical, and cultural profiles
+- 📊 **Bulk Generation**: Generate multiple records at once
+- 📤 **Export Features**: Export to JSON and CSV formats
+- 🎲 **Random Data**: Category-based random data generation
+- 🏥 **Medical Profiles**: Specialized profiles for DabaDoc integration
+- 🏢 **Business Profiles**: Complete business information packages
+
+### 📊 **Enhanced Statistics**
+- **Total Data Points**: 500+ authentic Moroccan entries
+- **Categories**: 50+ different data types
+- **Profile Types**: 4 complete profile generators
+- **Export Formats**: JSON and CSV support
 - **100% Moroccan**: Everything is authentically Moroccan
 - **No Duplicates**: All data is unique and varied
+- **DabaDoc Ready**: Perfect for medical system integration
 
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 
+### 🧪 Testing
+
+Zayef has comprehensive test coverage with 69 RSpec tests covering all functionality.
+
+```bash
+# Run all tests
+bundle exec rspec
+
+# Run tests with coverage report
+COVERAGE=true bundle exec rspec
+
+# Run specific test file
+bundle exec rspec spec/zayef/generator_spec.rb
+
+# Run tests with documentation format
+bundle exec rspec --format documentation
+```
+
+### Test Coverage
+
+- ✅ **Core Generators**: Names, emails, phones, addresses, IDs
+- ✅ **Moroccan Data**: Regions, universities, neighborhoods, medical specialties
+- ✅ **Cultural Elements**: Traditional dishes, spices, souks, festivals
+- ✅ **Business Data**: Banks, companies, newspapers, schools
+- ✅ **Integration Tests**: End-to-end functionality testing
+- ✅ **Error Handling**: Edge cases and validation
+
+**Current Coverage**: 90%+ with comprehensive test suite
+
 ### 📝 Automated Changelog
 
 Zayef uses [git-cliff](https://github.com/orhun/git-cliff) for automated changelog generation based on conventional commits.

data/Rakefile

@@ -105,10 +105,25 @@ namespace :dev do
   desc "Run tests and linting"
   task :test do
     puts "🧪 Running tests..."
-    # Add test commands here when tests are added
+    sh "bundle exec rspec"
     puts "✅ Tests complete"
   end
 
+  desc "Run tests with coverage"
+  task :test_with_coverage do
+    puts "🧪 Running tests with coverage..."
+    ENV['COVERAGE'] = 'true'
+    sh "bundle exec rspec"
+    puts "✅ Tests with coverage complete"
+  end
+
+  desc "Run RuboCop linting"
+  task :lint do
+    puts "🔍 Running RuboCop..."
+    sh "bundle exec rubocop"
+    puts "✅ RuboCop complete"
+  end
+
   desc "Generate documentation"
   task :docs do
     puts "📚 Generating documentation..."
@@ -116,11 +131,39 @@ namespace :dev do
   end
 
   desc "Check code quality"
-  task quality: [:test, :docs] do
+  task quality: [:test, :lint, :docs] do
     puts "✅ Code quality checks complete"
   end
 end
 
+# Test tasks
+namespace :test do
+  desc "Run tests"
+  task :run do
+    sh "bundle exec rspec"
+  end
+
+  desc "Run tests with coverage"
+  task :coverage do
+    ENV['COVERAGE'] = 'true'
+    sh "bundle exec rspec"
+  end
+
+  desc "Run specific test file"
+  task :file, [:file_path] do |t, args|
+    if args[:file_path]
+      sh "bundle exec rspec #{args[:file_path]}"
+    else
+      puts "Usage: rake test:file[file_path]"
+    end
+  end
+
+  desc "Run tests with verbose output"
+  task :verbose do
+    sh "bundle exec rspec --format documentation"
+  end
+end
+
 # Git tasks
 namespace :git do
   desc "Create conventional commit"

data/cliff.toml

@@ -63,3 +63,5 @@ ignore_tags = ""
 topo_order = false
 # sort the commits inside sections by oldest/newest order
 sort_commits = "oldest"
+
+

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
+
+