cog 0.1.2 → 0.1.3

data/Default.cogfile

@@ -9,5 +9,17 @@ project_templates_path 'cog/templates'
 # Define the directory to which project source code is generated
 project_source_path 'src'
 
-# Define the default language in which to generated application source code
-language 'c++'
+# Explicitly specify a mapping from file extensions to languages
+#
+# key => value pairs from this mapping will override the default
+# language map supplied by +cog+
+#
+# Type `cog language list` to see a list of supported languages
+# and the current file extension mappings
+language_extensions({
+  # :h => 'c++',
+  })
+
+# Define the target language which should be used when
+# creating generators, and no language is explicitly specified
+default_target_language 'c++'

data/bin/cog

@@ -10,10 +10,11 @@ include GLI::App
 
 program_desc 'This is a utility to help you write code generators.'
 
-# version Cog::VERSION
+desc 'Current version of cog'
+version Cog::VERSION
 
 desc 'Output more detailed information when running a command'
-switch [:verbose, :v]
+switch [:verbose]
 
 desc 'Set the Cogfile explicitly'
 arg_name 'path'
@@ -22,7 +23,7 @@ flag :cogfile
 desc 'Set the active tool'
 arg_name 'name'
 default_value 'basic'
-flag :tool
+flag [:tool, :t]
 
 desc 'Suppress the use of color in output'
 switch :colorless
@@ -51,8 +52,16 @@ command [:generator, :gen] do |c|
   c.desc 'Create a new project generator'
   c.arg_name 'name'
   c.command :new do |sub|
+    sub.desc 'Specify a target language other than the default'
+    sub.default_value 'in Cogfile'
+    sub.flag [:language, :l]
+    
     sub.action do |gopt, opt, args|
       args.each do |name|
+        if opt[:language] && opt[:language] != 'in Cogfile'
+          lang = Cog::Languages.get_language opt[:language]
+          Cog::Config.instance.target_language = lang
+        end
         Cog::Controllers::GeneratorController.create name
       end
     end
@@ -126,6 +135,24 @@ command [:template, :tm] do |c|
   end
 end
 
+desc 'Review supported languages'
+command [:language, :lang] do |c|
+  
+  c.default_command :list
+  
+  c.desc 'List the supported languages'
+  c.command :list do |sub|
+    sub.action do
+      summary = Cog::Config.instance.language_summary
+      w = summary.collect {|info| info.name.length}.max
+      summary.each do |info|
+        puts info.to_s(w)
+      end
+    end
+  end
+  
+end
+
 pre do |gopt, command, opt, args|
   Sickill::Rainbow.enabled = false if gopt[:colorless]
   if gopt[:cogfile] && !File.exists?(gopt[:cogfile])

data/lib/cog.rb

@@ -3,6 +3,7 @@ require 'cog/controllers'
 require 'cog/errors'
 require 'cog/generator'
 require 'cog/helpers'
+require 'cog/languages'
 require 'cog/version'
 
 # +cog+ is a command line utility that makes it a bit easier to organize a project
@@ -15,10 +16,10 @@ module Cog
   def self.initialize_project
     Object.new.instance_eval do
       class << self ; include Generator ; end
-      copy_if_missing File.join(Config.gem_dir, 'Default.cogfile'), 'Cogfile'
+      copy_file_if_missing File.join(Config.gem_dir, 'Default.cogfile'), 'Cogfile'
       config = Config.instance
-      touch_path config.project_generators_path
-      touch_path config.project_templates_path
+      touch_directory config.project_generators_path
+      touch_directory config.project_templates_path
       nil
     end
   end

data/lib/cog/built_in_tools/basic/cog_tool.rb

@@ -7,9 +7,12 @@ Cog::Config.instance.register_tool __FILE__, :built_in => true do |tool|
   #
   # When the block is executed, +self+ will be an instance of Cog::Config::Tool::GeneratorStamper
   tool.stamp_generator do
-    template_dest = File.join config.project_templates_path, "#{name}.txt.erb"
+    @language = Cog::Config.instance.target_language
     stamp 'basic/generator.rb', generator_dest, :absolute_destination => true
-    stamp 'basic/template.txt.erb', template_dest, :absolute_destination => true
+    @language.module_extensions.each do |ext|
+      template_dest = File.join config.project_templates_path, "#{name}.#{ext}.erb"
+      stamp "basic/template.#{ext}.erb", template_dest, :absolute_destination => true
+    end
   end
   
 end

data/lib/cog/config.rb

@@ -1,5 +1,7 @@
 require 'cog/config/cogfile'
 require 'cog/config/tool'
+require 'cog/config/lang_info'
+require 'cog/languages'
 require 'cog/errors'
 
 module Cog
@@ -13,9 +15,6 @@ module Cog
     # @return [String] path to the project's {Cogfile}
     attr_reader :cogfile_path
 
-    # @return [String] default language in which to generated application source code
-    attr_reader :language
-    
     # @return [String] directory in which to find project generators
     attr_reader :project_generators_path
 
