squared 0.0.9 → 0.0.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 90258e1d46b51b15fcb414cddf85407968d227b5032797e76ead83befa5d302b
-  data.tar.gz: a01b153f7c26b7f15a24cc66a159e47e42bc117e7b0810d7146c6ca3766f3cd0
+  metadata.gz: d000551aa00185dae3ea1bc7e3a61c64af96dce7d717339483d8cb572ca12d43
+  data.tar.gz: 229f06052512ee06d16e43688602753a867025e8cf39b6b1c6dfafa69805fdbc
 SHA512:
-  metadata.gz: 484c0af12a637957f3ed9ddc43b6f08bee1f3dbcba50a2acdfdd0dcb7bb929b83b64d40fd8bbf17ceddc5d8177a27773e4193198cbc80f2991651bf55366b2c8
-  data.tar.gz: a9617a969c41e971235b98bc730fd440f6c913a2ce21b9e8acb1907ae170ac72da1bb5d72df8650c1833827599fb0d95ab4aae19e5c75249dac07c0096efe077
+  metadata.gz: 5efe60578369457075929b95ba8ea628d39d7324d40f84c397e07606c8c5fe48f07f797b940d7ca34a80321bb3f1435494c36afcd95432cbe8924e4353099f56
+  data.tar.gz: daf832c4fbcf0e80459317be7b91781cfea9b653b3368cdbc090101d67ca59aff8b38940c2803100e322ca14bd25f45ccf37ef27bb348312b724c45babeb3393

data/README.md

