ants 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 7ce5b471679d1171433e6413906b18f29db61f66
+  data.tar.gz: a3e3981563e6ed41ef7805928d8146ff90cde0c4
+SHA512:
+  metadata.gz: e4ffc38efd70ed6c060f324463bf20d98201df87d57e553a4a9cc0e26f7f4f0499705c2d1ce2bf70ca443bfff031644dee70e2302acdc2ed7d77e5055130d077
+  data.tar.gz: 7b01d8e62ed8e5fdff08303efae9b175c8f0173165d12ab6f634bc97b088b5b3d52a79504e0fc13c8d298d2a63aa84a6879e2c356a95b54181303199237e241b

data/.gitignore

@@ -0,0 +1,38 @@
+*.rbc
+capybara-*.html
+.rspec
+/log
+/tmp
+/db/*.sqlite3
+/db/*.sqlite3-journal
+/public/system
+/coverage/
+/spec/tmp
+**.orig
+rerun.txt
+pickle-email-*.html
+
+# TODO Comment out these rules if you are OK with secrets being uploaded to the repo
+config/initializers/secret_token.rb
+config/secrets.yml
+
+## Environment normalisation:
+/.bundle
+/vendor/bundle
+
+# these should all be checked in to normalise the environment:
+# Gemfile.lock, .ruby-version, .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+
+# if using bower-rails ignore default bower_components path bower.json files
+/vendor/assets/bower_components
+*.bowerrc
+bower.json
+
+# Ignore pow environment settings
+.powenv
+
+# Mac chached files
+.DS_Store

data/Gemfile

@@ -0,0 +1,3 @@
+source "http://rubygems.org"
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,141 @@
+PATH
+  remote: .
+  specs:
+    ants (0.1.0)
+      mongoid (>= 4.0)
+      mongoid-slug (>= 4.0.0)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    actionmailer (4.2.1)
+      actionpack (= 4.2.1)
+      actionview (= 4.2.1)
+      activejob (= 4.2.1)
+      mail (~> 2.5, >= 2.5.4)
+      rails-dom-testing (~> 1.0, >= 1.0.5)
+    actionpack (4.2.1)
+      actionview (= 4.2.1)
+      activesupport (= 4.2.1)
+      rack (~> 1.6)
+      rack-test (~> 0.6.2)
+      rails-dom-testing (~> 1.0, >= 1.0.5)
+      rails-html-sanitizer (~> 1.0, >= 1.0.1)
+    actionview (4.2.1)
+      activesupport (= 4.2.1)
+      builder (~> 3.1)
+      erubis (~> 2.7.0)
+      rails-dom-testing (~> 1.0, >= 1.0.5)
+      rails-html-sanitizer (~> 1.0, >= 1.0.1)
+    activejob (4.2.1)
+      activesupport (= 4.2.1)
+      globalid (>= 0.3.0)
+    activemodel (4.2.1)
+      activesupport (= 4.2.1)
+      builder (~> 3.1)
+    activerecord (4.2.1)
+      activemodel (= 4.2.1)
+      activesupport (= 4.2.1)
+      arel (~> 6.0)
+    activesupport (4.2.1)
+      i18n (~> 0.7)
+      json (~> 1.7, >= 1.7.7)
+      minitest (~> 5.1)
+      thread_safe (~> 0.3, >= 0.3.4)
+      tzinfo (~> 1.1)
+    arel (6.0.0)
+    bson (2.3.0)
+    builder (3.2.2)
+    connection_pool (2.2.0)
+    diff-lcs (1.2.5)
+    erubis (2.7.0)
+    globalid (0.3.5)
+      activesupport (>= 4.1.0)
+    i18n (0.7.0)
+    json (1.8.2)
+    loofah (2.0.1)
+      nokogiri (>= 1.5.9)
+    mail (2.6.3)
+      mime-types (>= 1.16, < 3)
+    mime-types (2.5)
+    mini_portile (0.6.2)
+    minitest (5.6.1)
+    mongoid (4.0.2)
+      activemodel (~> 4.0)
+      moped (~> 2.0.0)
+      origin (~> 2.1)
+      tzinfo (>= 0.3.37)
+    mongoid-slug (4.0.0)
+      mongoid (>= 3.0)
+      stringex (~> 2.0)
+    moped (2.0.4)
+      bson (~> 2.2)
+      connection_pool (~> 2.0)
+      optionable (~> 0.2.0)
+    nokogiri (1.6.6.2)
+      mini_portile (~> 0.6.0)
+    optionable (0.2.0)
+    origin (2.1.1)
+    rack (1.6.0)
+    rack-test (0.6.3)
+      rack (>= 1.0)
+    rails (4.2.1)
+      actionmailer (= 4.2.1)
+      actionpack (= 4.2.1)
+      actionview (= 4.2.1)
+      activejob (= 4.2.1)
+      activemodel (= 4.2.1)
+      activerecord (= 4.2.1)
+      activesupport (= 4.2.1)
+      bundler (>= 1.3.0, < 2.0)
+      railties (= 4.2.1)
+      sprockets-rails
+    rails-deprecated_sanitizer (1.0.3)
+      activesupport (>= 4.2.0.alpha)
+    rails-dom-testing (1.0.6)
+      activesupport (>= 4.2.0.beta, < 5.0)
+      nokogiri (~> 1.6.0)
+      rails-deprecated_sanitizer (>= 1.0.1)
+    rails-html-sanitizer (1.0.2)
+      loofah (~> 2.0)
+    railties (4.2.1)
+      actionpack (= 4.2.1)
+      activesupport (= 4.2.1)
+      rake (>= 0.8.7)
+      thor (>= 0.18.1, < 2.0)
+    rake (10.4.2)
+    rspec (3.2.0)
+      rspec-core (~> 3.2.0)
+      rspec-expectations (~> 3.2.0)
+      rspec-mocks (~> 3.2.0)
+    rspec-aspic (0.0.2)
+    rspec-core (3.2.3)
+      rspec-support (~> 3.2.0)
+    rspec-expectations (3.2.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.2.0)
+    rspec-mocks (3.2.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.2.0)
+    rspec-support (3.2.2)
+    sprockets (3.0.2)
+      rack (~> 1.0)
+    sprockets-rails (2.2.4)
+      actionpack (>= 3.0)
+      activesupport (>= 3.0)
+      sprockets (>= 2.8, < 4.0)
+    stringex (2.5.2)
+    thor (0.19.1)
+    thread_safe (0.3.5)
+    tzinfo (1.2.2)
+      thread_safe (~> 0.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  ants!
+  rails (>= 4.1)
+  rake (>= 0.8.7)
+  rspec (>= 2.0)
+  rspec-aspic (>= 0.0.2)

data/LICENSE.md

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 [Slate Studio, LLC.](http://slatestudio.com)
+
+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.
+

data/README.md

@@ -0,0 +1,30 @@
+# ants
+Collection of concerns and helpers for Rails + Mongoid + Character web development
+
+
+### Sorted Relations
+
+In Mongoid, the HM & HABTM relations return docs in the wrong order. This workaround provides an ability to retrieve related documents in the same order it was stored.
+
+Usage example:
+
+  ```ruby
+  class Post
+    include Mongoid::Document
+    include Ants::SortedRelations
+
+    field :title
+
+    has_and_belongs_to_many :authors
+    sorted_relations_for :authors
+  end
+
+  post = Post.new title: 'RESTful actions with Mongosteen'
+  post.sorted_author_ids = [ Author.create(name: "Oleksandr Kravets").id,
+                             Author.create(name: "Roman Brazhnyk"   ).id,
+                             Author.create(name: "Maxim Melnyk"     ).id ]
+
+  post.sorted_authors.map(&:name)
+  #=> ['Alexander Kravets', 'Roman Brazhnyk', 'Maxim Melnyk']
+  ```
+

data/Rakefile

@@ -0,0 +1,3 @@
+# encoding: utf-8
+require "rubygems"
+require "bundler"

data/ants.gemspec

@@ -0,0 +1,33 @@
+# coding: utf-8
+$:.push File.expand_path('../lib', __FILE__)
+require 'ants/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'ants'
+  s.version     = Ants::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = [ 'Alexander Kravets' ]
+  s.email       = 'alex@slatestudio.com'
+  s.license     = 'MIT'
+  s.homepage    = 'https://github.com/slate-studio/ants'
+  s.summary     = 'Collection of concerns for Rails + Mongoid + Character web development'
+  s.description = <<-DESC
+Collection of concerns and helpers for Rails + Mongoid + Character web development
+  DESC
+
+  s.rubyforge_project = 'ants'
+  s.files             = `git ls-files`.split("\n")
+  s.require_paths     = [ 'lib' ]
+
+  s.add_dependency('mongoid',      '>= 4.0'  )
+  s.add_dependency('mongoid-slug', '>= 4.0.0')
+
+  s.add_development_dependency('rails',       [ '>= 4.1'   ])
+  s.add_development_dependency('rake',        [ '>= 0.8.7' ])
+  s.add_development_dependency('rspec',       [ '>= 2.0'   ])
+  s.add_development_dependency('rspec-aspic', [ '>= 0.0.2' ])
+end
+
+
+
+

data/lib/ants.rb

@@ -0,0 +1,17 @@
+require 'mongoid'
+require 'mongoid_slug'
+
+module Ants
+  require 'ants/engine'
+
+  require "mongoid/fake_criteria"
+
+  require "concerns/ants/id"
+  require "concerns/ants/featurable"
+  require "concerns/ants/hideable"
+  require "concerns/ants/orderable"
+  require "concerns/ants/meta"
+  require "concerns/ants/slug"
+  require "concerns/ants/publication"
+  require "concerns/ants/sorted_relations"
+end

data/lib/ants/engine.rb

@@ -0,0 +1,5 @@
+module Ants
+  class Engine < ::Rails::Engine
+    # auto wire
+  end
+end

data/lib/ants/version.rb

@@ -0,0 +1,3 @@
+module Ants
+  VERSION = "0.1.0"
+end

data/lib/concerns/ants/featurable.rb

@@ -0,0 +1,43 @@
+module Ants
+  module Featurable
+    extend ActiveSupport::Concern
+
+    included do
+      # attributes
+      field :featured, type: Boolean, default: false
+
+      # scopes
+      scope :featured,     -> { where(featured: true) }
+      scope :not_featured, -> { where(featured: false) }
+
+      # indexes
+      index({ featured: 1 })
+
+
+      # helpers
+      def featured?
+        self.featured
+      end
+
+
+      def set_featured!
+        return if self.featured?
+        self.featured = true
+        self.save!
+      end
+
+
+      def unset_featured!
+        return unless self.featured?
+        self.featured = false
+        self.save!
+      end
+
+
+    end
+  end
+end
+
+
+
+

data/lib/concerns/ants/hideable.rb

@@ -0,0 +1,43 @@
+module Ants
+  module Hideable
+    extend ActiveSupport::Concern
+
+    included do
+      # attributes
+      field :hidden, type: Boolean, default: false
+
+      # scopes
+      scope :hidden,     -> { where(hidden: true)  }
+      scope :not_hidden, -> { where(hidden: false) }
+
+      # indexes
+      index({ hidden: 1 })
+
+
+      # helpers
+      def hidden?
+        self.hidden
+      end
+
+
+      def hide!
+        return if self.hidden?
+        self.hidden = true
+        self.save!
+      end
+
+
+      def unhide!
+        return unless self.hidden?
+        self.hidden = false
+        self.save!
+      end
+
+
+    end
+  end
+end
+
+
+
+

data/lib/concerns/ants/id.rb

@@ -0,0 +1,25 @@
+module Ants
+  module Id
+    extend ActiveSupport::Concern
+
+    def serializable_hash(options={})
+
+      attrs = super(options)
+
+      attrs.each_pair do |k, v|
+
+        if k.end_with?('_id')
+          attrs[k] = v.to_s
+        end
+
+        if k.end_with?('_ids')
+          attrs[k] = attrs[k].collect { |id| id.to_s }
+        end
+
+      end
+
+      return attrs
+    end
+
+  end
+end

data/lib/concerns/ants/meta.rb

@@ -0,0 +1,39 @@
+module Ants
+  module Meta
+    extend ActiveSupport::Concern
+
+    included do
+
+      field :_meta_title,          default: ''
+      field :_meta_description,    default: ''
+      field :_meta_keywords,       default: ''
+      field :_opengraph_image_url, default: ''
+
+
+      # these helpers to be used for meta_tags helper,
+      # override them to add custom logic
+      def meta_title
+        _meta_title
+      end
+
+
+      def meta_description
+        _meta_description
+      end
+
+
+      def meta_keywords
+        _meta_keywords
+      end
+
+
+      def opengraph_image_url
+        _opengraph_image_url
+      end
+
+
+    end
+  end
+end
+
+

data/lib/concerns/ants/orderable.rb

@@ -0,0 +1,33 @@
+# ==========================================================================
+#
+# IMPORTANT: this default value raises "stack level too deep" if concern is
+#            included for existing objects, to fix issue update _position
+#            value for all objects like this:
+#
+#            > ModelClass.all.set(_position: 1000)
+#
+# ==========================================================================
+
+module Ants
+  module Orderable
+    extend ActiveSupport::Concern
+
+    included do
+
+      # attributes
+      field :_position, type: Float, default: -> { (self.class.all.last.try(:_position) || 1000) + 10 }
+
+      # scopes
+      default_scope -> { order_by(_position: :asc) }
+
+      # helpers
+      index({ _position: 1 })
+
+
+    end
+  end
+end
+
+
+
+

data/lib/concerns/ants/publication.rb

@@ -0,0 +1,79 @@
+module Ants
+  module Publication
+    extend ActiveSupport::Concern
+
+    included do
+      include Mongoid::Timestamps
+
+      include Ants::Id
+      include Ants::Featurable
+      include Ants::Orderable
+      include Ants::Slug
+      include Ants::Meta
+
+      # attributes
+      field :title
+      field :draft,        type: Boolean,  default: false
+      field :published_at, type: DateTime, default: -> { DateTime.now }
+
+      # slug
+      slug :title
+
+      # validations
+      validates_presence_of :title, :published_at
+
+      # scopes
+      scope :drafts,           -> { where(draft: true)                                           }
+      scope :ready_to_publish, -> { where(draft: false)                                          }
+      scope :scheduled,        -> { ready_to_publish.where(:published_at.gt  => Time.zone.now)   }
+      scope :published,        -> { ready_to_publish.where(:published_at.lte => Time.zone.now)   }
+      # override featured scope set by Ants::Featured to add ordering by _position
+      scope :featured,         -> { unscoped.published.where(featured: true).asc(:_position)     }
+      scope :featured_first,   -> { unscoped.desc(:featured).asc(:_position).desc(:published_at) }
+      # override default_scope set by Ants::Orderable
+      default_scope            -> { desc(:published_at).desc(:created_at)                        }
+
+      # indexes @TODO: verify if these indexes are required
+      index({ featured:     -1, _position:   1, published_at: -1 }) # featured first
+      index({ featured:     -1, _position:   1 })                   # featured
+      index({ published_at: -1, created_at: -1 })                   # default
+
+
+      # helpers
+      def draft?
+        self.draft
+      end
+
+
+      def published?
+        ! draft? && published_at <= Time.zone.now
+      end
+
+
+      def scheduled?
+        ! draft? && published_at > Time.zone.now
+      end
+
+
+      def _list_item_title
+        title
+      end
+
+
+      def _list_item_subtitle
+        published_at.strftime("%B %d, %Y @ %l:%M %P")
+      end
+
+
+      def meta_title
+        _meta_title.present || title
+      end
+
+
+    end
+  end
+end
+
+
+
+

data/lib/concerns/ants/slug.rb

@@ -0,0 +1,67 @@
+# =============================================================================
+#
+# Ants::Slug provides a flexible way to define a custom slug on a top of
+# Mongoid::Slug module, a few cases are covered:
+#
+#   1. if _slug is not defined, slug is autogenerated based on specified
+#      configuration
+#   2. if _slug is defined it's used as default
+#   3. if _slug is empty slug is autogenerated as in step 1
+#   4. if slug configuration field has changed value and _slug is set, _slug
+#      is used as default
+#
+# -----------------------------------------------------------------------------
+
+module Ants
+  module Slug
+    extend ActiveSupport::Concern
+
+
+    included do
+      include Mongoid::Slug
+
+      # attributes
+      field :_slug, default: ''
+
+      # callbacks
+      before_save :_populate_custom_slug
+
+
+      # helpers
+      def _populate_custom_slug
+        self.slugs = []
+
+        if ! self._slug.empty?
+          append_slug(self._slug)
+        end
+
+        return true
+      end
+
+
+      # override Mongoid::Slug method to workaround slug change
+      def slug_builder
+        _cur_slug = nil
+
+        # if custom slug is defined use that
+        if ! self._slug.empty?
+          append_slug(self._slug)
+        end
+
+        # user defined slug
+        if new_with_slugs? or persisted_with_slug_changes?
+          _cur_slug = _slugs.last
+        end
+
+        # generate slug if the slug is no custom slug defined or does not exist
+        _cur_slug || pre_slug_string
+      end
+
+
+    end
+  end
+end
+
+
+
+

data/lib/concerns/ants/sorted_relations.rb

@@ -0,0 +1,114 @@
+# =============================================================================
+#
+# class Book
+#   include Mongoid::Document
+#   include Mongoid::SortedRelations
+#
+#   field :title
+#
+#   has_many :chapters
+#   sorted_relations_for :chapters
+#
+#   has_and_belongs_to_many :authors
+#   sorted_relations_for :authors
+# end
+#
+# b = Book.create('Hello')
+#
+# b.sorted_chapter_ids = [ Chapter.create(:title => 'The End').id,
+#                          Chapter.create(:title => 'Part 3' ).id,
+#                          Chapter.create(:title => 'Part 2' ).id,
+#                          Chapter.create(:title => 'Part 1' ).id,
+#                          Chapter.create(:title => 'Intro'  ).id ]
+#
+# b.sorted_chapters()
+#
+# book.sorted_author_ids = [ Author.create(:name => 'Sun Tzu').id,
+#                            Author.create(:name => 'Sun Wu' ).id,
+#                            Author.create(:name => 'Lao Zi' ).id ]
+#
+# book.sorted_authors()
+#
+# =============================================================================
+
+module Ants
+  module SortedRelations
+    extend ActiveSupport::Concern
+
+    class_methods do
+
+      def sorted_relations_for(relation_name)
+        relation = self.relations[relation_name.to_s]
+
+        if relation.macro == :has_and_belongs_to_many
+          define_has_and_belongs_to_many_sorted_methods(relation)
+        end
+
+        if relation.macro == :has_many
+          define_has_many_sorted_methods(relation)
+        end
+      end
+
+
+      #
+      # HAS_AND_BELONGS_TO_MANY
+      #
+      def define_has_and_belongs_to_many_sorted_methods(relation)
+        # sorted_#{ relation.name }
+        self.send(:define_method, "sorted_#{ relation.name }") do
+          related_documents   = self.send(relation.name)
+          sorted_relation_ids = self.send("#{ relation.name.to_s.singularize }_ids").map { |id| id.to_s }
+
+          sorted_documents = related_documents.sort_by do |document|
+            sorted_relation_ids.index(document.id.to_s)
+          end
+
+          return Mongoid::FakeCriteria.new(sorted_documents)
+        end
+
+        # sorted_#{ relation.name } = [ <array of ids> ]
+        self.send(:define_method, "sorted_#{ relation.name.to_s.singularize }_ids=") do |ids|
+          self.send("#{ relation.name.to_s.singularize }_ids=", ids)
+        end
+      end
+
+
+      #
+      # HAS_MANY
+      #
+      def define_has_many_sorted_methods(relation)
+        # define field to store order for has_many related documents
+        self.field "_sorted_#{ relation.name.to_s.singularize }_ids", :type => Array, default: []
+
+        # sorted_#{ relation.name }
+        self.send(:define_method, "sorted_#{ relation.name }") do
+          related_documents   = self.send(relation.name)
+          sorted_relation_ids = self["_sorted_#{ relation.name.to_s.singularize }_ids"].map { |id| id.to_s }
+
+          # missing or new ids are in random order
+          sorted_documents = related_documents.sort_by do |document|
+            sorted_relation_ids.index(document.id.to_s)
+          end
+
+          return Mongoid::FakeCriteria.new(sorted_documents)
+        end
+
+        # sorted_#{ relation.name } = [ <array of ids> ]
+        self.send(:define_method, "sorted_#{ relation.name.to_s.singularize }_ids=") do |ids|
+          ids = ids.map{ |id| id.to_s }
+
+          self.update_attributes({
+            "_sorted_#{ relation.name.to_s.singularize }_ids" => ids, # store order
+            "#{ relation.name.to_s.singularize }_ids"         => ids  # update relations
+          })
+        end
+      end
+
+
+    end
+  end
+end
+
+
+
+

data/lib/mongoid/fake_criteria.rb

@@ -0,0 +1,29 @@
+module Mongoid
+  class FakeCriteria
+
+    def initialize(documents)
+      @documents = documents
+    end
+
+
+    def limit(quantity)
+      Mongoid::FakeCriteria.new(@documents[0..quantity-1])
+    end
+
+
+    def raw
+      @documents
+    end
+
+
+    def as_json(options={})
+      @documents.as_json(options)
+    end
+
+
+    def method_missing(*args, &block)
+      @documents.send(*args, &block)
+    end
+
+  end
+end

data/spec/mongoid/fake_criteria_spec.rb

@@ -0,0 +1,19 @@
+require 'spec_helper'
+
+describe Mongoid::FakeCriteria do
+
+  context "with the books ['book 1', 'book 2', 'book 3', 'book 4']" do
+    let(:books) { Mongoid::FakeCriteria.new(['book 1', 'book 2', 'book 3', 'book 4']) }
+
+    describe "#limit" do
+      the ("books.limit(2).raw") { should eql ['book 1', 'book 2'] }
+      the ("books.limit(0).raw") { should eql ['book 1', 'book 2', 'book 3', 'book 4'] }
+      the ("books.limit(6).raw") { should eql ['book 1', 'book 2', 'book 3', 'book 4'] }
+    end
+
+    context "#count" do
+      the ("books.count") { should eql 4 }
+    end
+  end
+
+end

data/spec/mongoid/sorted_relations_spec.rb

@@ -0,0 +1,35 @@
+require 'spec_helper'
+
+describe Ants::SortedRelations do
+
+  context "Having the book The Art of War" do
+    let(:book) { Book.new(:title => 'The Art of War') }
+
+    context "written by the authors Lao Zi, Sun Wu and Sun Tzu." do
+      before { book.sorted_author_ids = [ Author.create(:name => 'Sun Tzu').id,
+                                          Author.create(:name => 'Sun Wu' ).id,
+                                          Author.create(:name => 'Lao Zi' ).id ] }
+      before { book.save and book.reload }
+      before { book.sorted_author_ids = book.author_ids.map { |id| id.to_s }.reverse }
+
+      the("book.sorted_authors.map(&:name)") { should eql ['Lao Zi', 'Sun Wu', 'Sun Tzu'] }
+    end
+  end
+
+  context "Having the book War and Piece" do
+    let(:book) { Book.create(:title => 'War and Piece') }
+
+    context "to have chapters Intro, Part 1, Part 2, Part 3 and The End." do
+      before { book.sorted_chapter_ids = [ Chapter.create(:title => 'The End').id,
+                                           Chapter.create(:title => 'Part 3').id,
+                                           Chapter.create(:title => 'Part 2').id,
+                                           Chapter.create(:title => 'Part 1').id,
+                                           Chapter.create(:title => 'Intro').id ] }
+      before { book.reload }
+      before { book.sorted_chapter_ids = book.chapter_ids.map { |id| id.to_s }.reverse }
+
+      the("book.sorted_chapters.map(&:title)") { should eql ['Intro', 'Part 1', 'Part 2', 'Part 3', 'The End'] }
+    end
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,24 @@
+require 'rubygems'
+require 'bundler/setup'
+require 'rails/all'
+
+require 'rspec'
+require 'rspec-aspic'
+
+require 'mongoid'
+require File.expand_path('../../lib/ants', __FILE__)
+
+
+Mongoid.configure do |config|
+  config.connect_to('mongoid_ants_test')
+end
+
+Dir[ "#{File.dirname(__FILE__)}/support/**/*.rb" ].each { |f| require f }
+
+RSpec.configure do |config|
+  config.mock_with :rspec
+  config.include RSpecAspic
+  config.after :each do
+    Mongoid.purge!
+  end
+end