@@ -28,8 +27,18 @@ module Cog
     # @return [String] directory in which to find custom project templates
     attr_reader :project_templates_path
     
+    # @return [Languages::Lanugage] target language which should be used when creating generators, and no language is explicitly specified
+    attr_accessor :target_language
+    
+    # @return [String] the target language which is currently active
+    def active_language
+      @active_languages.last
+    end
+    
     # @return [Tool] the active tool affects the creation of new generators
-    attr_reader :active_tool
+    def active_tool
+      @active_tools.last
+    end
     
     # @return [Boolean] whether or not we operating in the context of a project
     def project?
@@ -46,10 +55,7 @@ module Cog
     #
     # @return [Array<String>] a list of directories order with ascending priority
     def template_paths
-      paths = [@project_templates_path]
-      paths += tools.collect {|tool| tool.templates_path}
-      paths << Config.cog_templates_path
-      paths.compact
+      [@project_templates_path, active_tool && active_tool.templates_path, Config.cog_templates_path].compact
     end
     
     # @return [Array<Tool>] a sorted list of available tools
@@ -100,15 +106,55 @@ module Cog
       @tools.member? name
     end
     
-    # Activate the registered tool with the given name
-    # @api developer
+    # Activate the registered tool with the given name with the scope of the provided block.
+    # If no block is provided, the tool will remain active indefinitely.
     # @param name [String] name of the registered tool to activate
+    # @yield the tool will be active within this block
     # @return [nil]
-    def activate_tool(name)
-      throw :ToolAlreadyActivated unless @active_tool.nil?
+    def activate_tool(name, &block)
+      name = name.to_s
       raise Errors::NoSuchTool.new(name) unless tool_registered?(name)
       @tools[name].load
-      @active_tool = @tools[name]
+      @active_tools << @tools[name]
+      if block
+        block.call
+        @active_tools.pop
+      end
+    end
+    
+    # Activate a given language within the scope of the provided block.
+    # Either provide <tt>:id</tt> or <tt>:ext</tt> but not both. If the extension does not match any of the supported languages, the {#active_language} will not change, but the block will still be called.
+    # @option opt [:String] :id (nil) the lanuage identifier. Type <tt>cog language list</tt> to see the possible values
+    # @option opt [:String] :ext (nil) a file extension which will map to a language identifier. Type <tt>cog language map</tt> to see mapped extensions
+    # @yield within this block the {#active_language} will be set to the desired value
+    # @return [Object] the value returned by the block
+    def activate_language(opt={}, &block)
+      lang_id = if opt[:ext]
+        ext = opt[:ext].to_s
+        ext = ext.slice(1..-1) if ext.start_with?('.')
+        @language_extension_map[ext.downcase.to_sym] unless ext.empty?
+      else
+        opt[:id]
+      end
+      if lang_id
+        @active_languages << Languages.get_language(lang_id)
+        r = block.call
+        @active_languages.pop
+        r
+      else
+        block.call
+      end
+    end
+    
+    # @return [Array<LangInfo>] current configuration of supported languages
+    def language_summary
+      summary = {}
+      @language_extension_map.each_pair do |ext, lang_id|
+        lang_id = Languages::ALIAS[lang_id] || lang_id
+        summary[lang_id] ||= LangInfo.new(lang_id, Languages::REV_ALIAS[lang_id] || [])
+        summary[lang_id].extensions << ext
+      end
+      summary.values.sort
     end
     
     # Location of the installed cog gem
@@ -134,7 +180,10 @@ module Cog
     def initialize(cogfile_path = nil)
       @project_root = nil
       @tools = {}
-      @language = 'c++'
+      @active_tools = [] # active tool stack
+      @target_language = Languages::Language.new
+      @active_languages = [Languages::Language.new] # active language stack
+      @language_extension_map = Languages::DEFAULT_LANGUAGE_EXTENSION_MAP
       if cogfile_path
         @cogfile_path = File.expand_path cogfile_path
         @project_root = File.dirname @cogfile_path

data/lib/cog/config/cogfile.rb

@@ -1,3 +1,6 @@
+require 'active_support/core_ext'
+require 'cog/languages'
+
 module Cog
   class Config
     
@@ -23,8 +26,10 @@ module Cog
     
       # Interpret the +Cogfile+ at {Config#cogfile_path}
       # @api developer
+      # @return [nil]
       def interpret
         eval File.read(@config.cogfile_path), binding
+        nil
       rescue Exception => e
         raise CogfileError.new(e.to_s)
       end
@@ -32,41 +37,57 @@ module Cog
       # Define the directory in which to find project generators
       # @param path [String] a file system path
       # @param absolute [Boolean] if +false+, the path is relative to {Config#project_root}
+      # @return [nil]
       def project_generators_path(path, absolute=false)
         @config.instance_eval do
           @project_generators_path = absolute ? path : File.join(project_root, path)
         end
