bashly 0.3.7 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 36db0864b7a077abc473fbad4aa91d14b7428e914be51b537f583f1dc2f97490
-  data.tar.gz: 1e6c19c9cb0b05e09287b3c4e0986fa1c6d1d001f5d03e4c9fd70a72dfe768dc
+  metadata.gz: 7e2d8e44019822a048ede2fadd9da870df078afad2931470748912b25acfb93f
+  data.tar.gz: 84738b8835be3af778b0df351154c2a73c966ee906317f61534c8100a17da9f8
 SHA512:
-  metadata.gz: 7d63a0ebf4158eaeb220a13b6f2ac4ea4c092f930281450cb7cf8d9e85fe495c46e5fa504fb77df19fba3a8e47c71027c6a713f349d108b24f6c930090bdbf8a
-  data.tar.gz: fca3133104b49a68468aacf5a01ef28ca8374df6e1b177bf380fbb6dd6bcc618bf69c1f7022745b34789965abc0534fab2960a7cb57906ce6ba636ae2705cc50
+  metadata.gz: 653e9a5a685d321837472cb2522f93aeabc0ed0de479f97ca35dcbb1d08e2bd997d50e17653c464ce201388f6b21ac59fa4b9d28a01beed5d5119beb8b278e1b
+  data.tar.gz: 79c111478814fb30246a214511946331c7a581196187c41ef6bc249be3858123786bba3596484b27d493288714fb9d257fc18e7b4432b0f77effe8ed7baa740b

data/README.md

@@ -1,8 +1,7 @@
 <div align='center'>
 <img src='logo.svg' width=280>
 
-Bashly - Bash CLI Framework and Generator
-==================================================
+# Bashly - Bash CLI Framework and Generator
 
 Create beautiful bash scripts from simple YAML configuration
 
@@ -16,25 +15,46 @@ Create beautiful bash scripts from simple YAML configuration
 
 </div>
 
+## Table of Contents
+
+- [Table of Contents](#table-of-contents)
+- [Installation](#installation)
+- [Prerequisites](#prerequisites)
+- [What is Bashly](#what-is-bashly)
+- [Usage](#usage)
+  - [Using the input arguemnts in your code](#using-the-input-arguemnts-in-your-code)
+- [Examples](#examples)
+  - [Sample configuraiton for a script without commands](#sample-configuraiton-for-a-script-without-commands)
+  - [Sample configuraiton for a script with commands](#sample-configuraiton-for-a-script-with-commands)
+- [Configuration Reference](#configuration-reference)
+  - [Command options](#command-options)
+  - [Argument options](#argument-options)
+  - [Flag options](#flag-options)
+  - [Environment Variable options](#environment-variable-options)
+- [Real World Examples](#real-world-examples)
+- [Contributing / Support](#contributing--support)
+
 ---
 
-Installation
---------------------------------------------------
+## Installation
 
 ```shell
 $ gem install bashly
 ```
 
+or with Docker:
 
-Prerequisites
---------------------------------------------------
+```shell
+$ alias bashly='docker run --rm -it --volume "$PWD:/app" dannyben/bashly'
+```
+
+## Prerequisites
 
 The bash scripts generated by bashly require bash 4 or higher due to heavy
 use of associative arrays.
 
 
-What is Bashly
---------------------------------------------------
+## What is Bashly
 
 Bashly is a command line application (written in Ruby) that lets you generate
 feature-rich bash command line tools.
@@ -61,9 +81,9 @@ Bahsly is responsible for:
   - **Color output**.
   - **Config file management** (INI format).
   - **YAML parsing**.
+  - and more.
 
-Usage
---------------------------------------------------
+## Usage
 
 In an empty directory, create a sample configuration file by running
 
@@ -93,9 +113,46 @@ Finally, edit the files in the `src` folder. Each of your script's commands
 get their own file. Once you edit, run `bashly generate` again to merge the
 content from your functions back into the script.
 
+### Using the input arguemnts in your code
+
+In order to access the parsed arguments in any of your partial scripts, you
+may simply access the `$args` associative array.
+
+For example:
+
+1. Generate a minimal configuration with `bashly init --minimal`
+2. Generate the bash script with `bashly generate`
+3. Run the script with `./download hello --force`
+
+You will notice that all the arguments of the associative array are printed 
+on screen. This is done by the `inspect_args` function that was inserted into
+the generated partial script `src/root_command.sh`.
+
+You can now access these variables by modifying `sec/root_command.sh` like
+this:
+
 
-Examples
---------------------------------------------------
+```bash
+# src/root_command.sh
+source_url=${args[source]}
+force=${args[--force]}
+
+if [[ $force ]]; then
+  echo "downloading $source_url with --force"
+else
+  echo "downloading $source_url"
+fi
+```
+
+After editing the file, run `bashly generate` (or `bashly g` for short) and
+run:
+
+```
+$ ./download a --force
+downloading a with --force
+```
+
+## Examples
 
 The `bashly.yml` file can be set up to generate two types of scripts:
 
@@ -123,8 +180,7 @@ See the [examples](examples) folder for more examples.
 
 
 
-Configuration Reference
---------------------------------------------------
+## Configuration Reference
 
 The `bashly.yml` configuration file consists of these types:
 
@@ -204,17 +260,21 @@ set.
 `required` | Specify if this variable is required.
 
 
-Real World Examples
---------------------------------------------------
+## Real World Examples
 
 - [Rush][rush] - a Personal Package Manager
+- [Alf][alf] - a generator for bash aliases and sub-aliases
+- [git-changelog][git-changelog] - a change log generator
 
 
-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/bashly/issues
 [rush]: https://github.com/DannyBen/rush-cli
+[alf]: https://github.com/DannyBen/alf
+[git-changelog]: https://github.com/DannyBen/git-changelog
+
+

data/lib/bashly/commands/generate.rb

@@ -3,14 +3,18 @@ module Bashly
     class Generate < Base
       help "Generate the bash script and required files"
 
-      usage "bashly generate [--force]"
+      usage "bashly generate [--force --wrap FUNCTION]"
       usage "bashly generate (-h|--help)"
 
       option "-f --force", "Overwrite existing files"
+      option "-w --wrap FUNCTION", "Wrap the entire script in a function so it can also be sourced"
 
       environment "BASHLY_SOURCE_DIR", "The path containing the bashly configuration and source files [default: src]"
       environment "BASHLY_TARGET_DIR", "The path to use for creating the bash script [default: .]"
 
+      example "bashly generate --force"
+      example "bashly generate --wrap my_function"
+
       def run
         create_user_files
         create_master_script
@@ -54,12 +58,15 @@ module Bashly
       end
 
       def create_master_script
-        master_script = command.render('master_script').lint
-        File.write master_script_path, master_script
+        File.write master_script_path, script.code
         FileUtils.chmod "+x", master_script_path
         say "created !txtgrn!#{master_script_path}"
       end
 
+      def script
+        @script ||= Models::Script.new(command, args['--wrap'])
+      end
+
       def master_script_path
         "#{Settings.target_dir}/#{command.name}"
       end

data/lib/bashly/commands/preview.rb

@@ -11,7 +11,8 @@ module Bashly
       def run
         config = Config.new "#{Settings.source_dir}/bashly.yml"
         command = Models::Command.new(config)
-        puts command.render 'master_script'
+        script = Models::Script.new command
+        puts script.code
       end
     end
   end

data/lib/bashly/models/command.rb

@@ -158,7 +158,7 @@ module Bashly
         args.each do |arg|
           result << arg.usage_string
         end
-        result << "[options]"
+        result << "[options]" unless flags.empty?
         result.join " "
       end
 

data/lib/bashly/models/flag.rb

@@ -11,6 +11,10 @@ module Bashly
         end
       end
 
+      def name
+        long || short
+      end
+
       def usage_string(extended: false)
         result = [aliases.join(", ")]
         result << arg.upcase if arg

data/lib/bashly/models/script.rb

@@ -0,0 +1,33 @@
+module Bashly
+  module Models
+    class Script
+      include Renderable
+
+      attr_reader :command, :function_name
+
+      def initialize(command, function_name = nil)
+        @command, @function_name = command, function_name
+      end
+
+      def code
+        if function_name
+          result = [header, render('wrapper')].join "\n"
+        else
+          result = [header, body].join "\n"
+        end
+
+        result.lint
+      end
+
+    private
+
+      def header
+        @header ||= render('header')
+      end
+
+      def body
+        @body ||= command.render('master_script')
+      end
+    end
+  end
+end

data/lib/bashly/templates/lib/config.sh

@@ -21,7 +21,7 @@ config_init() {
 # Usage: result=$(config_get hello)
 config_get() {
   key=$1
-  regex="^$key\s*=\s*(.+)$"
+  regex="^$key *= *(.+)$"
 
   config_init
   
@@ -44,7 +44,7 @@ config_set() {
 
   config_init
 
-  regex="^($key)\s*=\s*.+$"
+  regex="^($key) *= *.+$"
   output=""
   found_key=""
   
@@ -71,7 +71,7 @@ config_set() {
 config_del() {
   key=$1
 
-  regex="^($key)\s*="
+  regex="^($key) *="
   output=""
 
   config_init
@@ -100,7 +100,7 @@ config_show() {
 #   done
 #
 config_keys() {
-  regex="^(.*)\s*="
+  regex="^([a-zA-Z0-9_\-\/\.]+) *="
 
   config_init
 
@@ -113,3 +113,14 @@ config_keys() {
   done < "$CONFIG_FILE"
   echo "${keys[@]}"
 }
+
+# Returns true if the specified key exists in the config file
+# Usage:
+#
+#   if config_has_key "key" ; then
+#     echo "key exists"
+#   fi
+#
+config_has_key() {
+  [[ $(config_get "$1") ]]
+}

data/lib/bashly/templates/strings.yml

@@ -21,7 +21,7 @@ help_flag_text: Show this help
 version_flag_text: Show version number
 
 # Error messages
-flag_requires_an_argument: "%{long} requires an argument: %{usage}"
+flag_requires_an_argument: "%{name} requires an argument: %{usage}"
 invalid_argument: "invalid argument: %s"
 invalid_flag: "invalid option: %s"
 missing_required_argument: "missing required argument: %{arg}\\nusage: %{usage}"

data/lib/bashly/version.rb

@@ -1,3 +1,3 @@
 module Bashly
-  VERSION = "0.3.7"
+  VERSION = "0.4.1"
 end

data/lib/bashly/views/command/inspect_args.erb

@@ -1,5 +1,10 @@
 # :command.inspect_args
 inspect_args() {
-  echo args:
-  for k in "${!args[@]}"; do echo "- \${args[$k]} = ${args[$k]}"; done
+  readarray -t sorted_keys < <(printf '%s\n' "${!args[@]}" | sort)
+  if (( ${#args[@]} )); then
+    echo args:
+    for k in "${sorted_keys[@]}"; do echo "- \${args[$k]} = ${args[$k]}"; done
+  else
+    echo args: none
+  fi
 }

data/lib/bashly/views/command/master_script.erb

@@ -1,7 +1,3 @@
-#!/usr/bin/env bash
-# This script was generated by bashly (https://github.com/DannyBen/bashly)
-# Modifying it manually is not recommended
-
 <%= render :root_command if commands.empty? %>
 <%= render :version_command %>
 <%= render :usage %>

data/lib/bashly/views/flag/case.erb

@@ -1,16 +1,16 @@
 # :flag.case
 <%= aliases.join " | " %> )
   <%- if arg -%>
-  if [[ $2 && $2 != -* ]]; then
-    args[<%= long %>]="$2"
+  if [[ $2 ]]; then
+    args[<%= name %>]="$2"
     shift
     shift
   else
-    printf "%s\n" "<%= strings[:flag_requires_an_argument] % { long: long, usage: usage_string } %>"
+    printf "%s\n" "<%= strings[:flag_requires_an_argument] % { name: name, usage: usage_string } %>"
     exit 1
   fi
   <%- else -%>
-  args[<%= long %>]=1
+  args[<%= name %>]=1
   shift
   <%- end -%>
   ;;

data/lib/bashly/views/script/header.erb

@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+# This script was generated by bashly (https://github.com/DannyBen/bashly)
+# Modifying it manually is not recommended

data/lib/bashly/views/script/wrapper.erb

@@ -0,0 +1,6 @@
+# :script.wrapper
+<%= function_name %>() {
+<%= body.indent 2 %>
+}
+
+(return 0 2>/dev/null) || <%= function_name %> "$@"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bashly
 version: !ruby/object:Gem::Version
-  version: 0.3.7
+  version: 0.4.1
 platform: ruby
 authors:
 - Danny Ben Shitrit
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-02-17 00:00:00.000000000 Z
+date: 2021-02-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: colsole
@@ -80,6 +80,7 @@ files:
 - lib/bashly/models/command.rb
 - lib/bashly/models/environment_variable.rb
 - lib/bashly/models/flag.rb
+- lib/bashly/models/script.rb
 - lib/bashly/polyfills/hash.rb
 - lib/bashly/settings.rb
 - lib/bashly/templates/bashly.yml
@@ -123,6 +124,8 @@ files:
 - lib/bashly/views/environment_variable/usage.erb
 - lib/bashly/views/flag/case.erb
 - lib/bashly/views/flag/usage.erb
+- lib/bashly/views/script/header.erb
+- lib/bashly/views/script/wrapper.erb
 homepage: https://github.com/dannyben/bashly
 licenses:
 - MIT
@@ -142,7 +145,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.2.3
 signing_key: 
 specification_version: 4
 summary: Bash Command Line Tool Generator