general 1.5.0 → 2.0.0

data/spec/gtamplate_gtemplate_spec.rb

@@ -0,0 +1,266 @@
+# General is a templating system in ruby
+# Copyright (C) 2016  Anshul Kharbanda
+# 
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+# 
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+# 
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+require "spec_require"
+
+# Describe General::GTemplate
+#
+# Implements the general templating system for strings
+#
+# Author: Anshul Kharbanda
+# Created: 3 - 4 - 2016
+describe General::GTemplate do
+	# Before all
+	before :all do
+		class Person
+			def initialize nam, food
+				@name = nam
+				@food = food
+			end
+			def generalized
+				{name: @name, 
+				food: @food}
+			end
+		end
+
+		@template1  = General::GTemplate.new "There once was a man named @(name: Gordon Ramsay). @(name) loved @(food: Cat Food)!"
+		@template2  = General::GTemplate.new "@(user)@at;@(domain)"
+		@template3  = General::GTemplate.new "@[greetings] Hello, @(name)! How is the @(pet)? @[\n]"
+		@template4  = General::GTemplate.new "@(film: The Dark Knight)\nCrew:\n@[crew] \t@(name): @(role) @[\n]\nScore: @(score)/10"
+		@template5  = General::GTemplate.new "There once was a dog named @(name: dog -> capitalize). @(name -> capitalize) earned @(amount -> money) last week."
+		@template6  = General::GTemplate.new "There once was a cat named @(name -> capitalize all)."
+		@template7  = General::GTemplate.new "The time is @(time -> time). It may also be formatted as @(time -> time '@SS <- @MM <- @HH')"
+		@template8  = General::GTemplate.new "The name's @(name.last)... @(name.first) @(name.last)."
+		@template9  = General::GTemplate.new "My favorite color is @#!"
+		@template10 = General::GTemplate.new "@[list -> split] Need @#! @[\n]"
+	end
+
+	# Describe General::GTemplate::new
+	#
+	# Creates a GTemplate with the given template string
+	#
+	# Parameter: string - the string being converted to a template
+	describe "::new" do
+		it "creates a new GTemplate with the given template string" do
+			[@template1, @template2, @template3, @template4, @template5, 
+			 @template6, @template7, @template8, @template9, @template10]
+			.each{ |template| expect(template).to be_an_instance_of General::GTemplate }
+		end
+	end
+
+	# Describe General::GTemplate#apply
+	#
+	# Applies the given data to the template and returns the generated string
+	#
+	# Parameter: data - the data to be applied (as a hash. merges with defaults)
+	#
+	# Return: string of the template with the given data applied
+	describe "#apply" do
+		# ---------------------------------------------DATA----------------------------------------------
+		before :all do
+			# -------------------------------------BASIC PLACEHOLDER-------------------------------------
+			@data1 = {name: "Joe", food: "Joe's Shmoes"}
+			@name  = "Dog"
+			@food  = "Denny's Fennies"
+
+			@default_text = "There once was a man named Gordon Ramsay. Gordon Ramsay loved Cat Food!"
+			@name_text = "There once was a man named Dog. Dog loved Cat Food!"
+			@food_text = "There once was a man named Gordon Ramsay. Gordon Ramsay loved Denny's Fennies!"
+			@all_text = "There once was a man named Joe. Joe loved Joe's Shmoes!"
+
+			# ------------------------------------SPECIAL CHARACTERS------------------------------------
+			@data2 = { user: "hillary", domain: "clinton.org" }
+			@text2 = "hillary@clinton.org"
+
+			# --------------------------------------ARRAY TEMPLATE--------------------------------------
+			@data3 = {
+				greetings: [
+					{name: "Ben", pet: "dog"}, 
+					{name: "Jen", pet: "cat"},
+					{name: "Ken", pet: "plant"}
+				]
+			}
+			@text3 = "Hello, Ben! How is the dog?\nHello, Jen! How is the cat?\nHello, Ken! How is the plant?"
+
+			@data4 = {
+				film: 'Batman Begins',
+				crew: [
+					{name: 'David S. Goyer', role: 'Writer'},
+					{name: 'Chris Nolan',    role: 'Director'},
+					{name: 'Wally Pfister',  role: 'Director of Photography'},
+					{name: 'Michael Caine',  role: 'Alfred Pennyworth'},
+					{name: 'Christian Bale', role: 'Bruce Wayne/Batman'}
+				],
+				score: 10
+			}
+			@text4 = "Batman Begins\nCrew:\n\tDavid S. Goyer: Writer\n\tChris Nolan: Director\n\tWally Pfister: Director of Photography" \
+							 "\n\tMichael Caine: Alfred Pennyworth\n\tChristian Bale: Bruce Wayne/Batman\nScore: 10/10"
+
+			# ---------------------------------------OPERATIONS-----------------------------------------
+			@data5 = {name: "cat", amount: 19999}
+			@text5 = "There once was a dog named Cat. Cat earned $199.99 last week."
+
+			@data6 = {name: "joe schmoe"}
+			@text6 = "There once was a cat named Joe Schmoe."
+
+			hrs = 3; min = 14; sec = 12; pm = true
+			@data7 = {
+				time: ( ((pm ? 11 : 0) + hrs)*3600 + min*60 + sec )
+			}
+
+			@text7 = "The time is #{hrs}:#{min.to_s.rjust(2,'0')}:#{sec.to_s.rjust(2,'0')} #{pm ? 'PM' : 'AM'}. " \
+					"It may also be formatted as #{sec.to_s.rjust(2,'0')} <- #{min.to_s.rjust(2,'0')} <- #{((pm ? 11 : 0) + hrs).to_s.rjust(2,'0')}"
+
+			# --------------------------------------DOT NOTATION----------------------------------------
+			@data9 = General::GDotHash.new name: {first: "Gordon", last: "Ramsay"}
+			@text9 = "The name's Ramsay... Gordon Ramsay."
+
+			# ------------------------------------FULL PLACEHOLDER--------------------------------------
+			@data10 = "Gilbert"
+			@text10 = "My favorite color is Gilbert!"
+
+			# -----------------------------------TO-ARRAY OPERATION-------------------------------------
+			@data11 = {list: "Butter\nMilk\nEggs"}
+			@text11 = "Need Butter!\nNeed Milk!\nNeed Eggs!"
+
+			# ----------------------------------GENERALIZED INTERFACE-----------------------------------
+			@data12 = Person.new "Joe", "Joe's Schmoes"
+			@text12 = "There once was a man named Joe. Joe loved Joe's Schmoes!"
+		end
+
+		# ---------------------------------------------TEST----------------------------------------------
+
+		it "returns the template with data/defaults applied to corresponding placeholders" do
+			expect(@template1.apply).to eql @default_text
+			expect(@template1.apply name: @name).to eql @name_text
+			expect(@template1.apply food: @food).to eql @food_text
+			expect(@template1.apply @data1).to eql @all_text
+		end
+
+		it 'formats special @; characters appropriately' do
+			expect(@template2.apply @data2).to eql @text2
+		end
+
+		it "formatts array data according to array templates" do
+			expect(@template3.apply @data3).to eql @text3
+			expect(@template4.apply @data4).to eql @text4
+		end
+
+		it 'formats data according to given placeholder operations and arguments (if given)' do
+			expect(@template5.apply @data5).to eql @text5
+			expect(@template6.apply @data6).to eql @text6
+			expect(@template7.apply @data7).to eql @text7
+		end
+
+		it "applies data appropriately to dot notation placeholders" do 
+			expect(@template8.apply @data9).to eql @text9
+		end
+
+		it "applies full data to full placeholders" do 
+			expect(@template9.apply @data10).to eql @text10
+		end
+
+		it "formats array data generated by to-array operations according to array template" do 
+			expect(@template10.apply @data11).to eql @text11
+		end
+
+		it "returns the template with the generalized data from object applied appropriately" do 
+			expect(@template1.apply @data12).to eql @text12
+		end
+	end
+
+	# Describe General::GTemplate#apply_all
+	#
+	# Applies each data structure in the array independently to the template
+	# and returns an array of the generated strings
+	#
+	# Parameter: array - the array of data to be applied 
+	# 				     (each data hash will be merged with defaults)
+	#
+	# Return: array of strings generated from the template with the given 
+	# 		  data applied
+	describe '#apply_all' do
+		before :all do
+			@data5 = [
+				{name: "Joe",   food: "Joe's Schmoes"},
+				{name: "Jane",  food: "Jane's Danes"},
+				{name: "Denny", food: "Denny's Fennies"}
+			]
+
+			@text5 = [
+				"There once was a man named Joe. Joe loved Joe's Schmoes!",
+				"There once was a man named Jane. Jane loved Jane's Danes!",
+				"There once was a man named Denny. Denny loved Denny's Fennies!"	
+			]
+		end
+
+		it 'applies all the values in the data array individually' do
+			expect(@template1.apply_all @data5).to eql @text5
+		end
+	end
+
+	# Describe General::GTemplate#regex (depricated)
+	# 
+	# Returns the string as a regex
+	#
+	# Parameter: sub - true if the template is part of array template
+	#
+	# Returns: the string as a regex
+	describe '#regex (depricated)' do
+		before :all do
+			@regex1 = /\AThere once was a man named (?<name>.*)\. \k<name> loved (?<food>.*)!\z/
+			@sub_regex1 = "There once was a man named (?<name>.*)\\. \\k<name> loved (?<food>.*)!"
+		end
+
+		it 'returns the regex created from the GTemplate if template is not part of array template' do
+			expect(@template1.regex).to eql @regex1
+		end
+
+		it 'returns the sub regex string created from the GTemplate if template is part of array template' do
+			expect(@template1.regex true).to eql @sub_regex1
+		end
+	end
+
+	# Describe General::GTemplate#match (depricated)
+	#
+	# Matches the given string against the template and returns the 
+	# collected information. Returns nil if the given string does 
+	# not match.
+	#
+	# If a block is given, it will be run with the generated hash
+	# if the string matches. Alias for:
+	# 
+	# if m = template.match(string)
+	# 	 # Run block
+	# end
+	# 
+	# Parameter: string the string to match
+	# 
+	# Return: Information matched from the string or nil
+	describe '#match (depricated)' do
+		it 'returns the data generated from the string when the given string matches the template regex' do
+			expect(@template1.match @all_text).to eql @data1
+		end
+
+		it 'returns nil when the given string does not match the template regex' do
+			expect(@template1.match "").to be_nil
+		end
+
+		it 'passes the hash to a block if given' do
+			expect{ @template1.match(@all_text) { |hash| expect(hash).to eql @data1 } }.not_to raise_error
+		end
+	end
+end

