ActiveRecord style validations for Liquid content in your ActiveRecord models.
This gem makes 3 class methods available to your models:
validates_liquid_of- Ensures that the liquid content is valid and has all opening/closing tags.validates_presence_of_liquid_variable- Useful to ensure your user content contains the specified Liquid variable(s).validates_liquid_tag- Ensure that user content includes the specified tags, but the tag is optional if it is not present and does not exceed the maximum tag count
gem 'liquid-validations' in your Gemfile.
Then bundle install and you should be all set.
In it's simplest form:
class Article < ActiveRecord::Base
validates_liquid_of :content
validates_presence_of_liquid_variable :content, variable: 'very_important_variable'
validates_liquid_tag :content, tag: 'your_tag', max: 1
endvalidates_liquid_tag takes required tag, max and optional presence property
validates_liquid_tag :content,
tag: 'head_content',
max: 1validates_presence_of_liquid_variable takes an optional container option like this:
validates_presence_of_liquid_variable :content,
variable: 'head_content',
container: 'head' # <html><head>{{ head_content }}</head>...Which you may find useful for scoping. Or not.
Each of these methods make use of ActiveModel's underlying validates_each method so any valid options passed in will be handed off.
A fully tricked out example would be:
validates_liquid_of :content, :on => :create,
:message => 'is invalid liquid.',
:allow_nil => true,
:allow_blank => true,
:if => :needs_validation?,
:unless => Proc.new { |record| record.new_record? }Albeit, that's going a little overboard.
Liquid Validations has been tested (used) with the following:
- 2.3 and up
- 3
- 1.8
- 1.9
- 2.0
That's not to say it won't work with Rails 1.2 or 4, but we haven't yet tested either of those.
This should work outside of Rails as long as your models are using ActiveRecord as the database mapper. However, this is just in theory, and hasn't been tested yet.
If you do find that something is busted, or think improvements can be made
- Fork it
- Create a topic branch -
git checkout -b fix_rails_1-0 - Push to your branch -
git push origin fix_rails_1-0 - Create a Pull Request from your branch
That's it!