0.0
No commit activity in last 3 years
No release in over 3 years
This gem gives functional for update elements has_many relation
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.5
~> 10
~> 2.14
~> 1.3
 Project Readme

acts_has_many Build Status

Acts_has_many gem gives functional for useing common resources with has_many relation or has_many :trhough. The aim is common using records with has_many relation without duplications and gerbage, every erecord will be used

Installation

Add this line to your application's Gemfile:

gem 'acts_has_many'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install acts_has_many

Usage

  1. To initialize gem you should add acts_has_many to your common resource model
    class Tag < ActiveRecord::Base
      has_many :postings

      acts_has_many :postings
    end
  1. And add acts_has_many_for to model which will use common resource like:
    class Posting < ActiveRecord::Base
      belongs_to :tag, dependent: :destroy

      acts_has_many_for :tag
    end
  1. Then you could use new functionality
    Posting.first.tag_attributes = {title: 'ruby'}

in case with relation has_many through you could write next:

    Posting.first.tags_collection = [{title: 'ruby'}, {title: 'python'}]

More

acts_has_many options:

  • list relations or after necessary relations
  • :compare (string or symbol; default: :title) - name column with unique elements in table
  • :through (boolean; default: false) - if you use has_many :through
  • &block(should return ActiveRecord::Relation; by default :compare option is used)
  • example: do |params| where arel_table[:title].matches(params[:title]) end

acts_has_many_for options:

  • list necessary relations

<relation>_attributes options:

  • data - Hash (other data use standart way)

<relation>_collection options:

  • data - Array (Records, Hash, Empty)

has_many_update options:

  • data: data for update

has_many_through_update options:

  • :update - array data, data include :id record for update
  • :new - array data for new record

Additional

  • depend_relations - show depend relations(Array)
  • actual? - check actuality(Boolean)
  • condition - call block(in: params, out: ActiveRecord::Relation)
  • destroy! - standart destroy
  • destroy - destroy with cheking actuality record

Examples

Use with has_manay:

  class Posting < ActiveRecord::Base
    belongs_to :tag, dependent: :destroy

    acts_has_many_for :tag
  end

  class Tag < ActiveRecord::Base
    has_many :postings

    acts_has_many :postings, compare: :name
  end

  posting = Posting.create title: 'First posting',
                           tag_attributes: {name: 'ruby'}

  posting.tag # => #<Tag id: 1, title: "ruby">
  Tag.all     # => [#<Tag id: 1, title: "ruby">]

  posting = Posting.create title: 'Second posting',
                           tag_attributes: {name: 'ruby'}

  #NO DUPLICATIONS
  posting.tag # => #<Tag id: 1, title: "ruby">
  Tag.all     # => [#<Tag id: 1, title: "ruby">]

  posting.update_attributes tag_attributes: {name: 'python'}

  #COORRECT UPDATING
  posting.tag # => #<Tag id: 2, title: "python">
  Tag.all     # => [#<Tag id: 1, title: "ruby">, #<Tag id: 2, title: "python">]

  posting.tag_attributes = Tag.first
  posting.save

  #NO UNUSED RECORDS
  Tag.all     # => [#<Tag id: 1, title: "ruby">]

Use with has_many :through

  class Posting < ActiveRecord::Base
    has_many :posting_tags, dependent: :destroy
    has_many :tags, through: :posting_tags

    acts_has_many_for :tags
  end

  class PostingTag < ActiveRecord::Base
    belongs_to :posting
    belongs_to :tag
  end

  class Tag < ActiveRecord::Base
    has_many :postings, through: :posting_tags
    has_many :posting_tags

    acts_has_many :postings, through: true
  end

  posting = Posting.create title: 'First posting',
                           tags_collection: [{name: 'ruby'}, {name: 'python'}]

  posting.tags
  # => [#<Tag id: 1, title: "ruby">, #<Tag id: 2, title: "python">]
  Tag.all
  # => [#<Tag id: 1, title: "ruby">, #<Tag id: 2, title: "python">]

  posting = Posting.create title: 'Second posting',
                           tags_collection: [{name: 'ruby'}, {name: 'java'}]

  posting.tags
  # => [#<Tag id: 1, title: "ruby">, #<Tag id: 3, title: "java">]
  Tag.all
  # => [#<Tag id: 1, title: "ruby">, #<Tag id: 2, title: "python">, #<Tag id: 3, title: "java">]

  posting.update_attributes tags_collection: [Tag.first]

  posting.tags
  # => [#<Tag id: 2, title: "ruby">]
  Tag.all
  # => [#<Tag id: 1, title: "ruby">, #<Tag id: 2, title: "python">]

  Posting.first.destroy

  Tag.all
  # => [#<Tag id: 1, title: "ruby">]

Contributing

You can help improve this project.

Here are some ways you can contribute:

  • by reporting bugs
  • by suggesting new features
  • by writing or editing documentation
  • by writing specifications
  • by writing code
  • by refactoring code
  • by closing issues
  • by reviewing patches

Submitting an Issue

We use the GitHub issue tracker to track bugs and features. Before submitting a bug report or feature request, check to make sure it hasn't already been submitted. You can indicate support for an existing issuse by voting it up. When submitting a bug report, please include a Gist that includes a stack trace and any details that may be necessary to reproduce the bug, including your gem version, Ruby version, and operating system. Ideally, a bug report should include a pull request with failing specs.