legionio 0.3.1 → 0.3.2

data/docs/_build/html/searchindex.js

@@ -0,0 +1 @@
+Search.setIndex({docnames:["index","overview"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":3,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":2,"sphinx.domains.rst":2,"sphinx.domains.std":1,sphinx:56},filenames:["index.rst","overview.rst"],objects:{},objnames:{},objtypes:{},terms:{"class":0,"function":0,These:0,acknowledg:0,action:0,add:0,ani:0,call:0,can:0,chain:0,cluster:0,complex:0,connect:0,contain:0,content:[],creat:0,delet:0,design:0,exampl:0,extens:0,foobar:[],get:0,incid:0,index:[],input:0,instal:0,legion:0,lex:0,list:0,make:0,merg:0,modul:[],more:0,out:0,output:0,page:[],pagerduti:0,platform:0,project:0,relationship:0,resolv:0,runner:0,search:[],second:[],servic:0,them:0,thi:[],thing:0,think:0,trigger:0,updat:0,user:0,whatev:0,which:0,within:0,without:0,work:0,workflow:0,yaml:0,you:0,your:0},titles:["LegionIO Overview","<no title>"],titleterms:{about:0,document:[],indic:[],legionio:0,overview:0,tabl:[],test3:[],test:[],welcom:[]}})

data/docs/conf.py

@@ -0,0 +1,54 @@
+# Configuration file for the Sphinx documentation builder.
+#
+# This file only contains a selection of the most common options. For a full
+# list see the documentation:
+# https://www.sphinx-doc.org/en/master/usage/configuration.html
+
+# -- Path setup --------------------------------------------------------------
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+#
+# import os
+# import sys
+# sys.path.insert(0, os.path.abspath('.'))
+
+
+# -- Project information -----------------------------------------------------
+
+project = 'LegionIO'
+copyright = '2020, Esity'
+author = 'Esity'
+
+# The full version, including alpha/beta/rc tags
+release = '0.3.1'
+
+
+# -- General configuration ---------------------------------------------------
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = ['recommonmark']
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ['_templates']
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+# This pattern also affects html_static_path and html_extra_path.
+exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
+
+
+# -- Options for HTML output -------------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+#
+html_theme = 'alabaster'
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+html_static_path = ['_static']

data/docs/index.rst

@@ -0,0 +1,28 @@
+.. LegionIO documentation master file, created by
+   sphinx-quickstart on Thu Oct 15 08:16:27 2020.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+LegionIO Overview
+==============================
+
+About
+------------
+LegionIO is a platform designed for connecting things. You install a LEX(Legion Extension)
+which adds functionality to your Legion service?project?cluster? Whatever it's called.
+
+A LEX contains 1 or more runners. Think of them as classes
+A runner contains 1 or more functions. These are the things you can call and make relationships out of
+Example
+
+* Lex: pagerduty
+
+* Runners: incident, user, service
+
+* Functions within the incident runner: trigger, acknowledge, resolve, merge
+
+* Functions within the services runner: create, delete, update, list, get
+
+Any function can be a trigger or an action(the input or output in the relationship).
+
+Legion works by creating chains of relationships to make make a complex workflow without complex yaml

data/docs/make.bat

@@ -0,0 +1,35 @@
+@ECHO OFF
+
+pushd %~dp0
+
+REM Command file for Sphinx documentation
+
+if "%SPHINXBUILD%" == "" (
+	set SPHINXBUILD=sphinx-build
+)
+set SOURCEDIR=.
+set BUILDDIR=_build
+
+if "%1" == "" goto help
+
+%SPHINXBUILD% >NUL 2>NUL
+if errorlevel 9009 (
+	echo.
+	echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
+	echo.installed, then set the SPHINXBUILD environment variable to point
+	echo.to the full path of the 'sphinx-build' executable. Alternatively you
+	echo.may add the Sphinx directory to PATH.
+	echo.
+	echo.If you don't have Sphinx installed, grab it from
+	echo.http://sphinx-doc.org/
+	exit /b 1
+)
+
+%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
+goto end
+
+:help
+%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
+
+:end
+popd

data/exe/legion

@@ -44,7 +44,9 @@ op.on('-v', '--version') { options[:action] = :version }
 op.separator ''
 op.parse!(ARGV)
 
-require File.expand_path('lib/legion.rb') unless options[:action] == :help
-Legion.start
-require File.expand_path('lib/legion/process.rb') unless options[:action] == :help
-Legion::Process.new(options).run!
+unless options[:action] == :help
+  require 'legion'
+  Legion.start
+  require 'legion/process'
+  Legion::Process.new(options).run!
+end

data/lib/legion/extensions.rb

@@ -136,8 +136,7 @@ module Legion
       end
 
       def gem_load(gem_name, name)
-        gem_path = "#{Gem::Specification.find_by_name(gem_name).gem_dir}/lib/legion/extensions/#{name}"
-        require gem_path
+        require "#{Gem::Specification.find_by_name(gem_name).gem_dir}/lib/legion/extensions/#{name}"
         true
       rescue LoadError => e
         Legion::Logging.error e.message
@@ -148,62 +147,6 @@ module Legion
 
       def find_extensions
         @extensions ||= {}
-        # puts Gem.install('lex-esphome')
-        # puts Gem::Installer.new('lex-esphome')
-        # test = Gem::Installer.new('lex-esphome')
-        # puts test.install
-        # puts Gem::Dependency.new('lex-esphome')
-        # $LOAD_PATH << "#{ENV['GEM_HOME']}/gems/lex-esphome-0.1.0/lib"
-        # require 'legion/extensions/esphome'
-        # $LOAD_PATH << "#{ENV['GEM_HOME']}/gems/lex-esphome-0.1.0/lib"
-        # ENV['MY_RUBY_HOME'] #/Users/miverso2/.rvm/rubies/ruby-2.7.0
-        # ENV['GEM_HOME'] # /Users/miverso2/.rvm/gems/ruby-2.7.0
-        # require 'rubygems/dependency_installer.rb'
-        # puts Gem::DependencyInstaller.new.install('lex-esphome')
-        # puts Gem::Installer.new('lex-esphome').install
-        # puts Gem::Installer.new('lex-esphome').ensure_loadable_spec
-        # puts Gem.search('lex-esphome')
-        # Gem.clear_paths
-        # require 'legion/extensions/esphome'
-
-        # puts Gem.use_gemdeps
-        # pp Gem.gemdeps
-        # puts 'gems things'
-        # puts Gem.loaded_specs.key? 'lex-esphome'
-        # pp Gem.loaded_specs.keys
-        #
-        # require 'rubygems'
-        # require 'rubygems/command.rb'
-        # require 'rubygems/dependency_installer.rb'
-        #
-        # Gem::Command.build_args = ARGV
-        # inst = Gem::DependencyInstaller.new
-        # puts inst.installed_gems
-        # puts inst.install 'lex-esphome', install_as_default: true
-        # puts inst.installed_gems
-        # puts '....'
-        # test = Gem::DependencyList.new
-        # test.add(inst)
-        # pp test.find_name('lex-esphome')
-        # pp test.find_name('lex-logger')
-        # pp test.specs
-        # pp Gem::DependencyList.from_specs
-        # pp Gem::DependencyList.from_specs.key? 'lex-logg'
-        # pp inst
-        #
-        # pp Gem.new.all_specs
-        # load 'legion/extensions/esphome.rb'
-        # puts Gem.register_default_spec()
-        #  :use_gemdeps,
-        #  :detect_gemdeps,
-        #  :source_date_epoch,
-        #  :gemdeps,
-        # :register_default_spec,
-        #  :find_unresolved_default_spec,
-        #  :clear_default_specs,
-        # :loaded_specs,
-        # :default_path,
-
         Gem::Specification.all_names.each do |gem|
           next unless gem[0..3] == 'lex-'
 
@@ -212,12 +155,30 @@ module Legion
                                   gem_name:        "lex-#{lex[1]}",
                                   extension_name:  lex[1],
                                   version:         lex[2],
-                                  extension_class: "Legion::Extensions::#{lex[1].capitalize}" }
+                                  extension_class: "Legion::Extensions::#{lex[1].split('_').collect(&:capitalize).join}" }
         end
 
