faussaire 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 714ee3f21dd5575ad01277d68a1ea579a30df7b291f179d668505c75f9bb3446
+  data.tar.gz: 165a13bca8e97fd6a21b9a6f7d85186ffa37591ecf49587e8a080c42f02311b1
+SHA512:
+  metadata.gz: 9da106d7163b98fd9d1de4cf0e2e9f47bb3978a636ea0109e9d3c523e7ad260787d39737f43e6a48e8fc4893a76b14a7dc9dbe444205535a18265e084207f584
+  data.tar.gz: a601ca5524c1f5a982fad60d24743a6fa462ca53598971ff73376da4580d6b082f7c66d8ec2e8bcb16e4d91f78da60f93b11d77f7113867dec197adb59ab9b13

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,13 @@
+AllCops:
+  TargetRubyVersion: 2.6
+
+Style/StringLiterals:
+  Enabled: true
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  Enabled: true
+  EnforcedStyle: double_quotes
+
+Layout/LineLength:
+  Max: 120

data/CHANGELOG.md

@@ -0,0 +1,11 @@
+## [Unreleased]
+
+## [0.1.0] - 2023-12-25
+
+- Initial release
+
+## [Unreleased]
+
+## [0.1.1] - 2024-09-28
+
+- Publishing attempt

data/CONTRIBUTING.md

