moka 0.1.1

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2010 Luca Ongaro
+
+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/Manifest

@@ -0,0 +1,48 @@
+LICENSE.txt
+Manifest
+README.rdoc
+Rakefile
+bin/moka
+lib/commands.rb
+lib/commands/compile.rb
+lib/commands/delete.rb
+lib/commands/group/delete.rb
+lib/commands/group/group_generator.rb
+lib/commands/group/inspect.rb
+lib/commands/group/new.rb
+lib/commands/group/template/groupdir/variables.yml
+lib/commands/inspect.rb
+lib/commands/lib/compiler.rb
+lib/commands/lib/helpers.rb
+lib/commands/lib/lipsum_constants.rb
+lib/commands/lib/lipsum_helpers.rb
+lib/commands/lib/page_scope.rb
+lib/commands/lib/partials_inclusion.rb
+lib/commands/lib/site_tree.rb
+lib/commands/lib/string_inflectors.rb
+lib/commands/lib/utilities.rb
+lib/commands/new.rb
+lib/commands/order_groups.rb
+lib/commands/order_pages.rb
+lib/commands/page/delete.rb
+lib/commands/page/inspect.rb
+lib/commands/page/new.rb
+lib/commands/page/page_generator.rb
+lib/commands/page/template/pagedir/variables.yml
+lib/commands/server.rb
+lib/commands/site/inspect.rb
+lib/commands/site/new.rb
+lib/commands/site/site_generator.rb
+lib/commands/site/template/manifest.yml
+lib/commands/site/template/project/lib/helpers.rb
+lib/commands/site/template/project/site/content.erb
+lib/commands/site/template/project/site/header.erb
+lib/commands/site/template/project/site/layout.erb
+lib/commands/site/template/project/site/navigation.erb
+lib/commands/site/template/project/site/variables.yml
+lib/commands/site/template/project/styles/style.sass
+lib/commands/site/template/script/config/boot.rb
+lib/commands/site/template/script/moka
+lib/script_moka_loader.rb
+lib/version.rb
+moka.gemspec

data/README.rdoc

@@ -0,0 +1,9 @@
+== Welcome to Moka
+
+Moka is a damn simple framework designed to build static websites like portfolios, showcases, minisites, HTML mockups, etc. Moka setup takes a single command, and it provides a hierarchical template system and some hyper-convenient helper functions so you never have to write more code than necessary. The result of your work is compiled to plain HTML, CSS and Javascript, so you just have to upload it to your server. Plus, don't forget the Lipsum helper functions to generate dummy text with a single line of code during development or in HTML mockups.
+
+A taste of Moka coolness:
+- Don't Repeat Yourself
+- Convention Over Configuration
+- Start your creative work from instant zero!
+- Minimum overhead efforts (configuration, setup, learning, etc.)

data/Rakefile

@@ -0,0 +1,17 @@
+require 'rubygems'
+require 'rake'
+require 'echoe'
+
+Echoe.new('moka', '0.1.1') do |p|
+  p.summary        = "An damn simple static website framework."
+  p.description    = "Moka is a damn simple framework designed to build static websites like portfolios, showcases, minisites, HTML mockups, etc. Moka setup takes a single command, and it provides a hierarchical template system and some hyper-convenient helper functions so you never have to write more code than necessary. The result of your work is compiled to plain HTML, CSS and Javascript, so you just have to upload it to your server. Plus, don't forget the Lipsum helper functions to generate dummy text with a single line of code during development or in HTML mockups."
+  p.url            = "https://github.com/DukeLeNoir/Moka"
+  p.author         = "Luca Ongaro"
+  p.email          = "mail@lucaongaro.eu"
+  p.install_message= "Welcome aboard Moka. You'll love it!"
+  p.ignore_pattern = ["TODOs"]
+  p.runtime_dependencies = ["thor", "haml"]
+  p.development_dependencies = []
+end
+
+Dir["#{File.dirname(__FILE__)}/tasks/*.rake"].sort.each { |ext| load ext }