-        # Legion::Settings[:extensions].each do |extension|
-        #   puts extension unless @extensions.key? extension
-        # end
+        Legion::Settings[:extensions].each do |extension, values|
+          next if @extensions.key? extension.to_s
+          next if values[:enabled] == false
+          next if values[:auto_install] == false
+
+          Legion::Logging.warn "#{extension} is missing, attempting to install automatically.."
+          install = Gem.install("lex-#{extension}")
+          Legion::Logging.debug(install)
+          lex = Gem::Specification.find_by_name("lex-#{extension}")
+
+          @extensions[extension.to_s] = {
+            full_gem_name:   "lex-#{extension}-#{lex.version}",
+            gem_name:        "lex-#{extension}",
+            extension_name:  extension.to_s,
+            version:         lex.version,
+            extension_class: "Legion::Extensions::#{extension.to_s.split('_').collect(&:capitalize).join}"
+          }
+
+        rescue StandardError, Gem::MissingSpecError => e
+          Legion::Logging.error "Failed to auto install #{extension}, e: #{e.message}"
+        end
       end
     end
   end

data/lib/legion/extensions/builders/runners.rb

@@ -20,6 +20,7 @@ module Legion
             runner_name = file.split('/').last.sub('.rb', '')
             runner_class =  "#{lex_class}::Runners::#{runner_name.split('_').collect(&:capitalize).join}"
             loaded_runner = Kernel.const_get(runner_class)
+
             @runners[runner_name.to_sym] = {
               extension:       lex_class.to_s.downcase,
               extension_name:  extension_name,
@@ -30,6 +31,10 @@ module Legion
               class_methods:   {}
             }
 
