Faussaire
A gem to generate ultra-realistic fake data in French and Greek with credible, context-aware, and culturally relevant options.
Install / Use
/learn @ikramagix/FaussaireREADME
FAUSSAIRE • Au revoir Lorem Ipsum
Des données authentiques, des apps réalistes, des seeds ludiques
Faussaire est une alternative made in France à la gem Faker en Ruby.
Conçue pour fournir des données plus précises et plus diverses, elle dispose actuellement d'un set français exhaustif, réaliste et culturellement pertinent pour vos projets Ruby francophones.
Table des matières
- Pourquoi utiliser Faussaire ?
- Modules Disponibles
- Installation
- Utilisation
- Développement
- Licence
- Contribution
Nous avons pour projet de proposer une version grecque dans les mois à venir, et peut-être une version "globish".
Pourquoi utiliser Faussaire ?
Quand on aime ce qu’on fait, on aime rendre ça ludique.
Comme moi, ça a dû vous arriver. Des phases de débogage interminables avec une base de données peuplée de Lorem Ipsum, ça devient vite lassant. Et puis, comment tester cette REGEX sur le format des adresses françaises si les données de test n’ont pas de numéro de département à 3 chiffres ? Mince, vous venez d’envoyer votre app en production, mais vous vous rendez compte qu’en excluant les caractères spéciaux, vous avez aussi empêché Stéphane de mettre un accent à son prénom. La liste est interminable.
Si comme moi, vous en avez marre de la standardisation à outrance et que vous voulez utiliser une librairie francophone, amusante et enrichissante, vous allez adorer Faussaire.
C'est quand même plus drôle d'avoir une liste d'AOC, un générateur de phrases "corporate", des mots d'ancien français où un florilège de candidats désuets de téléralité quand vous testez votre base de données.
Faussaire a été développée avec des objectifs précis en tête:
-
Pertinence culturelle: Offrir des données françaises précises et culturellement pertinentes, afin de surpasser les résultats génériques des autres options disponibles.
-
Réalisme: Générer des données qui reflètent fidèlement les contextes français, des adresses aux noms, et bien plus encore. Dans la mesure du possible, nous privilégions l'utilisation de données réelles dans un souci d'authenticité.
-
Qualité des données: Proposer des options de génération de données soigneusement élaborés, précises et complètes, qu'il s'agisse de contextes professionnels ou de références culturelles.
Modules Disponibles
<details> <summary><strong>Faussaire::Ancien</strong></summary>Le module Faussaire::Ancien permet de générer des noms de figures historiques, de créatures mythologiques et des mots en ancien français. Idéal pour les apps dans des domaines tels que le jeu vidéo, la narration et les applications éducatives.
# Génère un nom de créature mythologique aléatoire.
Faussaire::Ancien.creature
# => "Cocatrix"
# Génère un nom de personnage historique aléatoire.
Faussaire::Ancien.historic_figure
# => "Napoléon Bonaparte"
# Récupère un mot ancien français aléatoire.
Faussaire::Ancien.words
# => "niquenoque"
Le module Faussaire::Address génère des adresses françaises détaillées. Ce module est particulièrement utile pour les tests, les simulations ou toute application nécessitant des données de localisation réalistes.
# Renvoie un nom de ville aléatoire.
Faussaire::Address.city
# => "Achiet-le-Petit"
# Renvoie un numéro de rue aléatoire jusqu'à 99.
Faussaire::Address.street_number_99
# => "42"
# Renvoie un numéro de rue aléatoire jusqu'à 999.
Faussaire::Address.street_number_999
# => "110"
# Renvoie un numéro de rue aléatoire jusqu'à 9999.
Faussaire::Address.street_number_9999
# => "3695"
# Renvoie un type de rue aléatoire.
Faussaire::Address.street_type
# => "Avenue"
# Renvoie un nom de rue aléatoire.
Faussaire::Address.street_name
# => "Charles Trenet"
# Renvoie un nom de département aléatoire.
Faussaire::Address.dpt_name
# => "Loire"
# Renvoie un numéro de département pour la France métropolitaine.
Faussaire::Address.dpt_number
# => "25"
# Renvoie un numéro de département pour les DOM-TOM.
Faussaire::Address.dpt_number_other
# => "971"
# Renvoie un code postal aléatoire au format à cinq chiffres.
Faussaire::Address.postal_code
# => "31200"
# Renvoie un nom de région aléatoire.
Faussaire::Address.region
# => "Île-de-France"
# Génère une adresse complète en utilisant divers composants.
Faussaire::Address.full_address
# => "88 Bourg Daniel Bustaffa, 91360 Prouville, La Réunion (974), Région Haute-Normandie"
Le module Faussaire::Bizness génère des noms de marques françaises et des phrases clichés du monde de l'entreprise.
# Génère un nom de marque française aléatoire.
Faussaire::Bizness.brands
# => "Boulangerie Paul"
# Génère un "charabia corporate" aléatoire.
Faussaire::Bizness.pipotronic
# => "En termes de redynamisation de une globalisation référentielle, un meilleur relationnel permet d'solutionner les nécessités back-office."
Le module Faussaire::Citation génère des proverbes français et des citations philosophiques.
# Génère une citation philosophique aléatoire.
Faussaire::Citation.philo
# => "Homère a dit un jour : Le sommeil et la mort sont des frères jumeaux."
# Génère un proverbe français aléatoire.
Faussaire::Citation.proverbe
# => "Pense deux fois avant de parler, tu en parleras deux fois mieux."
Le module Faussaire::Cosmos génère des données liées aux corps célestes, aux planètes et aux événements cosmiques.
# Génère un nom de planète aléatoire.
Faussaire::Cosmos.planet
# => "Neptune"
# Génère un événement cosmique aléatoire.
Faussaire::Cosmos.event
# => "Pluie de météorites"
# Génère un nom de quartier dans le cosmos (comme une galaxie ou une nébuleuse).
Faussaire::Cosmos.neighborhood
# => "Filament de Perseus-Pisces"
# Génère un nom d'exploration spatiale aléatoire.
Faussaire::Cosmos.exploration
# => "Voyager 2"
Le module Faussaire::Creamerie génère des données liées aux produits laitiers français, parfait pour des applications ou des démonstrations liées à l'alimentation.
# Génère un type de lait aléatoire.
Faussaire::Creamerie.milk_type
# => "Lait de bufflonne"
# Génère un beurre aléatoire.
Faussaire::Creamerie.butter
# => { name: "Beurre d'Isigny", type: "demi-sel" }
# Génère des informations sur les principaux producteurs de beurre.
Faussaire::Creamerie.butter_producers
# => "N°7: Turquie (215,431 t)"
# Génère un fromage aléatoire, en le liant à une région et une appellation.
Faussaire::Creamerie.cheese
# => { type: "AOP", name: "Camembert de Normandie", region: "Normandie" }
Le module Faussaire::Gardinerie est certifié bio! Des légumes, des fruits et diverses plantes, avec un accent particulier sur leur pertinence en France.
# Génère un nom de légume aléatoire et son mois de consommation idéal en France.
Faussaire::Gardinerie.vegetable
# => "Carotte (Mars)"
# Génère un nom de fruit aléatoire et son mois de consommation idéal en France.
Faussaire::Gardinerie.fruit
# => "Pomme (Janvier)"
# Génère un nom de mauvaise herbe nuisible (nuisible pour l'agriculture).
Faussaire::Gardinerie.rival_plant
# => "Orobanche minor de la famille des Orobanchaceae, parasite sur légumineuses, tabac, carottes, cultures diverses, très répandus dans les régions tempérées"
# Génère un nom de plante carnivore aléatoire.
Faussaire::Gardinerie.bang_bang_plant
# => "Drosera : pièges à mucilage avec feuilles et poils qui s'enroulent autour des proies"
# Génère un nom de plante psychotrope aléatoire.
Faussaire::Gardinerie.very_naughty_plant
# => "Nymphaea caerulea : Lotus bleu d’Égypte, plante aux effets enivrants et psychoactifs"
Le module Faussaire::Music génère des données liées à différents genres musicaux avec de la house, du rap français et des chansons de variété française.
# Génère une chanson de house aléatoire.
Faussaire::Music.house
# => "House is a feeling - LA Riots"
# Génère une chanson de rap français aléatoire.
Faussaire::Music.rap
# => "Chez nous - Sultan"
# Génère une chanson de variété française aléatoire.
Faussaire::Music.variete
# => "Mourir sur scène - Dalida"
Le module Faussaire::Name génère des noms français réalistes, qui peuvent être utilisés pour la création de personnages, le remplissage de bases de données, ou toute application nécessitant la génération aléatoire de noms.
# Génère un prénom féminin aléatoire.
Faussaire::Name.female_first_name
# => "Harmonie"
# Génère un prénom masculin aléatoire.
Faussaire::Name.male_first_name
# => "Jean-Claude"
# Génère un nom de famille aléatoire.
Faussaire::Name.family_name
# => "Boyer"
# Génère un nom complet en combinant un prénom aléatoire (féminin ou masculin) avec un nom de famille.
Faussaire::Name.name
# => "Jeanne Gaillard"
Le module Faussaire::Piraterie est un hommage à The Hacking Project (THP),
