No commit activity in last 3 years
No release in over 3 years
Sane ActiveRecord tree builder
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
 Dependencies

Runtime

 Project Readme

acts_as_sane_tree¶ ↑

(Building trees with a dash of sanity)¶ ↑

<img src=“https://secure.travis-ci.org/chrisroberts/acts_as_sane_tree.png” />

This is a drop in replacement for acts_as_tree on systems with Postgresql >= 8.4

What this provides¶ ↑

A fast way to build trees.

What version of Rails¶ ↑

  • Rails ~> 4.1.0

  • Rails ~> 4.0.0

  • Rails ~> 3.2.0

  • Rails ~> 3.1.0

  • Rails ~> 3.0.0

  • Rails ~> 2.3.0

Requirements¶ ↑

  • PostgreSQL version >= 8.4

  • ActiveRecord

Configuration¶ ↑

Same as acts_as_tree. Basically: Specify a parent_id or the column that holds the parent ID information.

class MyFancyTree < ActiveRecord::Base
  acts_as_sane_tree
end

Extras¶ ↑

A few extras are provided. Of note are:

  • #depth -> depth from root of the current node

  • #descendents -> all descendents of the current node (provided in either scope or nested hash)

  • nodes_within?(src, chk) - Returns true if chk contains any nodes found within src and all ancestors of nodes within src

  • nodes_within(src, chk) - Returns any matching nodes from chk found within src and all ancestors within src

  • nodes_and_descendents(*args) - Returns all nodes and descendents for given IDs or records. Provided in either scope or nested hash.

  • Works properly with STI

  • Adds ‘depth’ attribute to returned model instances

Documentation¶ ↑

Yes, there is documentation. Please read it and find all the fun tools at your fingertips:

chrisroberts.github.com/acts_as_sane_tree

Thanks¶ ↑

  • Thanks to David Hansson for the original

  • Thanks to PostgreSQL for providing tools for sanity

License¶ ↑

A (now not so large) majority of this was copied directly from the original acts as tree, with the original license:

  • Copyright © 2007 David Heinemeier Hansson, released under the MIT license

The new additions continue:

  • Copyright © 2011 Chris Roberts, released under the MIT license