decorators 1.0.0

data/lib/decorators.rb

@@ -0,0 +1,35 @@
+module Decorators
+  require 'decorators/paths'
+  require 'decorators/railtie'
+
+  class << self
+    def load!(cache_classes)
+      decorators.each do |decorator|
+        if cache_classes
+          require decorator
+        else
+          load decorator
+        end
+      end
+    end
+
+    attr_accessor :decorators
+    def decorators
+      paths.registered.map { |path|
+        Dir[path.join('app', 'decorators', '**', '*_decorator.rb')]
+      }.flatten.uniq
+    end
+
+    def register!(*paths_to_register)
+      paths_to_register.flatten.map do |path|
+        paths.register! path
+      end
+    end
+
+    protected
+    def paths
+      @paths ||= Paths.new
+    end
+  end
+
+end

data/lib/decorators/paths.rb

@@ -0,0 +1,16 @@
+require 'pathname'
+
+module Decorators
+  class Paths
+
+    attr_reader :registered
+    def initialize(*args)
+      @registered = Array.new(*args)
+    end
+
+    def register!(path)
+      @registered << Pathname.new(path)
+    end
+
+  end
+end

data/lib/decorators/railtie.rb

@@ -0,0 +1,11 @@
+require 'rails'
+
+module Decorators
+  class Railtie < Rails::Railtie
+
+    config.to_prepare do
+      Decorators.load! Rails.application.config.cache_classes
+    end
+
+  end
+end

data/license.md

@@ -0,0 +1,21 @@
+# MIT License
+
+Copyright (c) 2013 [Philip Arndt](http://philiparndt.name)
+
+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.md

@@ -0,0 +1,45 @@
+# Decorators Plugin
+
+This is a very simple plugin that adds support for decorators to your Rails application.
+Effectively all that this does is allow you to register paths in which to search
+for decorators which are then loaded at the appropriate point in your application's
+initialisation process.
+
+Decorators must follow this naming convention:
+
+    app/decorators/<any number of directories>/something_decorator.rb
+
+The important parts are being inside a sub directory of `app/decorators` and having
+`_decorator.rb` at the end of the file's name.
+
+## How to install
+
+In your Gemfile, add the gem:
+
+```ruby
+gem 'decorators', '~> 1.0.0'
+```
+
+Now, run `bundle install` and the gem should install.
+
+## How to use
+
+There really is just one method to call; `Decorators#register!`.
+Simply pass one path or many paths to the method to register paths to search
+inside for decorators to be loaded from.
+
+```ruby
+require 'decorators'
+Decorators.register! Rails.root
+```
+
+Or for many paths:
+
+```ruby
+require 'decorators'
+Decorators.register! Rails.root, Rails.root.join('vendor', 'extensions', 'extension_with_decorators')
+```
+## License
+
+Decorators is released under the [MIT license](https://github.com/parndt/decorators/blob/master/license.md#readme)
+and is copyright (c) 2013 [Philip Arndt](http://philiparndt.name)

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification
+name: decorators
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Philip Arndt
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-01-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: railties
+  prerelease: false
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 3.2.11
+    none: false
+  type: :runtime
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 3.2.11
+    none: false
+description: Manages the process of loading decorators into your Rails application.
+email: parndt@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/decorators.rb
+- lib/decorators/paths.rb
+- lib/decorators/railtie.rb
+- license.md
+- readme.md
+homepage: http://philiparndt.name
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+  none: false
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+  none: false
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Rails decorators plugin.
+test_files: []
+has_rdoc: