Skip to content

An alternative to the "Faker" library in Ruby, with credible and culturally relevant options.

License

Notifications You must be signed in to change notification settings

ikramagix/faussaire

Repository files navigation

FAUSSAIRE • Au revoir Lorem Ipsum

Gem Version

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 moins génériques que Faker, elle dispose actuellement d'un set français exhaustif, réaliste et culturellement pertinent pour vos projets Ruby francophones.

Table des matières

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.

Installation

Avant de commencer, vérifiez que Ruby et RubyGems sont bien installés sur votre machine. Vous pouvez utiliser les commandes suivantes :

Pour Ruby :

ruby -v

Cela affichera la version de Ruby installée, si Ruby est bien installé.

Pour RubyGems :

gem -v

Cela affichera la version de RubyGems installée, si RubyGems est bien installé.

Ensuite, vous pouvez installer Faussaire directement via RubyGems :

gem install faussaire

Vous pouvez également l'ajouter à votre Gemfile :

gem 'faussaire'

et lancez la commande suivante pour l'installer :

bundle install

Utilisation

Pour utiliser Faussaire dans vos applications Ruby, il suffit de charger la gem :

require 'faussaire'

Modules Disponibles dans Faussaire

Faussaire::Ancien

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"
Faussaire::Address

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"
Faussaire::Bizness

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."
Faussaire::Citation

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."
Faussaire::Cosmos

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"
Faussaire::Creamerie

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" }
Faussaire::Gardinerie

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"
Faussaire::Music

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"
Faussaire::Name

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"
Faussaire::Piraterie

Le module Faussaire::Piraterie est un hommage à The Hacking Project (THP), le bootcamp français qui réinvente l'apprentissage du code grâce à l'entraide et à l'esprit d'équipe. Ce module permet de générer des données inspirés de l'univers de la formation et a été réalisé pour être utilisé dans le cadre de la formation.

# Génère un rôle qu'un apprenant peut avoir chez THP.
Faussaire::Piraterie.role 
# => "Moussaillon"

# Génère un statut thématique autour de la piraterie mais qui n'est pas (encore) utilisé chez THP.
Faussaire::Piraterie.pnj 
# => "Siresse"

# Génère un type de navire pirate.
Faussaire::Piraterie.nav 
# => "Frégate"

# Génère un juron de pirate.
Faussaire::Piraterie.rage 
# => "Mille millions de mille sabords !"

# Génère une excuse aléatoire pour justifier une absence, un retard ou un projet non rendu.
Faussaire::Piraterie.excuse 
# => "Les embruns de la mer de Frêche m'ont rendu un peu fébrile… ai-je droit à un peu de repos Capitaine ?"

# Génère un potin amusant sur l'expérience d'apprentissage à THP, idéal pour le fameux Gossip Project.
Faussaire::Piraterie.potin 
# => "“Une bête de prime en crypto” : un corsaire influent promet une récompense au premier moussaillon qui contribue à la gem Faussaire. Des bruits de ponton racontent qu'un corsaire influent de la promo aurait mis en jeu une prime en crypto pour inciter les moussaillons à contribuer à la célèbre gem Faussaire. Vrai bonne affaire ou simple manigance ?"
Faussaire::Tv

Le module Faussaire::Tv génère des données factices liées à la télévision, y compris des titres d'émissions, des influenceurs, des couples célèbres, des chaînes TV, ainsi que des détails spécifiques liés au Festival de Cannes.

# Génère un titre d'émission de télévision aléatoire.
Faussaire::Tv.show 
# => "Marjolaine et les Millionnaires"

# Génère un nom d'influenceur célèbre aléatoire.
Faussaire::Tv.influencer 
# => "Le Vrai Bouseuh (Romain Goisbeau)"

# Génère un couple célèbre de la télévision aléatoire.
Faussaire::Tv.famous_couples 
# => "J.Lo et Diddy (2000)"

# Génère un nom de chaîne TV aléatoire.
Faussaire::Tv.channel 
# => "Canal+"

# Retourne le nombre total de films présentés au festival.
Faussaire::Tv::FestivalCannes.total_films 
# => 1234

# Génère un pays aléatoire parmi les plus représentés au festival.
Faussaire::Tv::FestivalCannes.most_represented_countries 
# => "161 (Royaume-Uni)"

# Génère un pays aléatoire parmi ceux qui ont remporté des récompenses.
Faussaire::Tv::FestivalCannes.awarded_countries 
# => "Grèce (total de 1 récompense)"

# Génère un réalisateur ayant remporté deux Palmes d'Or.
Faussaire::Tv::FestivalCannes.directors_with_two_palms 
# => "Ken Loach (Le vent se lève, Moi, Daniel Blake)"

# Génère un nominé ayant reçu plusieurs récompenses.
Faussaire::Tv::FestivalCannes.multiple_awardises 
# => "Dean Stockwell: Le Génie du mal, Long voyage vers la nuit"