data/spec/gtemplate_gio_spec.rb

@@ -0,0 +1,147 @@
+# General is a templating system in ruby
+# Copyright (C) 2016  Anshul Kharbanda
+# 
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+# 
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+# 
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+require_relative "spec_require"
+
+# Describe General::GIO
+#
+# Implements the general IO writer template
+#
+# Author: Anshul Kharbanda
+# Created: 3 - 4 - 2016
+describe General::GIO do
+	before :all do
+		@default_data = {place: "virginia"}
+		@applied_data = {name: "joe", food: "Joe's Schmoes", place: "kentucky"}
+
+		@gio1 = General::GIO.load("exp/templates/sample1" + General::GIO::EXTENSION)
+		@gio2 = General::GIO.load("exp/templates/sample2" + General::GIO::EXTENSION)
+		@gio3 = General::GIO.load("exp/templates/sample3" + General::GIO::EXTENSION)
+
+		@out1 = "exp/out/sample1.txt"
+		@out2 = "exp/out/sample2.txt"
+		@out3 = "exp/out/sample3.txt"
+		@outF = 3
+
+		@default_text1 = IO.read "exp/expected/default1.txt"
+		@default_text2 = IO.read "exp/expected/default2.txt"
+		@default_text3 = IO.read "exp/expected/default3.txt"
+
+		@applied_text1 = IO.read "exp/expected/applied1.txt"
+		@applied_text2 = IO.read "exp/expected/applied2.txt"
+		@applied_text3 = IO.read "exp/expected/applied3.txt"		
+	end
+
+	# Describe General::GIO::load
+	#
+	# Loads a GIO from a file with the given path
+	#
+	# Parameter: path - the path of the file to load
+	#
+	# Return: GIO loaded from the file
+	describe "::load" do
+		it "creates a new GIO with the given template string" do
+			expect(@gio1).to be_an_instance_of General::GIO
+			expect(@gio2).to be_an_instance_of General::GIO
+			expect(@gio3).to be_an_instance_of General::GIO
+		end
+
+		it "cannot load GMeta file (with @@yield defined)" do
+			expect { General::GIO.load("exp/templates/sample0"+General::GIO::EXTENSION) }.to raise_error General::GError
+		end
+
+		it "cannot load GMeta file with multiple @@yield statements" do
+			expect { General::GIO.load("exp/templates/sampleE1"+General::GIO::EXTENSION) }.to raise_error General::GError
+		end
+
+		it "cannot load GIO in which @@extend statement is not at the beginning of the template" do
+			expect { General::GIO.load("exp/templates/sampleE2"+General::GIO::EXTENSION) }.to raise_error General::GError
+		end
+
+		it "cannot load GIO with multiple @@extend statements" do
+			expect { General::GIO.load("exp/templates/sampleE3"+General::GIO::EXTENSION) }.to raise_error General::GError
+		end
+	end
+
+	# Describe General::GIO#write
+	# 
+	# Writes the template with the given data applied to the target stream
+	#
+	# Parameter: ios  - if String, is the name of the file to write to
+	# 					if IO, is the stream to write to
+	# Parameter: data - the data to be applied (merges with defaults)
+	describe "#write" do
+		# -------------------------------------------DEFAULT-------------------------------------------
+
+		context "with target and default data" do
+			it "writes the default data to the file with the given filename" do
+				@gio1.write @out1, @default_data
+				@gio2.write @out2, @default_data
+				@gio3.write @out3, @default_data
+
+				expect(IO.read @out1).to eql @default_text1
+				expect(IO.read @out2).to eql @default_text2
+				expect(IO.read @out3).to eql @default_text3
+			end
+
+			it "writes the default data to the given file io" do
+				File.open(@out1, "w+") { |ios| @gio1.write ios, @default_data }
+				File.open(@out2, "w+") { |ios| @gio2.write ios, @default_data }
+				File.open(@out3, "w+") { |ios| @gio3.write ios, @default_data }
+
+				expect(IO.read @out1).to eql @default_text1
+				expect(IO.read @out2).to eql @default_text2
+				expect(IO.read @out3).to eql @default_text3
+			end
+
+			it "raises TypeError if target is not string or io" do
+				expect{ @gio1.write @outF, @default_data }.to raise_error TypeError
+				expect{ @gio2.write @outF, @default_data }.to raise_error TypeError
+				expect{ @gio3.write @outF, @default_data }.to raise_error TypeError
+			end
+		end
+
+		# --------------------------------------------DATA---------------------------------------------
+
+		context "with target and given data" do
+			it "writes the given data to the file with the given filename" do
+				@gio1.write @out1, @applied_data
+				@gio2.write @out2, @applied_data
+				@gio3.write @out3, @applied_data
+
+				expect(IO.read @out1).to eql @applied_text1
+				expect(IO.read @out2).to eql @applied_text2
+				expect(IO.read @out3).to eql @applied_text3
+			end
+
+			it "writes the given data to the given file io" do
+				File.open(@out1, "w+") { |ios| @gio1.write ios, @applied_data }
+				File.open(@out2, "w+") { |ios| @gio2.write ios, @applied_data }
+				File.open(@out3, "w+") { |ios| @gio3.write ios, @applied_data }
+
+				expect(IO.read @out1).to eql @applied_text1
+				expect(IO.read @out2).to eql @applied_text2
+				expect(IO.read @out3).to eql @applied_text3
+			end
+
+			it "raises TypeError if target is not string or io" do
+				expect{ @gio1.write @outF, @applied_data }.to raise_error TypeError
+				expect{ @gio2.write @outF, @applied_data }.to raise_error TypeError
+				expect{ @gio3.write @outF, @applied_data }.to raise_error TypeError
+			end
+		end
+	end
+end