+        nil
       end
 
       # Define the directory in which to find custom project templates
       # @param path [String] a file system path
       # @param absolute [Boolean] if +false+, the path is relative to {Config#project_root}
+      # @return [nil]
       def project_templates_path(path, absolute=false)
         @config.instance_eval do
           @project_templates_path = absolute ? path : File.join(project_root, path)
         end
+        nil
       end
 
       # Define the directory to which project source code is generated
       # @param path [String] a file system path
       # @param absolute [Boolean] if +false+, the path is relative to {Config#project_root}
+      # @return [nil]
       def project_source_path(path, absolute=false)
         @config.instance_eval do
           @project_source_path = absolute ? path : File.join(project_root, path)
         end
+        nil
       end
 
-      # Define the default language in which to generated application source code
-      # @param lang [String] a code for the language. Acceptable values are <tt>c++</tt>
-      def language(lang)
+      # Explicitly specify a mapping from file extensions to languages
+      # @param map [Hash] key-value pairs from this mapping will override the default language map supplied by +cog+
+      # @return [nil]
+      def language_extensions(map)
+        @config.instance_eval do
+          @language_extension_map.update map
+        end
+        nil
+      end
+      
+      # Define the target language which should be used when
+      # creating generators, and no language is explicitly specified
+      # @param lang_id [String] a language identifier
+      def default_target_language(lang_id)
         @config.instance_eval do
-          @language = lang
+          @target_language = Cog::Languages.get_language(lang_id)
         end
       end
     end
 
     # For wrapping errors which occur during the processing of a {Cogfile}
-    # @api client
     class CogfileError < StandardError
       def message
         "in Cogfile, " + super

data/lib/cog/config/lang_info.rb

@@ -0,0 +1,40 @@
+module Cog
+  class Config
+    
+    # Describes configuration of a supported language
+    class LangInfo
+      # @return [String] a language identifier
+      attr_reader :lang_id
+      
+      # @return [Array<String>] a list of aliases
+      attr_reader :aliases
+      
+      # @return [Array<Symbol>] a list of extension which currently map to this language
+      attr_reader :extensions
+      
+      # @return [String] readable name of the language
+      attr_reader :name
+      
+      # @api developer
+      def initialize(lang_id, aliases)
+        @lang_id = lang_id
+        @aliases = aliases.dup
+        @name = @aliases.empty? ? @lang_id : @aliases.join(', ')
+        @extensions = []
+      end
+
+      # @param w [FixNum] width of the first column
+      # @return [String] one line summary in two columns
+      def to_s(w=nil)
+        w ||= name.length
+        "#{name.ljust w} -> #{@extensions.collect {|x| x.to_s}.sort.join ', '}"
+      end
+      
+      # Sort by name
+      def <=>(other)
+        name <=> other.name
+      end
+    end
+    
+  end
+end

data/lib/cog/controllers/template_controller.rb

@@ -16,10 +16,9 @@ module Cog
       def self.list(opt={})
         cts = Helpers::CascadingTemplateSet.new
         cts.add_templates 'built-in', :built_in, Config.cog_templates_path, opt
-        Config.instance.tools.each do |tool|
-          unless tool.templates_path.nil?
-            cts.add_templates tool.name, :tool, tool.templates_path, opt
-          end
+        tool = Config.instance.active_tool
+        unless tool.templates_path.nil?
+          cts.add_templates tool.name, :tool, tool.templates_path, opt
         end
         if Config.instance.project?
           cts.add_templates 'project', :project, Config.instance.project_templates_path, opt
@@ -41,7 +40,7 @@ module Cog
             original = get_template name, :as_path => true
             return if original == dest # Nothing to create
             if opt[:force_override]
-              copy_if_missing original, dest
+              copy_file_if_missing original, dest
             else
               raise Errors::DuplicateTemplate.new original
             end

data/lib/cog/errors.rb

@@ -48,7 +48,11 @@ module Cog
       "invalid directory structure for a cog tool"
     end
     
+    define_error :NoSuchFilter, 'filter'
+    
     define_error :NoSuchGenerator, 'generator'
+    
+    define_error :NoSuchLanguage, 'language'
 
     define_error :NoSuchTemplate, 'template'
 
@@ -56,5 +60,9 @@ module Cog
       "no such tool, make sure it appears in the COG_TOOLS environment variable"
     end
     
+    define_error :ScopeStackUnderflow, 'caller' do
+      "scope stack underflow: this can happen if you have too many *_end calls in a template"
+    end
+    
   end
 end

data/lib/cog/generator.rb

@@ -1,5 +1,8 @@
 require 'cog/config'
 require 'cog/errors'
+require 'cog/generator/file_methods'
+require 'cog/generator/filters'
+require 'cog/generator/language_methods'
 require 'cog/helpers'
 require 'erb'
 require 'rainbow'
@@ -13,27 +16,19 @@ module Cog
   # @see https://github.com/ktonon/cog#generators Introduction to Generators
   module Generator
 