data/bin/moka

@@ -0,0 +1,21 @@
+#!/usr/bin/env ruby
+
+require "script_moka_loader"
+require 'version'
+
+Moka::ScriptMokaLoader.exec_script_moka!
+
+# If called from within a moka app the following code isn't executed
+
+if %w(-v --version).include? ARGV.first
+  puts "Moka #{Moka::VERSION::STRING}"
+  exit(0)
+end
+
+if ARGV.first != "new" and ARGV.first != "n"
+  ARGV[0] = "--help"
+else
+  ARGV.shift
+end
+
+require "commands/new"

data/lib/commands.rb

@@ -0,0 +1,54 @@
+ARGV << '--help' if ARGV.empty?
+
+aliases = {
+  "n"  => "new",
+  "i" => "inspect",
+  "d"  => "delete",
+  "s"  => "server",
+  "op"  => "order_pages",
+  "og"  => "order_groups",
+  "c" => "compile"
+}
+
+command = ARGV.shift
+command = aliases[command] || command
+
+case command
+when 'new'
+  require "commands/new"
+
+when 'inspect'
+  require 'commands/inspect'
+
+when 'delete'
+  require "commands/delete"
+
+when 'order_groups'
+  require "commands/order_groups"
+
+when 'order_pages'
+  require "commands/order_pages"
+
+when 'server'
+  require 'commands/server'
+
+when 'compile'
+  require 'commands/compile'
+
+else
+  puts "Error: Command not recognized" unless %w(-h --help).include?(command)
+  puts <<-EOT
+Usage: moka COMMAND [ARGS]
+
+The most common moka commands are:
+ new            Generate a new site, page or group (short-cut alias: "n")
+ inspect        Inspect site, a group or a page (short-cut alias: "i")
+ delete         Delete a group or page (short-cut alias "d")
+ compile        Compile the project into html and css (short-cut alias "c")
+ server         Start a development server (short-cut alias "s")
+ order_pages    Start a utility to change pages ordering (short-cut alias "op")
+ order_groups   Start a utility to change groups ordering (short-cut alias "og")
+
+All commands can be run with -h for more information.
+  EOT
+end

data/lib/commands/compile.rb

@@ -0,0 +1,77 @@
+#!/usr/bin/env ruby
+
+require "yaml"
+require "fileutils"
+require 'getoptlong'
+require File.expand_path('lib/utilities', File.dirname(__FILE__))
+require File.expand_path('lib/compiler', File.dirname(__FILE__))
+
+opts = GetoptLong.new(
+  [ '--help', '-h', GetoptLong::NO_ARGUMENT ]
+)
+
+opts.each do |opt, arg|
+  case opt
+    when '--help'
+      puts <<-EOT
+
+Usage:
+
+ moka compile [page1] [page2] ...
+
+Examples:
+   moka compile index about othergroup:contacts
+     compile pages 'index' and 'about' belonging to group 'root' and page 'contacts' belonging to group 'othergroup'
+
+   moka compile
+     compile all pages
+      EOT
+      exit
+  end
+end
+
+compiler = Moka::Compiler.new
+
+manifest = YAML.load_file(File.expand_path("manifest.yml", MOKA_ROOT))
+
+puts ""
+
+if ARGV.size < 1
+  # compile all pages
+  manifest["site"].each do |group, pages|
+    if pages.is_a? Hash
+      pages.each do |page, page_vars|
+        if page_vars.is_a? Hash
+          compiler.compile! group, page, manifest
+        end
+      end
+    end
+  end
+else
+  # compile only pages passed as command line arguments
+  to_compile = {}
+
+  ARGV.each do |arg|
+    # parse arg to support syntax groupname:pagename
+    tc_page_name, tc_group = Moka::Utilities.parse_grouppage(arg)
+    if to_compile[tc_group].nil?
+      to_compile[tc_group] = [tc_page_name]
+    else
+      to_compile[tc_group] << tc_page_name
+    end
+  end
+  # compile each page to be compiled
+  to_compile.each do |group, pages|
+    pages.each do |page|
+      unless manifest["site"][group].nil? or manifest["site"][group][page].nil?
+        compiler.compile! group, page, manifest
+      end
+    end
+  end
+end
+
+# compile sass stylesheets
+puts ""
+puts "compiling stylesheets..."
+compiler.compile_styles!
+puts ""

