drjekyll 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1abacc0051e57841738784b05c84d1adb06051ad
+  data.tar.gz: d756a8cd82ef92f2310f8dd40445583c8abf3c7c
+SHA512:
+  metadata.gz: 0c127f82e87a8eaf5e5dc2be3440c11863d61c0282917e5fd03925531cb7e8281407a7273ad2feb6f4d51bb620a45dea1b759a170993fd8ae528457af5cf805b
+  data.tar.gz: 09f07a808b355bbcb8cb06ea2a5c466af3d22ab84829dfe813128ae5fa4212cc5053827c9862848bcd49c228504632ecdec6bfca9e703bec839dcbb8993ad52a

data/HISTORY.md

@@ -0,0 +1,3 @@
+### 0.0.1 / 2015-08-11
+
+* Everything is new. First release

data/Manifest.txt

@@ -0,0 +1,15 @@
+HISTORY.md
+Manifest.txt
+README.md
+Rakefile
+bin/drj
+bin/drjekyll
+lib/drjekyll.rb
+lib/drjekyll/catalog.rb
+lib/drjekyll/cli/download.rb
+lib/drjekyll/cli/list.rb
+lib/drjekyll/cli/main.rb
+lib/drjekyll/cli/opts.rb
+lib/drjekyll/cli/unzip.rb
+lib/drjekyll/version.rb
+test/data/themes.yml

data/README.md

@@ -0,0 +1,2 @@
+# drjekyll
+drjekyll

data/Rakefile

@@ -0,0 +1,31 @@
+require 'hoe'
+require './lib/drjekyll/version.rb'
+
+Hoe.spec 'drjekyll' do
+
+  self.version = DrJekyll::VERSION
+
+  self.summary = "drjekyll - the missing static site theme package manager"
+  self.description = summary
+
+  self.urls    = ['https://github.com/drjekyllthemes/drjekyll']
+
+  self.author  = 'Gerald Bauer'
+  self.email   = 'wwwmake@googlegroups.com'
+
+  # switch extension to .markdown for gihub formatting
+  self.readme_file  = 'README.md'
+  self.history_file = 'HISTORY.md'
+
+  self.extra_deps = [
+    ## 3rd party
+    ['fetcher', '>= 0.4.5'],
+  ]
+
+  self.licenses = ['Public Domain']
+
+  self.spec_extras = {
+    required_ruby_version: '>= 1.9.2'
+  }
+
+end

data/bin/drj

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+require 'drjekyll'
+
+## todo: set x flag for file
+
+DrJekyll.main

data/bin/drjekyll

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+require 'drjekyll'
+
+## todo: set x flag for file
+
+DrJekyll.main

data/lib/drjekyll.rb

@@ -0,0 +1,53 @@
+# encoding: utf-8
+
+##
+# use to test:
+#  $ ruby -I ./lib ./lib/drjekyll.rb
+
+
+## stdlibs
+require 'pp'
+require 'yaml'
+
+
+## 3rd party gems
+require 'props'        ## Use Env.home
+require 'logutils'
+
+
+## require 'fetcher'
+
+## more 3rd party gems
+require 'gli'
+
+
+
+# our own code
+
+require 'drjekyll/version'    # note: version always goes first
+require 'drjekyll/catalog'
+
+require 'drjekyll/cli/opts'
+require 'drjekyll/cli/main'
+require 'drjekyll/cli/list'
+require 'drjekyll/cli/download'
+require 'drjekyll/cli/unzip'
+
+
+
+module DrJekyll
+
+  def self.main
+    exit Tool.new.run( ARGV )
+  end
+
+end  # module DrJekyll
+
+
+## DrJekyll.banner  ## say hello
+
+## for debugging
+pp Env.home
+pp DrJekyll.root
+
+DrJekyll.main  if __FILE__ == $0

data/lib/drjekyll/catalog.rb