+            if settings.key?(:runners) && settings[:runners].key?(runner_name.to_sym)
+              @runners[runner_name.to_sym][:desc] = settings[:runners][runner_name.to_sym][:desc]
+            end
+
             loaded_runner.public_instance_methods(false).each do |runner_method|
               @runners[runner_name.to_sym][:class_methods][runner_method] = {
                 args: loaded_runner.instance_method(runner_method).parameters

data/lib/legion/extensions/helpers/lex.rb

@@ -5,6 +5,34 @@ module Legion
         include Legion::Extensions::Helpers::Core
         include Legion::Extensions::Helpers::Logger
 
+        def function_example(function, example)
+          function_set(function, :example, example)
+        end
+
+        def function_options(function, options)
+          function_set(function, :options, options)
+        end
+
+        def function_desc(function, desc)
+          function_set(function, :desc, desc)
+        end
+
+        def function_set(function, key, value)
+          unless respond_to? function
+            log.debug "function_#{key} called but function doesn't exist, f: #{function}"
+            return nil
+          end
+          settings[:functions] = {} if settings[:functions].nil?
+          settings[:functions][function] = {} if settings[:functions][function].nil?
+          settings[:functions][function][key] = value
+        end
+
+        def runner_desc(desc)
+          settings[:runners] = {} if settings[:runners].nil?
+          settings[:runners][actor_name.to_sym] = {} if settings[:runners][actor_name.to_sym].nil?
+          settings[:runners][actor_name.to_sym][:desc] = desc
+        end
+
         def self.included(base)
           base.send :extend, Legion::Extensions::Helpers::Core if base.instance_of?(Class)
           base.send :extend, Legion::Extensions::Helpers::Logger if base.instance_of?(Class)
@@ -12,7 +40,7 @@ module Legion
         end
 
         def default_settings
-          { logger: { level: 'info' }, workers: 1 }
+          { logger: { level: 'info' }, workers: 1, runners: {}, functions: {} }
         end
       end
     end

data/lib/legion/extensions/transport.rb

@@ -67,15 +67,17 @@ module Legion
       end
 
       def auto_create_dlx_exchange
-        return if transport_class::Exchanges.const_defined? 'Dlx'
+        dlx = if transport_class::Exchanges.const_defined? 'Dlx'
+                transport_class::Exchanges::Dlx
+              else
+                transport_class::Exchanges.const_set('Dlx', Class.new(default_exchange) do
+                  def exchange_name
+                    "#{super}.dlx"
+                  end
+                end)
+              end
 
-        dlx = transport_class::Exchanges.const_set('Dlx', Class.new(default_exchange) do
-          def exchange_name
-            "#{super}.dlx"
-          end
-        end)
         dlx.new
-        dlx
       end
 
       def auto_create_dlx_queue

data/lib/legion/service.rb

@@ -35,10 +35,30 @@ module Legion
       Legion::Data.setup
     end
 
-    def setup_settings
+    # noinspection RubyArgCount
+    def default_paths
+      [
+        '/etc/legionio',
+        "#{Etc.getpwuid.dir}/legionio",
+        "#{ENV['home']}/legionio",
+        '~/legionio',
+        './settings'
+      ]
+    end
+
+    def setup_settings(default_dir = __dir__)
       require 'legion/settings'
-      Legion::Logging.debug('Loading Legion::Settings')
-      Legion::Settings.load(config_dir: './settings')
+      config_directory = default_dir
+
+      default_paths.each do |path|
+        next unless Dir.exist? path
+
+        config_directory = path
+        break
+      end
+
+      Legion::Logging.info "Using directory #{config_directory} for settings"
+      Legion::Settings.load(config_dir: config_directory)
       Legion::Logging.info('Legion::Settings Loaded')
     end
 

data/lib/legion/version.rb

@@ -1,3 +1,3 @@
 module Legion
-  VERSION = '0.3.1'.freeze
+  VERSION = '0.3.2'.freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: legionio
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.3.2
 platform: ruby
 authors:
 - Esity
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-10-14 00:00:00.000000000 Z
+date: 2020-10-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby-ext
@@ -332,6 +332,7 @@ files:
 - ".rubocop.yml"
 - CHANGELOG.md
 - Gemfile
+- Gemfile.lock
 - LICENSE.txt
 - README.md
 - Rakefile
@@ -340,6 +341,37 @@ files:
 - bin/setup
 - bin/test
 - bitbucket-pipelines.yml
+- docs/Makefile
+- docs/_build/doctrees/environment.pickle
+- docs/_build/doctrees/index.doctree
+- docs/_build/doctrees/overview.doctree
+- docs/_build/html/.buildinfo
+- docs/_build/html/_sources/index.rst.txt
+- docs/_build/html/_sources/overview.rst.txt
+- docs/_build/html/_static/alabaster.css
+- docs/_build/html/_static/basic.css
+- docs/_build/html/_static/custom.css
+- docs/_build/html/_static/doctools.js
+- docs/_build/html/_static/documentation_options.js
+- docs/_build/html/_static/file.png
+- docs/_build/html/_static/jquery-3.5.1.js
+- docs/_build/html/_static/jquery.js
+- docs/_build/html/_static/language_data.js
+- docs/_build/html/_static/minus.png
+- docs/_build/html/_static/plus.png
+- docs/_build/html/_static/pygments.css
+- docs/_build/html/_static/searchtools.js
+- docs/_build/html/_static/underscore-1.3.1.js
+- docs/_build/html/_static/underscore.js
+- docs/_build/html/genindex.html
+- docs/_build/html/index.html
+- docs/_build/html/objects.inv
+- docs/_build/html/overview.html
+- docs/_build/html/search.html
+- docs/_build/html/searchindex.js
+- docs/conf.py
+- docs/index.rst
+- docs/make.bat
 - exe/legion
 - legion.gemspec
 - lib/legion.rb
@@ -383,7 +415,6 @@ files:
 - lib/legion/service.rb
 - lib/legion/supervision.rb
 - lib/legion/version.rb
-- settings/client.json
 homepage: https://bitbucket.org/legion-io/legion/
 licenses:
 - MIT

data/settings/client.json

@@ -1,25 +0,0 @@
-{
-  "client": {
-    "keepalive": {
-      "thresholds": {
-        "warning": 10
-      }
-    }
-  },
-  "data": {
-    "connection": {
-      "max_connections": 100,
-      "preconnect": false
-    }
-  },
-  "crypt": {
-    "cluster_secret": "fkljwelkfjwelkfjwelkjfwe",
-    "vault": {
-      "read_cluster_secret": false,
-      "connected": false,
-      "renewer": false,
-      "token": "s.660l1zqqjezPhPLo71tY7dsz",
-      "protocol": "http"
-    }
-  }
-}