flow-lite 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 4af502cc9764efd28671cbd3e4e498c0cc9dbd87
+  data.tar.gz: af96b08715862f411dfb3cdc7a2b87bc8ac4c8e6
+SHA512:
+  metadata.gz: c2edc964d13234f76c67c52989e4ff9e664164a61ba185f472d6f24a6300d1ee87cdc8ec30eb40a88258fd9beb63e133f95e852249b7f0d5b624e17430a86b31
+  data.tar.gz: 90a4af15059474729db047b8ad658c36cfacbcdfd0db1802ec29423d22893806eea0a9beeb371364a05f848ffbf8b82aa15333b32fbf3cfe630d8a73287e7eee

data/CHANGELOG.md

@@ -0,0 +1,4 @@
+### 0.0.1 / 2020-10-23
+
+* Everything is new. First release.
+

data/Manifest.txt

@@ -0,0 +1,7 @@
+CHANGELOG.md
+Manifest.txt
+README.md
+Rakefile
+bin/flow
+lib/flow-lite.rb
+lib/flow-lite/version.rb

data/README.md

@@ -0,0 +1,23 @@
+# flow-lite
+
+flow-lite gem - (yet) another (lite) workflow engine; let's you define your workflow steps in Flowfiles; incl. the flow command line tool
+
+
+* home  :: [github.com/rubycoco/git](https://github.com/rubycoco/git)
+* bugs  :: [github.com/rubycoco/git/issues](https://github.com/rubycoco/git/issues)
+* gem   :: [rubygems.org/gems/flow-lite](https://rubygems.org/gems/flow-lite)
+* rdoc  :: [rubydoc.info/gems/flow-lite](http://rubydoc.info/gems/flow-lite)
+
+
+
+## Usage
+
+To be done
+
+
+
+## License
+
+The `flow-lite` scripts are dedicated to the public domain.
+Use it as you please with no restrictions whatsoever.
+

data/Rakefile

@@ -0,0 +1,31 @@
+require 'hoe'
+require './lib/flow-lite/version.rb'
+
+Hoe.spec 'flow-lite' do
+
+  self.version = FlowLite::VERSION
+
+  self.summary = "flow-lite gem - (yet) another (lite) workflow engine; let's you define your workflow steps in Flowfiles; incl. the flow command line tool"
+  self.description = summary
+
+  self.urls    = { home: 'https://github.com/rubycoco/git' }
+
+  self.author  = 'Gerald Bauer'
+  self.email   = 'ruby-talk@ruby-lang.org'
+
+  # switch extension to .markdown for gihub formatting
+  self.readme_file  = 'README.md'
+  self.history_file = 'CHANGELOG.md'
+
+  self.extra_deps = [
+    ['gitti', '>= 0.6.1' ],
+    ['hubba', '>= 1.0.0' ],
+    ['monos', '>= 0.5.0' ],
+  ]
+
+  self.licenses = ['Public Domain']
+
+  self.spec_extras = {
+   required_ruby_version: '>= 2.2.2'
+  }
+end

data/bin/flow

@@ -0,0 +1,17 @@
+#!/usr/bin/env ruby
+
+###################
+# DEV TIPS:
+#
+# For local testing run like:
+#
+#    ruby -Ilib bin/flow
+#
+# Set the executable bit in Linux. Example:
+#
+#    % chmod a+x bin/flow
+#
+
+require 'flow-lite'
+
+Flow::Tool.main

data/lib/flow-lite.rb

@@ -0,0 +1,142 @@
+require 'pp'
+require 'optparse'
+
+
+
+####################
+# "prelude/prolog" add some 3rd party libs/gems
+# -- our own
+require 'gitti'
+require 'hubba'  ## todo/fix: rename to gitti-api/gitti-apis
+require 'mono'
+# -- some more ???
+
+
+
+#####################
+# our own code
+require 'flow-lite/version'   # note: let version always go first
+
+
+
+module Flow
+class Step
+  attr_reader :names    # e.g. :list or [:list,:ls] etc.
+  attr_reader :block
+
+  def name() @names[0]; end  ## "primary" name
+
+  def initialize( name_or_names, block )
+    @names  =  if name_or_names.is_a?( Array )
+                 name_or_names
+               else
+                 [name_or_names]   ## assume single symbol (name); wrap in array
+               end
+    @names = @names.map {|name| name.to_sym }   ## make sure we always use symbols
+    @block  = block
+  end
+end # class Step
+
+
+
+class Base    ## base class for flow class (auto)-constructed/build from flowfile
+end
+
+
+class Flowfile
+  ## convenience method - use like Flowfile.load_file()
+  def self.load_file( path='./Flowfile' )
+    code = File.open( path, 'r:utf-8' ) { |f| f.read }
+    load( code )
+  end
+
+  ## another convenience method - use like Flowfile.load()
+  def self.load( code )
+    flowfile = new
+    flowfile.instance_eval( code )
+    flowfile
+  end
+
+
+
+  def flow  ## build flow class
+    @flow_class ||= build_flow_class
+    @flow_class.new   ## todo/check: always return a new instance why? why not?
+  end
+
+  def build_flow_class
+    puts "  building flow class..."
+    flowfile = self
+    klass = Class.new( Base ) do
+      flowfile.steps.each_with_index do |step,i|
+        name = step.names[0]
+        puts "    adding step #{i+1}/#{flowfile.steps.size} >#{name}<..."
+        define_method( name, &step.block )
+
+        alt_names = step.names[1..-1]
+        alt_names.each do |alt_name|
+          puts "      adding alias >#{alt_name}< for >#{name}<..."
+          alias_method( alt_name, name )
+        end
+      end
+    end
+    klass
+  end
+
+
+
+  def initialize( opts={} )
+    @opts  = opts
+    @steps = []
+  end
+
+  attr_reader :steps
+
+  ## "classic / basic" primitives - step
+  def step( name, &block )
+    @steps << Step.new( name, block )
+  end
+
+
+  def run( name )
+    name = name.to_sym  ## make sure we always use symbols
+    if flow.respond_to?( name )
+       flow.send( name )
+    else
+      puts "!! ERROR: step definition >#{name}< not found; cannot run/execute - known steps include:"
+      pp @steps
+      exit 1
+    end
+  end
+end # class Flowfile
+
+
+
+class Tool
+  def self.main( args=ARGV )
+    options = {}
+    OptionParser.new do |parser|
+      parser.on( '-f FILENAME', '--flowfile FILENAME' ) do |filename|
+        options[:flowfile] = filename
+      end
+    end.parse!( args )
+
+    path  =  options[:flowfile] || './Flowfile'
+    flowfile = Flowfile.load_file( path )
+
+    ## allow multipe steps getting called - why? why not?
+    ##   flow setup clone update   etc??
+    args.each do |arg|
+      flowfile.run( arg )
+    end
+  end
+end # class Tool
+
+end # module Flow
+
+
+
+# say hello
+puts FlowLite.banner
+
+

data/lib/flow-lite/version.rb

@@ -0,0 +1,20 @@
+module FlowLite
+
+  MAJOR = 0    ## todo: namespace inside version or something - why? why not??
+  MINOR = 0
+  PATCH = 1
+  VERSION = [MAJOR,MINOR,PATCH].join('.')
+
+  def self.version
+    VERSION
+  end
+
+  def self.banner
+    "flow-lite/#{VERSION} on Ruby #{RUBY_VERSION} (#{RUBY_RELEASE_DATE}) [#{RUBY_PLATFORM}]"
+  end
+
+  def self.root
+    File.expand_path( File.dirname(File.dirname(File.dirname(__FILE__))) )
+  end
+
+end # module FlowLite

metadata

@@ -0,0 +1,134 @@
+--- !ruby/object:Gem::Specification
+name: flow-lite
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Gerald Bauer
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2020-10-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: gitti
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.6.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.6.1
+- !ruby/object:Gem::Dependency
+  name: hubba
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+- !ruby/object:Gem::Dependency
+  name: monos
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.5.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.5.0
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7'
+- !ruby/object:Gem::Dependency
+  name: hoe
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.22'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.22'
+description: flow-lite gem - (yet) another (lite) workflow engine; let's you define
+  your workflow steps in Flowfiles; incl. the flow command line tool
+email: ruby-talk@ruby-lang.org
+executables:
+- flow
+extensions: []
+extra_rdoc_files:
+- CHANGELOG.md
+- Manifest.txt
+- README.md
+files:
+- CHANGELOG.md
+- Manifest.txt
+- README.md
+- Rakefile
+- bin/flow
+- lib/flow-lite.rb
+- lib/flow-lite/version.rb
+homepage: https://github.com/rubycoco/git
+licenses:
+- Public Domain
+metadata: {}
+post_install_message: 
+rdoc_options:
+- "--main"
+- README.md
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.2.2
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.2
+signing_key: 
+specification_version: 4
+summary: flow-lite gem - (yet) another (lite) workflow engine; let's you define your
+  workflow steps in Flowfiles; incl. the flow command line tool
+test_files: []