planter-cli 3.0.4 → 3.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 06c272d8c938a24e24d8ad5ec220ba9100f6f35fbe6e8d9765a33c982607dbd0
-  data.tar.gz: f9a21781e985fce37c419fcf5f4e6f33cd13c951cd882468b6c90e3a19b50fdd
+  metadata.gz: 9d14e865eb5a5c296dc5b5672ffbacece33956b90e87c796b4d773f8c8ad1fa3
+  data.tar.gz: 8b1a869c83c2c0a31692cd41a24044d3b90e9558da5911de6e7549c60204bbc5
 SHA512:
-  metadata.gz: ffbd475e7f56a2c96cf325cd1a681e9a7541d191c9cc9f669c06e2b3a74b4c889b2256290c5b390ea36aa408bc5e262f605ed0106e4ec409b2dece751adbbcbc
-  data.tar.gz: cc9241c6c6ac2a10ac2d5b82cdf2e6c204472c18834b113499af57e18615706a429c2900d19bdb9aa287c2d77bbe0f0a0a22c29288c10fceb292d623a23c86c3
+  metadata.gz: ade318397e46f22c542775777285f967848dd4d4271452dad8b15f6224ef99923cffb8558de4efb8ce1161d7c1398d260d1864d4923be3f8a17f70a46835160c
+  data.tar.gz: 2ce7038f68dad0af81a595ceb7bd7efc7487a87d9c2d4df86bade005c109efdfa00ef139298dce03aa1e3d074ee45155d5c756f1f264dfe08d134c62e4d957a8

data/.irbrc

@@ -3,7 +3,8 @@ IRB.conf[:AUTO_INDENT] = true
 
 require "irb/completion"
 require_relative "lib/planter"
-
+ENV['RUBYOPT'] = "-W1"
+ENV['PLANTER_IRB'] = "true"
 # rubocop:disable Style/MixinUsage
 include Planter # standard:disable all
 # rubocop:enable Style/MixinUsage

data/.rubocop.yml

@@ -1,3 +1,5 @@
+inherit_from: .rubocop_todo.yml
+
 Style/RegexpLiteral:
   Exclude:
     - Guardfile
@@ -16,6 +18,7 @@ AllCops:
   Exclude:
     - pkg/**/*.rb
     - test/*
+    - 'lib/tty-spinner/**/*'
 
 Style/MutableConstant:
   Enabled: false
@@ -31,9 +34,6 @@ Style/StringLiteralsInInterpolation:
   Enabled: true
   EnforcedStyle: single_quotes
 
-Layout/LineLength:
-  Max: 120
-
 Metrics/MethodLength:
   Max: 45
 
@@ -42,6 +42,7 @@ Metrics/BlockLength:
   Exclude:
     - Rakefile
     - lib/*.rb
+    - lib/planter/string.rb
 
 Metrics/ClassLength:
   Max: 300

data/.rubocop_todo.yml

@@ -0,0 +1,63 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2024-09-04 13:26:32 UTC using RuboCop version 1.66.1.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, AllowedPatterns.
+# URISchemes: http, https
+Layout/LineLength:
+  Max: 125
+
+# Offense count: 1
+# Configuration parameters: CountComments, Max, CountAsOne, AllowedMethods, AllowedPatterns, inherit_mode.
+# AllowedMethods: refine
+Metrics/BlockLength:
+  Exclude:
+    - 'lib/planter/string.rb'
+
+# Offense count: 1
+# Configuration parameters: CountComments, Max, CountAsOne.
+Metrics/ClassLength:
+  Exclude:
+    - 'lib/planter/string.rb'
+
+# Offense count: 2
+# Configuration parameters: AllowedMethods, AllowedPatterns, Max.
+Metrics/CyclomaticComplexity:
+  Exclude:
+    - 'lib/planter/prompt.rb'
+    - 'lib/planter/string.rb'
+
+# Offense count: 2
+# Configuration parameters: CountComments, Max, CountAsOne, AllowedMethods, AllowedPatterns.
+Metrics/MethodLength:
+  Exclude:
+    - 'lib/planter/prompt.rb'
+    - 'lib/planter/string.rb'
+
+# Offense count: 1
+# Configuration parameters: AllowedMethods, AllowedPatterns, Max.
+Metrics/PerceivedComplexity:
+  Exclude:
+    - 'lib/planter/prompt.rb'
+
+# Offense count: 1
+# Configuration parameters: ExpectMatchingDefinition, CheckDefinitionPathHierarchy, CheckDefinitionPathHierarchyRoots, Regex, IgnoreExecutableScripts, AllowedAcronyms.
+# CheckDefinitionPathHierarchyRoots: lib, spec, test, src
+# AllowedAcronyms: CLI, DSL, ACL, API, ASCII, CPU, CSS, DNS, EOF, GUID, HTML, HTTP, HTTPS, ID, IP, JSON, LHS, QPS, RAM, RHS, RPC, SLA, SMTP, SQL, SSH, TCP, TLS, TTL, UDP, UI, UID, UUID, URI, URL, UTF8, VM, XML, XMPP, XSRF, XSS
+Naming/FileName:
+  Exclude:
+    - 'Rakefile.rb'
+    - 'spec/templates/test/Rakefile'
+
+# Offense count: 1
+# This cop supports safe autocorrection (--autocorrect).
+# Configuration parameters: AllowHeredoc, AllowURI, URISchemes, IgnoreCopDirectives, AllowedPatterns.
+# URISchemes: http, https
+Layout/LineLength:
+  Max: 125

data/.yardopts

@@ -1,6 +1,7 @@
 --markup=markdown
---private
---protected
+--no-private
+--list-undoc
+--exclude lib/tty-spinner/
 lib/**/*.rb
 -
 README.md

data/CHANGELOG.md

@@ -1,3 +1,31 @@
+### 3.0.6
+
+2024-09-05 05:53
+
+#### IMPROVED
+
+- Code cleanup and documentation
+
+### 3.0.5
+
+2024-09-04 07:49
+
+#### NEW
+
+- Date_format setting for date types
+- Allow `today '%Y'` inline date formatting
+- If/then logic for file operators
+- First_letter, first_word modifiers for variables
+- Allow default/value variable configutations to include %%placeholders%% and modifiers
+
+#### IMPROVED
+
+- Code refactoring
+
+#### FIXED
+
+- Overwrite operation not overwriting
+
 ### 3.0.4
 
 2024-09-02 08:43

data/Guardfile

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-scope groups: %i[doc lint unit]
+# scope groups: %i[doc lint unit]
 
 group :doc do
   guard :yard do

data/README.md

@@ -2,6 +2,33 @@
 
 Plant a directory structure and files using templates.
 
