Contents

module Anise
  require 'anise/annotations.rb'

  # = Annotatable
  #
  # Annotatable allows for the create of dynamic
  # method annotations which attach to the next
  # method defined.
  #
  #   class X
  #     include Anise::Annotatable
  #
  #     annotation :doc
  #
  #     doc "See waht I mean?"
  #     def see
  #       # ...
  #     end
  #   end
  #
  #   X.ann(:see, :doc) #=> "See what I mean?"
  #
  # TODO: This must work when included in a module or
  #       class and also when included at the toplevel.
  #
  module Annotatable

    def self.append_features(base)
      if base == Object
        Module.send(:include, self)  # FIXME: Module ?
      else
        base.extend self
      end
    end

    def pending_annotations
      @pending_annotations ||= []
    end

    def annotation(name)
      (class << self; self; end).instance_eval do
        define_method(name) do |*args|
          pending_annotations << [name, args]
        end
      end
    end

    def method_added(sym)
      pending_annotations.each do |name, args|
        ann sym, name => args
      end
      @pending_annotations = []
    end

  end

end

# Copyright (c) 2005, 2008 TigerOps

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
anise-0.1.1	lib/anise/annotatable.rb