data/spec/gtemplate_gtimeformat_spec.rb

@@ -0,0 +1,77 @@
+# General is a templating system in ruby
+# Copyright (C) 2016  Anshul Kharbanda
+# 
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+# 
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+# 
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+require_relative "spec_require"
+
+# Describe General::GTimeFormat
+# 
+# A special template used for formatting time strings
+#
+# Author:  Anshul Kharbanda
+# Created: 7 - 2 - 2016
+describe General::GTimeFormat do
+	before :all do
+		# Time value
+		@time = (11 + 3)*3600 + 42*60 + 9
+
+		# Phony value
+		@phony = {data: "Time, Yo!"}
+
+		# Formats
+		@format1 = General::GTimeFormat.new "@HH:@MM:@SS"
+		@format2 = General::GTimeFormat.new "@I:@MM:@S @A"
+		@format3 = General::GTimeFormat.new "@SS - @M - @H (@I @A)"
+
+		# Applied values
+		@applied1 = "14:42:09"
+		@applied2 = "3:42:9 PM"
+		@applied3 = "09 - 42 - 14 (3 PM)"
+	end
+
+	# Describe General::GTimeFormat::new
+	# 
+	# Creates the GTimeFormat with the given string
+	#
+	# Parameter: string - the template string
+	describe "::new" do
+		it "creates a new GTimeFormat with the given format string" do
+			expect(@format1).to be_an_instance_of General::GTimeFormat
+			expect(@format2).to be_an_instance_of General::GTimeFormat
+			expect(@format3).to be_an_instance_of General::GTimeFormat
+		end
+	end
+
+	# Describe General::GTimeFormat#apply
+	# 
+	# Applies the given integer value to the template and returns the generated string
+	#
+	# Parameter: value - the value to be applied (as a hash. merges with defaults)
+	#
+	# Return: string of the template with the given value applied
+	describe "#apply" do
+		it "returns the given integer time value value formatted according to the time format" do
+			expect(@format1.apply(@time)).to eql @applied1
+			expect(@format2.apply(@time)).to eql @applied2
+			expect(@format3.apply(@time)).to eql @applied3
+		end
+
+		it "raises TypeError if value given is not integer" do
+			expect{ @format1.apply(@phony) }.to raise_error TypeError
+			expect{ @format2.apply(@phony) }.to raise_error TypeError
+			expect{ @format3.apply(@phony) }.to raise_error TypeError
+		end
+	end
+end

