utter 1.0.16 → 1.0.17

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f602925ee178d67614c4be296fd44ce8d8b62ef8
-  data.tar.gz: 878ecdeee5f15f4a5cce617c11ff1356579f0753
+  metadata.gz: 398a52ed88f6a2b25b9fff85a438ee5de95cac77
+  data.tar.gz: db5180facb8db0e1e4a7db1c1957665bd7a7dd62
 SHA512:
-  metadata.gz: cb37da6ef392bb5bac9860b262e08fd8fbaefc7cd920063d9e124247b578f031708c0c79e69414cb0ebaa799e7c2f9acfe0ab409b070d7c82c80f21ed55117d4
-  data.tar.gz: 8ded5375888d16603f03c8033b562319bddf558940d39b9e398647f5a8b1f847786e239528dfda135f2e101922cb7de5b1c29b52ab644cd489ce3467916e75fa
+  metadata.gz: da4e45f8a6050d4fe9f11085b2f7d99ae49aa69db335e7f3f902652f9842e9bded4b19ff10b68c84ae63b2d0f48da9af63a458f5aae89b64be0a0328b79f6742
+  data.tar.gz: a7116ac6c01dfc5d80906d53166ca80e3601acd01406ddd662471bf0126d8bc1260026841cb6209e429051bc2ba71048046fa98051c3a128c728ddcb95f05c60

data/README.md

@@ -4,10 +4,14 @@ Utter is a Domain-specific Microservices Framework written in Ruby for building
 
 irc: #utter@freenode.net
 
+FAQ: Why Utter Services can NOT talk to each other?
+================================================
+Utter services are designed to be part of your versioned API, each service handles its own logging and provides its own monitoring mechanism.
+if you found yourself needing to stack\interface to each others then the Utter suggestion is to revise your architecutral design, as this is where the problem should be addressed and solved, inorder to keep your implmentation "fuck'n Simple", that is the utter way for doing microservices.
+
 What is a Domain-specific Microservice?
 ========================================
 
-
 A domain is an area of knowledge such as an industry field or a subject of interest.
 Building an application often requires the utilization of knowledge from a number of different domains. 
 Designing your "Application" on the premise that any authorized entity can utilize the knowledge of a specific domain via interacting with a domain-specific microservice that can do two things, consume messeges and produce messeges.

data/{lib → bin}/generators/container.rb

@@ -9,13 +9,17 @@ module Utter
       desc 'Generate an utter project skleton'
       def create_container params={}
 	path = params[:path]
+	module_name = params[:module_name]
+	api_version = params[:api_version]
+	service_name = params[:service_name]
 
 	# config.ru
 	@file = <<-FOO
-Dir[File.dirname(__FILE__) + '/microservice/**/*.rb'].each {|file| require file }
-Dir[File.dirname(__FILE__) + '/domain/**/*.rb'].each {|file| require file }
+require 'utter'
+Dir[File.dirname(__FILE__) + '/microservice/**/*.rb'].each {|file| require_relative file }
+Dir[File.dirname(__FILE__) + '/domain/**/*.rb'].each {|file| require_relative file }
 map "/" do
-  run Sonopace::API::Status
+  run #{module_name.capitalize}::#{api_version.capitalize}::#{service_name.capitalize}
 end
 	FOO
 	create_file "#{path}/config.ru"

data/{lib → bin}/generators/microservice.rb

@@ -12,14 +12,33 @@ module Utter
 
       desc 'Generate an utter microservice directory structure'
       def create_microservice params={}
-	path = params[:path]
+	path 		= params[:path]
+	module_name 	= params[:module_name]
+	api_version 	= params[:api_version]
+	service_name 	= params[:service_name]
+
 	empty_directory "#{path}/microservice"
 	empty_directory "#{path}/microservice/lib"
 	empty_directory "#{path}/microservice/lib/internals"
 	# microservice/lib/main.rb 
 	create_file  	"#{path}/microservice/lib/main.rb"
 	@file = <<-FOO
-#main.rb
+require 'json'
+module #{module_name.capitalize}
+  module #{api_version.capitalize}
+    class #{service_name.capitalize} < Utter::Microservice 
+      \$log.info("mounting \#{self}")
+      get '/' do
+	domain_stack = Utter::Stack.new do  
+	  #use MyDomainExtension, "data message"
+	end
+        \$log.info(domain_stack.to_s)
+	{"status": "running"}.to_json
+      end 
+      #run! if app_file == $0
+    end 
+  end 
+end
 	FOO
 	append_to_file "#{path}/microservice/lib/main.rb", @file
 

data/{lib → bin}/generators/tips.rb

@@ -144,10 +144,13 @@ module Utter
 
       when :utter_banner 
 	extend Thor::Shell
-	utter_title   = set_color " Utter ", :red, :on_white, :bold
-	utter_version = set_color Utter::VERSION + " ", :black, :on_white, :bold
-	say(utter_title + utter_version )
-	say("visit #utter @freenode.net for direct support")
+	utter_title		= set_color(" Utter ", :red, :on_white, :bold)
+	utter_version 		= set_color(Utter::VERSION + " | ", :black, :on_white, :bold)
+	#say(utter_title + utter_version )
+
+	irc		   	= set_color("", :green, :on_white, :bold)
+	irc_url 		= set_color("#utter @freenode.net" + " ", :green, :on_white, :bold)
+	say(utter_title + utter_version + irc + irc_url)
 
 	return # back to the calling routine	
 

data/bin/utter

@@ -2,11 +2,11 @@
 
 require "thor"
 require_relative './../lib/utter'
-require_relative './../lib/generators/tips'
-require_relative './../lib/generators/container'
-require_relative './../lib/generators/microservice'
-require_relative './../lib/generators/domain'
-require_relative './../lib/generators/extension'
+require_relative './generators/tips'
+require_relative './generators/container'
+require_relative './generators/microservice'
+require_relative './generators/domain'
+require_relative './generators/extension'
 
 module Utter
   #This directory contains common microservice templates
@@ -50,17 +50,17 @@ module Utter
 	  message = " e.g. api.github.com/v1/repos "
 	  puts (info + message)
 
-	  project_name = ask(set_color("Organization/Project Name, e.g. 'github': ", :bold)).downcase
-	  api_version = ask(set_color("API Version, e.g. 'v1': ",:bold)).downcase
-	  service_name = ask(set_color("Microservice Name, e.g. 'repos': ", :bold)).downcase
-	  #domain_name = ask(set_color("Domain Name, e.g. 'scm': ", :bold))
+	  module_name 	= ask(set_color("Organization/Project Name, e.g. 'github': ", :bold)).downcase
+	  api_version 	= ask(set_color("API Version, e.g. 'v1': ",:bold)).downcase
+	  service_name 	= ask(set_color("Microservice Name, e.g. 'repos': ", :bold)).downcase
+	  #domain_name 	= ask(set_color("Domain Name, e.g. 'scm': ", :bold))
 
 	  seprator
 
-	  path  = "./#{project_name}::#{api_version}::#{service_name}" 
+	  path  = "./#{module_name}::#{api_version}::#{service_name}" 
 
 	  #params = {:path => path, :module_name => project_name, :ext_name => service_name, :domain_name => domain_name}
-	  params = {:path => path, :module_name => project_name, :ext_name => service_name}
+	  params = {:path => path, :module_name => module_name, :api_version => api_version, :service_name => service_name}
 
 	 
 	  # Dockerfile
@@ -116,8 +116,14 @@ module Utter
 	  #print_table choices
 	  #selection = ask("Answer:", :green).to_i
 	  #p selection 
+=begin NOTE This should be AVOIDED, as by design services should be constrained from talking to each other, as they together form an API, and only a consumer talk to the API. In other words each service must have its own logging and monitoring mechanism. Once again Sinatra comes handy here.
+	when "monitor" 
+	  #TODO Generates an utter monitoring microservice
+	when "logging" 
+	  #TODO Generates an utter logging microservice
 	when "consumer" 
 	  #TODO Generates an utter consumer domain extension to talk to other services in your domain/lib/ directory
+=end
 	when "sdk" 
 	  #TODO generates an sdk library directory structure e.g. gitlapse SDK
 	else

data/lib/utter.rb

@@ -1,5 +1,6 @@
 require 'logger'
 require 'mushin'
+#require 'json' #TODO need to make all responses json based by default if it is a hash and raise an error if it is not a hash!!
 
 #require_relative "internals/core/store"
 #require_relative "internals/core/auth"
@@ -16,7 +17,7 @@ module Utter
   # MAJOR version when you make incompatible API changes,
   # MINOR version when you add functionality in a backwards-compatible manner, and
   # PATCH version when you make backwards-compatible bug fixes.
-  VERSION = "1.0.16"
+  VERSION = "1.0.17"
 
   $log = Logger.new(STDOUT)
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: utter
 version: !ruby/object:Gem::Version
-  version: 1.0.16
+  version: 1.0.17
 platform: ruby
 authors:
 - zotherstupidguy
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-10-05 00:00:00.000000000 Z
+date: 2016-10-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pry
@@ -334,13 +334,13 @@ files:
 - README.md
 - Rakefile
 - bin/console
+- bin/generators/container.rb
+- bin/generators/domain.rb
+- bin/generators/extension.rb
+- bin/generators/microservice.rb
+- bin/generators/tips.rb
 - bin/setup
 - bin/utter
-- lib/generators/container.rb
-- lib/generators/domain.rb
-- lib/generators/extension.rb
-- lib/generators/microservice.rb
-- lib/generators/tips.rb
 - lib/internals/core/auth.rb
 - lib/internals/core/microservice.rb
 - lib/internals/core/service_discovery.rb