dionysus 1.0.2 → 2.0.0

data/Gemfile

@@ -1,13 +1,20 @@
-source :gemcutter
+source "http://rubygems.org"
 
-gem 'bundler',        '~> 1.0'
-gem 'activesupport',  '~> 3.0.0'
+group :development, :test do
+  gem "rake",               "~> 0.9.2"
+  gem "rspec",              "~> 2.10.0"
+end
 
 group :development do
-  gem 'rspec',    '~> 2.0.0'
-  gem 'jeweler',  '~> 1.5.0'
-  gem 'rake',     '~> 0.8.0'
-  gem 'rcov',     '~> 0.9.0'
-  gem 'sdoc',     '~> 0.2.0'
-  gem 'rdiscount', '~> 1.6.0'
+  gem "yard",               "~> 0.8.2"
+  gem "redcarpet",          "~> 2.1.1"
+end
+
+group :test do
+  gem "shoulda-matchers",   "~> 1.2.0"
+  gem "mocha",              "~> 0.11.4"
+  gem "simplecov",          "~> 0.6.4", :require => false
 end
+
+# Specify core dependencies in core.gemspec
+gemspec

data/README.md

@@ -1,58 +1,55 @@
-Dionysus
-========
+# Dionysus
 
-A helpful set of utility classes, generators, and command-line tools.
+<<< description.md
 
 > Dionysus or Dionysos (pronounced /ˌdaɪ.ɵˈnaɪsəs/; Greek: Διόνυσος or 
 > Διώνυσος) is the ancient Greek god of wine, the inspirer of ritual madness 
 > and ecstasy, and a major figure of Greek mythology. 
 > [Wikipedia: Dionysus (2010/03/15)](http://en.wikipedia.org/wiki/Dionysus)
 
-Requirements
-------------
+**GitHub** http://github.com/tekwiz/dionysus
 
-* Rails 3
+**Issues** http://github.com/tekwiz/dionysus/issues
 
-Installation
-------------
+**Travis-CI** http://travis-ci.org/tekwiz/dionysus
+[![Build Status](https://secure.travis-ci.org/tekwiz/dionysus.png?branch=master)](http://travis-ci.org/tekwiz/dionysus)
 
-    gem install dionysus
+**Docs** http://rubydoc.info/gems/dionysus
 
-Usage
------
+**RubyGems** http://rubygems.org/gems/dionysus
 
-First, add "dionysus" to your Gemfile or whatever other dependency system you're using.  Then, you'll need to require each file/module as you need them.  Dionysus is setup *à la carte* since parts are bound to conflict with something you're using at some point.
+## Requirements
 
-Resources
----------
+* ActiveSupport 3.1 or 3.2
 
-* [Github Project](http://github.com/tekwiz/dionysus)
-* [SDocs](http://tekwiz.github.com/dionysus)
-* [Wiki on Github](http://wiki.github.com/tekwiz/dionysus/)
-* [Issues Tracker on Github](http://github.com/tekwiz/dionysus/issues)
+##Installation
 
-Features & Issues
------------------
+    $ gem install dionysus
 
-This is a brand new project, so if you find bugs or use cases that would helpful to satisfy, post an [Issue](http://github.com/tekwiz/dionysus/issues) on Github.
+or add to your Gemfile:
 
-This project is intended to be a **very** eclectic mix of helpful tools, so please feel free to send pull requests.  That said, make **absolutely sure** your modifications are well tested.  The hodge-podge nature of this project may make it prone to issues, so no code will be pulled-in that is not __fully_tested__.
+    gem "dionysus"
 
-Note on Patches/Pull Requests
------------------------------
+and 
+
+    $ bundle install
+
+## Usage
+
+Add dionysus to your Gemfile:
 
-* Fork the project.
-* Make your feature addition or bug fix.
-* Add tests for it. This is important so I don't break it in a
-  future version unintentionally.
-* Commit, do not mess with rakefile, version, or history.
-  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
-* Send me a pull request. Bonus points for topic branches.
+    gem "dionysus"
 
-Copyright
----------
+Then, you'll need to require each file/module as you need them.  Dionysus is setup *à la carte* 
+since parts are bound to conflict with something you're using at some point.
+
+## Contributing
+
+This project is intended to be a **very** eclectic mix of helpful tools, so please feel free to send pull requests.  That said, make **absolutely sure** your modifications are well tested.  The hodge-podge nature of this project may make it prone to issues, so no code will be pulled-in that is not __fully_tested__.
+
+-----------------------------
 
-    Copyright 2010 Travis D. Warlick, Jr.
+    Copyright 2012 Travis D. Warlick, Jr.
     
     Licensed under the Apache License, Version 2.0 (the "License");
     you may not use this file except in compliance with the License.

data/Rakefile

@@ -1,90 +1,27 @@
-require 'rubygems'
-require 'bundler'
-begin
-  Bundler.setup(:default, :development)
-rescue Bundler::BundlerError => e
-  $stderr.puts e.message
-  $stderr.puts "Run `bundle install` to install missing gems"
-  exit e.status_code
-end
-require 'rake'
-
-require 'jeweler'
-Jeweler::Tasks.new do |gem|
-  gem.name = "dionysus"
-  gem.summary = %Q{A helpful set of utility classes, generators, and command-line tools.}
-  gem.email = "warlickt@operissystems.com"
-  gem.homepage = "http://github.com/tekwiz/dionysus"
-  gem.authors = ["Travis D. Warlick, Jr."]
-  gem.add_bundler_dependencies(:default, :development)
-  # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
-end
-Jeweler::RubygemsDotOrgTasks.new
+require "bundler/gem_tasks"
+require "pathname"
 
-require 'rspec/core'
-require 'rspec/core/rake_task'
-RSpec::Core::RakeTask.new(:spec) do |spec|
-  spec.pattern = FileList['spec/**/*_spec.rb']
-end
-RSpec::Core::RakeTask.new(:rcov) do |spec|
-  spec.pattern = 'spec/**/*_spec.rb'
-  spec.rcov = true
-  spec.rcov_opts = '--exclude \/Library\/ --exclude /\.gem\/ --exclude /\.rvm\/ --exclude /\.bundle\/'
-end
-task :default => :spec
+$rake_root = Pathname(__FILE__).expand_path.dirname
 
-task :clobber_rcov do
-  FileUtils.rm_r 'coverage', :secure => true, :force => true, :verbose => true
+Dir.glob($rake_root.join("**/*.rake").to_s).each do |fn|
+  load fn
 end
 
-require 'rake/rdoctask'
-require 'sdoc'
-require 'dionysus/rdoc/markdown'
-require 'dionysus/rdoc/no_markup'
-RDoc::NoMarkup.files.include('LICENSE', 'VERSION')
+task :default => [:spec]
 
-Rake::RDocTask.new do |rdoc|
-  version = File.exist?('VERSION') ? File.read('VERSION') : ""
-  rdoc.options << '--fmt' << 'shtml'
-  rdoc.template = 'direct'
-  rdoc.title = "Dionysus #{version}"
-  rdoc.main = "README.md"
-  rdoc.rdoc_files.include('README.md', 'LICENSE', 'VERSION')
-  rdoc.rdoc_files.include('lib/**/*.rb')
-  rdoc.rdoc_dir = 'docs'
-end
-
-task :clobber => [:clobber_rcov, :clobber_rdoc]
-
-# Github pages tasks taken from the sdoc-helpers gem.
-# http://github.com/defunkt/sdoc-helpers
-# Author: Chris Wanstrath chris@ozmm.org
-namespace :pages do
-  task :publish => [ :check_dirty, :rerdoc ] do
-    version = File.exist?('VERSION') ? File.read('VERSION') : ""
-    `git checkout gh-pages`
-    `ls -1 | grep -v docs | xargs rm -rf; mv docs/* .; rm -rf docs`
-    `git add .; git commit -m "update docs for version #{version}"; git push origin gh-pages`
-    `git checkout master`
-    puts :done
+namespace :clobber do
+  desc "Clobber Gem Package (pkg/)"
+  task :pkg do
+    $rake_root.join("pkg").rmtree rescue nil
   end
 
-  desc "Initialize GitHub Pages with documentation"
-  task :init => [ :check_dirty, :rerdoc ] do
-    `git symbolic-ref HEAD refs/heads/gh-pages`
-    `rm .git/index`
-    `ls -1 | grep -v docs | xargs rm -rf; mv docs/* .; rm -rf docs`
-    `git add .;git commit -m "create docs"; git push origin gh-pages`
-    `git checkout master`
-    puts :done
+  desc "Clobber Coverage (coverage/)"
+  task :coverage do
+    $rake_root.join("coverage").rmtree rescue nil
   end
 
-  task :check_dirty do
-    if !`git status`.include?('nothing to commit')
-      abort "dirty index - not publishing!"
-    end
-  end
+  task :doc => ["doc:clobber"]
 end
 
-desc "Build and publish documentation using GitHub Pages."
-task :pages => "pages:publish"
+desc "Clobber All"
+task :clobber => ["doc:clobber", "clobber:pkg", "clobber:coverage"]

data/description.md

@@ -0,0 +1 @@
+A helpful set of utility classes, generators, and command-line tools.

data/lib/dionysus.rb

@@ -1,31 +1,12 @@
-# Copyright 2010 Travis D. Warlick, Jr.
-# 
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-# 
-#    http://www.apache.org/licenses/LICENSE-2.0
-# 
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-require 'rubygems'
-require 'bundler'
-Bundler.setup
-%w(hash class module).each { |v| require 'active_support/core_ext/'+v }
+require 'dionysus/version'
 
 ##
-# The top-level for Dionysus.
+# <<< description.md
 #
 # Dionysus is setup *à la carte* since parts are bound to conflict with 
 # something you're using at some point.  This means that if you need something,
 # you *must* require it.  See the documentation for instructions on what you 
 # should require (this is always within the first few lines).
 module Dionysus
-  # The current version
-  VERSION = File.read(File.join(File.dirname(__FILE__), '..', 'VERSION')).strip
+  
 end
-

data/lib/dionysus/configuration_callbacks.rb

@@ -0,0 +1,93 @@
+require 'set'
+require 'forwardable'
+require 'active_support/concern'
+require 'active_support/callbacks'
+require 'active_support/core_ext/module/aliasing'
+require 'active_support/core_ext/array/extract_options'
+
+module Dionysus
+  module ConfigurationCallbacks
+    extend ActiveSupport::Concern
+
+    included do
+      # TODO validate self.config inherits from AS::Configurable::Configuration and is an anonymous class
+      self.config.class.send(:include, Configuration)
+    end
+
+    module Configuration
+      extend ActiveSupport::Concern
+      include ActiveSupport::Callbacks
+
+      included do
+        alias_method :_set, :[]= # preserve the original #[] method
+        protected :_set # make it protected
+        extend Forwardable
+      end
+
+      def respond_to?(name, include_private=false)
+        if name.to_s =~ /^_/
+          include_private ? method_defined?(name) : public_method_defined?(name)
+        else
+          true
+        end
+      end
+
+      def before(get_set, key, *args, &block)
+        name = _setup_for_callback(get_set, key)
+        self.class.set_callback(name, :before, *args, &block)
+      end
+
+      def after(get_set, key, *args, &block)
+        name = _setup_for_callback(get_set, key)
+        self.class.set_callback(name, :after, *args, &block)
+      end
+
+      def around(get_set, key, *args, &block)
+        name = _setup_for_callback(get_set, key)
+        self.class.set_callback(name, :around, *args, &block)
+      end
+
+      def forward(get_set, key, to_accessor, to_method)
+        case get_set.to_sym
+        when :get
+          self.class.def_delegator(to_accessor, to_method, key)
+        when :set
+          self.class.def_delegator(to_accessor, to_method, "#{key}=")
+        else
+          raise ArgumentError, "Invalid get_set parameter %p"%[get_set]
+        end
+      end
+
+      private
+
+      def _setup_for_callback(get_set, key)
+        key = key.to_sym
+        name = "#{get_set}_#{key}"
+
+        case get_set.to_sym
+        when :get
+          if method_defined?(key)
+            warn "Cannot setup callbacks for #{self}##{key}.  Method already defined."
+          else
+            class_eval <<-EOS, __FILE__, __LINE__ + 1
+              def #{key}() run_callbacks(#{name.inspect}) { _get(#{key.inspect}) }; end
+            EOS
+          end
+        when :set
+          if method_defined?(:"#{key}=")
+            warn "Cannot setup callbacks for #{self}##{key}.  Method already defined."
+          else
+            class_eval <<-EOS, __FILE__, __LINE__ + 1
+              def #{key}=(val) run_callbacks(#{name.inspect}) { _set(#{key.inspect}, val) }; end
+            EOS
+          end
+        else
+          raise ArgumentError, "Invalid get_set parameter %p"%[get_set]
+        end
+
+        self.class.define_callbacks(name)
+        return name
+      end
+    end
+  end
+end

data/lib/dionysus/redcarpet/includes.rb

@@ -0,0 +1,41 @@
+require 'pathname'
+require 'redcarpet'
+require 'active_support/concern'
+require 'active_support/core_ext/object/blank'
+
+module Dionysus
+  module Redcarpet
+    module Includes
+      extend ActiveSupport::Concern
+
+      included do
+        if method_defined?(:preprocess)
+          alias_method_chain :preprocess, :includes
+        else
+          alias_method :preprocess, :preprocess_with_includes
+        end
+      end
+
+      def preprocess_with_includes(full_document)
+        lines = full_document.split($/)
+        lines.each_with_index do |ln, i|
+          if m = ln.match(/\A\s*<<<\s*(\S+)\s*\Z/)
+            path = Pathname.new(m[1])
+            if path.file?
+              newlines = path.readlines
+              newlines.collect! {|ln| ln.chomp}
+              newlines.shift while(newlines.first.blank?)
+              newlines.pop while(newlines.last.blank?)
+              lines[i] = newlines
+            else
+              warn "[WARNING] Cannot find path %s to include"%[path.to_s]
+            end
+          end
+        end
+        lines.flatten.join("\n")
+      end
+    end
+  end
+end
+
+Redcarpet::Render::HTML.send(:include, Dionysus::Redcarpet::Includes)

data/lib/dionysus/string/version_match.rb

@@ -0,0 +1,8 @@
+class String
+  # @param (String) req Gem version requirement
+  # @return (Boolean) true if the given requirement is satisfied by the current
+  #                   String
+  def version_match?(req)
+    Gem::Requirement.new(req) =~ Gem::Version.new(self)
+  end
+end

data/lib/dionysus/travisci/gemfile_generator.rb

@@ -0,0 +1,67 @@
+require 'bundler'
+
+module Dionysus
+  module TravisCI
+    class GemfileGenerator
+      def initialize(gemfile)
+        @definition = Bundler::Dsl.new
+        @definition.instance_eval(Bundler.read_file(gemfile), "Gemfile", 1)
+      end
+
+      def generate(filename, options={})
+        File.open(filename, "w") do |f|
+          f.puts %(source "http://rubygems.org")
+
+          @definition.dependencies.each do |dep|
+            next if exclude_by_group?(dep, :default, options[:without])
+            f.puts dependency_line(dep)
+          end
+
+          case options[:add]
+          when String
+            f.puts options[:add]
+          when Array
+            options[:add].each {|ln| f.puts ln}
+          else
+            raise "Invalid :add option: %p"%[options[:add]] if options[:add]
+          end
+
+          f.puts %(gemspec :path => "../")
+        end
+      end
+
+      private
+
+      def dependency_line(dep)
+        ln = [ %(gem "%s")%[dep.name] ]
+
+        ln << %("%s")%[dep.requirement]
+
+        groups = dep.groups.collect {|v| %(:#{v})}.join(", ")
+        ln << %(:group => [%s])%[groups]
+
+        if dep.autorequire == []
+          ln << %(:require => false)
+        elsif dep.autorequire
+          requires = dep.autorequire.collect {|s| %("#{s}")}.join(",")
+          ln << %(:require => [%s])%[requires]
+        end
+
+        if dep.source and dep.source.is_a?(Bundler::Source::Git)
+          ln << %(:git => "%s")%[dep.source.options["git"]]
+          ln << %(:branch => "%s")%[dep.source.options["branch"]]
+        elsif dep.source
+          raise "Unknown source type: %s"%[dep.source.class]
+        end
+
+        ln.join(", ")
+      end
+
+      def exclude_by_group?(dep, *without)
+        return false if without.nil? or without.empty?
+        without = without.compact.flatten
+        !(dep.groups & without).empty?
+      end
+    end
+  end
+end