liquidity 0.0.1

data/README.rdoc

@@ -0,0 +1,104 @@
+= Motivation
+
+Liquid layouts: the practice (among other things) of rendering a single ul/li group (like this):
+
+  <ul>
+    <li>1</li>
+    <li>2</li>
+    <li>3</li>
+    <li>4</li>
+    <li>5</li>
+    <li>6</li>
+    <li>7</li>
+    <li>8</li>
+    <li>9</li>
+    <li>10</li>
+    <li>11</li>
+  </ul>
+
+into a multi-column layout like this: 
+  
+  1   2   3
+  4   5   6
+  7   8   9
+  10  11
+
+using CSS like this: 
+
+  <style type="text/css">
+    ul {width: 30%}
+    li {width: 33%; text-align: left; float: left}
+  </style>
+
+
+But what if you wanted the data sorted by column, not by row? For this, CSS is inadequate: it's capable of flowing from left to right, 
+top to bottom. So in order to acheive a column sorting, we need to resort the data, like this: 
+
+  <ul>
+    <li>1</li>
+    <li>5</li>
+    <li>9</li>
+    <li>2</li>
+    <li>6</li>
+    <li>10</li>
+    <li>3</li>
+    <li>7</li>
+    <li>11</li>
+    <li>4</li>
+    <li>8</li>
+    <li></li>
+  </ul>
+
+Using the same CSS, this would render: 
+
+  1   5   9
+  2   6   10
+  3   7   11 
+  4   8
+
+The liquidity gem adds a "column_sort" method to the Array class, making it simple to resort your collection for a column-sorted liquid
+layout.
+
+= Installation
+
+Install the gem from rubygems.org:
+
+  # gem install liquidity
+
+= Usage
+
+Though I would imagine you would typically be using this for doing liquid layouts on the web, for the purposes of instruction, we'll
+imagine that we have the following method for printing out an array: 
+
+  require 'liquidity'
+
+  def print_matrix(a)
+    a.each_slice(3) do |slice|
+      puts slice.join("\t")
+    end
+  end
+
+If we passed off the array of (1..11) to it, we would see the following printed: 
+
+  a = (1..11).to_a
+  print_matrix a
+  # ==> 
+    1   2   3
+    4   5   6
+    7   8   9
+    10  11
+   
+Now, imagine that we wanted see the matrix where the data was sorted into columns, not rows. We can use the "column\_sort" method 
+provided by the "liquidity" gem: 
+
+  a = (1..11).to_a
+  print_matrix a.column_sort(3)
+  # ==> 
+    1   5   9
+    2   6   10
+    3   7   11 
+    4   8
+
+== Passing a block to column_sort 
+
+Just like the {Array::sort}[http://ruby-doc.org/core/classes/Array.html#M002185] method, you can pass a block to column_sort. 

data/lib/liquidity.rb

@@ -0,0 +1,2 @@
+require 'enumerator'
+require 'liquidity/liquidity'

data/lib/liquidity/liquidity.rb

@@ -0,0 +1,61 @@
+class Array
+  
+  #Though I would imagine you would typically be using this for doing liquid layouts on the web, for the purposes of instruction, we'll
+  #imagine that we have the following method for printing out an array: 
+  #
+  #  require 'liquidity'
+  #
+  #  def print_matrix(a)
+  #    a.each_slice(3) do |slice|
+  #      puts slice.join("\t")
+  #    end
+  #  end
+  #
+  #If we passed off the array of (1..11) to it, we would see the following printed: 
+  #
+  #  a = (1..11).to_a
+  #  print_matrix a
+  #  # ==> 
+  #    1   2   3
+  #    4   5   6
+  #    7   8   9
+  #    10  11
+  #   
+  #Now, imagine that we wanted see the matrix where the data was sorted into columns, not rows. We can use the "column\_sort" method 
+  #provided by the "liquidity" gem: 
+  #
+  #  a = (1..11).to_a
+  #  print_matrix a.column_sort(3)
+  #  # ==> 
+  #    1   5   9
+  #    2   6   10
+  #    3   7   11 
+  #    4   8
+  #
+  #== Passing a block to column_sort 
+  #
+  #Just like the {Array::sort}[http://ruby-doc.org/core/classes/Array.html#M002185] method, you can pass a block to column_sort. 
+  def column_sort(num_columns, &block)
+    new_array = sort(&block)
+    new_length = new_array.length % num_columns == 0 ? new_array.length : new_array.length + num_columns - new_array.length % num_columns
+    new_array.pad(new_length).slices(num_columns).transpose.flatten
+  end
+
+  # pad an array to a new length, adding nil elements onto the end of the collection 
+  def pad(new_length)
+    if new_length > length
+      self + ([nil] * (new_length - length))
+    else
+      self
+    end
+  end
+
+  # return a new array, sliced up into a given number of smaller arrays.
+  # e.g.: 
+  #   [1,2,3,4].slices(2) #==> [[1,2],[3,4]]
+  def slices(num_slices)
+    array_of_slices = []
+    each_slice(length / num_slices) { |s| array_of_slices << s }
+    array_of_slices
+  end
+end

metadata

@@ -0,0 +1,64 @@
+--- !ruby/object:Gem::Specification 
+name: liquidity
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Matt Parker
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-04-04 00:00:00 -04:00
+default_executable: 
+dependencies: []
+
+description: This gem adds a "column_sort" method to the Array class.
+email: moonmaster9000@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- README.rdoc
+- lib/liquidity.rb
+- lib/liquidity/liquidity.rb
+has_rdoc: true
+homepage: http://github.com/moonmaster9000/liquidity
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: A gem for making column-sorted liquid layouts simple.
+test_files: []
+