data/spec/spec_require.rb

@@ -16,10 +16,13 @@
 
 require_relative "../lib/gdothash"
 require_relative "../lib/goperations"
+require_relative "../lib/gerror"
 require_relative "../lib/gpartials/gpartial"
 require_relative "../lib/gpartials/gtext"
 require_relative "../lib/gpartials/gplaceholder"
-require_relative "../lib/gpartials/gpartial"
-require_relative "../lib/templates/gtemplate"
-require_relative "../lib/templates/gio"
-require_relative "../lib/templates/gtimeformat"
+require_relative "../lib/gpartials/garrayplaceholder"
+require_relative "../lib/gpartials/gfullplaceholder"
+require_relative "../lib/gpartials/gtimeformatplaceholder"
+require_relative "../lib/gtemplates/gtemplate"
+require_relative "../lib/gtemplates/gtimeformat"
+require_relative "../lib/gtemplates/gio"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: general
 version: !ruby/object:Gem::Version
-  version: 1.5.0
+  version: 2.0.0
 platform: ruby
 authors:
 - Anshul Kharbanda
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-11-02 00:00:00.000000000 Z
+date: 2017-02-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -36,27 +36,55 @@ files:
 - LICENSE
 - README.md
 - Rakefile
-- exp/future.general
-- exp/out.txt
-- exp/sample.general
+- exp/expected/applied1.txt
+- exp/expected/applied2.txt
+- exp/expected/applied3.txt
+- exp/expected/default1.txt
+- exp/expected/default2.txt
+- exp/expected/default3.txt
+- exp/out/sample1.txt
+- exp/out/sample2.txt
+- exp/out/sample3.txt
+- exp/templates/sample0.general
+- exp/templates/sample1.general
+- exp/templates/sample2.general
+- exp/templates/sample3.general
+- exp/templates/sampleE0.general
+- exp/templates/sampleE1.general
+- exp/templates/sampleE2.general
+- exp/templates/sampleE3.general
 - lib/gdothash.rb
 - lib/general.rb
