polite_text 0.1.2 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 975a036dc2224dc4f4511c9bb9c10e2cebf2b5e9ff53c5a832dbc1a8321ab885
-  data.tar.gz: b64fc451921d3d344ec50e1c406718abc36290a55ade06181390adf877b8e6db
+  metadata.gz: 6441b50cc047fa72c872b0b2f4e1bcaff686461d28738426251f3562e7507494
+  data.tar.gz: 5cec91bda68345fdc0af048107edaf971b32848f823e9f2e4f88f46524d608f5
 SHA512:
-  metadata.gz: 90cf022213168d75beec317b0e4b2e2eb50e62d3036a27c29c135efed9b2068d15c91a92de09f125dd3bcec61755e0e228d45c2a1d4ac5fd55de56835dd75ca4
-  data.tar.gz: bc51b523c94300e81e2243c839bdf8e54a570f25e6b159d11c58994ac2d304adf10c346161d3024af721fb90e56dce542abee6a46410c5e56cb261e3e3de72bd
+  metadata.gz: e6d59fba6f064483e5ffe3494d02694790d1d15cc2710463c49a64f25f487886518e68e33f6f23e6ed4ebc9bf87047f23a9fee49f8fb7b06802aea202d0ae134
+  data.tar.gz: d76c2d3b3eb20b90b03ff2f05fa5eb277e5d7b36100aa8ae5cae1650a55582da9a2146f6b06b14b208b397b3f752cf92abb9ae154c2199fc8b2dbdc2bf20b4a4

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    polite_text (0.1.1)
+    polite_text (0.3.0)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -5,9 +5,9 @@
 
 PoliteText is making your users' input polite 👀
 
-👉 Replace the swear words or execute callbacks if the input is not polite.
+👉 Replace the swear words or execute callbacks if the input is not polite based on a default swear words list or your own.
 
-## Installation
+## Installation 👨‍💻 👩‍💻
 
 Add this line to your application's Gemfile:
 
@@ -23,7 +23,10 @@ Or install it yourself as:
 
     $ gem install polite_text
 