+
+- [Planter](#planter)
+  - [Installation](#installation)
+  - [Configuration](#configuration)
+    - [Scripts](#scripts)
+    - [Templates](#templates)
+      - [Multiple choice type](#multiple-choice-type)
+    - [File-specific handling](#file-specific-handling)
+      - [If/then logic for file handling](#ifthen-logic-for-file-handling)
+    - [Regex replacements](#regex-replacements)
+    - [Finder Tags](#finder-tags)
+    - [Placeholders](#placeholders)
+      - [Default values in template strings](#default-values-in-template-strings)
+      - [Modifiers](#modifiers)
+      - [If/then logic](#ifthen-logic)
+  - [Usage](#usage)
+  - [Documentation](#documentation)
+  - [Development and Testing](#development-and-testing)
+    - [Source Code](#source-code)
+    - [Requirements](#requirements)
+    - [Rake](#rake)
+    - [Guard](#guard)
+  - [Contributing](#contributing)
+  - [License](#license)
+  - [Warranty](#warranty)
+
+
 ## Installation
 
     gem install planter-cli
@@ -33,7 +60,7 @@ Scripts can be executable files in any language, and receive the template direct
 
 Templates are directories found in `~/.config/planter/templates/[TEMPLATE_NAME]`. All files and directories inside of these template directories are copied when that template is called. Filenames, directory names, and file contents can all use template placeholders.
 
-Template placeholders are defined with `%%KEY%%`, where key is the key defined in the `variables` section of the configuration. `%%KEY%%` placeholders can be used in directory/file names, and in the file contents. These work in any plain text or RTF format document, including XML, so they can be used in things like Scrivener templates and MindNode files as well.
+Template placeholders are defined with `%%KEY%%`, where key is the key defined in the `variables` section of the configuration. `%%KEY%%` placeholders can be used in directory/file names, and in the file contents. These work in any plain text or RTF format document, including XML, so they can be used in things like Scrivener templates and MindNode files as well. See the subsections for info on default values and modifiers for template placeholders.
 
 Each template contains a `_planter.yml` file that defines variables and other configuration options. The file format for all configuration files is [YAML](https://yaml.org/spec/1.2.2/).
 
@@ -44,12 +71,15 @@ variables:
   - key: var_key
     prompt: Prompt text
     type: string # [string,paragraph,float,integer,number,date,choice] defaults to string
-    # value: (force value, string can include %%variables%% and regexes will be replaced. For date type can be today, time, now, etc.)
+    value: # (force value, string can include %%variables%% and regexes will be replaced. For date type can be today, time, now, etc.)
     default: Untitled
     min: 1
     max: 5
+    date_format: "%Y-%m-%d" # can be any strftime format, will be applied to any date type
 ```
 
+For the date type, value can be `today`, `now`, `tomorrow`, `last thursday`, etc. and natural language will be converted to a time. The formatting will be determined automatically based on the type of the value, e.g. "now" gets a time string, but "today" just gets a YYYY-mm-dd string. This can be modified using the `date_format` key, which accepts any [strftime](https://www.fabriziomusacchio.com/blog/2021-08-15-strftime_Cheat_Sheet/) value. You can also include a date format string in single parenthesis after a natural language date value, e.g. `value: "now 'This year: %Y'"`.
+
 A configuration can include additional keys:
 
 ```yaml
@@ -61,9 +91,6 @@ replacements: # Dictionary of pattern/replacments for regex substitution, see [R
 repo: # If a repository URL is provided, it will be pulled and duplicated instead of copying an existing file structure
 ```
 
-#### Default values in template strings
-
-In a template you can add a default value for a placholder by adding `%default value` to it. For example, `%%project%Default Project%%` will set the placeholder to `Default Project` if the variable value matches the default value in the configuration (or doesn't exist). This allows you to accept the default on the command line but have a different value inserted in the template. To use another variable in its place, use `$KEY` in the placeholder, e.g. `%%project%$title%%` will replace the `project` key with the value of `title` if the default is selected. Modifiers can be used on either side of the `%`, e.g. `%%project%$title:snake%%`.
 
 #### Multiple choice type
 
@@ -103,48 +130,35 @@ variables:
       - 1. zsh
 ```
 
-If the choice starts with a number (as above), then a numeric list will be generated and typing the associated index number will accept that choice. Numeric lists are automatically numbered, so the preceding digit doesn't matter, as long as it's a digit. In this case a default can be defined with an integer (in the `defaults:` key) for its placement in the list (starting with 1), and parenthesis aren't required.
-
-#### If/then logic
-
-A template can use if/then logic, which is useful with multiple choice types. It can be applied to any type, though.
-
-The format for if/then logic is:
-
-```
-%%if KEY OPERATOR VALUE%%
-content
-%%else if KEY OPERATOR VALUE2%%
-content 2
-%%else%%
-content 3
-%%endif%%
-```
-
-There should be no spaces around the comparison, e.g. `%% if language == javascript %%` won't work. The block must start with an `if` statement and end with `%%endif%%` or `%%end%%`. The `%%else%%` statement is optional -- if it doesn't exist then the entire block will be removed if no conditions are met.
+If the choice starts with a number (as above), then a numeric list will be generated and typing the associated index number will accept that choice. Numeric lists are automatically numbered, so the preceding digit doesn't matter, as long as it's a digit, and only the first item needs a digit to trigger numbering. In this case a default can be defined with an integer (in the `defaults:` key) for its placement in the list (starting with 1), and parenthesis aren't required.
 
-The key should be an existing key defined in `variables`. The operator can be any of:
+`value:` and `default:` can include previous variables, with modifiers:
 
-- `==` or `=` (equals)
-- `=~` (matches regex)
-- `*=` (contains)
-- `^=` (starts with)
-- `$=` (ends with)
-- `>` (greater than)
-- `>=` (greater than or equal)
-- `<` (less than)
-- `<=` (less than or equal)
-
-The value after the operator doesn't need to be quoted, anything after the operator will be compared to the value of the key.
-
-Logic can be used on multiple lines like the example above, or on a single line (useful for filenames):
-
-```
-%%project%%.%%if language == javascript%%js%%else if language == ruby%%rb%%else%%sh%%endif%%
+```yaml
+- variables:
+  - key: language
+    prompt: Programming language
+    type: choice
+    default: 2
+    choices:
+      - 1. ruby
+      - javascript
+      - python
+      - bash
+      - zsh
+  - key: shebang
+    prompt: Shebang line
+    type: choice
+    default: "%%language:first_letter:lowercase%%"
+    choices:
+      (r)uby: "#! /usr/bin/env ruby"
+      (j)avascript: "#! /usr/bin/env node"
+      (p)ython: "#! /usr/bin/env python"
+      (b)ash: "#! /bin/bash"
+      (z)sh: "#! /bin/zsh"
 ```
 
-Content within if/else blocks can contain variables.
-
+The above would define the `language` variable first, accepting `javascript` as default, then when displaying the menu for `shebang`, the language variable would have its first letter lowercased and set as the default option for the menu.
 
 ### File-specific handling
 
@@ -176,7 +190,17 @@ Merged content
 
 By default files that already exist in the destination directory are not overwritten, and merging allows you to add missing parts to a Rakefile or Makefile, for example.
 
-If `ask` is specified, a memu will be provided on the command line asking how to handle a file. If the file doesn't already exist, you will be asked only whether to copy the file or not. If it does exist, `overwrite` and `merge` options will be added.
+If `ask` is specified, a menu will be provided on the command line asking how to handle a file. If the file doesn't already exist, you will be asked only whether to copy the file or not. If it does exist, `overwrite` and `merge` options will be added.
+
+#### If/then logic for file handling
+
+The operation for a file match can be an if/then statement. There are two formats for this.
+
+First, you can simply write `OPERATION if VARIABLE COMP VALUE`, e.g. `copy if language == ruby`. This can have an `else` statement: `overwrite if language == ruby else copy`.
+
+You can also format it as `if VARIABLE COMP VALUE: OPERATION; else: OPERATION`. This format allows `else if` statements, e.g. `if language == perl: copy;else if language == ruby: overwrite; else: ignore`.
+
+Planter's if/then parsing does not handle parenthetical or boolean operations.
 
 ### Regex replacements
 
@@ -194,6 +218,69 @@ Replacements are performed on both file/directory names and file contents. This
 
 If `preserve_tags` is set to `true` in the config (either base or template), then existing Finder tags on the file or folder will be copied to the new file when a template is planted.
 
+### Placeholders
+
+Placeholders are `%%VARIABLE%%` strings used in filenames and within the content of the files. At their most basic, this would just look like `%%project_name%%`. But you can supply default values, string modifiers, and even if/then logic.
+
+#### Default values in template strings
+
+In a template you can add a default value for a placholder by adding `%default value` to it. For example, `%%project%Default Project%%` will set the placeholder to `Default Project` if the variable value matches the default value in the configuration (or doesn't exist). This allows you to accept the default on the command line but have a different value inserted in the template. To use another variable in its place, use `$KEY` in the placeholder, e.g. `%%project%$title%%` will replace the `project` key with the value of `title` if the default is selected. Modifiers can be used on either side of the `%`, e.g. `%%project%$title:snake%%`.
+
+#### Modifiers
+
+A `%%variable%%` in a template can include modifiers that affect the output of the variable. These are added as `%%variable:MODIFIER%%` and multiple modifiers can be strung together, e.g. `%%language:lowercase:first_letter%%`. The available modifiers are (listed with available abbreviations):
+
+- `snake` (`s`): snake_case the value
+- `camel` (`cam`): camelCase the value
+- `upper` (`u`): UPPERCASE the value
+- `lower` (`l`, `d`): lowercase the value
+- `title` (`t`): Title Case The Value
+- `slug` or `file` (`sl`): slug-format-the-value
+- `first_letter` (`fl`): Extract the first letter from the value
+- `first_word` (`fw`): Extract the first word from the value
+
+#### If/then logic
+
+A template can use if/then logic, which is useful with multiple choice types. It can be applied to any type, though.
+
+The format for if/then logic is:
+
+```
+%%if KEY OPERATOR VALUE%%
+content
+%%else if KEY OPERATOR VALUE2%%
+content 2
+%%else%%
+content 3
+%%endif%%
+```
+
+There should be no spaces around the comparison, e.g. `%% if language == javascript %%` won't work. The block must start with an `if` statement and end with `%%endif%%` or `%%end%%`. The `%%else%%` statement is optional -- if it doesn't exist then the entire block will be removed if no conditions are met.
+
+The key should be an existing key defined in `variables`. The operator can be any of:
+
+- `==` or `=` (equals)
+- `=~` (matches regex)
+- `*=` (contains)
+- `^=` (starts with)
+- `$=` (ends with)
+- `>` (greater than)
+- `>=` (greater than or equal)
+- `<` (less than)
+- `<=` (less than or equal)
+
+Any of these operators can be inverted (negated) by preceding with an exclamation point, e.g. `!=` means `not equal` and `!*=` means `does not contain`.
+
+The value after the operator doesn't need to be quoted, anything after the operator will be compared to the value of the key.
+
+Logic can be used on multiple lines like the example above, or on a single line (useful for filenames):
+
+
+    %%project%%.%%if language == javascript%%js%%else if language == ruby%%rb%%else%%sh%%endif%%
+
+
+Content within if/else blocks can contain variables. Planter's if/then parsing does not handle parenthetical or boolean operations.
+
 ## Usage
 
 The executable for Planter is `plant`. You can run `plant TEMPLATE` in any directory and TEMPLATE will be planted in the current directory. You can also use `--in PATH` to plant in another directory.
@@ -215,14 +302,13 @@ Some directories like `.git` and files like `_planter.yml` are automatically ign
 
 When `plant` is run, any defined variables will be requested on the command line using the defined prompt. If a `default` key is specified, hitting return at the prompt will accept the default value.
 
-Variables can be passed on the command line with `--var KEY:VALUE`. This flag can contain a comma-separated list, e.g. `--var KEY:VALUE,KEY:VALUE` or used multiple times in the same command. Variables passed on the command line will not be prompted for when processing variables.
+Variables can be passed on the command line with `--var KEY:VALUE`. This flag can contain a comma-separated list, e.g. `--var KEY:VALUE,KEY:VALUE` or be used multiple times in the same command. Variables passed on the command line will not be prompted for when processing variables.
 
 
 
 ## Documentation
 
 - [YARD documentation][RubyDoc] is hosted by RubyDoc.info.
-- [Interactive documentation][Omniref] is hosted by Omniref.
 
 [RubyDoc]: http://www.rubydoc.info/gems/planter-cli
 

data/Rakefile

@@ -134,9 +134,6 @@ task :cver do
   puts IO.read(File.join(File.dirname(__FILE__), 'CHANGELOG.md')).match(/^#+ (\d+\.\d+\.\d+(\w+)?)/)[1]
 end
 
-desc 'Alias for build'
-task package: :build
-
 desc 'Bump incremental version number'
 task :bump, :type do |_, args|
   args.with_defaults(type: 'inc')

data/bin/plant

@@ -79,8 +79,9 @@ opts.parse!
 ##
 def list_vars(template)
   puts "#{template} variables:"
-  Planter.config = template
-  Planter.config[:variables].sort_by { |v| v[:key].to_var }.each do |var|
+  Planter.template = template
+  @config = Planter::Config.new
+  @config.variables.sort_by { |v| v[:key].to_var }.each do |var|
     title = var[:prompt] || var[:key]
     var_type = var[:type].normalize_type || :string
     default = var[:value] || var[:default]
@@ -101,12 +102,12 @@ elsif options[:help]
   end
   Process.exit 0
 elsif ARGV.count.zero?
-  raise Planter::Errors::ArgumentError.new 'Template argument required'
+  die('Template argument required', :argument)
 end
 
 ARGV.each do |template|
   # Planter.spinner.update(title: 'Initializing configuration')
-  Planter.config = template
+  Planter.template = template
   app = Planter::Plant.new
   app.plant
 end

data/lib/planter/array.rb

@@ -9,10 +9,17 @@ module Planter
     ##
     ## @example    ["(c)hoice", "(o)ther"].abbr_choices #=> "[c/o]"
     ##
-    ## @param      default  [String] The color templated output string
+    ## @param      default  [String] The (unprocessed) color templated output string
     ##
     def abbr_choices(default: nil)
+      return default.nil? ? '' : "{xdw}[{xbc}#{default}{dw}]{x}" if all? { |c| c.to_i.positive? }
+
       chars = join(' ').scan(/\((?:(.)\.?)\)/).map { |c| c[0] }
+
+      return default.nil? ? '' : "{xdw}[{xbc}#{default}{dw}]{x}" if chars.all? { |c| c.to_i.positive? }
+
+      die('Array contains duplicates', :input) if chars.duplicates?
+
       out = String.new
       out << '{xdw}['
       out << chars.map do |c|
@@ -32,6 +39,8 @@ module Planter
     ## @return     [Array] Array of choices
     ##
     def to_options(numeric)
+      die('Array contains duplicates', :input) if duplicates?
+
       map.with_index do |c, i|
         # v = c.to_s.match(/\(?([a-z]|\d+\.?)\)?/)[1].strip
         if numeric
@@ -42,6 +51,11 @@ module Planter
       end
     end
 
+    ## test if array has duplicates
+    def duplicates?
+      uniq.size != size
+    end
+
     ## Find the index of a choice in an array of choices
     ##
     ## @param      choice  [String] The choice to find

data/lib/planter/color.rb

@@ -108,6 +108,12 @@ module Planter
         Color.template(self)
       end
 
+      ## Remove template codes from a string
+      ## @return [String] uncolored string
+      def strip_template
+        gsub(/(?<!\\)\{(\w+)\}/i, '')
+      end
+
       ##
       ## Extract the longest valid %color name from a string.
       ##
@@ -122,9 +128,7 @@ module Planter
         compiled = ''
         normalize_color.chars.each do |char|
           compiled += char
-          if Color.attributes.include?(compiled.to_sym) || compiled =~ /^([fb]g?)?#([a-f0-9]{6})$/i
-            valid_color = compiled
-          end
+          valid_color = compiled if Color.attributes.include?(compiled.to_sym) || compiled =~ /^([fb]g?)?#([a-f0-9]{6})$/i
         end
 
         valid_color
@@ -243,7 +247,7 @@ module Planter
       ##
       def template(input)
         input = input.join(' ') if input.is_a? Array
-        return input.gsub(/(?<!\\)\{(\w+)\}/i, '') unless Color.coloring?
+        return input.strip_template unless Color.coloring?
 
         input = input.gsub(/(?<!\\)\{((?:[fb]g?)?#[a-f0-9]{3,6})\}/i) do
           hex = Regexp.last_match(1)