@@ -0,0 +1,99 @@
+# encoding: utf-8
+
+module DrJekyll
+
+class Catalog
+  
+  def initialize( path )
+    ## read in themes catalog
+    text       = File.read( path )
+    @themes     = YAML.load( text )    
+
+    ## auto-add keys for now (for quick testing)
+    @themes.each do |k,h|
+      name   = k
+      keys   = h['keys'] || []
+      if keys.empty?
+        ## auto-add key from title/name
+        ##   downcase and remove all non alphanumeric (non-ascii)
+        slug = name.downcase.gsub( /[^a-z0-9]/, '' )
+
+        ## for quick testing add some shortcuts
+        if slug == 'planetjekyllsstarterminimal'
+          keys << 'starter'
+        elsif slug == 'drjekyllsminimal'
+          keys << 'minimial'
+        elsif slug == 'drjekyllsbootstrap'
+          keys << 'bootstrap'
+        elsif slug == 'drjekyllsclassicsbook'
+          keys << 'classics'
+        else
+        end
+        keys << slug
+        h['keys'] = keys
+      end
+    end
+  end
+
+  def list( filter=nil )
+    ## pp filter
+
+    @themes.each_with_index do |(k,h),i|
+      name   = k
+      author = h['author']
+      tags   = h['tags'] || []     ## allow nil for tags array for now
+      keys   = h['keys']
+
+      line = ''
+      line << "  %3d" % (i+1)
+      line << "..#{name}"
+      line << " (#{keys.join(' | ')})"
+      line << " by #{author}"
+      if tags.nil? == false && tags.empty? == false
+        line << " - "
+        tags.each do |tag|
+          line << "##{tag} "
+        end
+      end
+
+      if filter
+        ## note: ignore case (upper/lower/downcase) for now
+        ##  filter on name/title and
+        ##            tags for now
+        if name.downcase.index(filter.downcase)             != nil ||    ## note: 0 is match found on index 0; only nil is not found
+           tags.join('|').downcase.index( filter.downcase ) != nil
+          puts line
+        end
+      else
+        puts line
+      end
+    end
+  end  # method filter
+
+  def get( key )   ## use fetch or different name - why? why not??
+    ## find theme by key
+    ##  fix/todo: use linear search for now; use hash lookup later
+
+    theme = nil   ## note: return nil if nothing found
+
+    @themes.each do |k,h|
+      name   = k
+      keys   = h['keys']
+
+      if keys.include?( key )
+        ## bingo found
+        ##  todo: merge k (name/title) into (returned) hash - why? why not??
+        puts " ** bingo; found theme >#{k}<:"
+        pp h
+        theme = h
+        break
+      end
+    end
+  
+    theme
+  end
+  
+end # class Catalog
+
+end # module DrJekyll
+

data/lib/drjekyll/cli/download.rb

@@ -0,0 +1,33 @@
+# encoding: utf-8
+
+
+module DrJekyll
+
+class DownloadCommand   ## find a better name - why, why not ??
+
+  def initialize( catalog, opts )
+    @catalog = catalog
+    @opts    = opts
+  end
+
+  def run( args )
+    ## note: required template name (defaults to starter for now)
+    key = args[0] || 'starter'
+
+    theme = @catalog.get( key )
+    
+    if theme
+      download( theme )
+    else
+      ## todo: issue warning - why, why not??
+    end
+  end
+  
+  def download( theme )
+    ## to be done
+    pp theme
+  end
+  
+end ## class DownloadCommand
+
+end # module DrJekyll

data/lib/drjekyll/cli/list.rb

@@ -0,0 +1,24 @@
+# encoding: utf-8
+
+
+module DrJekyll
+
+class ListCommand   ## find a better name ??
+
+  def initialize( catalog, opts )
+    @catalog = catalog
+    @opts    = opts
+  end
+
+  def run( args )
+    filter = args[0]   ## optional filter (search query)
+    list( filter )
+  end
+  
+  def list( filter=nil )
+    @catalog.list( filter )
+  end
+
+end ## class ListCommand
+
+end # module DrJekyll

data/lib/drjekyll/cli/main.rb