+- lib/gerror.rb
 - lib/goperations.rb
+- lib/gpartials/garrayplaceholder.rb
+- lib/gpartials/gfullplaceholder.rb
 - lib/gpartials/gpartial.rb
 - lib/gpartials/gplaceholder.rb
+- lib/gpartials/gspecial.rb
 - lib/gpartials/gtext.rb
 - lib/gpartials/gtimeformatplaceholder.rb
-- lib/templates/gbasetemplate.rb
-- lib/templates/gio.rb
-- lib/templates/gtemplate.rb
-- lib/templates/gtimeformat.rb
-- spec/garrayplaceholder_spec.rb
+- lib/gprepartials/gextend.rb
+- lib/gprepartials/ginclude.rb
+- lib/gprepartials/gprepartial.rb
+- lib/gprepartials/gpretext.rb
+- lib/gprepartials/gyield.rb
+- lib/gtemplates/gbasetemplate.rb
+- lib/gtemplates/gio.rb
+- lib/gtemplates/gmeta.rb
+- lib/gtemplates/gtemplate.rb
+- lib/gtemplates/gtimeformat.rb
 - spec/gdothash_spec.rb
 - spec/goperations_spec.rb
+- spec/gpartial_garrayplaceholder_spec.rb
+- spec/gpartial_gfullplaceholder_spec.rb
+- spec/gpartial_gplaceholder_spec.rb
+- spec/gpartial_gspecial_spec.rb
+- spec/gpartial_gtext_spec.rb
 - spec/gpartial_spec.rb
