repop 0.1.0 (Stable version)
gem for replacing text based on a research key
This gem is derived from "Distlist" project ( https://github.com/MdreW/distlist ) and his work is replace the text according to the keys and values
Installation
In your gemfile
gem "repop"
Then at the command line
bundle install
Create the migration at the command line
rails generate repop:migration
Logic
Repop generates a polymorphic table named "repops". This table have a key field and a value field. A repopable model is connected with "repops" table with a "has_many". Repops gem adds automatically the connection, configure the model for acceptance of "nested_attributes" and make accessible the "repops_attributes" method. In the last add all necessary methods for replace a text based on keys of the model.
Usage
In your model
class UserModel < ActiveRecord::Base
repopable
end
If your wont include some local fields as keys
class UserModel < ActiveRecord::Base
repopable [:email, :name]
end
add keys/values
for adds a key value pair using nested attributes (this example use simple_forms)
In your controller:
@User = User.find(params[:id]) # or whatever you want
@User.repops.build # if your want to prepare a empty pair
In your view
= simple_form_for @user do |f|
= f.error_notification
.form-inputs
= f.input :email
= f,input :name
= f.simple_fields_for :repops do |o|
= o.input :key
= o.input :value
= o.input :_destroy, :as => :select, :include_blank => false, :default => false
.form-actions
= f.button :submit
Without use of "nested_attributes" is same of each other model
@user = User.find(params[:id]) # or whatever you want @user.repops.create(key: "a_key", value: "a_value")
text replacement
The "replace" methods find the keys including braces
str = "Good morning mister {name}, his car {car} is repaired."
user = User.first
user.replace(str) -> "Good morning mister Andrea, his car Fusion 1.6 is repaired."
The "world_replace" methods find any word boundary
str = "Good morning mister name, his car is repaired."
user = User.first
user.world_replace(str) -> "Good morning mister Andrea, his Fusion 1.6 is repaired."
The "repop_regexp" method return a keys regexp with all params and the "repop_value" method return the value for regexp. These methods are usable with "gsub".
user - User.first
"Good morning mister {name}, his car {car} is repaired.".gsub(user.repop_regexp, user.repop_value)
# same as "user.replace("text")"
The "repop_world_regexp" method return a world regexp and "repop_world_value" method return its value. These methods are usable with "gsub".
user - User.first
"Good morning mister name, his car is repaired.".gsub(user.repop_world_regexp, user.repop_world_value)
# same as "user.world_replace("text")"
The next episode:
- good spec test
- class method for search by options or by keys
- a simplified helper
- more documentation
Collaborate
- fork me
- send your code
- tell me your code
- join
- Bring me a coffee