data/lib/commands/delete.rb

@@ -0,0 +1,47 @@
+#!/usr/bin/env ruby
+
+require 'getoptlong'
+
+opts = GetoptLong.new(
+  [ '--help', '-h', GetoptLong::NO_ARGUMENT ]
+)
+
+opts.each do |opt, arg|
+  case opt
+    when '--help'
+      puts <<-EOT
+
+Usage:
+
+ moka delete page group_name:page_name
+
+ or
+
+ moka delete group group_name
+
+Examples:
+
+   moka delete page mypage
+     delete page 'mypage' in group 'root' also eliminating, if existing, the compiled version in the compiled directory
+
+   moka delete page mygroup:mypage
+     delete page 'mypage' in group 'mygroup'
+
+   moka delete group mygroup
+     delete group 'mygroup' and all its pages
+      EOT
+      exit
+  end
+end
+
+thing_to_be_deleted = ARGV.shift
+
+case thing_to_be_deleted
+  when 'page', 'p'
+    require File.expand_path('page/delete', File.dirname(__FILE__))
+  when 'group', 'g'
+    require File.expand_path('group/delete', File.dirname(__FILE__))
+  else
+    puts "ERROR: invalid option #{thing_to_be_deleted}. Valid options are 'page' and 'group'."
+    exit
+end

data/lib/commands/group/delete.rb

@@ -0,0 +1,59 @@
+require "yaml"
+require "fileutils"
+require File.expand_path('../lib/utilities', File.dirname(__FILE__))
+
+opts = GetoptLong.new(
+  [ '--help', '-h', GetoptLong::NO_ARGUMENT ]
+)
+
+opts.each do |opt, arg|
+  case opt
+    when '--help'
+      RDoc::usage
+  end
+end
+
+if ARGV.first.nil?
+  puts "you need to specify a group name."
+  exit
+end
+
+group = ARGV.first
+
+paths = []
+manifest = YAML.load_file(File.expand_path("manifest.yml", MOKA_ROOT))
+
+unless manifest["site"][group].nil?
+  unless manifest["site"][group].is_a? Hash
+    puts "ERROR: '#{group}' is a variable, not a group"
+    exit
+  end
+  manifest["site"][group].each do |page, page_vars|
+    if page_vars.is_a? Hash
+      paths << page_vars["path"] unless page_vars["path"].nil?
+    end
+  end
+else
+  puts "ERROR: cannot find any group named '#{group}'"
+  exit
+end
+
+manifest["site"].delete group
+
+f = File.open( File.expand_path('manifest.yml', MOKA_ROOT), 'w' ) do |out|
+  YAML.dump( manifest, out )
+end
+
+FileUtils.rm_r(File.expand_path("project/site/#{group}", MOKA_ROOT))
+paths.each do |path|
+  if File.exists? File.expand_path("compiled/"+path, MOKA_ROOT)
+    FileUtils.rm(File.expand_path("compiled/"+path, MOKA_ROOT))
+  end
+end
+if File.exists? File.expand_path("compiled/#{group}", MOKA_ROOT)
+  FileUtils.rm_r(File.expand_path("compiled/#{group}", MOKA_ROOT))
+end
+
+puts ""
+puts "Removed group '#{group}' and all its pages"
+puts ""

data/lib/commands/group/group_generator.rb

