zayef 0.1.1 → 0.2.0.1

data/REFACTORING.md

@@ -0,0 +1,220 @@
+# Zayef Generator Refactoring Summary
+
+## 🎯 Overview
+
+The Zayef generator has been completely refactored to follow the "Less Code, Better Result" philosophy, reducing repetition, improving maintainability, and adding better consistency.
+
+## ✅ Key Improvements
+
+### 1. Generic Helper Methods
+- **`pick(list)`**: Replaces repetitive `.sample` calls
+- **`random_number(min:, max:)`**: Consistent number generation
+- **`random_code(format:)`**: Pattern-based code generation (CNI, IBAN, etc.)
+- **`weighted_pick(weights_hash)`**: Realistic distribution sampling
+
+### 2. External Data Files
+- **`moroccan_names.json`**: First names (male/female) and last names
+- **`moroccan_geography.json`**: Cities, regions, districts, landmarks
+- **`moroccan_culture.json`**: Dishes, spices, festivals, hobbies, etc.
+- **`moroccan_business.json`**: Banks, industries, professions, etc.
+
+### 3. Data Loader Module
+- **Cached loading**: Data loaded once and cached for performance
+- **Convenience methods**: Direct access to specific data categories
+- **Error handling**: Graceful fallbacks for missing files
+- **Reload capability**: Clear cache and reload data when needed
+
+### 4. Parameterization Support
+```ruby
+# Age constraints
+profile = Zayef::Generator.profile(age_min: 25, age_max: 35)
+
+# City constraints
+profile = Zayef::Generator.profile(city: "Rabat")
+
+# Gender constraints
+profile = Zayef::Generator.profile(gender: "Female")
+
+# Combined constraints
+profile = Zayef::Generator.profile(age_min: 30, age_max: 40, city: "Casablanca", gender: "Male")
+```
+
+### 5. Consistency Improvements
+- **City-District matching**: Districts always match their cities
+- **Email consistency**: Uses generated first/last names
+- **Address consistency**: Addresses use the same city as the profile
+- **Gender-specific names**: First names can be gender-specific
+
+### 6. Weighted Sampling
+```ruby
+# Realistic nationality distribution
+nationality = Zayef::Generator.nationality  # 85% Moroccan, 5% French, etc.
+
+# Custom weighted sampling
+result = Zayef::Generator.weighted_pick({
+  "Option A" => 70,
+  "Option B" => 20,
+  "Option C" => 10
+})
+```
+
+### 7. Streaming Support
+```ruby
+# Large dataset generation without memory issues
+Zayef::Generator.stream_json(10000, 'personal') do |chunk|
+  file.write(chunk)
+end
+
+Zayef::Generator.stream_csv(50000, 'business') do |line|
+  csv_file.write(line)
+end
+```
+
+## 📊 Before vs After
+
+### Before (Repetitive)
+```ruby
+def first_name
+  MOROCCAN_FIRST_NAMES.sample
+end
+
+def last_name
+  MOROCCAN_LAST_NAMES.sample
+end
+
+def city
+  MOROCCAN_CITIES.sample
+end
+
+def cni_number
+  letters = ('A'..'Z').to_a.sample(2).join
+  numbers = rand(100000..999999)
+  "#{letters}#{numbers}"
+end
+```
+
+### After (DRY & Generic)
+```ruby
+def first_name(gender = nil)
+  pick(DataLoader.first_names(gender))
+end
+
+def last_name
+  pick(DataLoader.last_names)
+end
+
+def city
+  pick(DataLoader.cities)
+end
+
+def cni_number
+  random_code(format: 'AA######')
+end
+```
+
+## 🚀 Usage Examples
+
+### Basic Generation
+```ruby
+# Simple data generation
+name = Zayef::Generator.name
+email = Zayef::Generator.email
+phone = Zayef::Generator.phone
+```
+
+### Profile Generation
+```ruby
+# Complete profile with constraints
+profile = Zayef::Generator.profile(
+  age_min: 25,
+  age_max: 35,
+  city: "Rabat",
+  gender: "Female"
+)
+```
+
+### Bulk Generation
+```ruby
+# Generate multiple profiles
+profiles = Zayef::Generator.bulk_data(100, 'personal', city: "Casablanca")
+
+# 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 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
+```
+
+## 🔧 Data Management
+
+### Adding New Data
+1. Edit the appropriate JSON file in `data/` directory
+2. Add convenience method to `DataLoader` if needed
+3. Use `DataLoader.reload!` to refresh cached data
+
+### Custom Data Sources
+```ruby
+# Load custom data
+custom_data = Zayef::DataLoader.load_json('custom_data.json')
+
+# Use in generator
+def custom_field
+  pick(custom_data[:custom_list])
+end
+```
+
+## 📈 Performance Improvements
+
+- **Cached data loading**: Data loaded once and reused
+- **Generic helpers**: Reduced method call overhead
+- **Streaming support**: Memory-efficient large dataset generation
+- **Weighted sampling**: Realistic distributions without repetition
+
+## 🎨 Code Quality
+
+- **DRY principle**: Eliminated repetitive code patterns
+- **Single responsibility**: Each method has a clear purpose
+- **Consistent naming**: All methods follow the same conventions
+- **Error handling**: Graceful fallbacks for missing data
+- **Documentation**: Clear comments and examples
+
+## 🔮 Future Enhancements
+
+- **YAML support**: Alternative data format
+- **Database integration**: Load data from databases
+- **Custom distributions**: User-defined weighted sampling
+- **Validation**: Data consistency checks
+- **Internationalization**: Support for other countries
+
+## 📝 Migration Guide
+
+### For Existing Code
+1. Replace `.sample` calls with `pick()`
+2. Use `random_number(min:, max:)` for ranges
+3. Use `random_code(format:)` for formatted codes
+4. Add parameterization to profile methods
+5. Use `DataLoader` for direct data access
+
+### Breaking Changes
+- Some method signatures changed to support parameters
+- Data constants moved to external files
+- Profile methods now return consistent data
+
+## 🧪 Testing
+
+Run the example script to see all improvements in action:
+```bash
+ruby examples/refactored_usage.rb
+```
+
+This demonstrates all the new features and improvements in a practical way.

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/data/moroccan_business.json