@@ -0,0 +1,251 @@
+# Become a Faussaire: Contributing Guidelines
+
+Bonjour mighty programmer! 👋 Thinking about contributing to Faussaire? That’s awesome! Whether you’re a seasoned dev or just a beginner looking to practice, we’re excited to see what you’ll come up with. To keep things running smoothly, we’ve got a few guidelines for you. 
+
+**_These are just guidelines—nothing here is set in stone._**
+
+If you’ve got something cool to add, don’t be shy! Well-documented pull requests are always welcome, even if you don’t check every box below. We’re here to learn and have fun, after all! 😄
+
+
+> [!NOTE]
+> <p align="center">
+>   <a href="#Français" style="text-decoration:none;">
+>     <img src="bonjour.png" alt="Français" width="50" height="50">
+>   </a>
+>   <br>
+>   <a href="#Français" style="text-decoration:none;">
+>     Évidemment, vous pouvez aussi me lire en français. On est là pour ça, non ?
+>   </a>
+> </p>
+
+## Guidelines
+
+1. **Tests, Tests, Tests:**
+   - Every new feature, bug fix, or data addition needs to come with tests. 
+   - Make sure your tests cover all the important stuff and that they pass before you submit your pull request. We love seeing those green checkmarks! ✅
+
+> [!IMPORTANT]
+> Testing for duplicate values and data integrity is a must to ensure the gem runs smoothly.
+
+2. **Keep It Original:**
+   - Your contributions should be original and crafted with care. We put a lot of love into this project, and we hope you will too! 💖
+   - **No AI-generated data** and definitely **no direct copy-pasting** without some thoughtful formatting or adapting.
+
+> [!TIP]
+> Whatever you add should fit within the French vibe we’ve got going here. At the very least, it should be written in French. 🇫🇷
+
+3. **Update the README:**
+   - Added something new? Awesome! Just don’t forget to update the `README.md` so others know how to use it (and that it exists!). 👀
+
+> [!NOTE]
+> Stick to the current format so everything stays neat and easy to follow.
+
+4. **Relevance:**
+   - We’ve had enough of lorem ipsum—Faussaire is both serious & fun but definitely not boring, and we’d love to keep it that way!
+   - If you’re looking to practice or contribute, we recommend focusing on cultural themes like poets, quotes, sentence generators, specific brands, etc. We’re all about fun, business, and art here at Faussaire (even if the "crew" is currently...shhh, don’t tell anyone).
+
+> [!IMPORTANT]
+> Got something interesting? Great! Just keep it in French... For now!
+
+   - While our main focus is on French, we’re open to all kinds of topics and languages. And who knows, maybe a Greek version is on the horizon! Wink wink!
+
+5. **Code Comments:**
+   - Your code should be well-commented to ensure clarity and maintainability.
+
+> [!TIP]
+> While we prefer code to be written in English (because it’s just good practice, and we actually love foreign languages), we’re totally cool with comments in French given the nature of the app.
+
+   ```ruby
+   require 'yaml'
+
+   module Faussaire
+     class Music
+       DATA_PATH = File.expand_path('../../../locale/fr.yml', __FILE__)
+
+       ##
+       # Fetches and samples data based on the provided key. If the fetched data is an array,
+       # it samples a single item, otherwise returns the data directly.
+       #
+       # @param key [String] The dot-separated key used to access the data.
+       # @return [Object, nil] The data fetched and optionally sampled.
+       #
+       def self.fetch(key)
+         data = YAML.load_file(DATA_PATH)
+         result = data.dig(*key.split('.'))
+         result.is_a?(Array) ? result.sample : result
+       end
+
+       ##
+       # Produces a random house song.
+       #
+       # @return [String]
+       #
+       # @example
+       #   Faussaire::Music.house #=> "House is a feeling - LA Riots"
+       #
+       def self.house
+         fetch('fr.faussaire.music.house')
+       end
+
+       ##
+       # Produces a random French rap song.
+       #
+       # @return [String]
+       #
+       # @example
+       #   Faussaire::Music.rap #=> "Onizuka - PNL"
+       #
+       def self.rap
+         fetch('fr.faussaire.music.rap')
+       end
+
+       ##
+       # Produces a random French variété song.
+       #
+       # @return [String]
+       #
+       # @example
+       #   Faussaire::Music.variete #=> "Laisse tomber les filles - France Gall"
+       #
+       def self.variete
+         fetch('fr.faussaire.music.variete')
+       end
+     end
+   end
+   ```
+
+## How to Submit Your Contribution
+
+1. Fork the repository and create your feature branch: `git checkout -b a-great-idea-from-toi`
+2. Make your changes, ensuring you follow the guidelines above.
+3. Commit your changes: `git commit -am 'Added set of ridiculous quotes from French politicians and/or French fashion brands'`
+4. Push to the branch: `git push origin a-great-idea-from-toi`
+5. Submit a pull request.
+
+> [!TIP]
+> That’s it! We’re thrilled to see what you’ll add to Faussaire. Also, fun fact: The “Faussaire crew” currently consists of...well, just me. But hey, that means learning by doing is really a thing so keep going! Don't give up!
+
+Merci beaucoup for helping out and making Faussaire even better!
+
+<a name="Français"></a>
+
+# Devenir un Faussaire : Guide de Contribution
+
+Bonjour, monde ! 👋 Vous rejoignez le navire en contribuant à Faussaire ? Mais c'est génial ! 
+
+Que vous soyez un(e) dev expérimenté(e) ou un(e) débutant(e) cherchant à pratiquer, on a hâte de voir ce que vous allez proposer. Pour que tout se passe bien, voici quelques règles simples à suivre.
+
+> [!NOTE]
+> Ce ne sont QUE des lignes directrices—rien de plus. Si vous avez une super idée, n’hésitez pas ! Les pull requests bien documentées sont toujours les bienvenues, même si vous ne cochez pas toutes les "cases" ci-dessous. On est ici pour apprendre et s’amuser, après tout ! 😄
+
+
+## Les fameuses lignes directrices
+
+1. **Tests, Tests, Tests :**
+   - Chaque nouvelle fonctionnalité, correction de bug ou ajout de données doit être accompagné de tests.
+   - Assurez-vous que vos tests couvrent bien tout ce qui est important et qu’ils passent avant de soumettre votre pull request. On aime voir du vert dans le terminal ! ✅
+   
+> [!IMPORTANT]
+> Les tests pour éviter les doublons et vérifier l’intégrité des données sont essentiels pour que la gem fonctionne correctement. C'est pour ça qu'on a décidé de les rendre obligatoires.
+
+2. **Restez Original(e) :**
+   - Vos contributions doivent être originales et mijotées aux petits oignons. On met beaucoup de 💖 dans ce projet, et on espère que vous en ferez autant !
+   - **Pas de données générées par IA** et surtout **pas de copier-coller direct** sans une petite touche perso ou un minimum d’adaptation.
+
+> [!TIP]
+> Ce que vous ajoutez doit s’inscrire dans l’esprit que l’on cultive ici: drôle et/ou culturellement enrichissant.
+
+3. **Mise à jour du README :**
+   - Vous avez envoyé la sauce ? Super ! N’oubliez pas de mettre à jour le `README.md` pour que les autres sachent où la trouver (et qu'elle existe !). 👀
+
+> [!NOTE]
+> Respectez le format actuel pour que tout reste bien organisé et facile à suivre.
+
+4. **Pertinence :**
+   - On en a assez du lorem ipsum—Faussaire, c’est sérieux & fun, mais surtout pas ennuyeux, et on veut que ça reste comme ça !
+   - Si vous cherchez à pratiquer la programmation et/ou à contribuer, on vous conseille de vous concentrer sur des thèmes comme la poésie, les citations, les générateurs de phrases (un peu plus corsé), les marques, etc...
+   - Même si notre priorité reste le français, on est ouverts à d’autres sujets et langues. Et qui sait, peut-être qu’une version grecque est en préparation ! Clin d’œil, clin d’œil !
+   - Chez Faussaire, on adore rire donc lâchez vous.
+
+![Karine Lemarchand adore rire](jadore-rire.gif)
+
+5. **Commentaires :**
+   - Votre code doit être bien commenté pour être clair et facile à maintenir.
+
+> [!TIP]
+> Même si on préfère que le code soit écrit en anglais (c’est pô juste mais c'est partout pareil), les commentaires en français sont parfaitement OK, vu la nature de l’appli.
+
+   ```ruby
+   require 'yaml'
+
+   module Faussaire
+     class Music
+       DATA_PATH = File.expand_path('../../../locale/fr.yml', __FILE__)
+
+       ##
+       # Récupère et échantillonne les données en fonction de la clé fournie. Si les données récupérées sont un tableau,
+       # il en échantillonne un seul élément, sinon il retourne les données directement.
+       #
+       # @param key [String] La clé utilisée pour accéder aux données.
+       # @return [Object, nil] Les données récupérées et éventuellement échantillonnées.
+       #
+       def self.fetch(key)
+         data = YAML.load_file(DATA_PATH)
+         result = data.dig(*key.split('.'))
+         result.is_a?(Array) ? result.sample : result
+       end
+
+       ##
+       # Génère une chanson de house aléatoire.
+       #
+       # @return [String]
+       #
+       # @example
+       #   Faussaire::Music.house #=> "House is a feeling - LA Riots"
+       #
+       def self.house
+         fetch('fr.faussaire.music.house')
+       end
+
+       ##
+       # Génère une chanson de rap français aléatoire.
+       #
+       # @return [String]
+       #
+       # @example
+       #   Faussaire::Music.rap #=> "Onizuka - PNL"
+       #
+       def self.rap
+         fetch('fr.faussaire.music.rap')
+       end
+
+       ##
+       # Génère une chanson de variété française aléatoire.
+       #
+       # @return [String]
+       #
+       # @example
+       #   Faussaire::Music.variete #=> "Laisse tomber les filles - France Gall"
+       #
+       def self.variete
+         fetch('fr.faussaire.music.variete')
+       end
+     end
+   end
+   ```
+
+## Comment Soumettre Votre Contribution
+
+1. Forkez le dépôt et créez votre branche : `git checkout -b une-super-idee-de-toi`
+2. Apportez vos modifications/additions en suivant les recommandations ci-dessus.
+3. Commitez vos changements : `git commit -am 'Ajout d'un ensemble de citations ridicules de politiciens français et/ou de marques de luxe françaises'`
+4. Poussez sur votre branche : `git push origin une-super-idee-de-toi`
+5. Balancez une pull request.
+
+> [!TIP]
+> Et voilà ! On a hâte de découvrir ce que vous allez ajouter à Faussaire. D'ailleurs vous allez rire : "on", la "team Faussaire"... c'est personne, il n'y a que moi. Oui, j'aime la danse, la forêt et la solitude.
+
+
+Mais bon, ça prouve que l’apprentissage par la pratique, ça marche vraiment, alors continuez ! Ne lâchez rien ! 😉
+
+![Cuphead saying thank you](CUPHEAD.gif)

data/LICENSE.txt

@@ -0,0 +1,35 @@
+The MIT License (MIT)
+
+Copyright (c) 2023-2024 Ikrame Saadi (@ikramagix)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+----
+
+Additional Terms on Data Ownership & Usage
+
+The dataset included in this software, including but not limited to the `fr.yml` file and other data files (the "Dataset"), is the property of the original creator and is protected under applicable intellectual property laws. The following additional terms apply specifically to the Dataset:
+
+1. Educational Use Only: The Dataset may be used, modified, and distributed for educational purposes only as part of copies or substantial portions of the Software. Any other use of the Dataset is strictly prohibited without prior written authorization from the copyright holder.
+
+2. Restricted Use for Other Projects: The Dataset, including the `fr.yml` file, may not be extracted, used, or incorporated into other projects or software without explicit prior authorization from the copyright holder. This restriction applies regardless of whether the other project is for commercial or non-commercial purposes.
+
+3. Authorization Required: For any use of the Dataset outside the scope of these terms, including but not limited to commercial use or incorporation into other software, explicit authorization must be obtained from the copyright holder. Please contact [hello@ikramagix.com] for inquiries and permissions.
+
+These additional terms do not modify the MIT License as it applies to the Software itself. The Software remains available under the terms of the MIT License, while the Dataset is subject to the above restrictions.