@@ -16,9 +16,6 @@
 * [E-mc](https://github.com/anpham6/e-mc#readme)
 * [Pi-r](https://github.com/anpham6/pi-r#readme)
 
-> [!NOTE]
-> `squared-express` originally was intended to be used as a HTTP/1.1 insecure development server for Android projects. `E-mc` was created a few years later to produce static outputs for any kind of development accessible through a simple REST API. Gradually any new development that calls the REST API will use [NGINX Unit](https://unit.nginx.org) as the *production* application runtime to efficiently serve static assets. Middleware and application code can be conducted in the same manner with Express and other programming frameworks (e.g. Ruby). Maintanence updates with subsequent `E-mc` releases supporting legacy development environments will be tested only against `Express 4.19` although most existing applications can be upgraded without any problems. Upgrading to `Express 5` is not recommended as it offers no new noticeable features (e.g. HTTP/2) and possibly compatibility issues with template libraries.
-
 ## Installation
 
 * NodeJS 16 LTS
@@ -113,14 +110,13 @@ cd workspaces            # REPO_ROOT
 
 wget https://raw.githubusercontent.com/anpham6/squared/master/Rakefile
 
-# REPO_DOCS=1 (venv)
 rake -T                  # List tasks
 
 # REPO_BUILD={dev,prod}
 # PIPE_FAIL=1
 rake repo:init           # nightly
-# OR
-rake repo:init[latest]   # 0.11.x
+rake repo:init[latest]   # squared
+rake repo:init[0.11.x]   # e-mc
 # OR
 REPO_ROOT=/tmp/123 NODE_INSTALL=pnpm repo:init
 ```

data/README.ruby.md

@@ -4,9 +4,17 @@
 * [manifest](https://github.com/anpham6/squared-repo)
 * [docs](https://squared.readthedocs.io)
 
-## Prerequisites
+## Version Compatibility
 
-* Ruby 2.4
+| Date     | squared | Ruby 2 | Ruby 3 |
+| :------: | ------: | -----: | -----: |
+| 12-07-24 |   0.1.0 |  2.4.0 |  3.0.0 |
+
+## Installation
+
+```sh
+gem install squared
+```
 
 ### Optional
 
@@ -20,42 +28,67 @@ curl https://storage.googleapis.com/git-repo-downloads/repo > ~/.bin/repo
 chmod a+rx ~/.bin/repo
 ```
 
-## Installation
-
-```sh
-gem install squared
-```
-
 ## Example - Rakefile
 
 Projects from any accessible folder can be added either relative to `REPO_ROOT` or absolutely. The same Rakefile can also manage other similarly cloned repositories remotely by setting the `REPO_ROOT` environment variable to the location. Missing projects will simply be excluded from the task runner.
 
 ```ruby
 require "squared"
-require "squared/workspace/repo" # Repo (optional)
+
+require "squared/workspace"
+require "squared/workspace/repo"           # Optional
+require "squared/workspace/project/node"   #
+require "squared/workspace/project/python" #
+require "squared/workspace/project/ruby"   #
+# OR
+require "squared/app"                      # All workspace related modules
 
 # NODE_ENV  = production
 # REPO_ROOT = /workspaces
-# REPO_HOME = /workspaces/squared
+# REPO_HOME = /workspaces/squared (Dir.pwd)
 # rake      = /workspaces/squared/Rakefile
+# pathname  = /workspaces/pathname
+# optparse  = /workspaces/optparse
+# log       = /workspaces/logger
+# emc       = /workspaces/e-mc
+# pir       = /workspaces/pi-r
+# squared   = /workspaces/squared
+# cli       = /workspaces/squared/publish/sqd-cli
+# sqd-serve = /workspaces/squared/publish/sqd-serve
+# sqd       = /workspaces/squared/sqd
 
 Workspace::Application
-  .new(main: "squared") # Dir.pwd? (main? is implicitly basename)
-  .banner("group", "project", styles: %i[yellow black], border: "bold") # name | project | path | ref | group?
-  .repo("https://github.com/anpham6/squared-repo", "nightly", run: "build", ref: :node) # Repo (optional)
+  .new(Dir.pwd, main: "squared") # Dir.pwd? (main? is implicitly basename)
+  .banner("group", "project", styles: %i[yellow black], border: "bold") # name | project | path | ref | group? | parent? | version?
+  .repo("https://github.com/anpham6/squared-repo", "nightly", script: ["build:dev", "build:prod"], ref: :node) # Repo (optional)
   .run("rake install", ref: :ruby)
   .depend(false, group: "default")
   .clean("rake clean", group: "default")
   .clean(["build/"], group: "app")
-  .add("pathname", run: "rake compile", copy: "rake install", test: "rake test", group: "default", ref: :ruby) # Ruby (with C extensions)
+  .log({ file: "tmp/%Y-%m-%d.log", level: "debug" }, group: "app")
+  .add("pathname", run: "rake compile", copy: "rake install", test: "rake test", group: "default", env: { # Ruby (with C extensions)
+    "CFLAGS" => "-fPIC -O1"
+  })
   .add("optparse", doc: "rake rdoc", group: "default") # Uses bundler/gem_tasks (without C extensions)
-  .add("logger", copy: { from: "lib", glob: "**/*.rb", gemdir: "~/.rvm/gems/ruby-3.3.5/gems/logger-1.6.1" }, clean: ["tmp/"]) # autodetect: true
-  .add("emc", "e-mc", copy: { from: "publish", into: "@e-mc", also: [:pir, "squared-express/"] }, ref: :node) # Node
-  .add("pir", "pi-r", copy: { from: "publish", into: "@pi-r" }, clean: ["publish/**/*.js", "tmp/"]) # Trailing slash required for directories
-  .add("squared", log: { file: "tmp/%Y-%m-%d.log", level: "debug" }, group: "app") # Copy target (main)
-  .add("sqd", "squared/sqd", script: ["build:sqd", "prod:sqd"], depend: false, clean: ["build/sqd/"], exclude: :git) # NPM workspaces
+  .add("logger", copy: { from: "lib", glob: "**/*.rb", into: "~/.rvm/gems/ruby-3.3.5/gems/logger-1.6.1" }, clean: ["tmp/"]) # autodetect: true
+  .add("e-mc", "emc", copy: { from: "publish", scope: "@e-mc", also: [:pir, "squared-express/"] }, ref: :node) # Node
+  .add("pi-r", "pir", copy: { from: "publish", scope: "@pi-r" }, clean: ["publish/**/*.js", "tmp/"]) # Trailing slash required for directories
+  .add("squared", script: ["build:stage1", "build:stage2"], group: "app") do # Copy target (main)
+    add("publish/sqd-cli", "cli", exclude: [:git]) # rake cli:build
+    add("publish/sqd-serve")                       # rake sqd-serve:build
+    add("publish/sqd-admin", group: "sqd", exclude: [:base])
+    # OR
+    with(exclude: [:base]) { add("publish/*", "packages") } # rake packages:sqd-serve:build
+    # OR
+    add(["publish/sqd-cli", "publish/sqd-serve", "publish/sqd-admin"], true, exclude: [:base]) # rake squared:sqd-serve:build
+  end
+  .add("squared/sqd", exclude: [:git]) do
+    variable_set :script, "build:sqd"     # Override detection
+    variable_set :depend, false
+    variable_set :clean, ["build/sqd/"]
+  end
   .style("banner", 255.255) # 256 colors (fg | fg.bg | -0.bg)
-  .build(default: "status", parallel: ["pull", "fetch", "rebase", "copy", "clean"]) do |workspace|
+  .build(default: "status", parallel: ["pull", "fetch", "rebase", "copy", "clean", "outdated:ruby"]) do |workspace|
     workspace
       .enable_aixterm
       .style({
@@ -63,45 +96,40 @@ Workspace::Application
         border: "bright_white"
       })
   end
-# pathname  = /workspaces/pathname
-# optparse  = /workspaces/optparse
-# log       = /workspaces/logger
-# emc       = /workspaces/e-mc
-# pir       = /workspaces/pi-r
-# squared   = /workspaces/squared
 
-Workspace::Application
-  .new(ENV["SQUARED_DIR"], prefix: "rb", common: false) # Local styles
-  .group("default", "ruby/", run: "rake build", copy: "rake install", clean: "rake clean", ref: :ruby, override: {
-    pathname: {
-      run: "rake compile"                               # rake rb:pathname:build
-    }
-  })
-  .with(:python) do                                     # ref=Symbol  | group=String
-    banner("path", command: false, styles: "yellow")    # 
-    doc("make html")                                    # rake rb:doc:python
-    run(false)                                          # rake rb:build:python (disabled)
-    exclude(%i[base git])                               # Project::Git.ref (superclass)
-    add("android", "android-docs")                      # rake rb:android:doc
-    add("chrome", "chrome-docs")                        # rake rb:chrome:doc
-  end                                                   #
-  .style("inline", "bold")
-  .build
 # default   = /workspaces/ruby/*
 # pathname  = /workspaces/ruby/pathname
 # optparse  = /workspaces/ruby/optparse
 # logger    = /workspaces/ruby/logger
 # android   = /workspaces/android-docs
 # chrome    = /workspaces/chrome-docs
+
+Workspace::Application
+  .new(ENV["SQUARED_HOME"], prefix: "rb", common: false) # Local styles
+  .group("ruby", "default", run: "rake build", copy: "rake install", clean: "rake clean", ref: :ruby, override: {
+    pathname: {
+      run: "rake compile"                                # rake rb:pathname:build
+    }
+  })
+  .with(:python) do                                      # ref=Symbol | group=String
+    banner([:name, ': ', :version], "path")              # chrome-docs: 0.1.0 | /workspaces/chrome-docs
+    doc("make html")                                     # rake rb:doc:python
+    run(false)                                           # rake rb:build:python (disabled)
+    exclude(%i[base git])                                # Project::Git.ref (superclass)
+    add("android-docs", "android")                       # rake rb:android:doc
+    add("chrome-docs", "chrome")                         # rake rb:chrome:doc
+  end                                                    #
+  .style("inline", "bold")
+  .build
 ```
 
-**NOTE**: The use of "**ref**" (class name) is only necessary when running `repo:init` for the first time into an empty directory.
+**NOTE**: The use of "**ref**" (class name) is only necessary when initializing an empty directory (e.g. *rake repo:init*).
 
 ## Usage
 
 ```sh
-rake -T           # List tasks
-rake              # rake status (usually "build")
+rake -T             # List tasks
+rake                # rake status (usually "build")
 
 # GIT_OPTIONS=rebase
 rake pull           # All except "default" + "app"
@@ -123,7 +151,17 @@ rake clean:app      # none + skip + ["build/"]
 rake clean:node     # none + ["publish/**/*.js", "tmp/"] + ["build/"]
 ```
 
-## Commands
+```sh
+rake build:app                   # squared + cli + sqd-serve
+rake squared:build:workspace     # cli + sqd-serve
+rake pull:sqd                    # sqd-admin
+rake squared:pull:workspace      # sqd-serve + sqd-admin
+rake squared:outdated:workspace  # cli + sqd-serve + sqd-admin
+```
+
+## Methods
+
+Task:
 
 * run
 * depend
@@ -131,6 +169,11 @@ rake clean:node     # none + ["publish/**/*.js", "tmp/"] + ["build/"]
 * doc
 * clean
 
+Non-task:
+
+* log
+* exclude
+
 ## Styles
 
 * banner
@@ -139,6 +182,61 @@ rake clean:node     # none + ["publish/**/*.js", "tmp/"] + ["build/"]
 * active
 * inline
 * major
+* red
+* yellow
+* green
+
+## Environment
+
+### Build
+
+```ruby
+# :env                                         :run           :opts
+# LD_LIBRARY_PATH="path/to/lib" CFLAGS="-Wall" gcc a.c -o a.o -c
+BUILD_${NAME}      # gcc a.c -o a.o
+BUILD_OPTS_${NAME} # -c
+BUILD_ENV_${NAME}  # {"LD_LIBRARY_PATH":"path/to/lib","CFLAGS":"-Wall"} (hash/json)
+
+# :env                                       :opts                               :script
+# NODE_ENV="production" NO_COLOR="1" npm run --loglevel=error --workspaces=false build:dev
+BUILD_${NAME}      # build:dev
+BUILD_OPTS_${NAME} # --loglevel=error --workspaces=false
+BUILD_ENV_${NAME}  # {"NODE_ENV":"production","NO_COLOR":"1"} (hash/json)
+BUILD_DEV_${NAME}  # pattern,0,1 (:dev)
+BUILD_PROD_${NAME} # pattern,0,1 (:prod)
+
+BUILD_${NAME}=0    # skip project
+```
+
+These options also support the project specific suffix `${NAME}`. (e.g. LOG_FILE_SQUARED)
+
+### Logger
+
+```ruby
+LOG_FILE           # %Y-%m-%d.log
+# OR
+LOG_AUTO           # year,y,month,m,day,d,1
+# Optional
+LOG_DIR            # exist?
+LOG_LEVEL          # See gem "logger"
+LOG_COLUMNS        # terminal width (default: 80)
+```
+
+### Repo
+
+```ruby
+REPO_ROOT          # parent dir
+REPO_HOME          # project dir (main)
+REPO_BUILD         # run,script
+REPO_GROUP         # string
+REPO_REF           # e.g. ruby,node
+REPO_DEV           # pattern,0,1
+REPO_PROD          # pattern,0,1
+REPO_WARN          # 0,1
+REPO_SYNC          # 0,1
+REPO_MANIFEST      # e.g. latest,nightly,prod
+REPO_TIMEOUT       # confirm dialog (seconds)
+```
 
 ## LICENSE
 

data/lib/squared/app.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require_relative 'workspace'
+require_relative 'workspace/repo'
+require_relative 'workspace/project/node'
+require_relative 'workspace/project/python'
+require_relative 'workspace/project/ruby'
+require_relative 'config'
+
+Common = Squared::Common

data/lib/squared/common/base.rb

@@ -2,6 +2,15 @@
 
 module Squared
   module Common
+    ARG = {
+      PIPE: 1,
+      OUT: nil,
+      FAIL: false,
+      COMMON: true,
+      BANNER: true,
+      SPACE: ' => ',
+      COLOR: ENV.fetch('NO_COLOR', '').empty?
+    }
     VAR = {
       project: {},
       colors: {
@@ -65,6 +74,7 @@ module Squared
     end
 
     def __freeze__
+      ARG.freeze
       VAR.each_value(&:freeze)
       VAR[:theme].each_value(&:freeze)
       VAR.freeze
@@ -72,25 +82,17 @@ module Squared
 
     module_function
 
-    def env(key, default = nil, equals: nil, ignore: nil, **)
-      ret = ENV.fetch(key, '')
-      return ret == equals.to_s unless equals.nil?
-
-      ret.empty? || (ignore && as_a(ignore).any? { |val| ret == val.to_s }) ? default : ret
-    end
-
-    def message(*args, hint: nil)
-      args.reject(&:empty?).join(' => ') + (hint ? " (#{hint})" : '')
-    end
-
     def as_a(obj, meth = nil, flat: nil, compact: false)
       return [] if obj.nil?
 
-      if !obj.is_a?(::Array)
-        obj = [obj]
-      elsif flat
-        obj = obj.flatten(flat == true ? nil : flat)
+      unless obj.is_a?(::Array)
+        obj = if !obj.is_a?(::Hash) && obj.respond_to?(:to_a) && (val = obj.to_a).is_a?(::Array)
+                val
+              else
+                [obj]
+              end
       end
+      obj = obj.flatten(flat.is_a?(::Numeric) ? flat : nil) if flat
       obj = obj.map(&meth) if meth
       compact ? obj.compact : obj
     end

data/lib/squared/common/class.rb

@@ -1,14 +1,31 @@
 # frozen_string_literal: true
 
 require 'set'
+require 'forwardable'
 
 module Squared
   module Common
-    class JoinSet < ::Set
-      def self.to_s
-        super.to_s.match(/[^:]+$/)[0]
+    class SymSet
+      extend Forwardable
+
+      def_delegators :@data, :each, :each_with_index, :entries, :to_a, :include?
+
+      def initialize(data = [])
+        @data = Set.new(data)
       end
 
+      def add(val)
+        @data.add(val.to_sym)
+      end
+
+      def to_s
+        @data.to_s.sub('Set', SymSet.to_s)
+      end
+
+      alias inspect to_s
+    end
+
+    class JoinSet < ::Set
       def initialize(data = [], delim: ' ')
         super(data.compact)
         @delim = delim

data/lib/squared/common/format.rb

@@ -40,7 +40,7 @@ module Squared
       private
 
       def sub_style(val, *args, styles: nil, pat: nil, index: 1)
-        return val unless ENV.fetch('NO_COLOR', '').empty? && !__get__(:no_color)
+        return val unless ARG[:COLOR]
 
         if pat && index != 0
           return val unless (data = pat.match(val))
@@ -61,7 +61,7 @@ module Squared
           else
             s = ret
           end
-          if type.is_a?(Numeric)
+          if type.is_a?(::Numeric)
             f, b = type.to_s.split('.')
             s = wrap.(s, ['38', '5', f]) if f[0] != '-' && f.to_i <= 255
             if b
@@ -77,7 +77,7 @@ module Squared
                 code << c
               end
             else
-              next unless (n = TEXT_STYLE.index { |style| style == t })
+              next unless (n = TEXT_STYLE.index(t))
 
               s = "\x1B[#{n + 1}m#{s}\x1B[#{n == 0 ? 22 : n + 21}m"
             end
@@ -106,11 +106,11 @@ module Squared
         out
       end
 
-      def check_style(*args, empty: true)
+      def check_style(args, empty: true)
         ret = []
         colors = __get__(:colors)
         as_a(args, flat: true, compact: true).each do |val|
-          if !val.is_a?(Numeric)
+          if !val.is_a?(::Numeric)
             val = val.to_sym
             ret << val if colors.key?(val) || TEXT_STYLE.include?(val)
           elsif val >= 0 && val <= 256
@@ -123,39 +123,41 @@ module Squared
         ret if empty || !ret.empty?
       end
 
-      def apply_style(data, key, *args, empty: true)
-        data = __get__(:theme)[data] if data.is_a?(Symbol)
-        return unless data
+      def apply_style(data, key, args, empty: true)
+        return if data.is_a?(::Symbol) && (data = __get__(:theme)[data]).nil?
 
-        set = ->(k, v) { data[k.to_sym] = check_style(v, empty: empty) }
-        if key.is_a?(Hash)
-          key.each { |k, v| set.(k, v || args.flatten) }
+        set = ->(k, v) { data[k] = check_style(v, empty: empty) }
+        if key.is_a?(::Hash)
+          key.each { |k, v| set.(k, v || args) }
         else
-          set.(key, args.flatten)
+          set.(key.to_sym, args)
         end
       end
 
-      def log_title(level, color: true)
-        level = if level.is_a?(::Numeric)
-                  case level
-                  when Logger::DEBUG
-                    :debug
-                  when Logger::INFO
-                    :info
-                  when Logger::WARN
-                    :warn
-                  when Logger::ERROR
-                    :error
-                  when Logger::FATAL
-                    :fatal
-                  else
-                    :unknown
-                  end
-                else
-                  level.to_s.downcase.to_sym
-                end
+      def log_sym(level)
+        if level.is_a?(::Numeric)
+          case level
+          when Logger::DEBUG
+            :debug
+          when Logger::INFO
+            :info
+          when Logger::WARN
+            :warn
+          when Logger::ERROR
+            :error
+          when Logger::FATAL
+            :fatal
+          else
+            :unknown
+          end
+        else
+          level.to_s.downcase.to_sym
+        end
+      end
+
+      def log_title(level, color: ARG[:COLOR])
         theme = __get__(:theme)[:logger]
-        styles = theme[level] || theme[level = :unknown]
+        styles = theme[level = log_sym(level)] || theme[level = :unknown]
         case (ret = +level.to_s.upcase)
         when 'WARN', 'ERROR', 'FATAL'
           ret += '!'
@@ -163,26 +165,56 @@ module Squared
         color ? sub_style(ret, *styles) : ret
       end
 
-      def log_message(level, *args, subject: nil, hint: nil, color: true)
-        msg = [log_title(level, color: color)]
-        msg << (color ? sub_style(subject, :underline) : subject) if subject
-        message(msg.join(' '), *args, hint: hint)
+      def log_message(level, *args, subject: nil, hint: nil, color: ARG[:COLOR])
+        args = args.map(&:to_s)
+        if args.size > 1
+          title = log_title(level, color: false)
+          sub = { pat: /^(#{title})(.+)$/, styles: __get__(:theme)[:logger][log_sym(level)] } if color
+          emphasize(args, title: title + (subject ? " #{subject}" : ''), sub: sub)
+        else
+          msg = [log_title(level, color: color)]
+          if subject
+            msg << (color ? sub_style(subject, :underline) : subject)
+          else
+            msg += args
+            args.clear
+          end
+          message(msg.join(' '), *args, hint: hint)
+        end
       end
 
-      def raise_error(*args, hint: nil, kind: ArgumentError)
-        raise kind, message(*args, hint: hint)
+      def puts_oe(*args, pipe: 1)
+        if pipe.is_a?(::Pathname)
+          begin
+            File.open(pipe, 'a') do |f|
+              br = File::SEPARATOR == '\\' ? "\r\n" : "\n"
+              args.flatten.each { |val| f.write("#{strip_style(val.chomp)}#{br}") }
+            end
+            return
+          rescue StandardError
+            pipe = 2
+          end
+        end
+        (pipe == 2 ? $stderr : $stdout).puts(*args)
       end
 
       module_function
 
-      def emphasize(val, title: nil, cols: nil, sub: nil, pipe: nil)
+      def message(*args, hint: nil, empty: false)
+        (empty ? args.reject { |val| val.nil? || val.empty? } : args).join(ARG[:SPACE]) + (hint ? " (#{hint})" : '')
+      end
+
+      def emphasize(val, title: nil, footer: nil, cols: nil, sub: nil, border: nil, pipe: nil)
         n = 0
-        if title
-          title = title.to_s
-          n = title.size
+        set = lambda do |l|
+          ret = as_a(l, :to_s)
+          n = ret.max_by(&:size).size
+          ret
         end
+        title = set.(title) if title
+        footer = set.(footer) if footer
         if val.is_a?(::Array)
-          lines = val
+          lines = val.map(&:to_s)
         else
           lines = val.to_s.lines.map(&:chomp)
           lines[0] = "#{val.class}: #{lines.first}" if (err = val.is_a?(::StandardError))
@@ -194,24 +226,50 @@ module Squared
         end
         out = []
         bord = '-' * (n + 4)
+        bord = sub_style(bord, styles: border) if border
         sub = [sub] if sub && !sub.is_a?(::Array)
         pr = lambda do |line|
           s = line.ljust(n)
           sub&.each { |h| s = sub_style(s, **h) }
-          "| #{s} |"
+          s = "| #{s} |"
+          if border
+            s = sub_style(s, pat: /^(\|)(.+)$/m, styles: border)
+            s = sub_style(s, pat: /^(.+)(\|)$/m, styles: border, index: 2)
+          end
+          s
         end
         out << bord
-        out << pr.(title) << bord if title
+        if title
+          out += title.map { |t| pr.(t) }
+          out << bord
+        end
         lines.each { |line| out << pr.(line) }
         out << bord
+        out += footer if footer
         if block_given?
           yield out
-        elsif pipe.respond_to?(:puts)
+        elsif pipe
+          case pipe
+          when 0
+            pipe = $stdin
+          when 2
+            pipe = $stderr
+          else
+            pipe = $stdout unless pipe.respond_to?(:puts)
+          end
           pipe.puts out
         else
           err ? warn(out) : puts(out)
         end
       end
+
+      def strip_style(val)
+        val.gsub(/\x1B\[(\d+;?)+m/, '')
+      end
+
+      def raise_error(*args, hint: nil, kind: ArgumentError)
+        raise kind, message(*args, hint: hint, empty: true)
+      end
     end
   end
 end

data/lib/squared/common/prompt.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+require 'readline'
+
+module Squared
+  module Common
+    module Prompt
+      module_function
+
+      def confirm(msg, default = nil, agree: 'Y', cancel: 'N', attempts: 5, timeout: 15)
+        require 'timeout'
+        agree = /^#{agree}$/i if agree.is_a?(::String)
+        cancel = /^#{cancel}$/i if cancel.is_a?(::String)
+        Timeout.timeout(timeout) do
+          begin
+            while (ch = Readline.readline(msg, true))
+              ch = ch.chomp
+              ch = default if ch.empty?
+              case ch
+              when agree
+                return true
+              when cancel
+                return false
+              end
+              attempts -= 1
+              exit 1 unless attempts >= 0
+            end
+          rescue Interrupt
+            puts
+            exit 0
+          else
+            false
+          end
+        end
+      end
+    end
+  end
+end