@@ -0,0 +1,97 @@
+{
+  "banks": [
+    "Attijariwafa Bank", "Banque Centrale Populaire",
+    "BMCI", "Banque Marocaine pour le Commerce et l'Industrie",
+    "Société Générale Maroc", "Crédit du Maroc",
+    "Banque Marocaine du Commerce Extérieur", "CIH Bank",
+    "Crédit Immobilier et Hôtelier", "Al Barid Bank",
+    "Bank Al Maghrib", "CFG Bank",
+    "Crédit Agricole du Maroc", "Umnia Bank"
+  ],
+  "industries": [
+    "Agriculture", "Textile", "Tourisme", "Immobilier", 
+    "Banque et Finance", "Télécommunications", "Énergie", 
+    "Mines", "Transport", "Commerce", "Santé", "Éducation", 
+    "Technologie", "Artisanat", "Pêche", "Construction"
+  ],
+  "company_sizes": [
+    "1-10 employés", "11-50 employés", "51-200 employés", 
+    "201-500 employés", "501-1000 employés", "1000+ employés"
+  ],
+  "business_types": [
+    "SARL", "SA", "SNC", "SAS", "Auto-entrepreneur", 
+    "Coopérative", "Association", "Fondation", "ONG"
+  ],
+  "job_titles": [
+    "Directeur Général", "Directeur Commercial", "Directeur RH", 
+    "Chef de Projet", "Ingénieur", "Développeur", "Designer", 
+    "Comptable", "Secrétaire", "Commercial", "Technicien", 
+    "Ouvrier", "Agent de Sécurité", "Réceptionniste", 
+    "Chef de Cuisine", "Serveur", "Chauffeur", "Nettoyeur"
+  ],
+  "professions": [
+    "Médecin", "Ingénieur", "Enseignant",
+    "Avocat", "Notaire", "Architecte",
+    "Pharmacien", "Commerçant", "Artisan",
+    "Agriculteur", "Fonctionnaire", "Journaliste",
+    "Banquier", "Comptable", "Informaticien",
+    "Électricien", "Plombier", "Menuisier",
+    "Coiffeur", "Serveur", "Chauffeur",
+    "Garde-malade", "Secrétaire", "Traducteur",
+    "Guide touristique", "Vendeur"
+  ],
+  "work_schedules": [
+    "Temps plein", "Temps partiel", "CDI", "CDD", 
+    "Stage", "Freelance", "Consultant", "Télétravail"
+  ],
+  "medical_specialties": [
+    "Médecine générale", "Pédiatrie", "Cardiologie",
+    "Dermatologie", "Ophtalmologie", "ORL",
+    "Gynécologie Obstétrique", "Chirurgie générale",
+    "Médecine interne", "Psychiatrie", "Radiologie",
+    "Anesthésie-réanimation", "Néphrologie",
+    "Hépatologie", "Gastro-entérologie", "Endocrinologie",
+    "Rhumatologie", "Neurologie", "Urologie",
+    "Traumatologie", "Orthopédie", "Chirurgie plastique",
+    "Chirurgie vasculaire", "Médecine du travail",
+    "Médecine légale", "Médecine nucléaire",
+    "Médecine physique", "Oncologie"
+  ],
+  "education_levels": [
+    "Analphabète", "Primaire", "Collège", "Lycée", 
+    "Baccalauréat", "BTS", "Licence", "Master", "Doctorat"
+  ],
+  "income_ranges": [
+    "0-3000 MAD", "3000-6000 MAD", "6000-10000 MAD", 
+    "10000-15000 MAD", "15000-25000 MAD", "25000+ MAD"
+  ],
+  "languages": [
+    "Arabe", "Français", "Amazigh", "Anglais", "Espagnol", 
+    "Italien", "Allemand", "Néerlandais", "Portugais"
+  ],
+  "marital_statuses": [
+    "Célibataire", "Marié", "Divorcé", "Veuf"
+  ],
+  "blood_types": [
+    "A+", "A-", "B+", "B-", "AB+", "AB-", "O+", "O-"
+  ],
+  "eye_colors": [
+    "Marron", "Noir", "Bleu", "Vert"
+  ],
+  "hair_colors": [
+    "Noir", "Brun", "Châtain", "Blond"
+  ],
+  "religions": [
+    "Musulman", "Chrétien", "Juif", "Autre"
+  ],
+  "nationalities": {
+    "Marocaine": 85,
+    "Française": 5,
+    "Algérienne": 3,
+    "Tunisienne": 2,
+    "Espagnole": 2,
+    "Italienne": 1,
+    "Belge": 1,
+    "Autre": 1
+  }
+}

