rails-settings-cached 0.1.2 → 0.2.0

data/README.md

@@ -0,0 +1,106 @@
+# Settings Gem
+
+This is improved from rails-settings, added caching for all settings.
+Settings is a plugin that makes managing a table of global key, value pairs easy.
+Think of it like a global Hash stored in you database, that uses simple ActiveRecord
+like methods for manipulation.  Keep track of any global setting that you dont want
+to hard code into your rails app.  You can store any kind of object.  Strings, numbers,
+arrays, or any object. Ported to Rails 3!
+
+## Status
+
+[![CI Status](https://secure.travis-ci.org/huacnlee/rails-settings-cached.png)](http://travis-ci.org/huacnlee/rails-settings-cached)
+
+## Setup
+
+Edit your Gemfile:
+
+    gem "rails-settings-cached"
+
+Generate your settings:
+
+    rails g settings <settings_name>
+
+Now just put that migration in the database with:
+    
+    rake db:migrate
+
+## Usage
+  
+You need create a class in `app/models/setting.rb` :
+  
+    # app/models/setting.rb
+    # extension RailsSettings::CachedSettings
+    class Setting < RailsSettings::CachedSettings  
+    end
+
+The syntax is easy.  First, lets create some settings to keep track of:
+
+    Setting.admin_password = 'supersecret'
+    Setting.date_format    = '%m %d, %Y'
+    Setting.cocktails      = ['Martini', 'Screwdriver', 'White Russian']
+    Setting.foo            = 123
+    Setting.credentials    = { :username => 'tom', :password => 'secret' }
+
+Now lets read them back:
+
+    Setting.foo            # returns 123
+
+Changing an existing setting is the same as creating a new setting:
+
+    Setting.foo = 'super duper bar'
+
+For changing an existing setting which is a Hash, you can merge new values with existing ones:
+
+    Setting.merge!(:credentials, :password => 'topsecret')
+    Setting.credentials    # returns { :username => 'tom', :password => 'topsecret' }
+
+Decide you dont want to track a particular setting anymore?
+
+    Setting.destroy :foo
+    Setting.foo            # returns nil
+
+Want a list of all the settings?
+
+    Setting.all            # returns {'admin_password' => 'super_secret', 'date_format' => '%m %d, %Y'}
+
+You need name spaces and want a list of settings for a give name space? Just choose your prefered named space delimiter and use Setting.all like this:
+
+    Setting['preferences.color'] = :blue
+    Setting['preferences.size'] = :large
+    Setting['license.key'] = 'ABC-DEF'
+    Setting.all('preferences.')   # returns { 'preferences.color' => :blue, 'preferences.size' => :large }
+
+Set defaults for certain settings of your app.  This will cause the defined settings to return with the
+Specified value even if they are not in the database.  Make a new file in `config/initializers/default_settings.rb`
+with the following:
+
+    Setting.defaults[:some_setting] = 'footastic'
+  
+Now even if the database is completely empty, you app will have some intelligent defaults:
+
+    Setting.some_setting   # returns 'footastic'
+
+Settings may be bound to any existing ActiveRecord object. Define this association like this:
+Notice! is not do caching in this version.
+  
+    class User < ActiveRecord::Base
+      include RailsSettings::Extend 
+    end
+
+Then you can set/get a setting for a given user instance just by doing this:
+
+    user = User.find(123)
+    user.settings.color = :red
+    user.settings.color # returns :red
+    user.settings.all # { "color" => :red }
+
+I you want to find users having or not having some settings, there are named scopes for this:
+
+    User.with_settings # => returns a scope of users having any setting
+    User.with_settings_for('color') # => returns a scope of users having a 'color' setting
+  
+    User.without_settings # returns a scope of users having no setting at all (means user.settings.all == {})
+    User.without_settings('color') # returns a scope of users having no 'color' setting (means user.settings.color == nil)
+
+That's all there is to it! Enjoy!

data/lib/{rails-settings.rb → rails-settings-cached.rb}

@@ -1,5 +1,4 @@
 require "rails-settings/settings"
 require "rails-settings/scoped_settings"
 require "rails-settings/cached_settings"
-
-require "rails-settings/railtie" if defined?(Rails) && Rails.version >= "3"
+require "rails-settings/extend"

data/lib/rails-settings/extend.rb

@@ -0,0 +1,29 @@
+module RailsSettings
+  module Extend
+    extend ActiveSupport::Concern
+    
+    included do 
+      scope :with_settings, :joins => "JOIN settings ON (settings.thing_id = #{self.table_name}.#{self.primary_key} AND
+                                       settings.thing_type = '#{self.base_class.name}')",
+                            :select => "DISTINCT #{self.table_name}.*" 
+
+      scope :with_settings_for, lambda { |var| { :joins => "JOIN settings ON (settings.thing_id = #{self.table_name}.#{self.primary_key} AND
+                                                             settings.thing_type = '#{self.base_class.name}') AND settings.var = '#{var}'" } }
+                                                               
+      scope :without_settings, :joins => "LEFT JOIN settings ON (settings.thing_id = #{self.table_name}.#{self.primary_key} AND
+                                                                 settings.thing_type = '#{self.base_class.name}')",
+                               :conditions => 'settings.id IS NULL'
+                                     
+      scope :without_settings_for, lambda { |var| { :joins => "LEFT JOIN settings ON (settings.thing_id = #{self.table_name}.#{self.primary_key} AND
+                                                                                      settings.thing_type = '#{self.base_class.name}') AND
+                                                                                      settings.var = '#{var}'",
+                                                    :conditions => 'settings.id IS NULL' } }
+    end
+    
+    def settings
+      ScopedSettings.for_thing(self)
+    end
+  end
+end
+
+

data/lib/rails-settings/settings.rb

@@ -1,7 +1,7 @@
 module RailsSettings
   class Settings < ActiveRecord::Base
     
-    set_table_name 'settings'
+		self.table_name = 'settings'
     
     class SettingNotFound < RuntimeError; end
     
@@ -109,4 +109,4 @@ module RailsSettings
     
     
   end
-end
+end

metadata

@@ -1,14 +1,10 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: rails-settings-cached
-version: !ruby/object:Gem::Version 
-  prerelease: false
-  segments: 
-  - 0
-  - 1
-  - 2
-  version: 0.1.2
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+  prerelease: 
 platform: ruby
-authors: 
+authors:
 - Squeegy
 - Georg Ledermann
 - 100hz
@@ -16,80 +12,61 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2011-01-14 00:00:00 +08:00
-default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
+date: 2011-01-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: rails
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
+  requirement: &70106977170520 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        segments: 
-        - 3
-        - 0
-        - 0
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
         version: 3.0.0
   type: :runtime
-  version_requirements: *id001
+  prerelease: false
+  version_requirements: *70106977170520
 description: 
-email: rails-settings@theblackestbox.net
+email: huacnlee@gmail.com
 executables: []
-
 extensions: []
-
-extra_rdoc_files: 
-- README.rdoc
-files: 
-- .project
-- MIT-LICENSE
-- README.rdoc
-- Rakefile
-- VERSION
+extra_rdoc_files: []
+files:
 - lib/generators/settings/settings_generator.rb
 - lib/generators/settings/templates/migration.rb
 - lib/generators/settings/templates/model.rb
-- lib/rails-settings.rb
-- lib/rails-settings/railtie.rb
+- lib/rails-settings/cached_settings.rb
+- lib/rails-settings/extend.rb
 - lib/rails-settings/scoped_settings.rb
 - lib/rails-settings/settings.rb
-- lib/rails-settings/cached_settings.rb
-- rails-settings-cached.gemspec
-- rails/init.rb
-has_rdoc: true
-homepage: http://theblackestbox.net
+- lib/rails-settings-cached.rb
+- README.md
+homepage: https://github.com/huacnlee/rails-settings-cached
 licenses: []
-
 post_install_message: 
-rdoc_options: 
-- --charset=UTF-8
-require_paths: 
+rdoc_options: []
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      segments: 
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      segments: 
-      - 0
-      version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: 
-rubygems_version: 1.3.7
+rubygems_version: 1.8.10
 signing_key: 
 specification_version: 3
-summary: This is imporved from rails-settings, added caching. Settings is a plugin that makes managing a table of global key, value pairs easy. Think of it like a global Hash stored in you database, that uses simple ActiveRecord like methods for manipulation.  Keep track of any global setting that you dont want to hard code into your rails app.  You can store any kind of object.  Strings, numbers, arrays, or any object. Ported to Rails 3!
+summary: This is imporved from rails-settings, added caching. Settings is a plugin
+  that makes managing a table of global key, value pairs easy. Think of it like a
+  global Hash stored in you database, that uses simple ActiveRecord like methods for
+  manipulation.  Keep track of any global setting that you dont want to hard code
+  into your rails app.  You can store any kind of object.  Strings, numbers, arrays,
+  or any object. Ported to Rails 3!
 test_files: []
-

data/.project

@@ -1,12 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<projectDescription>
-	<name>rails-settings</name>
-	<comment></comment>
-	<projects>
-	</projects>
-	<buildSpec>
-	</buildSpec>
-	<natures>
-		<nature>org.radrails.rails.core.railsnature</nature>
-	</natures>
-</projectDescription>

data/MIT-LICENSE

@@ -1,21 +0,0 @@
-Copyright (c) 2006 Alex Wayne
-Some additional features added 2009 by Georg Ledermann
-
-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 PURPOa AND
-NONINFRINGEMENT. IN NO EVENT SaALL 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.rdoc

@@ -1,100 +0,0 @@
-= Settings Gem
-
-This is imporved from rails-settings, added caching for all settings.
-Settings is a plugin that makes managing a table of global key, value pairs easy.
-Think of it like a global Hash stored in you database, that uses simple ActiveRecord
-like methods for manipulation.  Keep track of any global setting that you dont want
-to hard code into your rails app.  You can store any kind of object.  Strings, numbers,
-arrays, or any object. Ported to Rails 3!
-
-
-== Setup
-
-Edit your Gemfile:
-  gem "rails-settings-cached"
-  
-Generate your settings:
-  rails g settings <settings_name>
-
-Now just put that migration in the database with:
-  rake db:migrate
-
-
-== Usage
-  
-You need create a class in app/models/setting.rb :
-  
-  # app/models/setting.rb
-  # extension RailsSettings::CachedSettings
-  class Setting < RailsSettings::CachedSettings  
-  end
-
-The syntax is easy.  First, lets create some settings to keep track of:
-
-  Setting.admin_password = 'supersecret'
-  Setting.date_format    = '%m %d, %Y'
-  Setting.cocktails      = ['Martini', 'Screwdriver', 'White Russian']
-  Setting.foo            = 123
-  Setting.credentials    = { :username => 'tom', :password => 'secret' }
-
-Now lets read them back:
-
-  Setting.foo            # returns 123
-
-Changing an existing setting is the same as creating a new setting:
-
-  Setting.foo = 'super duper bar'
-
-For changing an existing setting which is a Hash, you can merge new values with existing ones:
-  Setting.merge! :credentials, :password => 'topsecret'
-  Setting.credentials    # returns { :username => 'tom', :password => 'topsecret' }
-
-Decide you dont want to track a particular setting anymore?
-
-  Setting.destroy :foo
-  Setting.foo            # returns nil
-
-Want a list of all the settings?
-
-  Setting.all            # returns {'admin_password' => 'super_secret', 'date_format' => '%m %d, %Y'}
-
-You need name spaces and want a list of settings for a give name space? Just choose your prefered named space delimiter and use Settings.all like this:
-
-  Setting['preferences.color'] = :blue
-  Setting['preferences.size'] = :large
-  Setting['license.key'] = 'ABC-DEF'
-  Setting.all('preferences.')   # returns { 'preferences.color' => :blue, 'preferences.size' => :large }
-
-Set defaults for certain settings of your app.  This will cause the defined settings to return with the
-Specified value even if they are not in the database.  Make a new file in config/initializers/default_settings.rb
-with the following:
-
-  Setting.defaults[:some_setting] = 'footastic'
-  
-Now even if the database is completely empty, you app will have some intelligent defaults:
-
-  Setting.some_setting   # returns 'footastic'
-
-Settings may be bound to any existing ActiveRecord object. Define this association like this:
-Notice! has_settings is not do caching in this version.
-  
-  class User < ActiveRecord::Base
-    has_settings
-  end
-
-Then you can set/get a setting for a given user instance just by doing this:
-
-  user = User.find(123)
-  user.settings.color = :red
-  user.settings.color # returns :red
-  user.settings.all # { "color" => :red }
-
-I you want to find users having or not having some settings, there are named scopes for this:
-
-  User.with_settings # => returns a scope of users having any setting
-  User.with_settings_for('color') # => returns a scope of users having a 'color' setting
-  
-  User.without_settings # returns a scope of users having no setting at all (means user.settings.all == {})
-  User.without_settings('color') # returns a scope of users having no 'color' setting (means user.settings.color == nil)
-
-That's all there is to it! Enjoy!

data/Rakefile

@@ -1,20 +0,0 @@
-require 'rubygems'
-require 'rake'
-
-begin
-  require 'jeweler'
-  Jeweler::Tasks.new() do |gem|
-    gem.name = "rails-settings"
-    gem.summary = "Settings is a plugin that makes managing a table of global key, value pairs easy. Think of it like a global Hash stored in you database, that uses simple ActiveRecord like methods for manipulation.  Keep track of any global setting that you dont want to hard code into your rails app.  You can store any kind of object.  Strings, numbers, arrays, or any object. Ported to Rails 3!"
-    gem.email = "rails-settings@theblackestbox.net"
-    gem.homepage = "http://theblackestbox.net"
-    gem.authors = ["Squeegy","Georg Ledermann","100hz"]
-    gem.add_dependency "rails", ">= 3.0.0"
-  end
-  Jeweler::GemcutterTasks.new
-rescue LoadError
-  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
-end
-
-
-task :default => :release

data/VERSION

@@ -1 +0,0 @@
-0.1.1

data/lib/rails-settings/railtie.rb

@@ -1,43 +0,0 @@
-module RailsSettings
-  class Railtie < Rails::Railtie
-    
-    initializer 'rails_settings.initialize', :after => :after_initialize do      
-      Railtie.extend_active_record
-    end
-
-  end
-  
-  class Railtie
-    def self.extend_active_record
-      ActiveRecord::Base.class_eval do
-        def self.has_settings
-          class_eval do
-            def settings
-              RailsSettings::ScopedSettings.for_thing(self)
-            end
-            
-            scope :with_settings, :joins => "JOIN settings ON (settings.thing_id = #{self.table_name}.#{self.primary_key} AND
-                                                                     settings.thing_type = '#{self.base_class.name}')",
-                                        :select => "DISTINCT #{self.table_name}.*" 
-      
-            scope :with_settings_for, lambda { |var| { :joins => "JOIN settings ON (settings.thing_id = #{self.table_name}.#{self.primary_key} AND
-                                                                                          settings.thing_type = '#{self.base_class.name}') AND
-                                                                                          settings.var = '#{var}'" } }
-                                                                     
-            scope :without_settings, :joins => "LEFT JOIN settings ON (settings.thing_id = #{self.table_name}.#{self.primary_key} AND
-                                                                             settings.thing_type = '#{self.base_class.name}')",
-                                           :conditions => 'settings.id IS NULL'
-                                           
-            scope :without_settings_for, lambda { |var| { :joins => "LEFT JOIN settings ON (settings.thing_id = #{self.table_name}.#{self.primary_key} AND
-                                                                                                  settings.thing_type = '#{self.base_class.name}') AND
-                                                                                                  settings.var = '#{var}'",
-                                                                :conditions => 'settings.id IS NULL' } }
-          end
-        end
-      end
-    end
-    
-  end
-end
-
-

data/rails-settings-cached.gemspec

@@ -1,53 +0,0 @@
-# Generated by jeweler
-# DO NOT EDIT THIS FILE DIRECTLY
-# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
-# -*- encoding: utf-8 -*-
-
-Gem::Specification.new do |s|
-  s.name = %q{rails-settings-cached}
-  s.version = "0.1.2"
-
-  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.authors = ["Squeegy", "Georg Ledermann", "100hz", "Jason Lee"]
-  s.date = %q{2011-01-14}
-  s.email = %q{rails-settings@theblackestbox.net}
-  s.extra_rdoc_files = [
-    "README.rdoc"
-  ]
-  s.files = [
-    ".project",
-     "MIT-LICENSE",
-     "README.rdoc",
-     "Rakefile",
-     "VERSION",
-     "lib/generators/settings/settings_generator.rb",
-     "lib/generators/settings/templates/migration.rb",
-     "lib/generators/settings/templates/model.rb",
-     "lib/rails-settings.rb",
-     "lib/rails-settings/railtie.rb",
-     "lib/rails-settings/scoped_settings.rb",
-     "lib/rails-settings/settings.rb",
-     "lib/rails-settings/cached_settings.rb",
-     "rails-settings-cached.gemspec",
-     "rails/init.rb"
-  ]
-  s.homepage = %q{http://theblackestbox.net}
-  s.rdoc_options = ["--charset=UTF-8"]
-  s.require_paths = ["lib"]
-  s.rubygems_version = %q{1.3.7}
-  s.summary = %q{This is imporved from rails-settings, added caching. Settings is a plugin that makes managing a table of global key, value pairs easy. Think of it like a global Hash stored in you database, that uses simple ActiveRecord like methods for manipulation.  Keep track of any global setting that you dont want to hard code into your rails app.  You can store any kind of object.  Strings, numbers, arrays, or any object. Ported to Rails 3!}
-
-  if s.respond_to? :specification_version then
-    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
-    s.specification_version = 3
-
-    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_runtime_dependency(%q<rails>, [">= 3.0.0"])
-    else
-      s.add_dependency(%q<rails>, [">= 3.0.0"])
-    end
-  else
-    s.add_dependency(%q<rails>, [">= 3.0.0"])
-  end
-end
-

data/rails/init.rb

@@ -1 +0,0 @@
-require 'rails-settings'