jekyll-page-boilerplate 2.0.0 → 4.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 598484bc29508c7785e1dd1e24eb2699b6ecc7aa0ba346ee9c67a4d7530f3cc1
-  data.tar.gz: e72595d0503e4011384f54fd5d1a076e18796287b380911c1a14a8820d7c33a4
+  metadata.gz: 17477700177377cd7125dcdaab31a6c5ccc853d7f4a2ad866fb055680803f41e
+  data.tar.gz: 2b03a6cca499eb059c8842fd1a5c4dbeefef44b538d2bd92df738fd795c9a10b
 SHA512:
-  metadata.gz: '058701eb91e08f7630642bbcbeeedf3368fc90c533dcb88286570e348207fd12af8a8dab89f0ea56094ff06f097a11c7fc0b061760007c6adcdecf8a16c23483'
-  data.tar.gz: f2678c628a1fde61096a8c68c61945796881ed190fcbab82af68ea73ed2e06c3cfcd849eec3806946ac0314f1791a63418ae7415e0c657843473a68bfc3c8276
+  metadata.gz: 91381a908df2713f69036642a842f84da601f8616219ea362b18ded8f8c189452498a40d29c972f7e1832ba414ef8d4fdcd0bbf03aa97e8426582acb665c7b66
+  data.tar.gz: 7522e8fe98b9beb92b057f1159776ea53c9075fcede91b1a4d0c5632646fb0e25f602931a6b32b84d0bc4c061edaf49ed00715f1d51c70870c4355e0ee809bf0

data/exe/boilerplate

@@ -5,45 +5,4 @@ STDOUT.sync = true
 gem_dir = File.expand_path("..",File.dirname(__FILE__))
 $LOAD_PATH.unshift gem_dir # Look in gem directory for resources first.
 
-require 'jekyll_page_boilerplate'
-require "mercenary"
-
-Mercenary.program(:boilerplate) do |p|
-  p.version JekyllPageBoilerplate::VERSION
-  p.description 'jekyll-page-boilerplate is a gem for jekyll that helps you generate new pages'
-  p.syntax "boilerplate <subcommand> [options]"
-
-  p.command(:page) do |c|
-    c.syntax 'page BOILERPLATE_NAME "NEW PAGE TITLE"'
-    c.description "Creates a page or post from a boilerplate."
-
-    c.action do |args, _|
-      JekyllPageBoilerplate.page args[0], args[1], c
-    end
-  end
-
-  p.command(:help) do |c|
-    c.syntax "help"
-    c.description "Describe what jekyll-page-boilerplate does."
-
-    c.action do
-      JekyllPageBoilerplate.help c
-    end
-  end
-  
-  p.command(:init) do |c|
-    c.syntax "init"
-    c.description "Creates an example boilerplate."
-
-    c.action do
-      JekyllPageBoilerplate.init c
-    end
-  end
-
-
-
-
-  p.default_command(:help)
-end
-
-
+require 'jekyll_page_boilerplate_cli'

data/exe/bplate

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+
+STDOUT.sync = true
+
+gem_dir = File.expand_path("..",File.dirname(__FILE__))
+$LOAD_PATH.unshift gem_dir # Look in gem directory for resources first.
+
+require 'jekyll_page_boilerplate_cli'

data/lib/jekyll_page_boilerplate/example.md

@@ -3,8 +3,8 @@ _boilerplate:     # The config for your boilerplates:
   path: _posts    # this is the folder path it will create your new post/page under. 
   timestamp: true # when true new post/pages will include the date in the filename.
 
-title: TITLE      # The title will be overwriten
-created: CREATED  # created will be overwriten with the current time
+title: {{ boilerplate.title }}   # -T or --title options
+created: {{ boilerplate.time }}  # the current time.
 
 layout: post      # Anything else in the file will be copied to your new post/page.
 author: John Doe
@@ -17,7 +17,7 @@ A Jekyll Boilerplate Example
 
 To create a new page/post from this boilerplate run:
 ```bash
-$ boilerplate page example "Another post about pottery"`
+$ boilerplate create example "Another post about pottery"`
 ```
 
 A boilerplate is a markdown file in the `_boilerplates` folder.

data/lib/jekyll_page_boilerplate/init.rb

@@ -1,11 +1,16 @@
 require 'fileutils'
 
 module JekyllPageBoilerplate
-  module Init
+  class Init
+
+    def self.run
+      self.setup
+      return 'Created _boilerplates/example.md'
+    end
+    
     def self.setup
       FileUtils.mkpath('_boilerplates')
       FileUtils.cp(File.join(__dir__, 'example.md'), '_boilerplates')
     end
-  
   end
-end
+end

data/lib/jekyll_page_boilerplate/list.rb

@@ -0,0 +1,16 @@
+
+module JekyllPageBoilerplate
+
+  class List
+
+    SPACER = '\n'
+    REMOVE_SUFFIX = /\.\w+(?=[\s\n\r$])/
+
+    def self.run
+      Dir.glob("_boilerplates/*").map do |f|
+        File.basename(f, '.*')
+      end
+    end
+
+  end
+end

data/lib/jekyll_page_boilerplate/msg/readme.md

@@ -0,0 +1,30 @@
+A boilerplate is a markdown file in the `_boilerplates` folder.
+
+ie. `_boilerplates/post.md`
+    ---
+    _boilerplate:     # boilerplate settings
+        path: _posts    #   the path to create the new page under.
+        timestap: true  #   when true new post/pages will include the date in the filename. 
+    
+    title: {{ boilerplate.title }}
+    layout: post      # everthing else will be copied to the new post.
+    author: John Doe
+
+`$ boilerplate post -T "Another one about pottery"` would create a new file `_posts/yyyy-mm-dd-another-one-about-pottery.markdown`
+    ---
+    title: Another one about pottery
+    created: 'yyyy-mm-dd hh:mm:ss -0000'
+    layout: post
+    author: John Doe
+    ---
+
+Available Tags with `{{ boilerplate.xxx }}`:
+- `.title`, `.name`
+- `.path`, `.file`, `.suffix`
+- `.time`, `.date`, `.timestamp`
+- `.random_url`
+- And anything you put under the `_boilerplate:` header
+
+
+
+Use `boilerplate help` for more details

data/lib/jekyll_page_boilerplate/msg.rb

@@ -1,39 +1,24 @@
 
-module JekyllPageBoilerplate
-  module Msg
+module JekyllPageBoilerplate::Msg
 
-    HELP = <<-'HELP'
-
-  A boilerplate is a markdown file in the `_boilerplates` folder.
-
-  ie. `_boilerplates/post.yml`
-      ---
-      _boilerplate:     # boilerplate settings
-        path: _posts    #   the path to create the new page under.
-        timestap: true  #   when true new post/pages will include the date in the filename. 
-      
-      layout: post      # everthing else will be copied to the new post.
-      author: John Doe
-  
-
-  `$ boilerplate page post "Another one about pottery"` would create a new file `_posts/yyyy-mm-dd-another-one-about-pottery.markdown`
-      ---
-      title: Another one about pottery
-      created: 'yyyy-mm-dd hh:mm:ss -0000'
-      layout: post
-      author: John Doe
-      ---
-
-
-  Usage: `$ boilerplate [page|init|help]`
-
-  `$ boilerplate init`: creates a example boilerplate at `_boilerplates/example.md`
+  def self.file name
+    puts File.read(File.join(__dir__, 'msg', name))
+  end
   
-  `$ boilerplate page <boilerplate-name> <post-title>`: Creates a new page from a boilerplate
+  def self.error(**msgs)
+    msgs.each {|k,v| puts(k.to_s.capitalize!+': '+v)}
+  end
 
-  `$ boilerplate help`: shows this dialog.
+  def self.info msg
+    puts msg
+  end
 
-    HELP
-  
+  def self.try_and_report &block
+    begin
+      self.info block.call
+    rescue => e
+      self.error fatal: e.message
+    end
   end
-end
+
+end

data/lib/jekyll_page_boilerplate/page.rb

@@ -1,107 +1,139 @@
 
 require 'yaml'
 require "stringex"
+require 'securerandom'
+
+class JekyllPageBoilerplate::Page
+  
+  BOILERPLATES_PATH = '_boilerplates'
+  FILE_DATE_FORMATE = '%Y-%m-%d'
+  READ_CONFIG_REGEX = /[\r\n\s]{0,}^_boilerplate:(\s*^[\t ]{1,2}.+$)+[\r\s\n]{0,}(?![^\r\s\n])/
+  READ_FILE_REGEX = /^-{3}\s*^(?<head>[\s\S]*)^-{3}\s^(?<body>[\s\S]*)/
+  TAGS_REGEX = /(?<tag>\{{2}\s{0,}boilerplate\.(?<key>[^\{\}\.\s]+)\s{0,}\}{2})/
+
+  attr_reader :config
+
+  def self.run boilerplate, options
+    page = self.new(boilerplate, options)
+    page.create
+    return "Created %s/%s" % [page.config['path'], page.config['file']]
+  end
 
-module JekyllPageBoilerplate
-  class Page
+  def initialize boilerplate, options
+    options.compact!
+    options.transform_keys! {|k| k.to_s}
+    plate_path = get_boilerplate_path(boilerplate).to_s
 
-    BOILERPLATES_PATH = '_boilerplates'
-    FILE_DATE_FORMATE = '%Y-%m-%d'
-    READ_CONFIG_REGEX = /^_boilerplate:(\s*^[\t ]{1,2}.+$)+/
-    READ_FILE_REGEX = /^-{3}\s*$(?<head>[\s\S]*)^-{3}\s$(?<body>[\s\S]*)/
+    abort_unless_file_exists( plate_path )
 
+    parsed_file = {}
+    File.open(plate_path, 'r') do |file|
+      parsed_file = file.read.match(READ_FILE_REGEX).named_captures
+    end
 
-    def initialize boilerplate
+    @config = get_config(parsed_file['head']).merge(options)
+    @config['suffix'] ||= plate_path[/\.\w+$/]
+    @config['name'] ||= plate_path[/.*(?=\.)/] || plate_path
+    @head = get_head(parsed_file['head'])
+    @body = get_body(parsed_file['body'])
+  end
+  
+  def create
+    @config['time'] ||= Time.now.to_s
+    @config['date'] ||= Time.now.strftime(FILE_DATE_FORMATE)
 
-      plate_path = get_boilerplate_path(boilerplate)
-      
-      abort_unless_file_exists( plate_path )
+    abort_unless_file_exists(@config['path'])
+    
+    @config['file'] ||= get_new_page_filename(@config['title'] || @config['name'])
 
-      parsed_file = {}
-      File.open(plate_path, 'r') do |file|
-        parsed_file = file.read.match(READ_FILE_REGEX).named_captures
-      end
+    scan_template :@body
+    scan_template :@head
 
-      @config = get_config(parsed_file['head'])       
-      @head = get_head(parsed_file['head'])
-      @body = get_body(parsed_file['body'])
-    end
-    
-    def create title
-      abort_unless_file_exists(@config['path'])
-      
-      set_header_entry 'title', title.gsub(/[&-]/, '&'=>'&amp;', '-'=>' ')
-      set_header_entry 'created', Time.now.to_s
+    create_new_page @config['file']
+  end
 
-      create_new_page get_new_page_filename(title)
-    end
+  private
+  
+  def create_new_page filename
+    new_file_path = File.join( @config['path'], filename )
 
-    private
-    
-    def create_new_page filename
-      new_file_path = File.join( @config['path'], filename )
-
-      abort_if_file_exists(new_file_path)
-
-      open(new_file_path, 'w') do |page|
-        page.puts '---'
-        page.puts @head
-        page.puts '---'
-        page.puts @body
-        page.puts ''
-      end      
-    end
+    abort_if_file_exists(new_file_path)
 