-    # Get the template with the given name
-    # @param path [String] path to template file relative one of the {Config#template_paths}
-    # @option opt [Boolean] :absolute (false) is the +path+ argument absolute?
-    # @option opt [Boolean] :as_path (false) return the template as an ERB instance (+false+) or an absolute path to the file (+true+)
-    # @return [ERB, String] an instance of {http://ruby-doc.org/stdlib-1.9.3/libdoc/erb/rdoc/ERB.html ERB} or an absolute path to the template
-    def get_template(path, opt={})
-      path += '.erb'
-      fullpath = if opt[:absolute]
-        path
-      else
-        Config.instance.template_paths.inject('') do |found, prefix|
-          x = File.join prefix, path
-          found.empty? && File.exists?(x) ? x : found
-        end
-      end
-      raise Errors::NoSuchTemplate.new path unless File.exists? fullpath
-      if opt[:as_path]
-        File.expand_path fullpath
-      else
-        ERB.new File.read(fullpath), 0, '>'
+    include FileMethods
+    include Filters
+    include LanguageMethods
+
+    # @api developer
+    # @return [Hash] Generator context. Generator methods should place context into here instead of instance variables to avoid polluting the instance variable name space
+    def gcontext
+      if @generator_context.nil?
+        @generator_context = {
+          :scopes => []
+        }
       end
+      @generator_context
     end
     
     # Stamp a template into a file or return it as a string
@@ -41,18 +36,33 @@ module Cog
     # @param destination [String] path to which the generated file should be written, relative to the {Config#project_source_path}
     # @option opt [Boolean] :absolute_template_path (false) is the +template_path+ absolute?
     # @option opt [Boolean] :absolute_destination (false) is the +destination+ absolute?
+    # @option opt [String, Array<String>] :filter (nil) filter the result through the named methods
     # @option opt [Boolean] :quiet (false) suppress writing to STDOUT?
     # @return [nil or String] if +destination+ is not provided, the stamped template is returned as a string
     def stamp(template_path, destination=nil, opt={})
+      # Ignore destination if its a hash, its meant to be opt
+      opt, destination = destination, nil if destination.is_a? Hash
+      
+      # Find and render the template
       t = get_template template_path, :absolute => opt[:absolute_template_path]
       b = opt[:binding] || binding
-      return t.result(b) if destination.nil?
+      r = Config.instance.activate_language :ext => File.extname(template_path.to_s) do
+        t.result(b)
+      end
+      
+      # Run r through filters
+      f = opt[:filter]
+      f = [f].compact unless f.is_a?(Array)
+      f.each {|name| r = call_filter name, r }
       
+      return r if destination.nil?
+
+      # Place it in a file
       dest = opt[:absolute_destination] ? destination : File.join(Config.instance.project_source_path, destination)
       FileUtils.mkpath File.dirname(dest) unless File.exists? dest
       scratch = "#{dest}.scratch"
-      File.open(scratch, 'w') {|file| file.write t.result(b)}
-      if same? dest, scratch
+      File.open(scratch, 'w') {|file| file.write r}
+      if files_are_same? dest, scratch
         FileUtils.rm scratch
       else
         updated = File.exists? dest
@@ -62,93 +72,5 @@ module Cog
       nil
     end
 
-    # Copy a file from +src+ to +dest+, but only if +dest+ does not already exist.
-    # @param src [String] where to copy from
-    # @param dest [String] where to copy to
-    # @option opt [Boolean] :quiet (false) suppress writing to STDOUT?
-    # @return [nil]
-    def copy_if_missing(src, dest, opt={})
-      unless File.exists? dest
-        touch_path File.dirname(dest), opt
-        FileUtils.cp src, dest
-        STDOUT.write "Created #{dest.relative_to_project_root}\n".color(:green) unless opt[:quiet]
-      end
-    end
-
-    # Recursively create directories in the given path if they are missing.
-    # @param path [String] a file system path representing a directory
-    # @option opt [Boolean] :quiet (false) suppress writing to STDOUT?
-    # @return [nil]
-    def touch_path(path, opt={})
-      unless File.exists? path
-        FileUtils.mkdir_p path
-        STDOUT.write "Created #{path.relative_to_project_root}\n".color(:green) unless opt[:quiet]
-      end
-      nil
-    end
-    
-    # Create the file at the given path,
-    # Creates directories along the path as required.
-    # @param path [String] a file system path representing a file
-    # @option opt [Boolean] :quiet (false) suppress writing to STDOUT?
-    # @return [nil]
-    def touch_file(path, opt={})
-      touch_path File.dirname(path), opt
-      FileUtils.touch path
-      STDOUT.write "Created #{path.relative_to_project_root}\n".color(:green) unless opt[:quiet]
-      nil
-    end
-    
-    # File extension for a snippet of the given source code language.
-    # @api unstable
-    # @example
-    #   snippet_extension 'c++' # => 'h'
-    def snippet_extension(lang = 'text') # :nodoc:
-      case lang
-      when /(c\+\+|c|objc)/i
-        'h'
-      else
-        'txt'
-      end
-    end
-
-    # @api unstable
-    def include_guard_begin(name)
-      full = "COG_INCLUDE_GUARD_#{name.upcase}"
-      "#ifndef #{full}\n#define #{full}"
-    end
-    
-    # @api unstable
-    def include_guard_end
-      "#endif // COG_INCLUDE_GUARD_[...]"
-    end
-    
-    # @api unstable
-    def namespace_begin(name)
-      return if name.nil?
-      case Config.instance.language
-      when /c\+\+/
-        "namespace #{name} {"
-      end
-    end
-
-    # @api unstable
-    def namespace_end(name)
-      return if name.nil?
-      case Config.instance.language
-      when /c\+\+/
-        "} // namespace #{name}"
-      end
-    end
-    
-  private
-    def same?(original, scratch)
-      if File.exists? original
-        File.read(original) == File.read(scratch)
-      else
-        false
-      end
-    end
-
   end
 end

data/lib/cog/generator/file_methods.rb

@@ -0,0 +1,77 @@
+module Cog
+  module Generator
+    
+    # Methods for working with files
+    module FileMethods
+      
+      # Get the template with the given name
+      # @param path [String] path to template file relative one of the {Config#template_paths}
+      # @option opt [Boolean] :absolute (false) is the +path+ argument absolute?
+      # @option opt [Boolean] :as_path (false) return the template as an ERB instance (+false+) or an absolute path to the file (+true+)
+      # @return [ERB, String] an instance of {http://ruby-doc.org/stdlib-1.9.3/libdoc/erb/rdoc/ERB.html ERB} or an absolute path to the template
+      def get_template(path, opt={})
+        path = path.to_s
+        path += '.erb'
+        fullpath = if opt[:absolute]
+          path
+        else
+          Config.instance.template_paths.inject('') do |found, prefix|
+            x = File.join prefix, path
+            found.empty? && File.exists?(x) ? x : found
+          end
+        end
+        raise Errors::NoSuchTemplate.new path unless File.exists? fullpath
+        if opt[:as_path]
+          File.expand_path fullpath
+        else
+          ERB.new File.read(fullpath), 0, '>'
+        end
+      end
+      
+      # Copy a file from +src+ to +dest+, but only if +dest+ does not already exist.
+      # @param src [String] where to copy from
+      # @param dest [String] where to copy to
+      # @option opt [Boolean] :quiet (false) suppress writing to STDOUT?
+      # @return [nil]
+      def copy_file_if_missing(src, dest, opt={})
+        unless File.exists? dest
+          touch_directory File.dirname(dest), opt
+          FileUtils.cp src, dest
+          STDOUT.write "Created #{dest.relative_to_project_root}\n".color(:green) unless opt[:quiet]
+        end
+      end
+
+      # Recursively create directories in the given path if they are missing.
+      # @param path [String] a file system path representing a directory
+      # @option opt [Boolean] :quiet (false) suppress writing to STDOUT?
+      # @return [nil]
+      def touch_directory(path, opt={})
+        unless File.exists? path
+          FileUtils.mkdir_p path
+          STDOUT.write "Created #{path.relative_to_project_root}\n".color(:green) unless opt[:quiet]
+        end
+        nil
+      end
+    
+      # Create the file at the given path,
+      # Creates directories along the path as required.
+      # @param path [String] a file system path representing a file
+      # @option opt [Boolean] :quiet (false) suppress writing to STDOUT?
+      # @return [nil]
+      def touch_file(path, opt={})
+        touch_directory File.dirname(path), opt
+        FileUtils.touch path
+        STDOUT.write "Created #{path.relative_to_project_root}\n".color(:green) unless opt[:quiet]
+        nil
+      end
+
+      # @param file1 [File] a file
+      # @param file2 [File] another file
+      # @return [Boolean] whether or not the two files have the same content
+      def files_are_same?(file1, file2)
+        File.exists?(file1) && File.exists?(file2) && File.read(file1) == File.read(file2)
+      end
+
+    end
+  end
+end

data/lib/cog/generator/filters.rb

@@ -0,0 +1,30 @@
+require 'cog/errors'
+
+module Cog
+  module Generator
+    
+    # Filters are methods which translate text into more text
+    module Filters
+      
+      # @param text [String] some text which should be rendered as a comment
+      # @return [String] a comment appropriate for the current language context
+      def comment(text)
+        Config.instance.active_language.comment text
+      end
+
+      # @api developer
+      # Adds a call_filter method which throws NoSuchFilter if
+      # the filter is invalid
+      def self.included(other)
+        valid_filters = Filters.instance_eval {instance_methods}
+        other.instance_eval do
+          define_method "call_filter" do |name, text|
+            raise Errors::NoSuchFilter.new(name) unless valid_filters.member?(name.to_s)
+            method(name).call text
+          end
+        end
+      end
+
+    end
+  end
+end

data/lib/cog/generator/language_methods.rb

@@ -0,0 +1,60 @@
+require 'cog/errors'
+require 'cog/generator/language_methods/scope'
+
+module Cog
+  module Generator
+    
+    # Methods to help with generating language constructs
+    module LanguageMethods
+      
+      # @return [String] a warning comment not to edit the generated file
+      def warning
+        stamp 'warning', :filter => 'comment'
+      end
+
+      # Begin a scope, pushing it onto the scope stack
+      # @param scope [Scope] the scope to begin
+      # @return [String] the scope begin statement
+      def scope_begin(scope)
+        gcontext[:scopes] << scope
+        Config.instance.active_language.method("#{scope.type}_begin").call(scope.name)
+      end
+      
+      # End the scope, popping it off the scope stack
+      # @option opt [Boolean] :safe_pop (false) do not throw an exception if the stack is empty, instead, return +nil+
+      # @return [String, nil] the scope end statement, or +nil+ if <tt>:safe_pop</tt> and the stack is empty
+      def scope_end(opt={})
+        if gcontext[:scopes].empty?
+          raise Errors::ScopeStackUnderflow.new(self) unless opt[:safe_pop]
+          return nil
+        end
+        scope = gcontext[:scopes].pop
+        Config.instance.active_language.method("#{scope.type}_end").call(scope.name)
+      end
+      
+      # End all scope currently on the stack
+      # @return [String]
+      def end_all_scopes
+        lines = []
+        while line = scope_end(:safe_pop => true)
+          lines << line
+        end
+        lines.join "\n"
+      end
+
+      # @param name [String] name of the module
+      # @return [String] an include guard statement for the active language
+      def include_guard_begin(name = nil)
+        scope_begin Scope.new(:include_guard, name)
+      end
+    
+      def named_scope_begin(name = nil)
+        scope_begin Scope.new(:named_scope, name)
+      end
+
+      alias :named_scope_end :scope_end
+      alias :include_guard_end :scope_end
+      
+    end
+  end
+end

data/lib/cog/generator/language_methods/scope.rb

@@ -0,0 +1,24 @@
+module Cog
+  module Generator
+    module LanguageMethods
+      
+      # Defines a program scope
+      class Scope
+        
+        # @return [Symbol] type of the scope. For example, <tt>:include_guard</tt>
+        attr_reader :type
+        
+        # @return [String, nil] name of the scope
+        attr_reader :name
+        
+        # @param type [String] type of the scope
+        # @param name [String] name of the scope
+        def initialize(type, name=nil)
+          @type = type.to_sym
+          @name = name
+        end
+      end
+      
+    end
+  end
+end

data/lib/cog/languages.rb

@@ -0,0 +1,50 @@
+require 'cog/errors'
+require 'cog/languages/language'
+
+module Cog
+  
+  # Submodules define helpers for the target languages supported by +cog+
+  module Languages
+    
+    # @return [Hash] a mapping from file extensions to languages identifiers
+    DEFAULT_LANGUAGE_EXTENSION_MAP = {
+      :c => 'c',
+      :cpp => 'c++',
+      :cs => 'c#',
+      :h => 'c',
+      :hpp => 'c++',
+      :java => 'java',
+      :js => 'javascript',
+      :php => 'php',
+      :py => 'python',
+      :rb => 'ruby',
+    }
+
+    # @return [Hash] a mapping from language aliases to language identifiers
+    ALIAS = {
+      'c++' => 'c_plus_plus',
+      'c#' => 'c_sharp',
+      'php' => 'p_h_p',
+      'javascript' => 'java_script',
+    }
+    
+    # @return [Hash] a mapping of language identifiers to lists of aliases
+    REV_ALIAS = {}
+    ALIAS.each_pair do |a, lang|
+      REV_ALIAS[lang] ||= []
+      REV_ALIAS[lang] << a
+    end
+    
+    # @param lang_id [String] a langauge identifier
+    # @return [Language] a language helper corresponding to the given identifier
+    def self.get_language(lang_id)
+      lang_id = Languages::ALIAS[lang_id] || lang_id
+      require "cog/languages/#{lang_id.to_s.downcase}_language"
+      Languages.instance_eval {const_get "#{lang_id.camelize}Language"}.new
+    rescue LoadError
+      raise Errors::NoSuchLanguage.new lang_id
+    end
+    
+  end
+
+end

data/lib/cog/languages/c_language.rb

@@ -0,0 +1,17 @@
+require 'cog/languages/language'
+
+module Cog
+  module Languages
+    
+    class CLanguage < Language
+
+      def comment(text)
+        "/*\n#{text}\n */"
+      end
+
+      def module_extensions
+        [:c, :h]
+      end
+    end
+  end
+end

data/lib/cog/languages/c_plus_plus_language.rb

@@ -0,0 +1,30 @@
+require 'cog/languages/c_language'
+
+module Cog
+  module Languages
+    
+    class CPlusPlusLanguage < CLanguage
+
+      def module_extensions
+        [:cpp, :hpp]
+      end
+
+      def named_scope_begin(name)
+        "namespace #{name} {"
+      end
+
+      def named_scope_end(name)
+        "} // namespace #{name}"
+      end
+
+      def include_guard_begin(name)
+        "#ifndef #{name}\n#define #{name}"
+      end
+
+      def include_guard_end(name)
+        "#end // #{name}"
+      end
+      
+    end
+  end
+end

data/lib/cog/languages/c_sharp_language.rb

@@ -0,0 +1,13 @@
+require 'cog/languages/c_language'
+
+module Cog
+  module Languages
+    
+    class CSharpLanguage < CLanguage
+
+      def module_extensions
+        [:cs]
+      end
+    end
+  end
+end

data/lib/cog/languages/java_language.rb

@@ -0,0 +1,13 @@
+require 'cog/languages/c_language'
+
+module Cog
+  module Languages
+    
+    class JavaLanguage < CLanguage
+
+      def module_extensions
+        [:java]
+      end
+    end
+  end
+end

data/lib/cog/languages/java_script_language.rb

@@ -0,0 +1,13 @@
+require 'cog/languages/c_language'
+
+module Cog
+  module Languages
+    
+    class JavaScriptLanguage < CLanguage
+
+      def module_extensions
+        [:js]
+      end
+    end
+  end
+end

data/lib/cog/languages/language.rb

@@ -0,0 +1,45 @@
+module Cog
+  module Languages
+
+    # Interface that must be supported by all +cog+ language helpers.
+    # This base class corresponds to a plain text language.
+    class Language
+      
+      # @param text [String] some text which should be rendered as a comment
+      # @return [String] a comment appropriate for this language
+      def comment(text)
+        text
+      end
+      
+      # @return a set of extensions needed to define a module in this language
+      def module_extensions
+        [:txt]
+      end
+      
+      # @param name [String] name of the scope
+      # @return [String] begin a named scope
+      def named_scope_begin(name)
+        ""
+      end
+
+      # @param name [String] name of the scope
+      # @return [String] end the given named scope
+      def named_scope_end(name)
+        ""
+      end
+      
+      # @param name [String] name of the module to protect
+      # @return [String] an include guard statement
+      def include_guard_begin(name)
+        ""
+      end
+      
+      # @param name [String] name of the module to protect
+      # @return [String] an include guard end statement
+      def include_guard_end(name)
+        ""
+      end
+
+    end
+  end
+end

data/lib/cog/languages/p_h_p_language.rb

@@ -0,0 +1,13 @@
+require 'cog/languages/c_language'
+
+module Cog
+  module Languages
+    
+    class PHPLanguage < CLanguage
+
+      def module_extensions
+        [:php]
+      end
+    end
+  end
+end

data/lib/cog/languages/python_language.rb

@@ -0,0 +1,17 @@
+require 'cog/languages/language'
+
+module Cog
+  module Languages
+    
+    class PythonLanguage < Language
+
+      def comment(text)
+        "'''\n#{text}\n'''"
+      end
+
+      def module_extensions
+        [:py]
+      end
+    end
+  end
+end

data/lib/cog/languages/ruby_language.rb

@@ -0,0 +1,17 @@
+require 'cog/languages/language'
+
+module Cog
+  module Languages
+    
+    class RubyLanguage < Language
+
+      def comment(text)
+        "=begin\n#{text}\n=end"
+      end
+
+      def module_extensions
+        [:rb]
+      end
+    end
+  end
+end

data/lib/cog/version.rb

@@ -1,5 +1,5 @@
 module Cog
   unless const_defined? :VERSION
-    VERSION = '0.1.2'
+    VERSION = '0.1.3'
   end
 end

data/templates/basic/generator.rb.erb

@@ -4,8 +4,10 @@ class <%= camelized %>
   include Cog::Generator
   
   def generate
-    @some_context = :my_context_value
-    stamp '<%= name %>.txt', 'generated_<%= name %>.txt'
+    @class = '<%= name.gsub ' ', '' %>'
+<% @language.module_extensions.each do |ext| %>
+    stamp '<%= name %>.<%= ext %>', 'generated_<%= name %>.<%= ext %>'
+<% end %>
   end
 end
 

data/templates/basic/template.c.erb.erb

@@ -0,0 +1 @@
+<%%= warning %> 

data/templates/basic/template.cpp.erb.erb

@@ -0,0 +1,6 @@
+<%%= warning %> 
+#include "generated_<%= name %>.h"
+
+<%%= @class %>::<%%= @class >()
+{
+}

data/templates/basic/template.cs.erb.erb

@@ -0,0 +1,6 @@
+<%%= warning %> 
+
+class <%%= @class %>
+{
+	<%%= @class %>();
+};

data/templates/basic/template.h.erb.erb

@@ -0,0 +1 @@
+<%%= warning %> 

data/templates/basic/template.hpp.erb.erb

@@ -0,0 +1,6 @@
+<%%= warning %> 
+
+class <%%= @class %>
+{
+	<%%= @class %>();
+};

data/templates/basic/template.java.erb.erb