# Génère un gagnant de la Palme d'Or.
Faussaire::Tv::FestivalCannes.winners 
# => "Les Meilleures Intentions (Den Goda viljan) par Bille August en provenance de la Suède [1992]"

# Retourne un chiffre du box-office parmi les films du festival.
Faussaire::Tv::FestivalCannes.box_office 
# => "Apocalypse Now (1979) : 4 537 000 entrées"
Faussaire::Wine

Le module Faussaire::Wine génère des données liées aux vins français (noms de vins avec leur dénomination actuelle, types, bouteilles, régions, prix, et liqueurs).

# Génère un nom de vin aléatoire.
Faussaire::Wine.name 
# => "AOC Collioure"

# Génère un type de vin ou un style de vin aléatoire.
Faussaire::Wine.type 
# => "Vin tranquille blanc (pression inférieure à 0,5 bar à 20°C)"

# Génère un type de bouteille de vin aléatoire.
Faussaire::Wine.bottle_type 
# => "Bouteille Clavelien (bouteille en verre à col court, contenance de 0,62 L, corps cylindrique surmonté de larges épaules)"

# Génère une région viticole aléatoire.
Faussaire::Wine.region 
# => "Vignoble de Corse (120M€ en ventes, 2.45€/bt en prix moyen, 1.71€/m² en rentabilité)"

# Génère un prix de vin aléatoire avec 99 centimes et le symbole Euro (€).
Faussaire::Wine.price 
# => "39.99€"

# Génère un nom de liqueur aléatoire.
Faussaire::Wine.licocorico 
# => "AOC Grande Champagne (Eau de vie de vin) [Cognac]"

Vous voulez participer ?

Pour configurer l'environnement de développement pour Faussaire :

  1. Clonez le dépôt :
    git clone https://github.com/ikramagix/faussaire.git
  2. Accédez au répertoire du projet :
    cd faussaire
  3. Installez les dépendances :
    bin/setup
  4. Lancez les tests :
    rake spec

Licence

La gem Faussaire est disponible sous Licence MIT, qui vous permet d'utiliser, modifier et distribuer librement le logiciel contenu dans cette gem.

Important

La Licence MIT concerne uniquement le logiciel lui-même. Des restrictions s'appliquent au jeu de données utilisé dans ce projet (fr.yml). Assurez-vous de consulter les conditions spécifiques liées à l'utilisation des données.

Il manquerait pas un petit quelque chose ?

Toutes les contributions à Faussaire sont les bienvenues et le seront toujours !

N'hésitez pas à participer en soumettant vos pull requests :

  • Issues : Donnez autant de détails que possible sur le problème rencontré et comment le reproduire.
  • Pull Requests : Vous trouverez la marche à suivre dans CONTRIBUTING.md.

Merci à toi camarade faussaire ! 🙂‍

FAUSSAIRE • Goodbye Lorem Ipsum

Authentic French Data for Realistic Apps & Fun Seeding

Faussaire is a French-made alternative to the Faker gem in Ruby.

Designed to provide more accurate and less generic data than Faker, it currently offers an exhaustive, realistic, and culturally relevant French dataset for your Ruby projects.

Table of Contents

We plan to offer a Greek version in the coming months, and perhaps a "globish" version.

Why Using Faussaire ?

When you love what you do, you like to make it fun.

Like me, it has probably happened to you.

Endless debugging phases with a database filled with Lorem Ipsum can quickly become tedious.

And how do you test that REGEX for French addresses if the test data doesn’t include department numbers with 3 digits?

Oops, you’ve just deployed your app to production and realize that by excluding special characters, you’ve also prevented Stéphane from adding an accent to his name.

The list goes on.

If, like me, you're tired of excessive standardization and want to use a francophone, fun, and enriching library, you’re going to love Faussaire.

It’s much more fun to have a list of AOC wines, a corporate buzzword generator, old French words, or a lineup of outdated reality TV candidates when testing your database.

Faussaire was developed with specific goals in mind:

  • Cultural Relevance: To provide accurate and culturally relevant French data, surpassing the generic results from other available options.

  • Realism: To generate data that closely mirrors French contexts, from addresses to names and beyond. Whenever possible, we favor the use of real data for authenticity.

  • Data Quality: To offer carefully crafted, precise, and comprehensive data generation options, whether for professional contexts or cultural references.

Installation

Before you begin, ensure that Ruby and RubyGems are installed on your machine. You can use the following commands:

For Ruby:

ruby -v

This will display the installed Ruby version if Ruby is correctly installed.

For RubyGems:

gem -v

This will display the installed RubyGems version if RubyGems is correctly installed.

Then, you can install Faussaire directly via RubyGems:

gem install faussaire

You can also add it to your Gemfile:

gem 'faussaire'

and run the following command to install it:

bundle install

Usage

To use Faussaire in your Ruby applications, simply load the gem:

require 'faussaire'

Available Modules in Faussaire

Faussaire::Ancien

The Faussaire::Ancien module generates names of historical figures, mythological creatures, and old French words. Ideal for apps in areas like video games, storytelling, and educational applications.

# Generates a random mythological creature name.
Faussaire::Ancien.creature 
# => "Cocatrix"

# Generates a random historical figure name.
Faussaire::Ancien.historic_figure 
# => "Napoléon Bonaparte"

# Retrieves a random old French word.
Faussaire::Ancien.words 
# => "niquenoque"
Faussaire::Address

The Faussaire::Address module generates detailed French addresses. This module is particularly useful for testing, simulations, or any application requiring realistic location data.

# Returns a random city name.
Faussaire::Address.city 
# => "Achiet-le-Petit"

# Returns a random street number up to 99.
Faussaire::Address.street_number_99 
# => "42"

# Returns a random street number up to 999.
Faussaire::Address.street_number_999 
# => "110"

# Returns a random street number up to 9999.
Faussaire::Address.street_number_9999 
# => "3695"

# Returns a random street type.
Faussaire::Address.street_type 
# => "Avenue"

# Returns a random street name.
Faussaire::Address.street_name 
# => "Charles Trenet"

# Returns a random department name.
Faussaire::Address.dpt_name 
# => "Loire"

# Returns a department number for metropolitan France.
Faussaire::Address.dpt_number 
# => "25"

# Returns a department number for overseas departments.
Faussaire::Address.dpt_number_other 
# => "971"

# Returns a random postal code formatted to five digits.
Faussaire::Address.postal_code 
# => "31200"

# Returns a random region name.
Faussaire::Address.region 
# => "Île-de-France"

# Generates a complete address using various components.
Faussaire::Address.full_address 
# => "88 Bourg Daniel Bustaffa, 91360 Prouville, La Réunion (974), Région Haute-Normandie"
Faussaire::BiznessWindbag (nonsensical corporate phrases) and French brand names

The Faussaire::Bizness module generates French brand names and cliché corporate phrases.

# Generates a random French brand name.
Faussaire::Bizness.brands
# => "Boulangerie Paul"

# Generates random "corporate buzzwords."
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."
Faussaire::Citation

The Faussaire::Citation module generates French proverbs and philosophical quotes.

# Generates a random philosopher quote.
Faussaire::Citation.philo 
# => "Homère a dit un jour : Le sommeil et la mort sont des frères jumeaux."

# Generates a random French proverb.
Faussaire::Citation.proverbe 
# => "Pense deux fois avant de parler, tu en parleras deux fois mieux."
Faussaire::Cosmos

The Faussaire::Cosmos module generates data related to celestial bodies, planets, and cosmic events.

# Generates a random planet name.
Faussaire::Cosmos.planet 
# => "Neptune"

# Generates a random cosmic event.
Faussaire::Cosmos.event 
# => "Pluie de météorites"

# Generates a neighborhood name in the cosmos (like a galaxy or nebula).
Faussaire::Cosmos.neighborhood 
# => "Filament de Perseus-Pisces"

# Generates a random space exploration name.
Faussaire::Cosmos.exploration 
# => "Voyager 2"
Faussaire::Creamerie

The Faussaire::Creamerie module generates data related to French dairy products, perfect for food-related applications or demos.

# Generates a random type of milk.
Faussaire::Creamerie.milk_type 
# => "Lait de bufflonne"

# Generates a random butter.
Faussaire::Creamerie.butter 
# => { name: "Beurre d'Isigny", type: "demi-sel" }

# Generates information about top butter producers.
Faussaire::Creamerie.butter_producers 
# => "N°7: Turquie (215,431 t)"

# Generates a random cheese, linking it to a region and an appellation.
Faussaire::Creamerie.cheese 
# => { type: "AOP", name: "Camembert de Normandie", region: "Normandie" }
Faussaire::Gardinerie

The Faussaire::Gardinerie module is organic-certified! Vegetables, fruits, and various plants, with a particular focus on their relevance in France.

# Generates a random vegetable name and its ideal consumption month in France.
Faussaire::Gardinerie.vegetable 
# => "Carotte (Mars)"

# Generates a random fruit name and its ideal consumption month in France.
Faussaire::Gardinerie.fruit 
# => "Pomme (Janvier)"

# Generates a harmful weed name (harmful for 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"



# Generates a random carnivorous plant name.
Faussaire::Gardinerie.bang_bang_plant 
# => "Drosera : pièges à mucilage avec feuilles et poils qui s'enroulent autour des proies"

# Generates a random psychotropic plant name.
Faussaire::Gardinerie.very_naughty_plant 
# => "Nymphaea caerulea : Lotus bleu d’Égypte, plante aux effets enivrants et psychoactifs"
Faussaire::Music

The Faussaire::Music module generates data related to different music genres, focusing on house, French rap, and French variété songs.

# Generates a random house song.
Faussaire::Music.house 
# => "House is a feeling - LA Riots"

# Generates a random French rap song.
Faussaire::Music.rap 
# => "Chez nous - Sultan"

# Generates a random French variété song.
Faussaire::Music.variete 
# => "Mourir sur scène - Dalida"
Faussaire::Name

The Faussaire::Name module generates realistic French names, which can be used for character creation, database seeding, or any application requiring random name generation.

# Generates a random female first name.
Faussaire::Name.female_first_name 
# => "Harmonie"

# Generates a random male first name.
Faussaire::Name.male_first_name 
# => "Jean-Claude"

# Generates a random family name.
Faussaire::Name.family_name 
# => "Boyer"

# Generates a full name by combining a random first name (female or male) with a family name.
Faussaire::Name.name 
# => "Jeanne Gaillard"
Faussaire::Tv

The Faussaire::Tv module generates fake data related to television, including show titles, influencers, famous couples, TV channels, and specific details related to the Cannes Film Festival.

# Generates a random television show title.
Faussaire::Tv.show 
# => "Marjolaine et les Millionnaires"

# Generates a random famous influencer name.
Faussaire::Tv.influencer 
# => "Le Vrai Bouseuh (Romain Goisbeau)"

# Generates a random famous television couple.
Faussaire::Tv.famous_couples 
# => "J.Lo et Diddy (2000)"

# Generates a random TV channel name.
Faussaire::Tv.channel 
# => "Canal+"

# Returns the total number of films presented at the festival.
Faussaire::Tv::FestivalCannes.total_films 
# => 1234

# Generates a random country among the most represented at the festival.
Faussaire::Tv::FestivalCannes.most_represented_countries 
# => "161 (Royaume-Uni)"

# Generates a random country among those that have won awards.
Faussaire::Tv::FestivalCannes.awarded_countries 
# => "Grèce (total de 1 récompense)"

# Generates a director who has won the Palme d'Or twice.
Faussaire::Tv::FestivalCannes.directors_with_two_palms 
# => "Ken Loach (Le vent se lève, Moi, Daniel Blake)"

# Generates a nominee who has received multiple awards.
Faussaire::Tv::FestivalCannes.multiple_awardises 
# => "Dean Stockwell: Le Génie du mal, Long voyage vers la nuit"

# Generates a Palme d'Or winner.
Faussaire::Tv::FestivalCannes.winners 
# => "Les Meilleures Intentions (Den Goda viljan) par Bille August en provenance de la Suède [1992]"

# Returns a top box office figure from the festival's films.
Faussaire::Tv::FestivalCannes.box_office 
# => "Apocalypse Now (1979) : 4 537 000 entrées"
Faussaire::Wine

The Faussaire::Wine module generates data related to French wines (wine names with their current appellation, types, bottles, regions, prices, and liquors).

# Generates a random wine name.
Faussaire::Wine.name 
# => "AOC Collioure"

# Generates a random wine type or style.
Faussaire::Wine.type 
# => "Vin tranquille blanc (pression inférieure à 0,5 bar à 20°C)"

# Generates a random wine bottle type.
Faussaire::Wine.bottle_type 
# => "Bouteille Clavelien (bouteille en verre à col court, contenance de 0,62 L, corps cylindrique surmonté de larges épaules)"

# Generates a random wine region.
Faussaire::Wine.region 
# => "Vignoble de Corse (120M€ en ventes, 2.45€/bt en prix moyen, 1.71€/m² en rentabilité)"

# Generates a random wine price with 99 cents and the Euro (€) symbol.
Faussaire::Wine.price 
# => "39.99€"

# Generates a random liquor name.
Faussaire::Wine.licocorico 
# => "AOC Grande Champagne (Eau de vie de vin) [Cognac]"

Want to contribute?

To set up the development environment for Faussaire:

  1. Clone the repository:
    git clone https://github.com/ikramagix/faussaire.git
  2. Navigate to the project directory:
    cd faussaire
  3. Install dependencies:
    bin/setup
  4. Run the tests:
    rake spec

License

The Faussaire gem is available under the MIT License, which allows you to freely use, modify, and distribute the software contained within this gem.

Important

The MIT License only applies to the software itself. Restrictions apply to the dataset used in this project (fr.yml). Be sure to review the specific terms related to data usage.

Is something missing?

All contributions to Faussaire are welcome and will always be!

Feel free to participate by submitting your pull requests:

  • Issues: Provide as many details as possible about the problem encountered and how to reproduce it.
  • Pull Requests: Check out CONTRIBUTING.md.

Merci beaucoup, fellow faussaire! 🙂‍