includer 0.1.0

data/README.md

@@ -0,0 +1,37 @@
+# The Includer
+
+The Includer is an easy way to include files into another files, like we are used to do when programming (every language has its own variation of `load`, `require`, `import`, etc.) or in the web (Apache's [SSI](http://httpd.apache.org/docs/2.2/howto/ssi.html), PHP's [`include`](http://php.net/manual/en/function.include.php), Rails' [`render :partial`](http://api.rubyonrails.org/classes/ActionController/Base.html#M000658), etc.) but with any kind of file, under any circunstance.
+
+I use it to split large markdown files, but there are many potential uses (large CSV datasets, or configuration files, for instance). If you do something cool that's worth to be noted in this README, let me know ;-)
+
+## Installation
+
+    sudo gem sources -a http://gemcutter.org # [if you haven't done it already]
+    sudo gem install includer
+    
+## Usage
+
+For a file to include another, you just have to write the following:
+
+    {{path/to/file.ext}}
+    
+For example, this could be the markdown source for this README.md file (it really isn't ;-) ):
+
+    # The Includer
+    
+    {{intro.md}}
+    {{install.md}}
+    {{usage.md}}
+    {{copyright.md}}
+
+This can be done recursively: included files can include more files. Try infinite loops at your own risk. I mean, don't try them ;-)
+
+Then, just run The Includer:
+
+    $ includer input.txt output.txt
+
+If you omit the output file, it will write to the standard output.
+
+## Copyright & Licensing
+
+Copyright (c) 2010 Sergio Gil. MIT license, see LICENSE for details.

data/bin/includer

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'includer'
+
+Includer::CLI.new(*ARGV).run

data/lib/includer/cli.rb

@@ -0,0 +1,29 @@
+class Includer
+  
+  class CLI
+    
+    def initialize(*argv)
+      @input_file, @output_file = argv.first(2)
+      fail("includer <input_file> [<output_file>]") if @input_file.nil?
+      fail("File not found: #{@input_file}") unless File.exists?(@input_file)
+    end
+    
+    def run
+      output = Includer.read(@input_file)
+      if @output_file
+        File.open(@output_file, "w") { |f| f.write output }
+      else
+        STDOUT.puts output
+      end
+    end
+    
+    private
+    
+    def fail(message)
+      STDOUT.puts(message)
+      exit(-1)
+    end
+
+  end
+  
+end

data/lib/includer/includer.rb

@@ -0,0 +1,9 @@
+class Includer
+  
+  def self.read(file)
+    File.read(file).gsub(/\{\{(.+)\}\}/) do |match|
+      self.read(File.join(File.dirname(file), $1))
+    end
+  end
+
+end

data/lib/includer.rb

@@ -0,0 +1,2 @@
+require 'includer/includer'
+require 'includer/cli'

metadata

@@ -0,0 +1,68 @@
+--- !ruby/object:Gem::Specification 
+name: includer
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- "Sergio Gil P\xC3\xA9rez de la Manga"
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-02-15 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: 
+email: sgilperez@gmail.com
+executables: 
+- includer
+extensions: []
+
+extra_rdoc_files: 
+- README.md
+files: 
+- lib/includer/cli.rb
+- lib/includer/includer.rb
+- lib/includer.rb
+- README.md
+has_rdoc: true
+homepage: http://github.com/porras/includer
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README.md
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Includes files into another files
+test_files: []
+