markdown_exec 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 57da333a75458ce1ba2d67c92ee1be458418df6a008f41a89c3545dc0afb94ed
-  data.tar.gz: 4d0c80082485dc50bdb1460adcf101b8ddba65da7d6406d93c1824fd21f9fe95
+  metadata.gz: 0d9976af006093768c7673d5ef0abeff6766539ff86029179d45db0530a4e203
+  data.tar.gz: c2814cf1b85ba80352819c2866862e40a9185874469edc65e0673485e0ca4f7e
 SHA512:
-  metadata.gz: 2f425417848f457325a54d6b8b72f4ecc6f9a5a4ab5ce334b7e1ac93f8760657f9e52c6c2713dcb645d5c9b6a2b1a8cfa99e6a6ef9640cc87e3401a84fff15b2
-  data.tar.gz: 89ad4e3849de542cee33ad65f7bc6185a8f2cda880fec6d94d5f2c1657e957ad33a1c364cf89c56f5fa4999ffea5d5bba7287ebbf747c845307bc80540f0ff21
+  metadata.gz: 9720f8af38d17eba836b73407dedf71848c19663fa017277d3a62e003e19da36a3cad881796ce58e7b84d3d03a94a3a130d6876ac41c908d4694dadc80b53c6b
+  data.tar.gz: 707486f6a6e424787ee7ef05336d5a7290375844f477f369aa7dce2dc72d7f0343d425d83ac778d6b12859b4e155c6fea0ed0acb0cc3719b2d42b5fbf99f2c7b

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 ## [Unreleased]
 
+## [0.2.0] - 2022-03-12
+
+- Improve processing of file and path sepcs.
+
 ## [0.1.0] - 2022-03-06
 
 - Initial release

data/README.md

@@ -1,66 +1,103 @@
 # MarkdownExec
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/markdown_exec`. To experiment with that code, run `bin/console` for an interactive prompt.
+This gem allows you to interactively select and run code blocks in markdown files.
 
-TODO: Delete this and the text above, and describe your gem
+* Code blocks may be named.
 
-## Installation
-
-Add this line to your application's Gemfile:
+* Named blocks can be required by other blocks.
 
-```ruby
-gem 'markdown_exec'
-```
+* The user-selected code block, and all required blocks, are arranged in the order they appear in the markdown file.
 
-And then execute:
+* The code is presented for approval prior to execution.
 
-    $ bundle install
+## Installation
 
-Or install it yourself as:
+Install:
 
     $ gem install markdown_exec
 
 ## Usage
 
-TODO: Write usage instructions here
+`mde --help`
+Displays help information.
 
-## Development
+`mde`
+Process `README.md` file in the current folder. Displays all the blocks in the file and allows you to select using [up], [down], and [return]. Press [ctrl]-c to abort selection.
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+`mde -f my.md`
+Select a block to execute from `my.md`.
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+`mde -p .`
+Select a markdown file in the current folder. Select a block to execute from that file.
 
-## Contributing
+`mde --list-blocks`
+List all blocks in the all the markdown documents in the current folder.
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/markdown_exec. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/markdown_exec/blob/master/CODE_OF_CONDUCT.md).
+`mde --list-docs`
+List all markdown documents in the current folder.
 
-## License
+## Behavior
+* If no file and no folder are specified, blocks within `./README.md` are presented.
+* If a file is specified, its blocks are presented.
+* If a folder is specified, its files are presented. When a file is selected, its blocks are presented.
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+## Configuration
 
-## Code of Conduct
+While starting up, reads the YAML configuration file `.mde.yml` in the current folder if it exists.
 
-Everyone interacting in the MarkdownExec project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/markdown_exec/blob/master/CODE_OF_CONDUCT.md).
+e.g. Use to set the default file for the current folder.
 
-# 2022-03-06
-```
-gem build markdown_exec.gemspec
-```
-```expect
-  Successfully built RubyGem
-  Name: markdown_exec
-  Version: 0.0.1
-  File: markdown_exec-0.0.1.gem
-```
-```
-gem install ./markdown_exec-0.0.1.gem
+* `filename: CHANGELOG.md` sets the file to open.
+* `folder: documents` sets the folder to search for default or specified files.
+
+# Example blocks
+
+When prompted, select either the `awake` or `asleep` block. The standard output confirms which required were blocks were included. Naming "hidden" blocks with parentheses "(" and ")" is a convention used here to re-inforce the purpose of the named blocks.
+
+``` :(day)
+# block named "(day)", required by other blocks
+export MYTIME=early
 ```
+
+``` :(night)
+# block named "(night)", required by other blocks
+export MYTIME=late
 ```
-gem list | grep exec
+
+``` :awake +(day) +(report)
+# block named "awake", select to see result
+export ACTIVITY=awake
 ```
+
+``` :asleep +(night) +(report)
+# block named "asleep", select to see result
+export ACTIVITY=asleep
 ```
-gem uninstall markdown_exec
+
+``` :(report)
+# block named "(report)", required by other blocks
+echo "time: $MYTIME, activity: $ACTIVITY"
 ```
-pusher api key: rubygems_8c4b38ef685484719858c53c3161a124c15d7a9bec6cb65a
 
-gem push markdown_exec-0.0.1.gem
+## Example blocks
+![Sample blocks](/assets/blocks.png)
+
+## Selecting a file
+![Selecting a file](/assets/select_file.png)
+
+## Selecting a block
+![Selecting a block](/assets/select.png)
+
+## Approving code
+![Approving code](/assets/approve.png)
+
+## Output
+![Output of execution](/assets/executed.png)
+
+# License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+# Code of Conduct
+
+Everyone interacting in the MarkdownExec project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/markdown_exec/blob/master/CODE_OF_CONDUCT.md).

data/lib/markdown_exec/version.rb

@@ -4,5 +4,5 @@ module MarkdownExec
   APP_NAME = 'MDE'
   APP_DESC = 'Markdown block executor'
   GEM_NAME = 'markdown_exec'
-  VERSION = '0.1.1'
+  VERSION = '0.2.0'
 end

data/lib/markdown_exec.rb

@@ -3,19 +3,34 @@
 
 # encoding=utf-8
 
-# rubocop:disable Style/GlobalVars
 $pdebug = !(ENV['MARKDOWN_EXEC_DEBUG'] || '').empty?
 
 require 'open3'
 require 'optparse'
-# require 'pathname'
 require 'tty-prompt'
 require 'yaml'
+
 require_relative 'markdown_exec/version'
 
+$stderr.sync = true
+$stdout.sync = true
+
 BLOCK_SIZE = 1024
 SELECT_PAGE_HEIGHT = 12
 
+class Object # rubocop:disable Style/Documentation
+  def present?
+    self && !blank?
+  end
+end
+
+class String # rubocop:disable Style/Documentation
+  BLANK_RE = /\A[[:space:]]*\z/.freeze
+  def blank?
+    empty? || BLANK_RE.match?(self)
+  end
+end
+
 module MarkdownExec
   class Error < StandardError; end
 
@@ -28,66 +43,50 @@ module MarkdownExec
       @options = options
     end
 
-    def count_blocks
+    # Returns true if all files are EOF
+    #
+    def all_at_eof(files)
+      files.find { |f| !f.eof }.nil?
+    end
+
+    def count_blocks_in_filename
       cnt = 0
-      File.readlines(options[:mdfilename]).each do |line|
+      File.readlines(options[:filename]).each do |line|
         cnt += 1 if line.match(/^```/)
       end
       cnt / 2
     end
 
-    def find_files
-      puts "pwd: #{`pwd`}" if $pdebug
-      # `ls -1 *.md`.split("\n").tap { |ret| puts "find_files() ret: #{ret.inspect}" if $pdebug }
-      `ls -1 #{File.join options[:mdfolder], '*.md'}`.split("\n").tap do |ret|
-        puts "find_files() ret: #{ret.inspect}" if $pdebug
-      end
-    end
-
     def fout(str)
       puts str # to stdout
     end
 
-    def copts(call_options = {}, options_block = nil)
-      class_call_options = options.merge(call_options || {})
-      if options_block
-        options_block.call class_call_options
-      else
-        class_call_options
-      end.tap { |ret| puts "copts() ret: #{ret.inspect}" if $pdebug }
-    end
-
-    def bsr(headings, title)
-      # puts "bsr() headings: #{headings.inspect}"
-      { headings: headings, name: title, title: title }
+    def get_block_by_name(table, name, default = {})
+      table.select { |block| block[:name] == name }.fetch(0, default)
     end
 
-    def block_summary(opts, headings, block_title, current)
-      puts "block_summary() block_title: #{block_title.inspect}" if $pdebug
+    def get_block_summary(opts, headings, block_title, current)
       return [current] unless opts[:struct]
 
-      # return [{ body: current, name: block_title, title: block_title }] unless opts[:bash]
-      return [bsr(headings, block_title).merge({ body: current })] unless opts[:bash]
+      return [summarize_block(headings, block_title).merge({ body: current })] unless opts[:bash]
 
       bm = block_title.match(/:(\S+)( |$)/)
       reqs = block_title.scan(/\+\S+/).map { |s| s[1..] }
 
-      if $pdebug
-        puts ["block_summary() bm: #{bm.inspect}",
-              "block_summary() reqs: #{reqs.inspect}"]
-      end
-
       if bm && bm[1]
-        # [{ body: current, name: bm[1], reqs: reqs, title: bm[1] }]
-        [bsr(headings, bm[1]).merge({ body: current, reqs: reqs })]
+        [summarize_block(headings, bm[1]).merge({ body: current, reqs: reqs })]
       else
-        # [{ body: current, name: block_title, reqs: reqs, title: block_title }]
-        [bsr(headings, block_title).merge({ body: current, reqs: reqs })]
+        [summarize_block(headings, block_title).merge({ body: current, reqs: reqs })]
       end
     end
 
-    def get_blocks(call_options = {}, &options_block)
-      opts = copts call_options, options_block
+    def list_blocks_in_file(call_options = {}, &options_block)
+      opts = optsmerge call_options, options_block
+
+      unless opts[:filename]&.present?
+        fout 'No blocks found.'
+        exit 1
+      end
 
       blocks = []
       current = nil
@@ -95,8 +94,7 @@ module MarkdownExec
       block_title = ''
 
       headings = []
-      File.readlines(opts[:mdfilename]).each do |line|
-        puts "get_blocks() line: #{line.inspect}" if $pdebug
+      File.readlines(opts[:filename]).each do |line|
         continue unless line
 
         if opts[:mdheadings]
@@ -107,18 +105,15 @@ module MarkdownExec
           elsif (lm = line.match(/^# *([^#]*?) *$/))
             headings = [lm[1]]
           end
-          puts "get_blocks() headings: #{headings.inspect}" if $pdebug
         end
 
         if line.match(/^`{3,}/)
           if in_block
-            puts 'get_blocks() in_block' if $pdebug
             if current
 
-              # block_title ||= current.join(' ').gsub(/  +/, ' ')[0..64]
               block_title = current.join(' ').gsub(/  +/, ' ')[0..64] if block_title.nil? || block_title.empty?
 
-              blocks += block_summary opts, headings, block_title, current
+              blocks += get_block_summary opts, headings, block_title, current
               current = nil
             end
             in_block = false
@@ -127,7 +122,6 @@ module MarkdownExec
             ## new block
             #
 
-            # lm = line.match(/^`{3,}([^`\s]+)( .+)?$/)
             lm = line.match(/^`{3,}([^`\s]*) *(.*)$/)
 
             do1 = false
@@ -138,11 +132,6 @@ module MarkdownExec
             else
               do1 = true
             end
-            if $pdebug
-              puts ["get_blocks() lm: #{lm.inspect}",
-                    "get_blocks() opts: #{opts.inspect}",
-                    "get_blocks() do1: #{do1}"]
-            end
 
             if do1 && (!opts[:title_match] || (lm && lm[2] && lm[2].match(opts[:title_match])))
               current = []
@@ -155,218 +144,93 @@ module MarkdownExec
           current += [line.chomp]
         end
       end
-      blocks.tap { |ret| puts "get_blocks() ret: #{ret.inspect}" if $pdebug }
-    end # get_blocks
-
-    def make_block_label(block, call_options = {})
-      opts = options.merge(call_options)
-      puts "make_block_label() opts: #{opts.inspect}" if $pdebug
-      puts "make_block_label() block: #{block.inspect}" if $pdebug
-      if opts[:mdheadings]
-        heads = block.fetch(:headings, []).compact.join(' # ')
-        "#{block[:title]} [#{heads}] (#{opts[:mdfilename]})"
-      else
-        "#{block[:title]} (#{opts[:mdfilename]})"
-      end
+      blocks.tap { |ret| puts "list_blocks_in_file() ret: #{ret.inspect}" if $pdebug }
     end
 
-    def make_block_labels(call_options = {})
-      opts = options.merge(call_options)
-      get_blocks(opts).map do |block|
-        make_block_label block, opts
+    def list_files_per_options(options)
+      default_filename = 'README.md'
+      default_folder = '.'
+      if options[:filename]&.present?
+        list_files_specified(options[:filename], options[:folder], default_filename, default_folder)
+      else
+        list_files_specified(nil, options[:folder], default_filename, default_folder)
       end
     end
 
-    def select_block(call_options = {}, &options_block)
-      opts = copts call_options, options_block
-
-      blocks = get_blocks(opts.merge(struct: true))
-      puts "select_block() blocks: #{blocks.to_yaml}" if $pdebug
-
-      prompt = TTY::Prompt.new(interrupt: :exit)
-      pt = "#{opts.fetch(:prompt, nil) || 'Pick one'}:"
-      puts "select_block() pt: #{pt.inspect}" if $pdebug
-
-      blocks.each { |block| block.merge! label: make_block_label(block, opts) }
-      block_labels = blocks.map { |block| block[:label] }
-      puts "select_block() block_labels: #{block_labels.inspect}" if $pdebug
-
-      if opts[:preview_options]
-        select_per_page = 3
-        block_labels.each do |bn|
-          fout " - #{bn}"
-        end
+    def list_files_specified(specified_filename, specified_folder, default_filename, default_folder, filetree = nil)
+      fn = if specified_filename&.present?
+             if specified_folder&.present?
+               "#{specified_folder}/#{specified_filename}"
+             else
+               "#{default_folder}/#{specified_filename}"
+             end
+           elsif specified_folder&.present?
+             if filetree
+               "#{specified_folder}/.+\\.md"
+             else
+               "#{specified_folder}/*.[Mm][Dd]"
+             end
+           else
+             "#{default_folder}/#{default_filename}"
+           end
+      if filetree
+        filetree.select { |filename| filename == fn || filename.match(/^#{fn}$/) || filename.match(%r{^#{fn}/.+$}) }
       else
-        select_per_page = SELECT_PAGE_HEIGHT
-      end
-
-      return nil if block_labels.count.zero?
-
-      sel = prompt.select(pt, block_labels, per_page: select_per_page)
-      puts "select_block() sel: #{sel.inspect}" if $pdebug
-      # catch
-      # # catch TTY::Reader::InputInterrupt
-      #   puts "InputInterrupt"
-      # end
-
-      label_block = blocks.select { |block| block[:label] == sel }.fetch(0, nil)
-      puts "select_block() label_block: #{label_block.inspect}" if $pdebug
-      sel = label_block[:name]
-      puts "select_block() sel: #{sel.inspect}" if $pdebug
-
-      cbs = code_blocks(blocks, sel)
-      puts "select_block() cbs: #{cbs.inspect}" if $pdebug
-
-      ## display code blocks for approval
-      #
-      cbs.each { |cb| fout cb } if opts[:display] || opts[:approve]
-
-      allow = true
-      allow = prompt.yes? 'Process?' if opts[:approve]
-
-      selected = block_by_name blocks, sel
-      puts "select_block() selected: #{selected.inspect}" if $pdebug
-      if allow && opts[:execute]
-
-        ## process in script, to handle line continuations
-        #
-        cmd2 = cbs.flatten.join("\n")
-        fout "$ #{cmd2.to_yaml}"
-
-        # Open3.popen3(cmd2) do |stdin, stdout, stderr, wait_thr|
-        #   cnt += 1
-        #   # stdin.puts "This is sent to the command"
-        #   # stdin.close                # we're done
-        #   stdout_str = stdout.read   # read stdout to string. note that this will block until the command is done!
-        #   stderr_str = stderr.read   # read stderr to string
-        #   status = wait_thr.value    # will block until the command finishes; returns status that responds to .success?
-        #   fout "#{stdout_str}"
-        #   fout "#{cnt}: err: #{stderr_str}" if stderr_str != ''
-        #   # fout "#{cnt}: stt: #{status}"
-        # end
-
-        Open3.popen3(cmd2) do |stdin, stdout, stderr|
-          stdin.close_write
-          begin
-            files = [stdout, stderr]
-
-            until all_eof(files)
-              ready = IO.select(files)
-
-              next unless ready
-
-              readable = ready[0]
-              # writable = ready[1]
-              # exceptions = ready[2]
-
-              readable.each do |f|
-                # fileno = f.fileno
-
-                data = f.read_nonblock(BLOCK_SIZE)
-                # fout "- fileno: #{fileno}\n#{data}"
-                fout data
-              rescue EOFError #=> e
-                # fout "fileno: #{fileno} EOF"
-              end
-            end
-          rescue IOError => e
-            fout "IOError: #{e}"
-          end
-        end
-      end
-
-      selected[:name]
-    end # select_block
-
-    def select_md_file
-      opts = options
-      files = find_files
-      if files.count == 1
-        sel = files[0]
-      elsif files.count >= 2
-
-        if opts[:preview_options]
-          select_per_page = 3
-          files.each do |file|
-            fout " - #{file}"
-          end
-        else
-          select_per_page = SELECT_PAGE_HEIGHT
-        end
-
-        prompt = TTY::Prompt.new
-        sel = prompt.select("#{opts.fetch(:prompt, 'Pick one')}:", files, per_page: select_per_page)
-      end
-
-      sel
+        Dir.glob(fn)
+      end.tap { |ret| puts "list_files_specified() ret: #{ret.inspect}" if $pdebug }
     end
 
-    # Returns true if all files are EOF
-    #
-    def all_eof(files)
-      files.find { |f| !f.eof }.nil?
+    def list_markdown_files_in_folder
+      Dir.glob(File.join(options[:folder], '*.md'))
     end
 
     def code(table, block)
-      puts "code() table: #{table.inspect}" if $pdebug
-      puts "code() block: #{block.inspect}" if $pdebug
-      all = [block[:name]] + unroll(table, block[:reqs])
-      puts "code() all: #{all.inspect}" if $pdebug
+      all = [block[:name]] + recursively_required(table, block[:reqs])
       all.reverse.map do |req|
-        puts "code() req: #{req.inspect}" if $pdebug
-        block_by_name(table, req).fetch(:body, '')
+        get_block_by_name(table, req).fetch(:body, '')
       end
          .flatten(1)
          .tap { |ret| puts "code() ret: #{ret.inspect}" if $pdebug }
     end
 
-    def block_by_name(table, name, default = {})
-      table.select { |block| block[:name] == name }.fetch(0, default)
-    end
-
-    def code_blocks(table, name)
-      puts "code_blocks() table: #{table.inspect}" if $pdebug
-      puts "code_blocks() name: #{name.inspect}" if $pdebug
-      name_block = block_by_name(table, name)
-      puts "code_blocks() name_block: #{name_block.inspect}" if $pdebug
-      all = [name_block[:name]] + unroll(table, name_block[:reqs])
-      puts "code_blocks() all: #{all.inspect}" if $pdebug
+    def list_recursively_required_blocks(table, name)
+      name_block = get_block_by_name(table, name)
+      all = [name_block[:name]] + recursively_required(table, name_block[:reqs])
 
       # in order of appearance in document
       table.select { |block| all.include? block[:name] }
            .map { |block| block.fetch(:body, '') }
            .flatten(1)
-           .tap { |ret| puts "code_blocks() ret: #{ret.inspect}" if $pdebug }
+           .tap { |ret| puts "list_recursively_required_blocks() ret: #{ret.inspect}" if $pdebug }
     end
 
-    def unroll(table, reqs)
-      puts "unroll() table: #{table.inspect}" if $pdebug
-      puts "unroll() reqs: #{reqs.inspect}" if $pdebug
-      all = []
-      rem = reqs
-      while rem.count.positive?
-        puts "unrol() rem: #{rem.inspect}" if $pdebug
-        rem = rem.map do |req|
-          puts "unrol() req: #{req.inspect}" if $pdebug
-          next if all.include? req
+    def make_block_label(block, call_options = {})
+      opts = options.merge(call_options)
+      if opts[:mdheadings]
+        heads = block.fetch(:headings, []).compact.join(' # ')
+        "#{block[:title]}  [#{heads}]  (#{opts[:filename]})"
+      else
+        "#{block[:title]}  (#{opts[:filename]})"
+      end
+    end
 
-          all += [req]
-          puts "unrol() all: #{all.inspect}" if $pdebug
-          block_by_name(table, req).fetch(:reqs, [])
-        end
-                 .compact
-                 .flatten(1)
-                 .tap { |_ret| puts "unroll() rem: #{rem.inspect}" if $pdebug }
+    def make_block_labels(call_options = {})
+      opts = options.merge(call_options)
+      list_blocks_in_file(opts).map do |block|
+        make_block_label block, opts
       end
-      all.tap { |ret| puts "unroll() ret: #{ret.inspect}" if $pdebug }
     end
 
-    # $stderr.sync = true
-    # $stdout.sync = true
+    def optsmerge(call_options = {}, options_block = nil)
+      class_call_options = options.merge(call_options || {})
+      if options_block
+        options_block.call class_call_options
+      else
+        class_call_options
+      end.tap { |ret| puts "optsmerge() ret: #{ret.inspect}" if $pdebug }
+    end
 
-    ## configuration file
-    #
-    def read_configuration!(options, configuration_path)
+    def read_configuration_file!(options, configuration_path)
       if File.exist?(configuration_path)
         # rubocop:disable Security/YAMLLoad
         options.merge!((YAML.load(File.open(configuration_path)) || {})
@@ -376,31 +240,40 @@ module MarkdownExec
       options
     end
 
+    def recursively_required(table, reqs)
+      all = []
+      rem = reqs
+      while rem.count.positive?
+        rem = rem.map do |req|
+          next if all.include? req
+
+          all += [req]
+          get_block_by_name(table, req).fetch(:reqs, [])
+        end
+                 .compact
+                 .flatten(1)
+                 .tap { |_ret| puts "recursively_required() rem: #{rem.inspect}" if $pdebug }
+      end
+      all.tap { |ret| puts "recursively_required() ret: #{ret.inspect}" if $pdebug }
+    end
+
     def run
       ## default configuration
       #
       options = {
         mdheadings: true,
         list_blocks: false,
-        list_docs: false,
-        mdfilename: 'README.md',
-        mdfolder: '.'
+        list_docs: false
       }
 
-      def options_finalize!(options); end
-
-      # puts "MDE run() ARGV: #{ARGV.inspect}"
-
-      # read local configuration file
+      ## post-parse options configuration
       #
-      read_configuration! options, ".#{MarkdownExec::APP_NAME.downcase}.yml"
+      options_finalize = ->(_options) {}
 
-      ## read current details for aws resources from app_data_file
+      # read local configuration file
       #
-      # load_resources! options
-      # puts "q31 options: #{options.to_yaml}" if $pdebug
+      read_configuration_file! options, ".#{MarkdownExec::APP_NAME.downcase}.yml"
 
-      # rubocop:disable Metrics/BlockLength
       option_parser = OptionParser.new do |opts|
         executable_name = File.basename($PROGRAM_NAME)
         opts.banner = [
@@ -408,20 +281,20 @@ module MarkdownExec
           "Usage: #{executable_name} [options]"
         ].join("\n")
 
-        ## menu top: on_head appear in reverse order added
+        ## menu top: items appear in reverse order added
         #
         opts.on('--config PATH', 'Read configuration file') do |value|
-          read_configuration! options, value
+          read_configuration_file! options, value
         end
 
         ## menu body: items appear in order added
         #
-        opts.on('-f RELATIVE', '--mdfilename', 'Name of document') do |value|
-          options[:mdfilename] = value
+        opts.on('-f RELATIVE', '--filename', 'Name of document') do |value|
+          options[:filename] = value
         end
 
-        opts.on('-p PATH', '--mdfolder', 'Path to documents') do |value|
-          options[:mdfolder] = value
+        opts.on('-p PATH', '--folder', 'Path to documents') do |value|
+          options[:folder] = value
         end
 
         opts.on('--list-blocks', 'List blocks') do |_value|
@@ -435,12 +308,12 @@ module MarkdownExec
         ## menu bottom: items appear in order added
         #
         opts.on_tail('-h', '--help', 'App help') do |_value|
-          puts option_parser.help
+          fout option_parser.help
           exit
         end
 
         opts.on_tail('-v', '--version', 'App version') do |_value|
-          puts MarkdownExec::VERSION
+          fout MarkdownExec::VERSION
           exit
         end
 
@@ -449,71 +322,148 @@ module MarkdownExec
         end
 
         opts.on_tail('-0', 'Show configuration') do |_v|
-          options_finalize! options
-          puts options.to_yaml
+          options_finalize.call options
+          fout options.to_yaml
         end
-      end # OptionParser
-      # rubocop:enable Metrics/BlockLength
-
+      end
       option_parser.load # filename defaults to basename of the program without suffix in a directory ~/.options
       option_parser.environment # env defaults to the basename of the program.
       option_parser.parse! # (into: options)
-      options_finalize! options
+      options_finalize.call options
 
       ## process
       #
-      # rubocop:disable Metrics/BlockLength
-      loop do # once
-        mp = MarkParse.new options
-        options.merge!(
-          {
-            approve: true,
-            bash: true,
-            display: true,
-            exclude_expect_blocks: true,
-            execute: true,
-            prompt: 'Execute',
-            struct: true
-          }
-        )
-
-        ## show
+      options.merge!(
+        {
+          approve: true,
+          bash: true,
+          display: true,
+          exclude_expect_blocks: true,
+          execute: true,
+          prompt: 'Execute',
+          struct: true
+        }
+      )
+      mp = MarkParse.new options
+
+      ## show
+      #
+      if options[:list_docs]
+        fout mp.list_files_per_options options
+        return
+      end
+
+      if options[:list_blocks]
+        fout (mp.list_files_per_options(options).map do |file|
+                mp.make_block_labels(filename: file, struct: true)
+              end).flatten(1)
+        return
+      end
+
+      mp.select_block(
+        bash: true,
+        filename: select_md_file(list_files_per_options(options)),
+        struct: true
+      )
+    end
+
+    def select_block(call_options = {}, &options_block)
+      opts = optsmerge call_options, options_block
+
+      blocks = list_blocks_in_file(opts.merge(struct: true))
+
+      prompt = TTY::Prompt.new(interrupt: :exit)
+      pt = "#{opts.fetch(:prompt, nil) || 'Pick one'}:"
+
+      blocks.each { |block| block.merge! label: make_block_label(block, opts) }
+      block_labels = blocks.map { |block| block[:label] }
+
+      if opts[:preview_options]
+        select_per_page = 3
+        block_labels.each do |bn|
+          fout " - #{bn}"
+        end
+      else
+        select_per_page = SELECT_PAGE_HEIGHT
+      end
+
+      return nil if block_labels.count.zero?
+
+      sel = prompt.select(pt, block_labels, per_page: select_per_page)
+
+      label_block = blocks.select { |block| block[:label] == sel }.fetch(0, nil)
+      sel = label_block[:name]
+
+      cbs = list_recursively_required_blocks(blocks, sel)
+
+      ## display code blocks for approval
+      #
+      cbs.each { |cb| fout cb } if opts[:display] || opts[:approve]
+
+      allow = true
+      allow = prompt.yes? 'Process?' if opts[:approve]
+
+      selected = get_block_by_name blocks, sel
+      if allow && opts[:execute]
+
+        ## process in script, to handle line continuations
         #
-        if options[:list_docs]
-          fout mp.find_files
-          break
+        cmd2 = cbs.flatten.join("\n")
+
+        Open3.popen3(cmd2) do |stdin, stdout, stderr|
+          stdin.close_write
+          begin
+            files = [stdout, stderr]
+
+            until all_at_eof(files)
+              ready = IO.select(files)
+
+              next unless ready
+
+              readable = ready[0]
+              # writable = ready[1]
+              # exceptions = ready[2]
+
+              readable.each do |f|
+                print f.read_nonblock(BLOCK_SIZE)
+              rescue EOFError #=> e
+                # do nothing at EOF
+              end
+            end
+          rescue IOError => e
+            fout "IOError: #{e}"
+          end
         end
+      end
+
+      selected[:name]
+    end
+
+    def select_md_file(files_ = nil)
+      opts = options
+      files = files_ || list_markdown_files_in_folder
+      if files.count == 1
+        sel = files[0]
+      elsif files.count >= 2
 
-        if options[:list_blocks]
-          fout (mp.find_files.map do |file|
-                  mp.make_block_labels(mdfilename: file, struct: true)
-                end).flatten(1).to_yaml
-          break
+        if opts[:preview_options]
+          select_per_page = 3
+          files.each do |file|
+            fout " - #{file}"
+          end
+        else
+          select_per_page = SELECT_PAGE_HEIGHT
         end
 
-        ## process
-        #
-        mp.select_block(bash: true, struct: true) if options[:mdfilename]
-
-# rubocop:disable Style/BlockComments
-=begin
-  # rescue ArgumentError => e
-  #   puts "User abort: #{e}"
-
-  # rescue StandardError => e
-  #   puts "ERROR: #{e}"
-  #   raise StandardError, e
-
-  # ensure
-  #   exit
-=end
-        # rubocop:enable Style/BlockComments
-
-        break unless false # rubocop:disable Lint/LiteralAsCondition
-      end # loop
-    end # run
-  end # class MarkParse
-
-  # rubocop:enable Metrics/BlockLength
-  # rubocop:enable Style/GlobalVars
-end # module MarkdownExec
+        prompt = TTY::Prompt.new
+        sel = prompt.select("#{opts.fetch(:prompt, 'Pick one')}:", files, per_page: select_per_page)
+      end
+
+      sel
+    end
+
+    def summarize_block(headings, title)
+      { headings: headings, name: title, title: title }
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: markdown_exec
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Fareed Stevenson
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-03-12 00:00:00.000000000 Z
+date: 2022-03-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: open3
@@ -66,8 +66,8 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.2.0
-description: Execute shell blocks in markdown files. Name blocks and require named
-  blocks.
+description: Interactively select and execute shell blocks in markdown files. Build
+  complex scripts by naming blocks and requiring named blocks.
 email:
 - fareed@phomento.com
 executables:
@@ -83,6 +83,11 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- assets/approve.png
+- assets/blocks.png
+- assets/executed.png
+- assets/select.png
+- assets/select_file.png
 - bin/console
 - bin/mde
 - bin/setup
@@ -93,6 +98,8 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://rubygems.org/gems/markdown_exec
+  source_code_uri: https://github.com/fareedst/markdown_exec
+  changelog_uri: https://github.com/fareedst/markdown_exec/blob/main/CHANGELOG.md
 post_install_message:
 rdoc_options: []
 require_paths: