kojo 0.3.3 → 0.3.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 74de16b71f9f82631f4c62aa2f8a295b1c575ec72115d010d7188a7fbd412114
-  data.tar.gz: fd97420ac441b2872c9c48b9326057e441fac811efba27e4763852655c6a479d
+  metadata.gz: 31deffc66dbb1ff100bb90f669f8d2995f8eeac92c78919434caffbb9ecfee69
+  data.tar.gz: 6c4b75d7e13b627520d403d8885333a9c30b06cd40c56889e2cd4823ac125b12
 SHA512:
-  metadata.gz: de8d9c02d15b26336b345a585130077ae17052e0876bd2ae5abdc5048d7f7eb18f10808ef8d99d96a0083cccac67a52497d66ee05ab120f1a15c834712accb3d
-  data.tar.gz: 982cbeb243666fe90116dc179634d19d9075889b8a9cc65053dc75a8646892522423340e9fad2794c200899336cc23ddd56855ca51a2c6428ab2a82eef9a41c8
+  metadata.gz: b6731a253afc7c3ccdb8f718e4a78d70d6bfcea9079c269f0b9ca1d8da3596abcbfd5b895fa2e32bbc2b14629c4b5a022cd7996fb3428a6260cb5b5b64b97aa8
+  data.tar.gz: 0c285f0dcaeff09fb183fe2f02e8f25a9905b4431bca7908dfc0824bfd5caba74d215476e661b519733c790b2b79ea599c9d325f03bdab7c847f98761c815ffc

data/README.md

@@ -2,24 +2,22 @@
 
 ![kojo](images/kojo.png)
 
-Kojo Configuration Ninja
-==================================================
+# Kojo Configuration Ninja
 
 [![Gem Version](https://badge.fury.io/rb/kojo.svg)](https://badge.fury.io/rb/kojo)
-[![Build Status](https://travis-ci.com/DannyBen/kojo.svg?branch=master)](https://travis-ci.com/DannyBen/kojo)
+[![Build Status](https://github.com/DannyBen/kojo/workflows/Test/badge.svg)](https://github.com/DannyBen/kojo/actions?query=workflow%3ATest)
 [![Maintainability](https://api.codeclimate.com/v1/badges/f24566ad04b5054a2251/maintainability)](https://codeclimate.com/github/DannyBen/kojo/maintainability)
 
 
 Kojo helps you generate configuration files from templates, using variables 
-and definition files.  
-It is a command line utility, and it works on any text file format.
+and definition files. It is a command line utility, and works on any text file
+format.
 
 </div>
 
 ---
 
-Table of Contents
---------------------------------------------------
+## Table of Contents
 
 - [Installation](#installation)
 - [Usage](#usage)
@@ -28,28 +26,32 @@ Table of Contents
   - [Transform an Entire Folder](#transform-an-entire-folder)
   - [Transform One to Many using Config](#transform-one-to-many-using-config)
   - [Transform One to Many using Front Matter](#transform-one-to-many-using-front-matter)
+  - [Interactive Form Templates](#interactive-form-templates)
   - [Conditions and Loops with ERB](#conditions-and-loops-with-erb)
-- [Interactive Mode](#interactive-mode)
+- [Interactive Fallback](#interactive-fallback)
 - [Using from Ruby Code](#using-from-ruby-code)
 - [Contributing / Support](#contributing--support)
 
 ---
 
-Installation
---------------------------------------------------
+## Installation
 
-    $ gem install kojo
+```shell
+$ gem install kojo
+```
 
+Or with Docker:
 
+```shell
+$ alias kojo='docker run --rm -it -v "$PWD:/app" dannyben/kojo'
+```
 
-Usage
---------------------------------------------------
+## Usage
 
 If you prefer to learn by example, see the [examples](examples#examples) folder for 
 several use cases. Each example subfolder contains the command to run, the 
 relevant files, and the expected output.
 
-
 ### Variables
 
 ![kojo](images/features-vars.svg)
@@ -63,8 +65,6 @@ Include variables in your configuration templates by using this syntax:
 - Variables from the top level will be forwarded downstream, and aggregated 
   with any additional variables that are defined in subsequent `@imports`.
 
-
-
 ### Import
 
 ![kojo](images/features-import.svg)
@@ -86,8 +86,6 @@ resulting configuration file.
 
 The space after `filename` is optional.
 
-
-
 ### Transform an Entire Folder
 
 ![kojo](images/features-dir.svg)
@@ -97,8 +95,6 @@ output folder, with all the variables and `@imports` evaluated.
 
 You may use `%{variables}` in filenames.
 
-
-
 ### Transform One to Many using Config
 
 ![kojo](images/features-config.svg)
@@ -169,6 +165,20 @@ Your template that uses %{arg} goes here
 Additional arguments provided to the command line, will also be transferred
 to the template.
 
+### Interactive Form Templates
+
+![kojo](images/features-form.svg)
+
+Using the `kojo form` command lets you define an ERB or [ERBX][erbx] template, and include interactive prompts to enter the input. 
+
+1. Use either ERB tags (`<%= %>`, `<%- -%>`) or ERBX tags (`{{ }}`, `(( ))`).
+2. Use the built in `prompt` object, which is a [TTY::Prompt](tty-prompt) instance, to prompt for input when running the command (for example: `{{ prompt.ask? "Your Name?" }}`)
+3. Any unidentified ruby command will be forwarded to the `prompt` object, so `prompt.ask` is the same as just using `ask`.
+4. If there is a file with the same name as the template, and with an `.rb` extension (for example `form.md` and `form.md.rb`), then the ruby file will be loaded into the ERB template as if it was written inside it.
+5. If you prefer using a single template file (without the ruby appendix), you can simply use regular ERB/ERBX tags, like demonstrated below.
+
+![kojo](images/features-form-inline.svg)
+
 ### Conditions and Loops with ERB
 
 ![kojo](images/features-erb.svg)
@@ -182,10 +192,7 @@ Use this syntax for ruby code:
 <%- ruby code here -%>     # for code that should not be printed
 <%= ruby code here -%>     # for code that should be printed
 ```
-
-
-Interactive Mode
---------------------------------------------------
+## Interactive Fallback
 
 When Kojo encounters a variable that was not supplied (either through the command 
 line or through a configuration file), it will prompt for a value.
@@ -201,21 +208,20 @@ running from within Ruby code.
 When running from within Ruby code, you can also use `Kojo.interactive = true`
 and `Kojo.interactive?` to get the current state.
 
-
-Using from Ruby Code
---------------------------------------------------
+## Using from Ruby Code
 
 Although Kojo was primarily designed as a command line utility, you can also
 use it as a library from your Ruby code.
 
 These are the primary classes:
 
-| Class                       | Description                                  | CLI equivalent
-|-----------------------------|----------------------------------------------|---------------
-| `Kojo::Template`            | generate from a single template              | `kojo file`
-| `Kojo::FrontMatterTemplate` | generate from a template with a front matter | `kojo single`
-| `Kojo::Config`              | generate from a config file                  | `kojo config`
-| `Kojo::Collection`          | generate from a directory                    | `kojo dir`
+| Class                       | Description                                  | CLI equivalent |
+| --------------------------- | -------------------------------------------- | -------------- |
+| `Kojo::Template`            | generate from a single template              | `kojo file`    |
+| `Kojo::FrontMatterTemplate` | generate from a template with a front matter | `kojo single`  |
+| `Kojo::Config`              | generate from a config file                  | `kojo config`  |
+| `Kojo::Collection`          | generate from a directory                    | `kojo dir`     |
+| `Kojo::Form`                | generate interactively                       | `kojo form`    |
 
 ### Examples
 
@@ -246,9 +252,13 @@ end
 template = Kojo::FrontMatterTemplate.new 'examples/single/Dockerfile'
 params = { version: '0.1.1' }
 
-result = template.render params do |path, content|
+template.render params do |path, content|
   # code to handle results here
 end
+
+# Form
+template = Kojo::Form.new 'examples/form/movie.md'
+puts template.render
 ```
 
 In addition, Kojo extends Ruby's `File` class with the `File.deep_write`
@@ -265,12 +275,13 @@ config.generate do |path, content|
 end
 ```
 
-Contributing / Support
---------------------------------------------------
+## Contributing / Support
 
 If you experience any issue, have a question or a suggestion, or if you wish
 to contribute, feel free to [open an issue][issues].
 
 ---
 
-[issues]: https://github.com/DannyBen/kojo/issues
+[issues]: https://github.com/DannyBen/kojo/issues
+[erbx]: https://github.com/DannyBen/erbx
+[tty-prompt]: https://github.com/piotrmurach/tty-prompt#contents

data/lib/kojo.rb

@@ -1,6 +1,9 @@
 require 'requires'
 require 'byebug' if ENV['BYEBUG']
 
+require 'yaml'
+require 'json'
+
 requires 'kojo/refinements'
 requires 'kojo/extensions'
 
@@ -9,6 +12,7 @@ require 'kojo/template'
 require 'kojo/collection'
 require 'kojo/config'
 require 'kojo/front_matter_template'
+require 'kojo/form'
 
 module Kojo
   class << self

data/lib/kojo/cli.rb

@@ -15,6 +15,8 @@ module Kojo
       runner.route 'dir',    to: Kojo::Commands::DirCmd
       runner.route 'config', to: Kojo::Commands::ConfigCmd
       runner.route 'single', to: Kojo::Commands::SingleCmd
+      runner.route 'form',   to: Kojo::Commands::FormCmd
+      runner.route 'tojson', to: Kojo::Commands::ToJsonCmd
 
       runner
     end

data/lib/kojo/collection.rb

@@ -12,15 +12,19 @@ module Kojo
       @import_base = dir
     end
 
-    def render(args={}, &block)
+    def render(args = {}, &block)
       files.each do |file|
         handle file, args, &block
       end
     end
 
+    def size
+      files.size
+    end
+
   private
 
-    def handle(file, args={})
+    def handle(file, args = {})
       template = Template.new file
       template.import_base = import_base
 
@@ -34,7 +38,9 @@ module Kojo
       raise Kojo::NotFoundError, "Directory not found: #{dir}" unless Dir.exist? dir
       raise Kojo::NotFoundError, "Directory is empty: #{dir}" if Dir.empty? dir
 
-      @files = Dir["#{dir}/**/*"].reject { |f| File.directory? f }.sort
+      @files = Dir.glob("#{dir}/**/*", File::FNM_DOTMATCH)
+        .reject { |f| File.directory? f }
+        .sort
     end
   end
 end

data/lib/kojo/commands/command_base.rb

@@ -4,9 +4,8 @@ module Kojo
   module Commands
     class CommandBase < MisterBin::Command
       def save(file, output)
-        outpath = "#{outdir}/#{file}"
-        File.deep_write outpath, output
-        say "Saved #{outpath}"  
+        File.deep_write file, output
+        say "Saved #{file}"
       end
     end
   end

data/lib/kojo/commands/config.rb

@@ -3,7 +3,7 @@ require 'mister_bin'
 
 module Kojo::Commands
   # Handle calls to the +kojo config+ command
-  class ConfigCmd < MisterBin::Command
+  class ConfigCmd < CommandBase
     using Kojo::Refinements
 
     attr_reader :gen, :outdir, :opts, :import_base, :config_file
@@ -59,13 +59,5 @@ module Kojo::Commands
         say output
       end
     end
-
-    def save(path, output)
-      dir = File.dirname path
-      FileUtils.mkdir_p dir unless Dir.exist? dir
-      File.write path, output
-      say "Saved #{path}"
-    end
-
   end
 end

data/lib/kojo/commands/dir.rb

@@ -62,7 +62,7 @@ module Kojo
 
       def write(collection)
         collection.render @opts do |file, output|
-          save file, output
+          save "#{outdir}/#{file}", output
         end
       end
     end

data/lib/kojo/commands/file.rb

@@ -3,7 +3,7 @@ require 'mister_bin'
 module Kojo
   module Commands
     # Handle calls to the +kojo file+ command
-    class FileCmd < MisterBin::Command
+    class FileCmd < CommandBase
       using Kojo::Refinements
 
       attr_reader :opts, :outfile, :infile, :import_base
@@ -48,8 +48,7 @@ module Kojo
         output = template.render(opts)
 
         if outfile
-          File.write outfile, output
-          say "Saved #{outfile}"
+          save outfile, output
         else
           puts output
         end

data/lib/kojo/commands/form.rb

@@ -0,0 +1,35 @@
+require 'mister_bin'
+
+module Kojo
+  module Commands
+    # Handle calls to the +kojo form+ command
+    class FormCmd < CommandBase
+      attr_reader :infile, :outdir
+
+      help "Fill a template form interactively"
+
+      usage "kojo form INFILE [--save FILE]"
+      usage "kojo form (-h|--help)"
+
+      option "-s --save FILE", "Save to file instead of printing"
+
+      param "INFILE", "ERBX template to transform"
+
+      example "kojo form report.md"
+      example "kojo form report.md --save output.md"
+
+      def run
+        infile = args['INFILE']
+        outfile = args['--save']
+        template = Kojo::Form.new infile
+        
+        if outfile
+          save outfile, template.render
+        else
+          puts template.render 
+        end
+      end
+
+    end
+  end
+end

data/lib/kojo/commands/single.rb

@@ -46,7 +46,7 @@ module Kojo
 
       def write(template)
         template.render opts do |file, output|
-          save file, output
+          save "#{outdir}/#{file}", output
         end
       end
     end

data/lib/kojo/commands/to_json.rb

@@ -0,0 +1,67 @@
+require 'mister_bin'
+
+module Kojo
+  module Commands
+    # Handle calls to the +kojo dir+ command
+    class ToJsonCmd < CommandBase
+      using Kojo::Refinements
+
+      attr_reader :input, :save_files, :replace_files
+
+      help "Convert one or more YAML files to JSON"
+
+      usage "kojo tojson INPUT... [(--save | --replace)]"
+      usage "kojo tojson (-h|--help)"
+
+      option "-s --save", "Save each input file in the same directory"
+      option "-r --replace", "Save each input file in the same directory and delete the input file"
+
+      param "INPUT", "Path to a YAML file or multiple files using a glob pattern"
+
+      example "kojo tojson myfile.yaml"
+      example "kojo tojson myfile.yaml --save"
+      example "kojo tojson indir/*.yaml"
+      example "kojo tojson indir/*.yaml --replace"
+      example "kojo tojson indir/**/*.yml"
+
+      def run
+        @input = get_input_files
+        @save_files = args['--save'] || args['--replace']
+        @replace_files = args['--replace']
+
+        save_files ? write : show
+      end
+
+    private
+
+      def tojson(path)
+        JSON.pretty_generate YAML.load_file(path)
+      end
+
+      # Glob patterns are usually handled by the shell, but in case
+      # we still have '*' in our string (for example, if it was sent
+      # quoted), we will do the globbing ourselves
+      def get_input_files
+        args['INPUT'].map do |path|
+          path.include?('*') ? Dir[path].sort : path
+        end.flatten
+      end
+
+      def show
+        input.each do |infile|
+          outfile = infile.gsub(/\.ya?ml/, '.json')
+          say "\n!txtgrn!# #{outfile}"
+          say tojson(infile)
+        end
+      end
+
+      def write
+        input.each do |infile|
+          outfile = infile.gsub(/\.ya?ml/, '.json')
+          save outfile, tojson(infile)
+          File.delete infile if replace_files
+        end
+      end
+    end
+  end
+end

data/lib/kojo/config.rb

@@ -1,5 +1,3 @@
-require 'yaml'
-
 module Kojo
   # The Config class handles multiple template generation from a 
   # definitions YAML file.
@@ -14,7 +12,7 @@ module Kojo
       @import_base = nil
     end
 
-    def generate(opts={}, &block)
+    def generate(opts = {}, &block)
       if directory_mode?
         generate_from_dir opts, &block
       else

data/lib/kojo/extensions/file.rb

@@ -1,3 +1,5 @@
+require 'fileutils'
+
 class File
   def self.deep_write(path, content)
     FileUtils.mkdir_p File.dirname(path)

data/lib/kojo/form.rb

@@ -0,0 +1,60 @@
+require 'erbx'
+require 'tty-prompt'
+
+module Kojo
+  # The Form class handles interactive ERBX templates
+  class Form
+    attr_reader :file
+
+    def initialize(file)
+      @file = file
+    end
+
+    def content
+      @content ||= content!
+    end
+
+    def content!
+      content = File.read file
+      ruby_code = File.exist?("#{file}.rb") ? File.read("#{file}.rb") : nil
+      content = "<%-\n#{ruby_code}\n-%>\n#{content}" if ruby_code
+      content
+    end
+
+    def render
+      ERBX.new(content).result(binding)
+    rescue TTY::Reader::InputInterrupt
+      # :nocov:
+      raise Kojo::Interrupt
+      # :nocov:
+    end
+
+    def prompt
+      @prompt ||= TTY::Prompt.new
+    end
+
+    def method_missing(method_name, *args, **kargs, &block)
+      if respond_to? method_name
+        prompt.send method_name, *args, **kargs, &block
+      else
+        super
+      end
+    end
+
+    def respond_to?(method_name, include_private = false)
+      prompt.respond_to?(method_name) || super
+    end
+
+    # Below are TTY::Prompt functions that are not captured by the 
+    # `mthod_missing`, so we specify them explicitly
+
+    def select(*args, &block)
+      prompt.select *args, &block
+    end
+
+    def warn(*args, &block)
+      prompt.warn *args, &block
+    end
+
+  end
+end

data/lib/kojo/front_matter_template.rb

@@ -1,5 +1,3 @@
-require 'yaml'
-
 module Kojo
   # The FrontMatterTemplate class handles a single template file, that 
   # contains a YAML front matter.
@@ -12,7 +10,7 @@ module Kojo
       @file = file
     end
 
-    def render(additional_args=nil)
+    def render(additional_args = nil)
       additional_args ||= {}
       config, @template = read_file file
 
@@ -24,7 +22,7 @@ module Kojo
 
   private
 
-    def handle(args={})
+    def handle(args = {})
       content = template
       content = content.eval_erb args, file
       content = content.eval_vars args, file

data/lib/kojo/refinements/array.rb

@@ -5,7 +5,7 @@ module Kojo
     refine Array do
       # Convert an array of +["key=value", "key=value"]+ pairs to a hash
       def args_to_hash
-        collect { |a| k, v = a.split '=' }
+        collect { |a| a.split '=' }
           .to_h
           .symbolize_keys
           .typecast_values

data/lib/kojo/refinements/string.rb

@@ -1,6 +1,5 @@
 require 'erb'
 require 'ostruct'
-require 'kojo/refinements/hash'
 
 module Kojo
   module Refinements

data/lib/kojo/template.rb

@@ -16,7 +16,7 @@ module Kojo
       @import_base = dir
     end
 
-    def render(args={})
+    def render(args = {})
       @args = args
       evaluate file
     end

data/lib/kojo/version.rb

@@ -1,3 +1,3 @@
 module Kojo
-  VERSION = "0.3.3"
+  VERSION = "0.3.8"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kojo
 version: !ruby/object:Gem::Version
-  version: 0.3.3
+  version: 0.3.8
 platform: ruby
 authors:
 - Danny Ben Shitrit
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-01-05 00:00:00.000000000 Z
+date: 2020-10-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mister_bin
@@ -52,6 +52,34 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.5'
+- !ruby/object:Gem::Dependency
+  name: tty-prompt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.21'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.21'
+- !ruby/object:Gem::Dependency
+  name: erbx
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.1
 description: Generate configuration files from templates, using variables and definition
   files.
 email: db@dannyben.com
@@ -69,10 +97,13 @@ files:
 - lib/kojo/commands/config.rb
 - lib/kojo/commands/dir.rb
 - lib/kojo/commands/file.rb
+- lib/kojo/commands/form.rb
 - lib/kojo/commands/single.rb
+- lib/kojo/commands/to_json.rb
 - lib/kojo/config.rb
 - lib/kojo/exceptions.rb
 - lib/kojo/extensions/file.rb
+- lib/kojo/form.rb
 - lib/kojo/front_matter_template.rb
 - lib/kojo/refinements/array.rb
 - lib/kojo/refinements/hash.rb
@@ -98,7 +129,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.1.4
 signing_key: 
 specification_version: 4
 summary: Configuration Ninja