rag 1.0.0

data/data/license/lgpl

@@ -0,0 +1,165 @@
+                   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.

data/data/license/mit.erb

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) <%=year%> <%=author%>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/data/template/default/.gitignore

@@ -0,0 +1 @@
+*~

data/data/template/default/.rspec

@@ -0,0 +1 @@
+--color

data/data/template/default/Gemfile

@@ -0,0 +1,7 @@
+source :rubygems
+
+group :development do
+
+end
+
+gemspec

data/data/template/default/LICENSE.erb

@@ -0,0 +1,20 @@
+Copyright (c) 2011 <%=author%>
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/data/template/default/README.md.erb

@@ -0,0 +1,38 @@
+Foo, a very good library
+========================
+
+**Homepage**: [https://github.com/<%=github.username%>/<%=project%>](https://github.com/<%=github.username%>/<%=project%>) <br/>
+**Author**:	<%=author%> <br/>
+**License**: <%=license%> <br/>
+**Documentation**: [http://rubydoc.info/gems/<%=project%>/frames](http://rubydoc.info/gems/<%=project%>/frames) <br/>
+**Issue Tracker**: [https://github.com/<%=github.username%>/<%=project%>/issues](https://github.com/<%=github.username%>/<%=project%>/issues) <br/>
+
+Overview
+--------
+
+	descripe your prjoect here.
+
+Features
+--------
+
+	a clearly list of features.
+
+Usage
+-----
+
+	how to use
+
+Install
+----------
+
+	install method
+
+Resources
+---------
+
+	some related resources to help each other.
+
+
+Copyright
+---------
+Copyright &copy; 2011 by <%=author%>. this library released under <%=license%>, See {file:LICENSE} for futher details.

data/data/template/default/Ragfile

@@ -0,0 +1,5 @@
+# add your own task in Ragfile or in tasks/*.rag
+class Rag < Thor
+end
+
+# vim: filetype=ruby

data/data/template/default/__project__.gemspec.erb

@@ -0,0 +1,20 @@
+$: << "."
+require "version"
+
+Gem::Specification.new do |s|
+	s.name = "<%=project%>"
+	s.version = <%=project.capitalize%>::VERSION::IS
+	s.summary = "a good lib"
+	s.description = <<-EOF
+a good lib
+	EOF
+
+	s.author = "<%=author%>"
+	s.email = "<%=email%>"
+	s.homepage = "http://github.com/<%=github.username%>/<%=project%>"
+	s.rubyforge_project = "xx"
+
+	s.files = `git ls-files`.split("\n")
+
+	s.add_dependency "x"
+end

data/data/template/default/__project__.watchr

@@ -0,0 +1,22 @@
+# lib/**/*.rb
+watch %r~lib/(.*)\.rb~ do |m|
+	test "spec/#{m[1]}_spec.rb"
+end
+
+# spec/**/*_spec.rb
+watch %r~spec/.*_spec\.rb~ do |m|
+	test m[0]
+end
+
+# Ctrl-\
+Signal.trap('QUIT') do
+  puts "--- Running all tests ---\n\n"
+	test "spec"
+end
+
+def test path
+	cmd = "rspec #{path}"
+	puts cmd
+	system cmd
+end
+

data/data/template/default/version.rb.erb

@@ -0,0 +1,9 @@
+module <%=project.capitalize%>
+	module VERSION
+		MAJOR = 0
+		MINOR = 1
+		PATCH = 0
+
+		IS = [MAJOR, MINOR, PATCH].join(".") 
+	end
+end

data/data/template/default.readme

@@ -0,0 +1,26 @@
+
+file layout
+
+	bin/
+
+	lib/
+	  \__project__/
+	    ...
+	  \__project__.rb
+
+	spec/
+    spec_helper.rb
+	  \__project__
+			...
+	\__project__.watchr
+
+	Gemfile
+	Ragfile
+	\__project__.gemspec
+	version.rb
+
+	LICENSE
+	README
+
+
+# vim: filetype=markdown

data/data/template/test/file_name.erb

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

data/docs/OverView.md

@@ -0,0 +1,11 @@
+
+see template/default/README
+
+
+Template
+--------
+
+filename:
+	subsitute '__project__' to your 'project-name'
+
+

data/lib/rag/doc.rb

@@ -0,0 +1,6 @@
+class Rag < Thor
+	desc "doc", "test documentation with yard server --reload"
+	def doc
+		system "yard server --reload", :verbose
+	end
+end

data/lib/rag/gem.rb

@@ -0,0 +1,17 @@
+class Rag < Thor
+
+	desc "release", "release this gem to RubyGems.org"
+	def release
+		system "gem build #{Rc.o.project}.gemspec", :verbose
+		system "gem push #{Rc.o.project}-#{Rc.o.version}.gem", :verbose
+		Pa.rm "#{Rc.o.project}-#{Rc.o.version}.gem", :verbose
+	end
+
+	desc "install", "install this gem to your system"
+	def install
+		system "gem build #{Rc.o.project}.gemspec", :verbose
+		system "gem install #{Rc.o.project}-#{Rc.o.version}.gem", :verbose
+		Pa.rm "#{Rc.o.project}-#{Rc.o.version}.gem", :verbose
+	end
+
+end

data/lib/rag/new/project.rb

@@ -0,0 +1,142 @@
+require "tagen/yaml"
+require "tagen/erb"
+
+class Rag
+=begin
+
+== ERB support variables
+* project 		# the name of your project, provided by `rag new <project_name>'
+* others from .ragrc 
+
+== Configrauton
+
++ ~/.ragrc 
++ APP/.ragrc 
++ from cmdline
+
+you can use arbitrary name in .ragrc, then you can use then in template file.
+
+=end
+class Project
+	module ClassMethods
+		def create name, o={}
+			Project.new(name, o).create
+		end
+
+		# find templates
+		def templates
+			templates = []
+			templates << Rc.pa.template.ls - %w(test)
+			home_template_pa = Pa('~/.rag/tempalte' )
+			templates << home_template_pa.ls if home_tempate_pa.exists?
+		end
+
+		# call by `rag new -l'
+		def list_templates
+			puts self.templates.join('\n')
+		end
+
+	end
+	extend ClassMethods
+
+	attr_reader :options, :name, :project
+	def initialize name, o={}
+		@name = name
+		@options = o
+		@project = name=="." ? (o["name"] || Pa.pwd2.base) : name
+		@dest = Pa(@name)
+	end
+
+	def create
+		create_project_directory
+		if name=="."
+			copy_files
+		else
+			copy_files :overwrite => true
+		end
+	end
+
+	def create_project_directory
+		if @name=="."
+			return
+		elsif @dest.exists?
+			puts "dest directory `#{@name}' already existing"
+			exit
+		else
+			@dest.mkdir
+		end
+	end
+
+	def copy_files o={}
+		Pa.each_r Rc.pa.template.join(options[:template]) do |pa, relative, e|
+			# skip *~
+			next if pa.b =~ /~$/
+
+			# convert __project__ to @name
+			dest = @dest.join(relative.gsub(/__project__/, project))
+			path_msg = relative.gsub(/__project__/,project).gsub(/\.erb$/,'')
+
+			# skip directory not file
+			next if dest.exists? and dest.directory? 
+
+			if not o[:overwrite] and (dest.exists? or dest.sub(/\.erb$/, '').exists?)
+				print "Overwrite #{path_msg}? [yna] "
+				case $stdin.gets.rstrip
+				when "y"
+					puts "[overwrite] #{path_msg}"
+					copy_file pa, dest, o
+				when "a"
+					puts "[overwrite] #{path_msg}"
+					o[:overwrite] = true
+					copy_file pa, dest, o
+				when "q"
+					exit
+				else
+					puts "[skip] #{path_msg}"
+					next
+				end
+			elsif o[:overwrite] and dest.exists?
+				puts "[overwrite] #{path_msg}"
+				copy_file pa, dest, o
+			else
+				# classify: file dir/
+				puts "[create] #{path_msg}" + (dest.directory? ? '/' : '')
+				copy_file pa, dest, o
+			end
+
+		end
+	end
+
+	# not rescurive copy
+	def copy_file src, dest, o
+		if src.e=='erb'
+			copy_erb_file src, dest.sub(/\.erb$/,'')
+		else
+			Pa.cp src, dest, o.merge(special: true)
+		end
+	end
+
+	def copy_erb_file src, dest
+		content = ERB.new(File.read(src.p)).result(nil, get_erb_config)
+		File.write dest.p, content
+		dest.chmod(src.stat.mode)
+	end
+
+	def get_erb_config
+		# ~/.ragrc
+		home_config = YAML.load(Rc.pa.config)
+		# APP/.ragrc
+		app_config = Rc.pa.app_config.exists? ? YAML.load(Rc.pa.app_config) : {}
+		# cli
+		cli_config = options
+
+		config = home_config.merge(app_config).merge(cli_config)
+		config["project"] = project
+
+		o = OpenOption.new(config)
+		o
+	end
+
+
+end
+end

data/lib/rag/new.rb

@@ -0,0 +1,39 @@
+require_relative "new/project"
+
+class Rag  < Thor
+	desc "new <project_name> or new .", "create a new project or use current directory"
+	method_option "author", 		type: :string, banner: "NAME", desc: "the project's author name"
+	method_option "email", 			type: :string, desc: "author's email address"
+	method_option "template", 	type: :string, default: "default", banner: "NAME", desc: "which template to use"
+	method_option "name", 			type: :string, banner: "NAME", desc: "rag new . [--name hello] default from File.basename(cur_path)"
+	method_option "list", 			type: :boolean, desc: "list templates", aliaes: %w(-l)
+	def new name
+		if options.list?
+			Project.list_templates
+		end
+
+		check_first_time
+
+		Project.create name, options
+	end
+
+	private
+	def check_first_time
+ 		return unless first_time?
+
+		puts "first time run rag"
+		(Rc.pa.data+'/home_config').each do |src|
+			dest = '~/' + src.b.sub(/^_/, '.')
+			puts "[create] #{dest.short}"
+			Pa.cp src, dest
+		end
+		puts "exit."
+		puts "please edit ~/.ragrc config file, then run rag again"
+		exit
+	end
+
+	def first_time?
+		Rc.pa.config.exists? ? false : true
+	end
+
+end

data/lib/rag/rc.rb

@@ -0,0 +1,21 @@
+class Rag
+  Rc = OpenOption.new
+	Rc.pa = OpenOption.new
+		Rc.pa.config = Pa(ENV['HOME']).join('.ragrc')
+		Rc.pa.app = Pa(__FILE__).dir2.parent(2)
+			Rc.pa.app_config = Rc.pa.app.join('.ragrc')
+			Rc.pa.data = Rc.pa.app.join('data')
+				Rc.pa.template = Rc.pa.data.join('template')
+				Rc.pa.home_config = Rc.pa.data.join('home_config')
+				Rc.pa.header = Rc.pa.data.join('header')
+				Rc.pa.license = Rc.pa.data.join('license')
+
+	Rc.o = OpenOption.new
+		gemspec_file = Dir['*.gemspec'][0]
+		if gemspec_file
+			gemspec = Gem::Specification.load gemspec_file
+			Rc.o.project = gemspec.name
+			Rc.o.version = gemspec.version
+		end
+
+end

data/lib/rag/test.rb

@@ -0,0 +1,21 @@
+module Ragen
+	class Test < Thor
+		default_task :default
+
+		desc "default", "default", hide: true
+		def default
+			system "watchr #{Rag::Rc.o.project}.watchr", :verbose
+		end
+
+		desc "test [all]", "auto test with watchr"
+		def all
+			system "rspec --color spec", :verbose
+		end
+
+	end
+end
+
+class Rag < Thor
+	desc "test", "run test"
+	subcommand "test", Ragen::Test
+end

data/lib/rag.rb

@@ -0,0 +1,8 @@
+require "bundler/setup"
+require "thor"
+require "tagen/core"
+
+class Rag < Thor
+end
+
+require_relative "rag/rc"

data/rag.gemspec

@@ -0,0 +1,22 @@
+$: << "."
+require "version"
+require "bundler"
+
+Gem::Specification.new do |s|
+	s.name = "rag"
+	s.version = Rag::VERSION::IS
+	s.summary = "a project helper, include create, developing, testing, release"
+	s.description = <<-EOF
+a project helper, include create, develop, test, release
+	EOF
+
+	s.author = "Guten"
+	s.email = "ywzhaifei@gmail.com"
+	s.homepage = "http://github.com/GutenLinux/rag"
+	s.rubyforge_project = "xx"
+
+	s.files = `git ls-files`.split("\n")
+	s.executables = %w(rag)
+
+	s.add_bundler_dependencies
+end

data/rag.watchr

@@ -0,0 +1,22 @@
+# lib/**/*.rb
+watch %r~lib/(.*)\.rb~ do |m|
+	test "spec/#{m[1]}_spec.rb"
+end
+
+# spec/**/*_spec.rb
+watch %r~spec/.*_spec\.rb~ do |m|
+	test m[0]
+end
+
+# Ctrl-\
+Signal.trap('QUIT') do
+  puts "--- Running all tests ---\n\n"
+	test "spec"
+end
+
+def test path
+	cmd = "rspec --color #{path}"
+	puts cmd
+	system cmd
+end
+