data/data/moroccan_culture.json

@@ -0,0 +1,127 @@
+{
+  "traditional_dishes": [
+    "Couscous", "Tagine", "Pastilla", "Harira",
+    "Rfissa", "Tanjia", "Mechoui", "Briouates",
+    "Msemen", "Meloui", "Baghrir", "Khobz",
+    "Bissara", "Lentilles aux merguez",
+    "Khlia", "Merguez", "Sardines grillées",
+    "Daqous aux olives", "Kefta aux œufs",
+    "Poulet aux citrons confits",
+    "Tajine aux pruneaux", "Tajine aux abricots",
+    "Chorba frik", "Soupe de poisson",
+    "Maâqouda", "Zaalouk"
+  ],
+  "spices": [
+    "Ras-el-hanout", "Safran", "Cannelle",
+    "Curcuma", "Gingembre", "Paprika",
+    "Cumin", "Coriandre", "Cardamome",
+    "Muscade", "Poivre noir", "Piment",
+    "Fenouil", "Anis étoilé", "Clous de girofle",
+    "Laurier", "Citron confit", "Olives",
+    "Amandes", "Pistaches", "Noix",
+    "Miel d'oranger", "Fleur d'oranger",
+    "Huile d'argan", "Beurre clarifié"
+  ],
+  "souks": [
+    "Souk Semmarine", "Souk El Kébir", "Souk El Attarine",
+    "Souk Zitoun El Jdid", "Souk El Hadadine",
+    "Souk El Bahia", "Souk Smarine", "Souk El Ghezel",
+    "Souk El Koutoubine", "Souk El Abid",
+    "Souk Sebbaghine", "Souk Cherratine",
+    "Souk Nejjarine", "Marché Central",
+    "Souk Al Fassia", "Souk El Joutia"
+  ],
+  "restaurants": [
+    "Café Clock", "Nomad", "Le Jardin",
+    "Café Bousafsaf", "Dar Moha", "Al Fassia",
+    "Café de France", "Le Jardin d'Essai",
+    "Café Hafa", "Nomad Café", "Dar Essalam",
+    "Café Central", "Le Jardin Secret",
+    "Café Arabe", "Dar El Hana"
+  ],
+  "hotels": [
+    "Riad Kniza", "Palmeraie Palace",
+    "Hotel Sahrai", "Riad Al Fassia",
+    "Hotel El Andalous", "Riad El Cadi",
+    "Hotel Atlas Medina", "Riad Dar Anika",
+    "Hotel Nomade", "Riad Zitouna",
+    "Hotel Al Fassia", "Riad Les Jardin"
+  ],
+  "mosques": [
+    "Mosquée Hassan II", "Mosquée Koutoubia",
+    "Mosquée Al Quaraouiyine", "Mosquée Bahia",
+    "Mosquée Saadian", "Mosquée Moulay Idriss",
+    "Mosquée El Badi", "Mosquée Lalla Aouda",
+    "Mosquée Tin Mal", "Mosquée Nejjarine",
+    "Mosquée Cherratine", "Mosquée El Glaoui"
+  ],
+  "schools": [
+    "Lycée Descartes", "Lycée Lyautey",
+    "Lycée Moulay Youssef", "Lycée Mohammed V",
+    "École Américaine", "Lycée Français",
+    "École Mission La Sallle", "Lycée Victor Hugo",
+    "École Sainte Marie", "Lycée Ibn Khaldoun",
+    "École Al Khansaa", "Lycée Ibn Sina"
+  ],
+  "universities": [
+    "Université Mohammed V de Rabat", "Université Hassan II de Casablanca",
+    "Université Ibn Tofail de Kénitra", "Université Cadi Ayyad de Marrakech",
+    "Université Abdelmalek Essaâdi de Tanger", "Université Sidi Mohammed Ben Abdellah de Fès",
+    "Université Ibn Zohr d'Agadir", "Université Chouaib Doukkali d'El Jadida",
+    "Université Sultan Moulay Slimane de Beni Mellal", "Université Mohammed Premier d'Oujda",
+    "Université Hassan Ier de Settat", "École Polytechnique de l'Université Internationale de Rabat"
+  ],
+  "newspapers": [
+    "Le Matin", "L'Économiste",
+    "Libération", "Aujourd'hui le Maroc",
+    "Al Alam", "Assabah",
+    "Bayane Al Yaoum", "Al Akhbar",
+    "Al Massae", "Al Ahdath Al Maghribia",
+    "Al Ittihad Al Ichtiraki", "Rissalat Al Oumma"
+  ],
+  "festivals": [
+    "Festival de Marrakech", "Festival de Fès",
+    "Festival de Tan-Tan", "Festival de Rabat",
+    "Festival Mawazine", "Festival Jazzablanca",
+    "Festival de Taroudant", "Festival de Meknès",
+    "Festival de Ouarzazate", "Festival de Tanger",
+    "Festival de Chefchaouen", "Festival de Asilah"
+  ],
+  "music_genres": [
+    "Chaabi", "Gnawa", "Rai", "Pop", "Rock", "Hip-Hop", 
+    "Rap", "Jazz", "Classique", "Électronique", "Reggae", 
+    "Blues", "Country", "Folk", "Metal", "R&B"
+  ],
+  "movie_genres": [
+    "Action", "Comédie", "Drame", "Romance", "Thriller", 
+    "Horreur", "Science-fiction", "Fantasy", "Documentaire", 
+    "Animation", "Biographie", "Guerre", "Western", "Musical"
+  ],
+  "hobbies": [
+    "Football", "Basketball", "Tennis", "Natation", "Course à pied", 
+    "Musique", "Danse", "Lecture", "Cinéma", "Voyage", "Cuisine", 
+    "Photographie", "Peinture", "Jardinage", "Jeux vidéo", 
+    "Échecs", "Pêche", "Randonnée", "Yoga", "Méditation"
+  ],
+  "sports": [
+    "Football", "Basketball", "Tennis", "Natation", "Athlétisme", 
+    "Boxe", "Judo", "Karate", "Cyclisme", "Volleyball", 
+    "Handball", "Rugby", "Golf", "Équitation", "Escalade"
+  ],
+  "social_media": [
+    "Facebook", "Instagram", "Twitter", "TikTok", "YouTube", 
+    "LinkedIn", "Snapchat", "WhatsApp", "Telegram", "Discord"
+  ],
+  "transportation": [
+    "Voiture personnelle", "Taxi", "Bus", "Train", "Tramway", 
+    "Moto", "Vélo", "Marche", "Covoiturage", "Uber/Careem"
+  ],
+  "pets": [
+    "Chat", "Chien", "Oiseau", "Poisson", "Hamster", 
+    "Lapin", "Tortue", "Serpent", "Aucun animal"
+  ],
+  "colors": [
+    "Rouge", "Bleu", "Vert", "Jaune", "Orange", "Violet", 
+    "Rose", "Noir", "Blanc", "Gris", "Marron", "Turquoise"
+  ]
+}