-## Usage
+## Usage with the default swear words list 🌝
+
+### Swear words  🔞
+PoliteText has a default list of forbidden words, this list includes the most common swear words used on the web. You can acces the list of swear words [here](https://github.com/OpenGems/polite_text/blob/master/lib/locales/en.yml).
 
 ### Remove swear words 🤬
 ```
@@ -32,7 +35,6 @@ include PoliteText
 str = "This gem is a fucking big shit but let's try it"
 
 PoliteText.be_polite!(str)
-
 => "This gem is a *** big *** but let's try it"
 ```
 
@@ -43,20 +45,86 @@ include PoliteText
 str = "This gem is a fucking big shit but let's try it"
 
 PoliteText.is_polite?(str)
+=> false
+```
+
+### Example for an Article model
+
+```
+# == Schema Information
+#
+# Table name: articles
+#
+#  id         :bigint           not null, primary key
+#  text      :string           default(""), not null
+#  created_at :datetime         not null
+#  updated_at :datetime         not null
+#
+
+class Article < ApplicationRecord
+  include PoliteText
+
+  # Callbacks
+  before_save :make_text_polite
+
+  # Methods
+  def make_text_polite
+    PoliteText.be_polite!(text)
+  end
+end
+```
+
+## Usage with custom swear words list 🌞
+
+### Custom swear words list  🔞
+Create a custom list in a **YAML** file following this format :
+```
+# custom_swear_words.yml
+
+swear_words:
+  - gem
+  - big
+  - but
+```
+
+Place it where you want in your app, we recommend here : `./lib/polite_text/my_custom_swear_words.yml`
 
+## Confirguration
+
+📄 Create an initializer named `polite_text.rb`
+
+✌️ Add the path to your custom swear words list like this :
+
+```
+# ./config/initializers/polite_text.rb
+
+PoliteText.configure do |config|
+  config.custom_swear_words_path = "#{__dir__}/../../lib/polite_text/custom_swear_words.yml"
+end
+```
+
+PoliteText is now configured with your custom list ✨💫
+```
+str = "This gem is a fucking big shit but let's try it"
+
+<<<<<<< HEAD
+PoliteText.be_polite!(str)
+=> "This *** is a fucking *** shit *** let's try it" 
+
+PoliteText.is_polite?(str)
 => false
 ```
 
+
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/OpenGems/polite_text.
 This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.
 
 ### Todo 💪
-- [ ] Allow users to add their own swear words list
-- [ ] Allow users to remove swear words from the default list
-- [ ] Manage locales with I18N
-- [ ] Add swear words from multiple languages
+- [ ] Manage locales with I18N for default swear words lists by country.
+- [ ] Add default swear words lists from multiple languages.
+- [ ] Improve the default swear words list and keeping it short.
 
 ## License
 

data/lib/locales/en.yml

@@ -4,18 +4,24 @@ swear_words:
   - fuck
   - fuckyou
   - fucker
+  - fuckers
   - fucking 
   - dick head
   - dick
   - dickhole
   - cock
   - asshole
+  - assholes
   - son of a bitch
   - bitch
+  - bitches
   - biatch
   - whore
+  - whores
   - bastard
+  - bastards
   - wanker
+  - wankers
   - shit
   - piss
   - pussy

data/lib/polite_text.rb

@@ -3,9 +3,14 @@ require 'polite_text/text_scanner'
 require 'polite_text/text_cleaner'
 
 module PoliteText
-  class Error < StandardError; end
-
   class << self
+    attr_accessor :custom_swear_words_path
+
+    def configure
+      yield self if block_given?
+      check_attrs
+    end
+
     def be_polite!(text)
       PoliteText::TextCleaner.new(text).clean!
     end
@@ -13,5 +18,13 @@ module PoliteText
     def is_polite?(text)
       PoliteText::TextScanner.new(text).match_swear_word?
     end
+
+    private
+
+    def check_attrs
+      unless custom_swear_words_path.is_a?(::String)
+        raise(ArgumentError, 'Invalid path to your custom swear words list.')
+      end
+    end
   end
 end

data/lib/polite_text/base.rb

@@ -6,19 +6,24 @@ module PoliteText
       @swear_words ||= /\b(#{Regexp.union(swear_words_list).source})\b/
     end
 
-    def swear_words_load_path
-      "#{__dir__}/../locales/#{locale}.yml"
-    end
-
-    def swear_words_list
-      YAML.load_file(swear_words_load_path)['swear_words']
+    def swear_words_list()
+      path = custom_swear_words_path ? custom_swear_words_path.to_s : swear_words_load_path
+      YAML.load_file(path)['swear_words']
     end
 
     private
 
-    # Todo: Implement dynamic locale with I18N
+    def custom_swear_words_path
+      @custom_swear_words_path ||= PoliteText.custom_swear_words_path
+    end
+
+    # TODO: Implement dynamic locale with I18N
     def locale
       @locale ||= 'en'
     end
+
+    def swear_words_load_path
+      "#{__dir__}/../locales/#{locale}.yml"
+    end
   end
 end

data/lib/polite_text/text_cleaner.rb

@@ -3,19 +3,13 @@ module PoliteText
     attr_reader :text
 
     def initialize(text)
-      @text = text.to_s
+      raise ArgumentError.new('The text can not be nil') if text.nil?
 
-      validate_text!
+      @text = text.to_s
     end
 
     def clean!
-      text.gsub!(swear_words, '***')
-    end
-
-    private
-
-    def validate_text!
-      raise ArgumentError.new('The text can not be empty') if @text.empty?
+      text.gsub!(swear_words, '***') || text
     end
   end
 end

data/lib/polite_text/text_scanner.rb

@@ -3,19 +3,13 @@ module PoliteText
     attr_reader :text
 
     def initialize(text)
-      @text = text.to_s
+      raise ArgumentError.new('The text can not be nil') if text.nil?
 
-      validate_text!
+      @text = text.to_s
     end
 
     def match_swear_word?
       !@text.match?(swear_words)
     end
-
-    private
-
-    def validate_text!
-      raise ArgumentError.new('The text can not be empty') if @text.empty?
-    end
   end
 end

data/lib/polite_text/version.rb

@@ -1,3 +1,3 @@
 module PoliteText
-  VERSION = "0.1.2"
+  VERSION = "0.3.0"
 end

data/polite_text.gemspec

@@ -17,7 +17,7 @@ Gem::Specification.new do |spec|
 
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
-  spec.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+  spec.files         = Dir.chdir(File.expand_path(__dir__)) do
     `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
   end
   spec.bindir        = 'exe'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: polite_text
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.3.0
 platform: ruby
 authors:
 - DumasOlivier
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-11-05 00:00:00.000000000 Z
+date: 2020-11-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec