configurable_engine 0.4.7 → 2.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 42b345dc60ccd203b5e50caa3a5c626d3db7b850
-  data.tar.gz: f5cdc2bbefe5017c78db8ccb644da9daa7db638b
+SHA256:
+  metadata.gz: 052c84d5fd01f589b20d96f859db8e9472ccc006e65e1169cfa856821d99c505
+  data.tar.gz: 0cad323593bc477cc75fdf4e5688b32bdc40f37f378bc87812944e2a3dac76f1
 SHA512:
-  metadata.gz: 42b929c5021f20fa1eac5d5499007d077dad5148ab7928d2d2afc1cfdb7088011053c903faa2bba52842c7b4d85584ad175d366f0c64765f9c0d4e25e7c86e61
-  data.tar.gz: 943f8e63591d88a8d21d9cd964bea594218999a2513f62027af6da1afb01bb400a862cc5ad05ad777765391b96e4f7aab221beea090b721dc9a56d69fbd25f74
+  metadata.gz: e49206f97f2db7ac059b4e9999d7de7e7d45aaebba6f16c3d41befdbf97ab6fba031149d5513cbc2c09d45db661f2703d39835d14713ccfac34fb668cb2950c6
+  data.tar.gz: 61f85de5aa43479682c21777d3b6929fb38f1a667dc94359de380c9622ada73676c9067ac594cc3ec2d4026bee5e210abc19bb4745687d0101c6137ed2d85963

data/CHANGELOG.md

@@ -1,3 +1,33 @@
+### v2.0.0 - August 20, 2020
+**bug fixes**
+Can render layout of parent application
+
+### v2.0.0 - August 20, 2020
+**features**
+Configurable_Engine is mountable. This allows folks to use it with a catch-all route
+
+**breaking changes**
+Existing users must add `mount ConfigurableEngine::Engine, at: "/admin/configurable"` to their routes.rb. Routing helpers may not work as they used to.
+
+### v1.0.0 - August 20, 2020
+**features**
+Official rails 5.2 support
+
+**breaking changes**
+No further support for rails < 5.2
+
+### v0.5.0 - August 3, 2018
+**features**
+Official rails 4.2 support (Thanks @ento)
+
+**breaking changes**
+No further support for rails < 4.2, and non-mri rubies. Happy to accept those back as PRs!
+
+
+### v0.4.8 - March 4, 2015
+**bug fix**
+Cacheing was just totally broken.  Whoops! (thanks, @antoshalee)
+
 ### v0.4.7 - November 4, 2014
 **bug fix**
 Configurable broke for users using cacheing.

data/README.md

@@ -1,6 +1,6 @@
 # Configurable [![Build Status](https://travis-ci.org/paulca/configurable_engine.png?branch=master)](https://travis-ci.org/paulca/configurable_engine)
 
-A Rails 3/4 configuration engine. An update to [Behavior](http://github.com/paulca/behavior) for Rails 3 and 4.
+A Rails 4 configuration engine. An update to [Behavior](http://github.com/paulca/behavior) for Rails 4.
 
 ## How it works ##
 
@@ -10,7 +10,7 @@ If you or your app users need to change these variables, Configurable stores new
 
 ## Installation ##
 
-Configurable is available as a Ruby gem. Simply add it to your Rails 3 app's `Gemfile`:
+Configurable is available as a Ruby gem. Simply add it to your Rails 4 app's `Gemfile`:
 
 ```ruby
 gem 'configurable_engine'
@@ -22,11 +22,17 @@ Then run the `configurable_engine:install` generator:
 $ rails generate configurable_engine:install
 ```
 
+this will
+- add config/configurable.yml
+- create a migration for your configurable table
+- mount the UI in your routes (defaulting to admin/configurables)
+
+
 ## Usage ##
 
-There are two parts to how configurable_engine works. First of all there is a config file, config/configurable.yml. This file controls the variables that are allowed to be set in the app.
+There are two parts to how configurable_engine works. First of all there is a config file, `config/configurable.yml`. This file controls the variables that are allowed to be set in the app.
 
-For example, if you wanted to have access to a config variable "site_title", put this in configurable.yml:
+For example, if you wanted to have access to a config variable `site_title`, put this in `configurable.yml`:
 
 ```yaml
 site_title:
@@ -58,7 +64,7 @@ and include `ConfigurableEngine::ConfigurablesController`, eg.
 ```ruby
 class Admin::ConfigurablesController < ApplicationController
   # include the engine controller actions
-  include ConfigurableEngine::ConfigurablesController
+  include ConfigurableEngine::ConfigurablesControllerMethods
 
   # add your own filter(s) / layout
   before_filter :protect_my_code
@@ -100,16 +106,50 @@ Price:
   type: decimal             # coerces the value to a decimal
 ```
 
-## Cacheing ##
+## Caching ##
 
 If you want to use rails caching of Configurable updates, simply set
 
-
 ```ruby
 config.use_cache = true
 ```
+
 in your `config/application.rb` (or `config/production.rb`)
 
+## Styling the interface ##
+
+To style the web interface you are advised to use Sass. Here's an example scss file that will make the interface bootstrap-3 ready:
+
+```
+@import 'bootstrap';
+
+.configurable-container {
+  @extend .col-md-6;
+
+  .configurable-options {
+    form {
+      @extend .form-horizontal;
+
+      .configurable {
+        @extend .col-md-12;
+        @extend .form-group;
+
+        textarea, input[type=text], input[type=password] {
+          @extend .form-control;
+        }
+      }
+
+      input[type=submit] {
+        @extend .btn;
+        @extend .btn-primary;
+      }
+    }
+  }
+}
+```
+
+Just save this into your rails assets and you're ready to go.
+
 ## Running the Tests ##
 
 The tests for this rails engine are in the `spec` and `features` directories.  They use the dummy rails app in `spec/dummy`
@@ -130,4 +170,3 @@ All contributions are welcome. Just fork the code, ensure your changes include a
 
 Copyright (c) 2011 Paul Campbell. See LICENSE.txt for
 further details.
-

data/app/controllers/configurable_engine/configurables_controller.rb

@@ -0,0 +1,10 @@
+module ConfigurableEngine
+  class ConfigurablesController < ApplicationController
+    # this allows us to render url_helpers from parent app's layout
+    helper Rails.application.routes.url_helpers
+    # this ensures our local routes override any parent routes
+    helper ConfigurableEngine::Engine.routes.url_helpers
+
+    include ConfigurableEngine::ConfigurablesControllerMethods
+  end
+end

data/app/models/configurable.rb

@@ -1,4 +1,6 @@
 class Configurable < ActiveRecord::Base
+  serialize :value
+
   after_save    :invalidate_cache, if: -> { ConfigurableEngine::Engine.config.use_cache }
   after_destroy :invalidate_cache, if: -> { ConfigurableEngine::Engine.config.use_cache }
 
@@ -51,7 +53,7 @@ class Configurable < ActiveRecord::Base
       else
         database_finder.call
         if found
-          Rails.cache.store cache_key(key), value
+          Rails.cache.write cache_key(key), value
         end
       end
     else
@@ -61,7 +63,11 @@ class Configurable < ActiveRecord::Base
     if found
       value
     else
-      parse_value key, defaults[key][:default]
+      parse_value(key, defaults[key][:default]).tap do |val|
+        if ConfigurableEngine::Engine.config.use_cache
+          Rails.cache.write cache_key(key), val
+        end
+      end
     end
   end
 
@@ -75,7 +81,7 @@ class Configurable < ActiveRecord::Base
       [true, 1, "1", "t", "true"].include?(value)
     when 'decimal'
       value ||= 0
-      BigDecimal.new(value.to_s)
+      BigDecimal(value.to_s)
     when 'integer'
       value.to_i
     when 'list'
@@ -85,6 +91,12 @@ class Configurable < ActiveRecord::Base
       else
         value.split("\n").collect { |v| v =~ /,/ ? v.split(',') : v }
       end
+    when 'date'
+      if value.is_a? Date
+        value
+      else
+       Date.parse(value) if value.present?
+      end
     else
       value
     end
@@ -131,6 +143,8 @@ class Configurable < ActiveRecord::Base
       Integer(value) rescue false
     when 'list'
       value.is_a?(Array)
+    when 'date'
+      value.is_a?(Date)
     else
       true
     end

data/app/views/configurable_engine/configurables/show.html.erb

@@ -0,0 +1,31 @@
+<div class='configurable-container'>
+
+  <div class="header">
+    <h2>Config</h2>
+  </div>
+
+  <div class="configurable-options">
+    <%= form_tag(configurable_path, :method => :put) do -%>
+      <%- @keys.each do |key| -%>
+        <%- options = Configurable.defaults[key] -%>
+        <div class="configurable">
+          <%= label_tag key, options[:name] %>
+          <%- if options[:type] == 'boolean' %>
+            <%= hidden_field_tag key, "0" %>
+            <%= check_box_tag key, "1", Configurable.send(key) %>
+          <%- elsif options[:type] == 'password' -%>
+            <%= password_field_tag key, Configurable.send(key) %>
+          <%- elsif options[:type] == 'text' -%>
+            <%= text_area_tag key, Configurable.send(key) %>
+          <%- elsif options[:type] == 'list' -%>
+            <%= text_area_tag key, Configurable.serialized_value(key) -%>
+          <%- else -%>
+            <%= text_field_tag key, Configurable.send(key) %>
+          <%- end -%>
+        </div>
+      <%- end -%>
+
+      <%= submit_tag 'Save' %>
+    <%- end -%>
+  </div>
+</div>

data/config/routes.rb

@@ -1,5 +1,3 @@
-Rails.application.routes.draw do
-  namespace :admin do
-    resource :configurable
-  end
-end
+ConfigurableEngine::Engine.routes.draw do
+  resource :configurable, path: '/'
+end

data/lib/configurable_engine.rb

@@ -1,2 +1,2 @@
 require 'configurable_engine/engine'
-require 'configurable_engine/configurables_controller'
+require 'configurable_engine/configurables_controller_methods'

data/lib/configurable_engine/{configurables_controller.rb → configurables_controller_methods.rb}

@@ -1,5 +1,5 @@
 module ConfigurableEngine
-  module ConfigurablesController
+  module ConfigurablesControllerMethods
     def show
       @keys = Configurable.keys
     end
@@ -15,11 +15,11 @@ module ConfigurableEngine
         end
 
       if failures.empty?
-        redirect_to admin_configurable_path, :notice => "Changes successfully updated"
+        redirect_to configurable_path, :notice => "Changes successfully updated"
       else
         flash[:error] = failures.flat_map(&:errors).flat_map(&:full_messages).join(',')
-        redirect_to admin_configurable_path
+        redirect_to configurable_path
       end
     end
   end
-end
+end

data/lib/configurable_engine/engine.rb

@@ -1,8 +1,10 @@
 module ConfigurableEngine
-  class Engine < Rails::Engine
+  class Engine < ::Rails::Engine
+    engine_name "configurable"
+    isolate_namespace ConfigurableEngine
     config.use_cache = false
     config.generators do |g|
       g.test_framework :rspec
     end
   end
-end
+end

data/lib/configurable_engine/version.rb

@@ -1,3 +1,3 @@
 module ConfigurableEngine
-  VERSION = '0.4.7'
-end
+  VERSION = '2.0.1'
+end

data/lib/generators/configurable_engine/install_generator.rb

@@ -20,5 +20,9 @@ class InstallGenerator < Rails::Generators::Base
       copy_file 'configurable.yml', 'config/configurable.yml'
       migration_template 'migration.rb', 'db/migrate/create_configurables.rb'
     end
+
+    def mount_interface
+      route 'mount ConfigurableEngine::Engine, at: "/admin/configurable"'
+    end
   end
-end
+end

data/lib/generators/configurable_engine/templates/migration.rb

@@ -1,4 +1,4 @@
-class CreateConfigurables < ActiveRecord::Migration
+class CreateConfigurables < ActiveRecord::Migration[5.2]
   def self.up
     create_table :configurables do |t|
       t.string :name
@@ -14,4 +14,4 @@ class CreateConfigurables < ActiveRecord::Migration
     remove_index :configurables, :name
     drop_table :configurables
   end
-end
+end

metadata

@@ -1,15 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: configurable_engine
 version: !ruby/object:Gem::Version
-  version: 0.4.7
+  version: 2.0.1
 platform: ruby
 authors:
 - Paul Campbell
 - Michael Glass
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2014-11-04 00:00:00.000000000 Z
+date: 2020-08-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -17,17 +17,17 @@ dependencies:
     requirements:
     - - ">"
       - !ruby/object:Gem::Version
-        version: 3.1.0
+        version: 5.2.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">"
       - !ruby/object:Gem::Version
-        version: 3.1.0
-description: 'Configurable is a Rails 3/4 engine that allows you to set up config
-  variables in a config file, specifying default values for all environmentspec. These
-  variables can then be set on a per-app basis using a user facing configuration screen. '
+        version: 5.2.0
+description: 'Configurable is a Rails 4 engine that allows you to set up config variables
+  in a config file, specifying default values for all environmentspec. These variables
+  can then be set on a per-app basis using a user facing configuration screen. '
 email: paul@rslw.com
 executables: []
 extensions: []
@@ -38,12 +38,12 @@ files:
 - CHANGELOG.md
 - LICENSE.txt
 - README.md
-- app/controllers/admin/configurables_controller.rb
+- app/controllers/configurable_engine/configurables_controller.rb
 - app/models/configurable.rb
-- app/views/admin/configurables/show.html.erb
+- app/views/configurable_engine/configurables/show.html.erb
 - config/routes.rb
 - lib/configurable_engine.rb
-- lib/configurable_engine/configurables_controller.rb
+- lib/configurable_engine/configurables_controller_methods.rb
 - lib/configurable_engine/engine.rb
 - lib/configurable_engine/version.rb
 - lib/generators/configurable_engine/install_generator.rb
@@ -53,7 +53,7 @@ homepage: http://github.com/paulca/configurable_engine
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -68,9 +68,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.4.2
-signing_key: 
+rubygems_version: 3.0.3
+signing_key:
 specification_version: 4
-summary: Database-backed configuration for Rails 3, with defaults from config file.
+summary: Database-backed configuration for Rails 4, with defaults from config file.
 test_files: []

data/app/controllers/admin/configurables_controller.rb

@@ -1,3 +0,0 @@
-class Admin::ConfigurablesController < ApplicationController
-  include ConfigurableEngine::ConfigurablesController
-end

data/app/views/admin/configurables/show.html.erb

@@ -1,24 +0,0 @@
-<h2>Config</h2>
-
-<%= form_tag(admin_configurable_path, :method => :put) do -%>
-  <%- @keys.each do |key| -%>
-    <%- options = Configurable.defaults[key] -%>
-    <div class="configurable">
-      <%= label_tag key, options[:name] %>
-      <%- if options[:type] == 'boolean' %>
-        <%= hidden_field_tag key, "0" %>
-        <%= check_box_tag key, "1", Configurable.send(key) %>
-      <%- elsif options[:type] == 'password' -%>
-        <%= password_field_tag key, Configurable.send(key) %>
-      <%- elsif options[:type] == 'text' -%>
-        <%= text_area_tag key, Configurable.send(key) %>
-      <%- elsif options[:type] == 'list' -%>
-        <%= text_area_tag key, Configurable.serialized_value(key) -%>
-      <%- else -%>
-        <%= text_field_tag key, Configurable.send(key) %>
-      <%- end -%>
-    </div>
-  <%- end -%>
-  
-  <%= submit_tag 'Save' %>
-<%- end -%>