@@ -0,0 +1,115 @@
+require "rubygems"
+require "thor"
+require "thor/group"
+
+module Moka
+  module Generators
+    class MokaGroupGenerator < Thor::Group
+      require "yaml"
+      require File.expand_path('../lib/utilities', File.dirname(__FILE__))
+      require File.expand_path('../lib/site_tree', File.dirname(__FILE__))
+
+      include Thor::Actions
+      include Moka::SiteTree
+
+      argument :name
+      class_option :template, :type => :string, :aliases => "-t"
+      class_option :vars, :aliases => %w(-v), :type => :hash
+
+      def self.source_root
+        File.expand_path('template/', File.dirname(__FILE__))
+      end
+
+      def load_manifest
+        @manifest = YAML.load_file(File.expand_path("manifest.yml", MOKA_ROOT))
+        @site = SiteNode.new("site", @manifest["site"])
+      end
+
+      def verify_if_group_exists
+        @group = name
+        unless @site.find_group(@group).nil?
+          say_status "ERROR:", "group '#{@group}' already exists!", :red
+          exit
+        end
+      end
+
+      def update_manifest
+        unless options[:template].nil?
+          @template_group = options[:template]
+          if @site.find_group(@template_group).nil?
+            say_status "ERROR:", "cannot find group '#{@template_group}'", :red
+            exit
+          end
+          template_manifest = Moka::Utilities.deepcopy(@manifest["site"][@template_group])
+          @site.find_group(@template_group).pages.each do |page|
+            template_manifest[page.name]["path"] = File.join "#{@group}", "#{page.name}.#{@site.respond_to?(:default_extension) ? @site.default_extension : "html"}"
+          end
+        else
+          template_manifest = {}
+        end
+        @group_params = {"order" => Time.new.utc.to_i}
+        @manifest["site"][@group] = template_manifest.merge @group_params
+        # dump manifest
+        f = File.open( File.expand_path('manifest.yml', MOKA_ROOT), 'w' ) do |out|
+          YAML.dump( @manifest, out )
+        end
+        say_status "update", "manifest.yml", :green
+      end
+
+      def create_group_dir_and_files
+        unless options[:template].nil?
+          directory(File.expand_path("project/site/#{@template_group}", MOKA_ROOT), File.expand_path("project/site/#{@group}", MOKA_ROOT))
+        else
+          directory("groupdir", File.expand_path("project/site/#{@group}", MOKA_ROOT))
+        end
+      end
+
+      def delete_variables_using_reserved_name
+        unless options[:vars].nil?
+          options[:vars].each do |var_name, var_value|
+            if Moka::SiteTree::RESERVED_NAMES.include? var_name.to_s
+              say_status "WARNING:", "variable '#{var_name}' is a reserved word, and will not be set as a variable", :yellow
+            end
+          end
+          options[:vars].delete_if {|var_name, var_value| Moka::SiteTree::RESERVED_NAMES.include? var_name.to_s }
+        end
+      end
+
+      def dump_variables
+        if File.exists? File.expand_path("project/site/#{@group}/variables.yml", MOKA_ROOT)
+          @group_variables = YAML.load_file(File.expand_path("project/site/#{@group}/variables.yml", MOKA_ROOT))
+        else
+          @group_variables = {}
+        end
+        unless options[:vars].nil?
+          @group_variables.merge! options[:vars]
+          f = File.open( File.expand_path("project/site/#{@group}/variables.yml", MOKA_ROOT), 'w' ) do |out|
+            YAML.dump( @group_variables, out )
+          end
+          say_status "update", "project/site/#{@group}/variables.yml", :green
+        end
+      end
+
+      def notify_about_creation
+        say ""
+        if options[:template].nil?
+          say "Generated group #{@group}"
+        else
+          say "Generated group #{@group} using group #{@template_group} as a template"
+        end
+        say ""
+        say " Group Parameters:"
+        @group_params.each do |param_name, param_value|
+          say "  #{param_name} = #{param_value}"
+        end
+
+        say ""
+        say " Group Variables:"
+        @group_variables.each do |var_name, var_value|
+          puts "  #{var_name} = #{var_value}"
+        end
+        say ""
+      end
+    end
+  end
+end