@@ -0,0 +1 @@
+<%%= warning %> 

data/templates/basic/template.js.erb.erb

@@ -0,0 +1 @@
+<%%= warning %> 

data/templates/basic/template.php.erb.erb

@@ -0,0 +1 @@
+<%%= warning %> 

data/templates/basic/template.py.erb.erb

@@ -0,0 +1 @@
+<%%= warning %> 

data/templates/basic/template.rb.erb.erb

@@ -0,0 +1,6 @@
+<%%= warning %> 
+
+class <%%= @class %>
+{
+	<%%= @class %>();
+};

data/templates/basic/template.txt.erb.erb

@@ -1 +1 @@
-This is some context: <%%= @some_context %>!
+<%%= warning %> 

data/templates/cog/custom_tool/tool.rb.erb

@@ -10,7 +10,13 @@ module <%= @tool_module %>
   def self.widget(generator_name, &block)
     w = Widget.new generator_name
     block.call w
-    w.generate
+    
+    # Activate <%= @tool_name %> while rendering templates
+    # so that cog will be able to find <%= @tool_name %> templates
+    Cog::Config.instance.activate_tool '<%= @tool_name %>' do
+      w.generate
+    end
+    
     nil
   end
 

data/templates/warning.erb

@@ -0,0 +1,11 @@
+-------------------------------------------------------------------------------
+
+  WARNING
+
+  This is a generated file. DO NOT EDIT THIS FILE! Your changes will
+  be lost the next time this file is regenerated.
+   
+  This file was generating using cog
+  https://github.com/ktonon/cog
+
+-------------------------------------------------------------------------------

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: cog
 version: !ruby/object:Gem::Version 
-  hash: 31
+  hash: 29
   prerelease: 
   segments: 
   - 0
   - 1
-  - 2
-  version: 0.1.2
+  - 3
+  version: 0.1.3
 platform: ruby
 authors: 
 - Kevin Tonon
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2012-11-12 00:00:00 Z
+date: 2012-11-14 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: gli
@@ -114,6 +114,16 @@ files:
 - Default.cogfile
 - LICENSE
 - templates/basic/generator.rb.erb
+- templates/basic/template.c.erb.erb
+- templates/basic/template.cpp.erb.erb
+- templates/basic/template.cs.erb.erb
+- templates/basic/template.h.erb.erb
+- templates/basic/template.hpp.erb.erb
+- templates/basic/template.java.erb.erb
+- templates/basic/template.js.erb.erb
+- templates/basic/template.php.erb.erb
+- templates/basic/template.py.erb.erb
+- templates/basic/template.rb.erb.erb
 - templates/basic/template.txt.erb.erb
 - templates/cog/custom_tool/cog_tool.rb.erb
 - templates/cog/custom_tool/Gemfile.erb
@@ -125,11 +135,12 @@ files:
 - templates/cog/custom_tool/tool.gemspec.erb
 - templates/cog/custom_tool/tool.rb.erb
 - templates/cog/custom_tool/version.rb.erb
-- templates/warning.h.erb
+- templates/warning.erb
 - lib/cog/built_in_tools/basic/cog_tool.rb
 - lib/cog/built_in_tools/basic.rb
 - lib/cog/built_in_tools.rb
 - lib/cog/config/cogfile.rb
+- lib/cog/config/lang_info.rb
 - lib/cog/config/tool.rb
 - lib/cog/config.rb
 - lib/cog/controllers/generator_controller.rb
@@ -137,10 +148,24 @@ files:
 - lib/cog/controllers/tool_controller.rb
 - lib/cog/controllers.rb
 - lib/cog/errors.rb
+- lib/cog/generator/file_methods.rb
+- lib/cog/generator/filters.rb
+- lib/cog/generator/language_methods/scope.rb
+- lib/cog/generator/language_methods.rb
 - lib/cog/generator.rb
 - lib/cog/helpers/cascading_template_set.rb
 - lib/cog/helpers/string.rb
 - lib/cog/helpers.rb
+- lib/cog/languages/c_language.rb
+- lib/cog/languages/c_plus_plus_language.rb
+- lib/cog/languages/c_sharp_language.rb
+- lib/cog/languages/java_language.rb
+- lib/cog/languages/java_script_language.rb
+- lib/cog/languages/language.rb
+- lib/cog/languages/p_h_p_language.rb
+- lib/cog/languages/python_language.rb
+- lib/cog/languages/ruby_language.rb
+- lib/cog/languages.rb
 - lib/cog/spec_helpers/matchers/match_maker.rb
 - lib/cog/spec_helpers/matchers.rb
 - lib/cog/spec_helpers/runner.rb

data/templates/warning.h.erb

@@ -1,9 +0,0 @@
-/* --------------------------------------------------------------------------
-   WARNING
-
-   This is a generated file. DO NOT EDIT THIS FILE! Your changes will be lost
-   the next time this file is regenerated.
-   
-   This file was generating using cog
-   https://github.com/ktonon/cog
-   -------------------------------------------------------------------------- */