@@ -0,0 +1,177 @@
+# encoding: utf-8
+
+### NOTE: wrap gli config into a class
+##  see github.com/davetron5000/gli/issues/153
+
+module DrJekyll
+
+class Tool
+  def initialize
+    LogUtils::Logger.root.level = :info   # set logging level to info 
+   end
+
+  def run( args )
+    puts DrJekyll.banner
+    Toolii.run( args )
+  end
+end
+
+## NOTE: gli added function are class methods (thus, wrap class Toolii in Tool for now)
+
+class Toolii
+  extend GLI::App
+
+  def self.logger=(value) @@logger=value; end
+  def self.logger()       @@logger; end
+
+  ## todo: find a better name e.g. change to settings? config? safe_opts? why? why not?
+  def self.opts=(value)  @@opts = value; end
+  def self.opts()        @@opts; end
+
+
+logger = LogUtils::Logger.root
+opts   = Opts.new 
+
+
+program_desc 'drjekyll command line tool'
+version VERSION
+
+
+desc 'Use only local (offline) cached data; no (online) remote network access'
+switch [:l, :local], negatable: false
+
+desc '(Debug) Show debug messages'
+switch [:verbose], negatable: false    ## todo: use -w for short form? check ruby interpreter if in use too?
+
+desc 'Only show warnings, errors and fatal messages'
+switch [:q, :quiet], negatable: false
+
+
+
+desc "List themes"
+arg_name 'QUERY'   # optional search query/filter
+command [:list,:ls,:l] do |c|
+
+  c.action do |g,o,args|
+    ## read in themes diretory    
+    themes_dir = "#{DrJekyll.root}/test/data"
+    catalog    = Catalog.new( "#{themes_dir}/themes.yml" )
+
+    cmd = ListCommand.new( catalog, opts )
+    cmd.run( args )
+    puts 'Done.'
+  end # action
+end  # command list
+
+
+## use get or fetch - why, why not??
+desc "Download theme; saved in ~/.drjekyll/cache"
+arg_name 'NAME'   # required theme name
+command [:download,:dl,:d,:get,:g] do |c|
+
+  c.action do |g,o,args|
+    ## read in themes diretory    
+    themes_dir = "#{DrJekyll.root}/test/data"
+    catalog    = Catalog.new( "#{themes_dir}/themes.yml" )
+
+    cmd = DownloadCommand.new( catalog, opts )
+    cmd.run( args )
+    puts 'Done.'
+  end # action
+end  # command download
+
+
+## use install or unzip/unpack - why, why not??
+desc "Setup (unzip/unpack) theme; use archive in ~/.drjekyll/cache"
+arg_name 'NAME'   # required theme name
+command [:unpack,:pk,:p,:setup,:s] do |c|
+
+  c.action do |g,o,args|
+    ## read in themes diretory    
+    themes_dir = "#{DrJekyll.root}/test/data"
+    catalog    = Catalog.new( "#{themes_dir}/themes.yml" )
+
+    cmd = UnzipCommand.new( catalog, opts )
+    cmd.run( args )
+   puts 'Done.'
+  end # action
+end  # command setup
+
+
+desc "Download 'n' setup (unzip/unpack) theme"
+arg_name 'NAME'   # required theme name
+command [:new,:n] do |c|
+
+  c.action do |g,o,args|
+
+    ## todo: required template name (defaults to starter for now)
+    name = args[0] || 'starter'
+
+    puts "  download theme here"
+    puts "  unzip/unpack (setup) here"
+    puts 'Done.'
+  end # action
+end  # command setup
+
+
+
+
+desc '(Debug) Test command suite'
+command :test do |c|
+  c.action do |g,o,args|
+
+    puts "hello from test command"
+    puts "args (#{args.class.name}):"
+    pp args
+    puts "o (#{o.class.name}):"
+    pp o
+    puts "g (#{g.class.name}):"
+    pp g
+    
+    LogUtils::Logger.root.debug 'test debug msg'
+    LogUtils::Logger.root.info 'test info msg'
+    LogUtils::Logger.root.warn 'test warn msg'
+    
+    puts 'Done.'
+  end
+end
+
+
+
+pre do |g,c,o,args|
+  opts.merge_gli_options!( g )
+  opts.merge_gli_options!( o )
+
+  puts DrJekyll.banner
+
+  if opts.verbose?
+    LogUtils::Logger.root.level = :debug
+  end
+
+  logger.debug "Executing #{c.name}"   
+  true
+end
+
+post do |global,c,o,args|
+  logger.debug "Executed #{c.name}"
+  true
+end
+
+
+on_error do |e|
+  puts
+  puts "*** error: #{e.message}"
+
+  if opts.verbose?
+    puts e.backtrace
+  end
+
+  false # skip default error handling
+end
+
+
+### exit run(ARGV)  ## note: use Toolii.run( ARGV ) outside of class
+
+end  # class Toolii
+
+end # module DrJekyll