data/data/moroccan_geography.json

@@ -0,0 +1,99 @@
+{
+  "cities": [
+    "Casablanca", "Rabat", "Marrakech", "Fès", "Meknès", "Agadir", "Tanger",
+    "Oujda", "Kenitra", "Tétouan", "Safi", "Mohammedia", "El Jadida",
+    "Beni Mellal", "Khouribga", "Settat", "Larache", "Ksar El Kebir",
+    "Nador", "Berkane", "Errachidia", "Khemisset", "Ifrane", "Azrou",
+    "Chefchaouen", "Al Hoceima", "Taza", "Sidi Kacem", "El Kelaa",
+    "Ben Slimane", "Khémisset", "Sidi Bennour", "Youssoufia",
+    "Guelmim", "Taroudant", "Tinghir", "Zagora", "Sidi Ifni",
+    "Laâyoune", "Dakhla", "Boujdour", "Tan-Tan",
+    "Taourirt", "Ouarzazate", "Midelt", "Figuig", "Jerada",
+    "Sefrou", "Boulemane", "Taounate", "Guercif", "Imzouren",
+    "Fnideq", "Martil", "Saidia", "Ahfir", "Aklim",
+    "Tiznit", "Chtouka", "Ait Baha", "Biougra",
+    "Tata", "Foum Zguid", "Assa", "Zag",
+    "Smara", "Boukraa", "Bir Anzarane",
+    "Skhirat", "Temara", "Sale", "Skhirat",
+    "Bouskoura", "Mediouna", "Tit Mellil",
+    "Aïn Harrouda", "Harhoura", "Moulay Bousselham",
+    "Souk El Arbaa", "El Jadida", "Dar Bouazza",
+    "El Mansouria", "Bouskoura", "Mediouna",
+    "Nouaceur", "Berrechid", "Ben Ahmed",
+    "El Gara", "Bouknadel", "Skhirat", "Temara"
+  ],
+  "regions": [
+    "Casablanca-Settat", "Rabat-Salé-Kénitra",
+    "Fès-Meknès", "Marrakech-Safi",
+    "Tanger-Tétouan-Al Hoceïma",
+    "Oriental", "Béni Mellal-Khénifra",
+    "Drâa-Tafilalet", "Souss-Massa",
+    "Guelmim-Oued Noun", "Laâyoune-Sakia El Hamra",
+    "Dakhla-Oued Ed-Dahab"
+  ],
+  "provinces": [
+    "Casablanca", "Rabat", "Marrakech", "Fès", "Meknès",
+    "Agadir", "Tanger", "Oujda", "Kenitra", "Tétouan",
+    "Safi", "Mohammedia", "El Jadida", "Beni Mellal",
+    "Khouribga", "Settat", "Larache", "Nador", "Berkane",
+    "Errachidia", "Khemisset", "Ifrane", "Chefchaouen",
+    "Al Hoceima", "Taza", "Guelmim", "Taroudant",
+    "Laâyoune", "Dakhla", "Ouarzazate", "Midelt",
+    "Essaouira", "Azilal", "Boujdour", "Sidi Ifni",
+    "Tan-Tan", "Smara", "Fquih Ben Salah", "Sidi Kacem",
+    "Sidi Slimane", "Tinghir", "Zagora", "Taourirt",
+    "Jerada", "Guercif", "Chichaoua", "Youssoufia"
+  ],
+  "districts_by_city": {
+    "Casablanca": [
+      "Casablanca-Anfa", "Casablanca-Aïn Sebaa", "Casablanca-Hay Mohammadi",
+      "Casablanca-Sidi Bernoussi", "Casablanca-Mers Sultan", "Casablanca-Moulay Rachid",
+      "Casablanca-Sidi Othmane", "Casablanca-Ben M'sick", "Casablanca-Sidi Maarouf"
+    ],
+    "Rabat": [
+      "Rabat-Agdal", "Rabat-Hassan", "Rabat-Yacoub El Mansour",
+      "Rabat-Souissi", "Rabat-Océan", "Rabat-Medina"
+    ],
+    "Marrakech": [
+      "Marrakech-Médina", "Marrakech-Gueliz",
+      "Marrakech-Menara", "Marrakech-Sidi Youssef Ben Ali"
+    ],
+    "Fès": [
+      "Fès-Médina", "Fès-El Jdid-Dar Dbibegh", "Fès-Saïss", "Fès-Zouagha"
+    ],
+    "Agadir": [
+      "Agadir-Cité Dakhla", "Agadir-Talborjt", "Agadir-Ben Sergao", "Inezgane-Aït Melloul"
+    ],
+    "Tanger": [
+      "Tanger-Assilah", "Tanger-Médina", "Tanger-Marchan", "Tanger-Maghogha"
+    ],
+    "Meknès": [
+      "Meknès-Hamria", "Meknès-Medina", "Meknès-El Menzeh"
+    ]
+  },
+  "neighborhoods": [
+    "Medina", "Gueliz", "Maarif", "Anfa", "Derb Sultan",
+    "Hay Hassani", "Sbata", "Lissasfa", "Ain Diab",
+    "Racine", "Bourgogne", "Palmier", "Californie",
+    "Ouasis", "Sidi Bernoussi", "Mers Sultan",
+    "Agdal", "Yacoub El Mansour", "Hassan",
+    "Souissi", "La Gironde", "El Oulfa",
+    "L'Hivernage", "Marjane", "Touarga",
+    "Massira", "Sidi Moumen", "Hay Mohammadi",
+    "Ben M'sick", "Sidi Othman", "El Harti",
+    "Tabriquet", "Les Princes", "Sidi Maârouf",
+    "Diour", "Jamaâ", "Hay El Hanaa",
+    "Errahma", "Hay El Farah"
+  ],
+  "landmarks": [
+    "Mosquée Hassan II", "Place Jemaa el-Fnaa", "Médina de Fès",
+    "Chefchaouen", "Désert du Sahara", "Atlas", "Cascades d'Ouzoud",
+    "Gorges du Todra", "Vallée du Draa", "Merzouga",
+    "Aït Benhaddou", "Volubilis", "Médina de Marrakech",
+    "Kasbah des Oudayas", "Jardin Majorelle", "Palais Bahia",
+    "Kasbah Taourirt", "Chellah", "Plage d'Agadir", "Cap Spartel",
+    "Tétouan-Medina", "Mosquée Moulay Ismail", "Bab Mansour",
+    "Ouzoud Waterfalls", "Dades Valley", "Legzira Beach", 
+    "Rabat Royal Palace", "Guelmim Desert Festival", "Erg Chebbi Dunes"
+  ]
+}