data/spec/support/models/author.rb

@@ -0,0 +1,9 @@
+class Author
+  include Mongoid::Document
+
+  # attributes
+  field :name
+
+  # relations
+  has_and_belongs_to_many :books
+end

data/spec/support/models/book.rb

@@ -0,0 +1,14 @@
+class Book
+  include Mongoid::Document
+  include Ants::SortedRelations
+
+  # attributes
+  field :title
+
+  # relations
+  has_many :chapters
+  sorted_relations_for :chapters
+
+  has_and_belongs_to_many :authors
+  sorted_relations_for :authors
+end

data/spec/support/models/chapter.rb

@@ -0,0 +1,9 @@
+class Chapter
+  include Mongoid::Document
+
+  # attributes
+  field :title
+
+  # relations
+  belongs_to :book
+end

metadata

@@ -0,0 +1,153 @@
+--- !ruby/object:Gem::Specification
+name: ants
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Alexander Kravets
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-05-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: mongoid
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: mongoid-slug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.0.0
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.1'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.8.7
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.8.7
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rspec-aspic
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.0.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.0.2
+description: |
+  Collection of concerns and helpers for Rails + Mongoid + Character web development
+email: alex@slatestudio.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- Gemfile.lock
+- LICENSE.md
+- README.md
+- Rakefile
+- ants.gemspec
+- lib/ants.rb
+- lib/ants/engine.rb
+- lib/ants/version.rb
+- lib/concerns/ants/featurable.rb
+- lib/concerns/ants/hideable.rb
+- lib/concerns/ants/id.rb
+- lib/concerns/ants/meta.rb
+- lib/concerns/ants/orderable.rb
+- lib/concerns/ants/publication.rb
+- lib/concerns/ants/slug.rb
+- lib/concerns/ants/sorted_relations.rb
+- lib/mongoid/fake_criteria.rb
+- spec/mongoid/fake_criteria_spec.rb
+- spec/mongoid/sorted_relations_spec.rb
+- spec/spec_helper.rb
+- spec/support/models/author.rb
+- spec/support/models/book.rb
+- spec/support/models/chapter.rb
+homepage: https://github.com/slate-studio/ants
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: ants
+rubygems_version: 2.4.6
+signing_key: 
+specification_version: 4
+summary: Collection of concerns for Rails + Mongoid + Character web development
+test_files: []