tabulatr 0.0.1

data/.gitignore

@@ -0,0 +1 @@
+pkg

data/Gemfile

@@ -0,0 +1,13 @@
+source 'http://rubygems.org'
+
+gemspec
+
+gem "rails"
+gem "whiny_hash"
+gem "id_stuffer"
+
+group :development, :test do
+  gem 'rspec'
+  gem 'rspec-rails'
+  gem 'webrat'
+end

data/Gemfile.lock

@@ -0,0 +1,106 @@
+PATH
+  remote: .
+  specs:
+    tabulatr (0.0.1)
+      id_stuffer (>= 0.0.1)
+      rails (~> 3.0.3)
+      whiny_hash (>= 0.0.2)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    abstract (1.0.0)
+    actionmailer (3.0.3)
+      actionpack (= 3.0.3)
+      mail (~> 2.2.9)
+    actionpack (3.0.3)
+      activemodel (= 3.0.3)
+      activesupport (= 3.0.3)
+      builder (~> 2.1.2)
+      erubis (~> 2.6.6)
+      i18n (~> 0.4)
+      rack (~> 1.2.1)
+      rack-mount (~> 0.6.13)
+      rack-test (~> 0.5.6)
+      tzinfo (~> 0.3.23)
+    activemodel (3.0.3)
+      activesupport (= 3.0.3)
+      builder (~> 2.1.2)
+      i18n (~> 0.4)
+    activerecord (3.0.3)
+      activemodel (= 3.0.3)
+      activesupport (= 3.0.3)
+      arel (~> 2.0.2)
+      tzinfo (~> 0.3.23)
+    activeresource (3.0.3)
+      activemodel (= 3.0.3)
+      activesupport (= 3.0.3)
+    activesupport (3.0.3)
+    arel (2.0.7)
+    builder (2.1.2)
+    diff-lcs (1.1.2)
+    erubis (2.6.6)
+      abstract (>= 1.0.0)
+    i18n (0.5.0)
+    id_stuffer (0.0.1)
+    mail (2.2.15)
+      activesupport (>= 2.3.6)
+      i18n (>= 0.4.0)
+      mime-types (~> 1.16)
+      treetop (~> 1.4.8)
+    mime-types (1.16)
+    nokogiri (1.4.4)
+    polyglot (0.3.1)
+    rack (1.2.1)
+    rack-mount (0.6.13)
+      rack (>= 1.0.0)
+    rack-test (0.5.6)
+      rack (>= 1.0)
+    rails (3.0.3)
+      actionmailer (= 3.0.3)
+      actionpack (= 3.0.3)
+      activerecord (= 3.0.3)
+      activeresource (= 3.0.3)
+      activesupport (= 3.0.3)
+      bundler (~> 1.0)
+      railties (= 3.0.3)
+    railties (3.0.3)
+      actionpack (= 3.0.3)
+      activesupport (= 3.0.3)
+      rake (>= 0.8.7)
+      thor (~> 0.14.4)
+    rake (0.8.7)
+    rspec (2.3.0)
+      rspec-core (~> 2.3.0)
+      rspec-expectations (~> 2.3.0)
+      rspec-mocks (~> 2.3.0)
+    rspec-core (2.3.1)
+    rspec-expectations (2.3.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.3.0)
+    rspec-rails (2.3.1)
+      actionpack (~> 3.0)
+      activesupport (~> 3.0)
+      railties (~> 3.0)
+      rspec (~> 2.3.0)
+    thor (0.14.6)
+    treetop (1.4.9)
+      polyglot (>= 0.3.1)
+    tzinfo (0.3.23)
+    webrat (0.7.2)
+      nokogiri (>= 1.2.0)
+      rack (>= 1.0)
+      rack-test (>= 0.5.3)
+    whiny_hash (0.0.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  id_stuffer
+  rails
+  rspec
+  rspec-rails
+  tabulatr!
+  webrat
+  whiny_hash

data/LICENSE

@@ -0,0 +1,23 @@
+The MIT License
+
+Copyright (c) 2010-2011 by Provideal GmbH, Peter Horn
+http://www.provideal.net, peter.horn@provideal.net
+
+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.textile

@@ -0,0 +1,284 @@
+h1. Tabulatr - Index Tables made easy, finally
+
+h2. Mission Objective
+
+Tabulatr aims at making the ever-recurring task of creating listings of ActiveRecord models simple and uniform.
+
+We found ourselves reinventing the wheel in every project we made, by using
+
+* different paging mechanisms,
+* different ways of implementing filtering/searching,
+* difterent ways of implementing selecting and batch actions,
+* different layouts.
+
+We finally thought that whilst gems like Formtastic or SimpleForm provide a really cool, uniform, and concise way to implement forms, it's time for a table builder. During a project with Magento (*shiver*) we decided that their general tables are quite reasonable, and enterprise-proven -- so that's our starting point. 
+
+h3. Visual Components
+
+Every Tabulatr table consists of the following components:
+
+* a wrapping form
+* a 'Controls Container' containing the table-controls as
+  * the paginator, 
+  * the batch_actions, 
+  * the submit button, 
+  * controls to manage selecting/checking/marking, 
+  * an info_text
+* The actual table consisting of
+  * A header row,
+  * A filter row,
+  * data rows,
+  * possibly a selecting/checking/marking column
+  * possibly action links/buttons
+  
+Whilst this is a strong decision, we made everything as-configurable-as-possible, there are roughly 150 options you can use to tweak almost every aspect of Tabulatr.
+
+h3. Features
+
+Tabulatr tries to make these common tasks as simple/transparent as possible:
+* paging
+* selecting/checking/marking
+* filtering
+* batch actions
+
+h2. Example
+
+h3. Models
+
+We suppose we have a couple of models
+* tags has and belong to many products
+* vendors have many products
+* products belong to vendors and have and belong to many tags
+  
+h3. Controller
+
+In the products controllers index action we have:
+
+<pre>
+  def index
+    @products = Product.find_for_table(params)
+  end
+</pre>
+
+the find_for_table method is injected into ActiveRecord by Tabulatr, it retrieves all relevant data from the params hash automagically.
+
+h3.View
+
+To get a simple Table, all we need to do is
+
+<pre>
+  <%= table_for @products do |t|
+    t.column :id
+    t.column :title
+    t.column :price
+    t.column :active
+    t.association :vendor, :name
+    t.association :tags, :title
+  end %>
+</pre>
+
+but the result is pretty fancy, already:
+
+<img src="assets/simple_table.png" />
+
+To add a column with ckeckboxes (thus giving all the "Select ..." buttons a reasonable semantics), we simply add a
+<pre>
+  t.checkbox  
+</pre>
+row.
+
+To add e.g. edit-buttons, we specify
+<pre>
+  t.action do |record|
+    link_to "Edit", edit_product_path(record)
+  end
+</pre>
+
+To add a select-popup with batch-actions (i.e., actions that are to be perfored on all selected rows), we add an option to the table_for:
+<pre>
+  <%= table_for @products, :batch_actions => {'foo' => 'Foo', 'delete' => "Delete"} do |t|
+    ...
+  end %>
+</pre>
+
+to handle the actual batch action, we have to add a block to the <tt>find_for_table</tt> call in the controller:
+<pre>
+  @products = Product.find_for_table(params) do |batch_actions|
+    batch_actions.delete do |ids|
+      ids.each do |id|
+        Product.find(id).destroy
+      end
+      redirect_to index_select_products_path()
+      return
+    end
+    batch_actions.foo do |ids|
+      # do whatever is foo-ish to the records
+    end
+  end
+</pre>
+where the <tt>ids</tt> parameter to the block is actually an Array containing the numeric ids of the currently selected rows.
+
+h2. Options
+
+Literally every aspect of Tabulatr can be tweaked to fit your needs. You may add or remove components, change the class or other html attributes of the generated html nodes. There are options of several types:
+
+h3. Table Options
+
+These options are to be specified at the form_for level and change the appearance and behaviour of the table. This is taken from <tt>lib/tabulatr/tabulatr/settings.rb</tt>
+
+<pre>
+  remote: false,                               # add data-remote="true" to form
+  form_class: 'tabulatr_form',                 # class of the overall form
+  table_class: 'tabulatr_table',               # class for the actual data table
+  sortable_class: 'sortable',                  # class for the header of a sortable column
+  sorting_asc_class: 'sorting-asc',            # class for the currently asc sorting column
+  sorting_desc_class: 'sorting-desc',          # class for the currently desc sorting column
+  page_left_class: 'page-left',                # class for the page left button
+  page_right_class: 'page-right',              # class for the page right button
+  page_no_class: 'page-no',                    # class for the page no <input>
+  control_div_class_before: 'table-controls',  # class of the upper div containing the paging and batch action controls
+  control_div_class_after: 'table-controls',   # class of the lower div containing the paging and batch action controls
+  paginator_div_class: 'paginator',            # class of the div containing the paging controls
+  batch_actions_div_class: 'batch-actions',    # class of the div containing the batch action controls
+  select_controls_div_class: 'check-controls',  # class of the div containing the check controls
+  submit_class: 'submit-table',                # class of submit button
+  pagesize_select_class: 'pagesize_select',    # class of the pagesize select element
+  select_all_class: 'select-btn',              # class of the select all button
+  select_none_class: 'select-btn',             # class of the select none button
+  select_visible_class: 'select-btn',          # class of the select visible button
+  unselect_visible_class: 'select-btn',        # class of the unselect visible button
+  select_filtered_class: 'select-btn',         # class of the select filtered button
+  unselect_filtered_class: 'select-btn',       # class of the unselect filteredbutton
+  info_text_class: 'info-text',                # class of the info text div
+
+  batch_actions_label: 'Batch Action: ',       # Text to show in front of the batch action select
+  batch_actions_type: :select,                 # :select or :button depending on the kind of input you want
+  batch_actions_class: 'batch-action-inputs',  # class to apply on the batch action input elements
+  submit_label: 'Apply',                       # Text on the submit button
+  select_all_label: 'Select All',              # Text on the select all button
+  select_none_label: 'Select None',            # Text on the select none button
+  select_visible_label: 'Select visible',      # Text on the select visible button
+  unselect_visible_label: 'Unselect visible',  # Text on the unselect visible button
+  select_filtered_label: 'Select filtered',    # Text on the select filtered button
+  unselect_filtered_label: 'Unselect filtered',# Text on the unselect filtered button
+  info_text: "Showing %1$d, total %2$d, selected %3$d, matching %4$d",
+
+  # which controls to be rendered above and below the tabel and in which order
+  before_table_controls: [:submit, :paginator, :batch_actions, :select_controls, :info_text],
+  after_table_controls: [],
+
+  # whih selecting controls to render in which order
+  select_controls: [:select_all, :select_none, :select_visible, :unselect_visible,
+                    :select_filtered, :unselect_filtered],
+
+  image_path_prefix: '/images/tabulatr/',
+  pager_left_button: 'left.gif',
+  pager_left_button_inactive: 'left_off.gif',
+  pager_right_button: 'right.gif',
+  pager_right_button_inactive: 'right_off.gif',
+  sort_up_button: 'up.gif',
+  sort_up_button_inactive: 'up_off.gif',
+  sort_down_button: 'down.gif',
+  sort_down_button_inactive: 'down_off.gif',
+
+  make_form: true,                            # whether or not to wrap the whole table (incl. controls) in a form
+  table_html: false,                          # a hash with html attributes for the table
+  row_html: false,                            # a hash with html attributes for the normal trs
+  header_html: false,                         # a hash with html attributes for the header trs
+  filter_html: false,                         # a hash with html attributes for the filter trs
+  filter: true,                               # false for no filter row at all
+  paginate: true,                             # true to show paginator
+  sortable: true,                             # true to allow sorting (can be specified for every sortable column)
+  selectable: true,                           # true to render "select all", "select none" and the like
+  action: nil,                                # target action of the wrapping form if applicable
+  batch_actions: false,                       # name: value hash of batch action stuff
+  translate: false,                           # call t() for all 'labels' and stuff, possible values are true/:translate or :localize
+  row_classes: ['odd', 'even']                # class for the trs
+</pre>
+
+h3. Column Options
+
+<pre>
+  header: false,                   # a string to write into the header cell
+  width: false,                    # the width of the cell
+  align: false,                    # horizontal alignment
+  valign: false,                   # vertical alignment
+  wrap: true,                      # wraps
+  type: :string,                   # :integer, :date
+  td_html: false,                  # a hash with html attributes for the cells
+  th_html: false,                  # a hash with html attributes for the header cell
+  filter_html: false,              # a hash with html attributes for the filter cell
+  filter_html: false,              # a hash with html attributes for the filter cell
+  filter: true,                    # false for no filter field,
+                                   # container for options_for_select
+                                   # String from options_from_collection_for_select or the like
+                                   # :range for range spec
+                                   # :checkbox for a 0/1 valued checkbox
+  checkbox_value: '1',             # value if checkbox is checked
+  checkbox_label: '',              # text behind the checkbox
+  filter_width: '97%',             # width of the filter <input>
+  range_filter_symbol: '&ndash;',  # put between the <inputs> of the range filter
+  format: false,                   # a sprintf-string or a proc to do special formatting
+  method: false,                   # if you want to get the column by a different method than its name
+  link: false,                     # proc or symbol to make the content a link
+  join_symbol: ', ',               # symbol used to join the elements of 'many' associations
+  sortable: true                   # if set, sorting-stuff is added to the header cell
+</pre>
+
+h3. Global settings 
+
+These settings are *not* supposed to be changed on a per-table basis. This is necessary, because the <tt>find_for_table</tt> method needs to rely on a priori information.
+
+h4. Table Form Options
+
+This hash contains all the information about the naming of the generated form elements. To override them, you should, in an initializer, call 
+<pre>
+  Tabulatr.table_form_options(my_options_hash)
+</pre>
+
+<pre>
+  batch_action_name: 'batch_action',       # name of the batch action param
+  sort_by_key: 'sort_by_key',              # name of key which to search, format is 'id asc'
+  pagination_postfix: '_pagination',       # name of the param w/ the pagination infos
+  filter_postfix: '_filter',               # postfix for name of the filter in the params hash: xxx_filter
+  sort_postfix: '_sort',                   # postfix for name of the filter in the params hash: xxx_filter
+  checked_postfix: '_checked',             # postfix for name of the checked in the params hash: xxx_filter
+  associations_filter: '__association',    # name of the associations in the filter hash
+  method: 'post',                          # http method for that form if applicable
+  batch_postfix: '_batch',                 # postfix for name of the batch action select
+  checked_separator: ','                   # symbol to separate the checked ids
+</pre>
+
+h4. Paginate options
+
+To override these, you should, in an initializer, call 
+<pre>
+  Tabulatr.paginate_options(my_options_hash)
+</pre>
+
+<pre>
+  page: 1,
+  pagesize: 10,
+  pagesizes: [10, 20, 50]
+</pre>
+
+h2.Dependencies
+
+We use
+* <a href="http://github.com/providel/whiny_hash">WhinyHash</a> to handle the options in a fail-early-manner,
+* <a href="http://github.com/providel/id_stuffer">IdStuffer</a> to compress the _remembered_ ids.
+* And... eh... It's an extension for rails, so it might be handy to have a version of rails 3 and ruby 1.9.
+
+h2.Bugs
+
+There are, definitely, roughly 1000 bugs in Tabulatr, although we do some testing (see <tt>spec/dummy_app/spec</tt>). So if you hunt them, please let me know.
+
+h2. License
+
+Copyright (c) 2010-2011 Peter Horn, <a href="http://www.provideal.net" target="_blank">Provideal GmbH</a>
+
+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/Rakefile

@@ -0,0 +1,11 @@
+# Add your own tasks in files placed in lib/tasks ending in .rake,
+# for example lib/tasks/capistrano.rake, and they will automatically be available to Rake.
+
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/assets/tabulatr.css

@@ -0,0 +1,107 @@
+<style type="text/css" media="screen">
+
+  body {
+    font: 9pt Verdana;
+  }
+
+  table {
+    border-collapse: collapse;
+    width:100%;
+  }
+
+  td, th {
+    border: 1px solid gray;
+    padding:5px;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+    overflow: ellipsis;
+  }
+
+  th {
+    background-color: #ccc;
+    text-shadow: 1px 1px 1px rgba(0,0,0,.2);
+  }
+
+  div.table-controls {
+    font: 9pt Verdana;
+    width: 100%-10px;
+    border: 1px solid gray;
+    padding:5px;
+    margin-bottom: 10px;
+    background-color: #eee;
+    border-radius: 5px;
+    position: relative;
+  }
+
+  div.table-controls input {
+    font: 9pt Verdana;
+  }
+
+  div.table-controls input[type=submit] {
+    position: relative;
+    background-repeat: repeat-x;
+    color: #efefef;
+    font-weight: bold;
+    display: inline-block;
+    text-decoration: none;
+    border-width: 1px;
+    border-style: solid;
+    padding: 0 12px;
+    margin: 0;
+    text-shadow: 1px 1px 1px rgba(0,0,0,.2);
+    -moz-box-shadow: 1px 1px 1px rgba(0,0,0,.25);
+    -webkit-box-shadow: 1px 1px 1px rgba(0,0,0,.25);
+    box-shadow: 1px 1px 1px rgba(0,0,0,.25);
+    -moz-border-radius: 5px;
+    -webkit-border-radius: 5px;
+    border-radius: 5px;
+    cursor: pointer;
+    background-position: 0 -80px;
+    font-size: 11px;
+    height: 24px;
+    line-height: 24px;
+  }
+
+  div.table-controls input[type=submit] {
+    background-image: url(../images/tabulatr/buttons_lite_background.png);
+    background-color: #263849;
+    border-color: #16222c;
+    color: #efefef;
+  }
+
+  div.table-controls input[type=submit]:hover {
+    background-color: #16222c;
+    color: #efefef;
+    text-decoration: none;
+  }
+
+  div.paginator {
+    display: inline-block;
+    margin-right: 40px;
+  }
+
+  div.batch-actions {
+    display: inline-block;
+  }
+
+  div.check-controls {
+    margin-top: 10px;
+    position: absolute;
+    bottom: 5px;
+    right: 5px;
+  }
+
+  div.check-controls input[type=submit] {
+    font-size: 9px;
+    height: 20px;
+    line-height: 20px;
+    margin:3px;
+  }
+
+  div.info-text {
+    margin-top:10px;
+    font-size: 9pt;
+  }
+
+
+</style>

data/lib/initializers/action_view.rb

@@ -0,0 +1,31 @@
+#--
+# Copyright (c) 2010-2011 Peter Horn, Provideal GmbH
+#
+# 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.
+#++
+
+class ActionView::Base
+  # render the table in a view
+  def table_for(records, opts={}, &block)
+    tabulatr = Tabulatr.new(records, self, opts)
+    tabulatr.build_table(&block)
+  end
+end
+

data/lib/initializers/active_record.rb

@@ -0,0 +1,32 @@
+#--
+# Copyright (c) 2010-2011 Peter Horn, Provideal GmbH
+#
+# 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.
+#++
+
+# We monkey patch ActiveRecord::Base to add a function for finding using
+# the information of the params hash as created by a Tabulatr table
+if Object.const_defined? "ActiveRecord"
+  class ActiveRecord::Base
+    def self.find_for_table(params, opts={}, &block)
+      Tabulatr::Finder.find_for_active_record_table(self, params, opts, &block)
+    end
+  end
+end

data/lib/initializers/mark_as_localizable.rb

@@ -0,0 +1,43 @@
+#--
+# Copyright (c) 2010-2011 Peter Horn, Provideal GmbH
+#
+# 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.
+#++
+
+# This is probably a REALLY bad idea...
+module MarkAsLocalizable
+  def l
+    @should_localize = true
+    self
+  end
+
+  def should_localize?
+    @should_localize == true
+  end
+end
+
+class String
+  include MarkAsLocalizable
+end
+
+class Symbol
+  include MarkAsLocalizable
+end
+