+    open(new_file_path, 'w') do |page|
+      page.puts '---'
+      page.puts @head.lstrip
+      page.puts '---'
+      page.puts @body
+      page.puts ''
+    end      
+  end
 
-    def set_header_entry key, val
-      @head << "\n#{key}: null" unless @head.match /^#{key}:.*$/
-      @head.gsub! /^#{key}:.*$/, "#{key}: #{val}"
+  def scan_template var
+    instance_variable_get(var).scan(TAGS_REGEX).uniq.each do |tag, key|
+      instance_variable_get(var).gsub! /\{{2}\s{0,}boilerplate\.#{key}\s{0,}\}{2}/, get_tag_value(key)
     end
+  end
 
-    def get_body markdown
-      return markdown
-    end
+  def get_tag_value(key)
+    return @config[key] if @config[key]
+    key = key.split('=')
+    return Tag.send(key[0].to_sym, *key[1]&.split(','))
+  end
+ 
+  class Tag
+    class << self
+      def missing_method
+        nil
+      end
 
-    def get_config head
-      return YAML.load(head.match(READ_CONFIG_REGEX).to_s)['_boilerplate']
+      def random_url length = nil
+        length && length = length.to_i
+        SecureRandom.urlsafe_base64(length)
+      end
     end
+  end
 
-    def get_head head
-      return head.gsub READ_CONFIG_REGEX, ''
-    end
-    
+  def get_body markdown
+    return markdown
+  end
 
-    def get_boilerplate_path plate_name
-      return Dir.glob( 
-        "#{File.join(BOILERPLATES_PATH, plate_name)}.{md,markdown,MD,MARKDOWN}" 
-      ).first
-    end
+  def get_config head
+    return YAML.load(head.match(READ_CONFIG_REGEX).to_s)['_boilerplate']
+  end
 
+  def get_head head
+    return head.gsub( READ_CONFIG_REGEX, '')
+  end
+  
 
-    def get_new_page_filename title
-      title = title.to_url
-      title = "#{title}#{@config['suffix'] || '.markdown'}"
-      if @config['timestamp']
-        title = "#{Time.now.strftime(FILE_DATE_FORMATE)}-#{title}"
-      end
-      return title
+  def get_boilerplate_path plate_name
+    return Dir.glob( 
+      "#{File.join(BOILERPLATES_PATH, plate_name)}*" 
+    ).first
+  end
+
+
+  def get_new_page_filename title
+    title = title.to_url
+    title = "#{title}#{@config['suffix']}"
+    if @config['timestamp']
+      title = "#{@config['date']}-#{title}"
     end
+    return title
+  end
 
 
 
-    def abort_if_file_exists(file_path)
-      if File.exist?(file_path)
-        raise "#{file_path} already exists!"
-      end
+  def abort_if_file_exists(file_path)
+    if File.exist?(file_path)
+      raise "#{file_path} already exists!"
     end
+  end
 
-    def abort_unless_file_exists(file_path)
-      unless File.exist?(file_path)
-        raise "#{file_path} does not exist!"
-      end
+  def abort_unless_file_exists(file_path)
+    unless File.exist?(file_path)
+      raise "The file `#{file_path}` does not exist!"
     end
-
-
   end
 
-end
+end

data/lib/jekyll_page_boilerplate/version.rb

@@ -1,3 +1,5 @@
 module JekyllPageBoilerplate
-  VERSION = "2.0.0"
+  VERSION = "4.0.1"
+
+  DESCRIPTION = "A jekyll plugin that allows you to create new pages or posts from a boilerplate through the terminal."  
 end

data/lib/jekyll_page_boilerplate.rb

@@ -1,33 +1,33 @@
 require "jekyll_page_boilerplate/version"
-require "jekyll_page_boilerplate/page"
 require "jekyll_page_boilerplate/msg"
+require "jekyll_page_boilerplate/page"
 require "jekyll_page_boilerplate/init"
+require "jekyll_page_boilerplate/list"
+
 
 module JekyllPageBoilerplate
   class Error < StandardError; end
 
-
-  def self.init cmd
-    begin
-      Init.setup
-    rescue => e
-      cmd.logger.fatal e.message
+  def self.init 
+    Msg.try_and_report do
+      Init.run
     end
   end
 
-
-  def self.help cmd
-    cmd.logger.info Msg::HELP
+  def self.list
+    Msg.try_and_report do
+      List.run
+    end
   end
 
+  def self.readme
+    Msg.file 'readme.md'
+  end
 
-  def self.page boilerplate_name, page_title, cmd
-    page = Page.new(boilerplate_name)
-    begin
-      page.create(page_title)
-    rescue => e
-      cmd.logger.fatal e.message
+  def self.page boilerplate_name, options
+    Msg.try_and_report do
+      Page.run(boilerplate_name, options)
     end
-  end
+  end  
 
 end

data/lib/jekyll_page_boilerplate_cli.rb

@@ -0,0 +1,64 @@
+require "bales"
+require 'jekyll_page_boilerplate'
+
+class JekyllPageBoilerplate::Application < Bales::Application
+  version JekyllPageBoilerplate::VERSION
+  description JekyllPageBoilerplate::DESCRIPTION
+
+  # `boilerplate <page>`  
+  option :title, type: String, long_form: '--title', short_form: '-T',
+    description: "`path/<title>.md`"
+  option :path, type: String, long_form: '--path', short_form: '-p',
+    description: "`<path>/title.md`"
+  option :timestamp, type: TrueClass, long_form: '--timestamp', short_form: '-s',
+    description: "`path/<time.now>-title.md`"
+  option :suffix, type: String, long_form: '--suffix', short_form: '-x',
+    description: "`path/title.<md, markdown, txt>`"
+
+  action do |plate, title: nil, path: nil, timestamp: nil, suffix: nil|
+    JekyllPageBoilerplate.page plate, {title: title, path: path, suffix: suffix, timestamp: timestamp}
+  end
+
+  # `boilerplate readme`  
+  command 'readme' do
+    description "Helpful info"
+    action do
+      JekyllPageBoilerplate.readme
+    end
+  end
+
+  # `boilerplate help`  
+  command 'help', parent: Bales::Command::Help
+
+  # `boilerplate init`  
+  command 'init' do
+    description "Creates an example boilerplate."
+    action do
+      JekyllPageBoilerplate.init
+    end
+  end
+  
+  # `boilerplate list`  
+  command 'list' do
+    description "List all the boilerplates"
+    action do 
+      JekyllPageBoilerplate.list
+    end
+  end
+  
+
+  def self.run(*args, **opts)
+    begin
+      super
+    rescue => e
+      JekyllPageBoilerplate.readme 
+    end
+  end
+
+end
+
+JekyllPageBoilerplate::Application.parse_and_run
+
+  
+  
+  

metadata

@@ -1,29 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-page-boilerplate
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 4.0.1
 platform: ruby
 authors:
 - Sean Ferney
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-05-25 00:00:00.000000000 Z
+date: 2022-05-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: mercenary
+  name: bales
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.4.0
+        version: 0.1.3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.4.0
+        version: 0.1.3
 - !ruby/object:Gem::Dependency
   name: stringex
   requirement: !ruby/object:Gem::Requirement
@@ -50,16 +50,21 @@ email:
 - sean@codekarma.dev
 executables:
 - boilerplate
+- bplate
 extensions: []
 extra_rdoc_files: []
 files:
 - exe/boilerplate
+- exe/bplate
 - lib/jekyll_page_boilerplate.rb
 - lib/jekyll_page_boilerplate/example.md
 - lib/jekyll_page_boilerplate/init.rb
+- lib/jekyll_page_boilerplate/list.rb
 - lib/jekyll_page_boilerplate/msg.rb
+- lib/jekyll_page_boilerplate/msg/readme.md
 - lib/jekyll_page_boilerplate/page.rb
 - lib/jekyll_page_boilerplate/version.rb
+- lib/jekyll_page_boilerplate_cli.rb
 homepage: https://github.com/CodeKarmaDev/jekyll-page-boilerplate
 licenses:
 - MIT