jekyll-page-boilerplate 1.0.1 → 4.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6a93e2b4e7e502c0d19906f1dae2786f6fb1ceecf39d52c0dbdf82db241215e2
-  data.tar.gz: 71434d9ca5e0072c25543fc2180b37ee59ce4702d73dde7ea454c16bf14d56cd
+  metadata.gz: d0bdff35c4fc0b98be3987b90be503a93864c8dcb0dec6358a1cdd07f19fdc88
+  data.tar.gz: 8a11dca9014aaa518f9f56d4782077e3791b4342af84a8f917afe8d5b7eecf62
 SHA512:
-  metadata.gz: 9cf262a0c5dc30f2af6b428ab50c0a9b5942c7e192c3e5f18a6e56dab04f2c081f3137119dabce88d108fedc9b65703363985df7a292fd70e472bcc15d778228
-  data.tar.gz: f09fcfbd8dec7ef599e738b9dc45b4616ac181b07088dce6e1025bf3db9ccac32a24b52be9624d24304c03bc011d841cbdda157cdf20e7d8d7b77f12749c7ed9
+  metadata.gz: b9a614357a7bcb5c380ab20587b34779d18d12d06380f0511a15f8187ea22b28547b640aeba05029422de27cc3e0974ac724c0b13746220a6e3455f83abf67be
+  data.tar.gz: 7533fd3e0811a14c04f505c444d1e61225bc624c54d9cd2aecace495884172c8628b04810d54e23639137334ea5ccdff4e65ab8dddeb8ed39c33e099e226def0

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 "jekyll-page <subcommand> [options]"
-
-  p.command(:page) do |c|
-    c.syntax "create 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

@@ -0,0 +1,44 @@
+---
+_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: {{ 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
+---
+
+
+A Jekyll Boilerplate Example
+----------------------------
+
+
+To create a new page/post from this boilerplate run:
+```bash
+$ boilerplate create example "Another post about pottery"`
+```
+
+A boilerplate is a markdown file in the `_boilerplates` folder.
+
+
+This would create a new file:
+
+```text 
+_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
+---
+
+A Jekyll Boilerplate Example
+----------------------------
+
+To create a new page/post from this boilerplate run:
+
+recursion error...
+
+```

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.yml'), '_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,27 @@
+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. 
+    
+    title: {{ boilerplate.title }}
+    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`
+
+    `$ boilerplate page <boilerplate-name> <post-title>`: Creates a new page from a boilerplate
+
+    `$ boilerplate help`: shows this dialog.

data/lib/jekyll_page_boilerplate/msg.rb

@@ -1,40 +1,24 @@
 
-module JekyllPageBoilerplate
-  module Msg
+module JekyllPageBoilerplate::Msg
 
-    HELP = <<-'HELP'
-
-      Create a new jekyll page/post from a boilerplate.
-
-      A boilerplate is a yaml file in the `_boilerplates` folder.
-
-      ie. `_boilerplates/post.yml`
-          ---
-          path: _posts
-          timestap: true
-          
-          header:
-            layout: post
-            author: John Doe
-      
-      Boilerplate yaml settings:
-        path - the path to create the new page under.
-        timestamp - when true new post/pages will include the date in the filename.
-        header - Any yaml you put under `header` will be added to your new pages/post
-        
+  def self.file name
+    puts File.read(File.join(__dir__, 'msg', name))
+  end
+  
+  def self.error(**msgs)
+    msgs.each {|k,v| puts(k.to_s.capitalize!+': '+v)}
+  end
 
-      `$ 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
-        ---
-        
+  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,95 +1,144 @@
 
 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'
+    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, suffix: '.yml' 
-      plate_path = File.join(BOILERPLATES_PATH, "#{boilerplate}#{suffix}")
-      
-      set_boilerplate_from_yaml_file( plate_path )
-    end    
+    @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)
+
+    abort_unless_file_exists(@config['path'])
     
-    def create title
-      abort_unless_file_exists(@boilerplate['path'])
-      
-      add_header_title( title )
-      add_header_created()
-      
-      create_new_page( title )
-
-      @boilerplate
-    end
+    @config['file'] ||= get_new_page_filename(@config['title'] || @config['name'])
 
-    private
+    scan_template :@body
+    scan_template :@head
 
-    def create_new_page title
-      filename = get_new_page_filename( title )
-      
-      new_file_path = File.join( @boilerplate['path'], filename )
+    create_new_page @config['file']
+  end
 
-      abort_if_file_exists(new_file_path)
+  private
+  
+  def create_new_page filename
+    new_file_path = File.join( @config['path'], filename )
 
-      open(new_file_path, 'w') do |page|
-        page.puts @boilerplate['header'].to_yaml
-        page.puts '---'
-        page.puts ''
-        page.print @boilerplate['content']
-        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 add_header_created
-      @boilerplate['header']['created'] = Time.now.to_s
+  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
-    
-    def add_header_title title
-      @boilerplate['header']['title'] = title.gsub(/[&-]/, '&'=>'&amp;', '-'=>' ')
-    end
-
+  end
 
-    def set_boilerplate_from_yaml_file yaml_path
-      abort_unless_file_exists( yaml_path )
-      
-      @boilerplate = {} 
-      
-      File.open(yaml_path, 'r') do |yaml_file|
-        @boilerplate = YAML.load( yaml_file.read )
+  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
-    end
-    
 
-    def get_new_page_filename title
-      title = title.to_url
-      title = "#{title}#{@boilerplate['suffix'] || '.markdown'}"
-      if @boilerplate['timestamp']
-        title = "#{Time.now.strftime(FILE_DATE_FORMATE)}-#{title}"
+      def random_url length = nil
+        length && length = length.to_i
+        SecureRandom.urlsafe_base64(length)
       end
-      return title
     end
+  end
 
+  def fill_template key, val
+    @head.gsub! /\{{2}\s{0,}boilerplate\.#{key}\s{0,}\}{2}/, @config[key].to_s
+    @body.gsub! /\{{2}\s{0,}boilerplate\.#{key}\s{0,}\}{2}/, @config[key].to_s
+  end
 
+  def get_body markdown
+    return markdown
+  end
 
-    def abort_if_file_exists(file_path)
-      if File.exist?(file_path)
-        raise "#{file_path} already exists!"
-      end
-    end
+  def get_config head
+    return YAML.load(head.match(READ_CONFIG_REGEX).to_s)['_boilerplate']
+  end
 
-    def abort_unless_file_exists(file_path)
-      unless File.exist?(file_path)
-        raise "#{file_path} does not exist!"
-      end
+  def get_head head
+    return head.gsub( READ_CONFIG_REGEX, '')
+  end
+  
+
+  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
+  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 = "1.0.1"
+  VERSION = "4.0.0"
+
+  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,59 +1,70 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-page-boilerplate
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 4.0.0
 platform: ruby
 authors:
 - Sean Ferney
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2020-10-26 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
     requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 2.8.5
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 2.8.5
 description: A jekyll plugin that allows you to create new pages or posts from a boilerplate
   through the terminal.
 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.yml
+- 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
@@ -75,8 +86,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.8
+rubygems_version: 3.2.3
 signing_key: 
 specification_version: 4
-summary: A jekyll plugin that create new pages from boilerplates
+summary: A jekyll plugin that creates new pages from boilerplates
 test_files: []

data/lib/jekyll_page_boilerplate/example.yml

@@ -1,43 +0,0 @@
----
-
-# Create a new jekyll page/post from a boilerplate.
-
-# A boilerplate is a yaml file in the `_boilerplates` folder.
-
-# `$ boilerplate page example "Another post about pottery"`
-
-# the path to create the new page under.
-path: _posts
-
-# when true new post/pages will include the date in the filename.
-timestamp: true
-
-# Any yaml you put under `header` will be added to your new pages/post
-header:
-  layout: post
-  author: John Doe
-
-# the boilerplate markdown content for your page
-content: '
-
-# Heading
-
-
-Some stuff that changes a little bit but that I don't want to bother copying and pasting.'
-
-
-# This would create a new file: 
-#   _posts/yyyy-mm-dd-another-one-about-pottery.markdow`
-#   ---
-#   title: Another one about pottery
-#   created: 'yyyy-mm-dd hh:mm:ss -0000'
-#   layout: post
-#   author: John Doe
-#   ---
-#   
-#   Heading
-#   -------
-#
-#   Some stuff that changes a little bit but that I don't want to bother copying and pasting.
-# 
-#