-- spec/gplaceholder_spec.rb
-- spec/gtemplates_spec.rb
-- spec/gtext_spec.rb
+- spec/gtamplate_gtemplate_spec.rb
+- spec/gtemplate_gio_spec.rb
+- spec/gtemplate_gtimeformat_spec.rb
 - spec/spec_require.rb
 homepage: https://andydevs.github.io/general
 licenses:

data/exp/future.general

@@ -1,11 +0,0 @@
-@@include sample
-
-@if(drives: true)
-
-@(name) drove to the store to get some @(food).
-
-@else
-
-@(name) walked thirty blocks uphil to the store to get some @(food)
-
-@end

data/exp/out.txt

@@ -1 +0,0 @@
-There once was a chef name Joe, and he loved eating Joe's Schmoes. He went to Kentucky.

data/exp/sample.general

@@ -1 +0,0 @@
-There once was a chef name @(name: gordon ramsay -> capitalize all), and he loved eating @(food: carrots). He went to @(place -> capitalize).

data/lib/templates/gio.rb

@@ -1,68 +0,0 @@
-# General is a templating system in ruby
-# Copyright (C) 2016  Anshul Kharbanda
-# 
-# This program is free software: you can redistribute it and/or modify
-# it under the terms of the GNU General Public License as published by
-# the Free Software Foundation, either version 3 of the License, or
-# (at your option) any later version.
-# 
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-# 
-# You should have received a copy of the GNU General Public License
-# along with this program.  If not, see <http://www.gnu.org/licenses/>.
-
-require_relative "gtemplate"
-
-# General is a templating system in ruby
-#
-# Author: Anshul Kharbanda
-# Created: 3 - 4 - 2016
-module General
-	# Implements the general IO writer template
-	#
-	# Author: Anshul Kharbanda
-	# Created: 3 - 4 - 2016
-	class GIO < GTemplate
-		# The general file extension
-		EXTENSION = ".general"
-
-		# Public read source
-		attr :source
-
-		# Loads a GIO from a file with the given path
-		#
-		# Parameter: path - the path of the file to load
-		#
-		# Return: GIO loaded from the file
-		def self.load path
-			self.new IO.read(path), path
-		end
-
-		# Creates a GIO with the given template string and source filename
-		#
-		# Parameter: string - the string being converted to a template
-		# Parameter: source - the name of the source file of the template
-		def initialize string, source=nil
-			super string
-			@source = source
-		end
-
-		# Writes the template with the given data applied to the target stream
-		#
-		# Parameter: ios  - if String, is the name of the file to write to
-		# 					if IO, is the stream to write to
-		# Parameter: data - the data to be applied (merges with defaults)
-		def write ios, data={}
-			if ios.is_a? String
-				IO.write ios, apply(data)
-			elsif ios.is_a? IO
-				ios.write apply(data)
-			else
-				raise TypeError.new "Expected IO or String, got: #{ios.class}"
-			end
-		end
-	end
-end