lorj 1.0.9 → 1.0.10

data/lorj-spec/process/mock_process.rb

@@ -0,0 +1,48 @@
+# encoding: UTF-8
+
+# (c) Copyright 2014 Hewlett-Packard Development Company, L.P.
+#
+#    Licensed under the Apache License, Version 2.0 (the "License");
+#    you may not use this file except in compliance with the License.
+#    You may obtain a copy of the License at
+#
+#        http://www.apache.org/licenses/LICENSE-2.0
+#
+#    Unless required by applicable law or agreed to in writing, software
+#    distributed under the License is distributed on an "AS IS" BASIS,
+#    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#    See the License for the specific language governing permissions and
+#    limitations under the License.
+
+# Students process
+class StudentsProcess
+  def create_student(sObjectType, hParams)
+    PrcLib.state(format("Running creation process for object '%s' = '%s'",
+                        sObjectType, hParams[:student_name]))
+    #  byebug if ENV['BYEBUG'] # rubocop: disable Debugger
+    object = controller_create(sObjectType)
+    PrcLib.runtime_fail "Student '%s' not created.",
+                        hParams[:student_name] if object.nil?
+    PrcLib.info("'%s': '%s' created with id %s",
+                sObjectType, hParams[:student_name], object[:id])
+    object
+  end
+end
+
+# Declaring your data model and handlers.
+class Lorj::BaseDefinition # rubocop: disable Style/ClassAndModuleChildren
+  # We need to define the student object and the handler to use while we need to
+  # create it.
+  define_obj(:student,
+             # The function to call in the class Students
+             :create_e => :create_student,
+             # We use predefined call to the controller query
+             :query_e => :controller_query,
+             # We use predefined call to the controller get
+             :get_e => :controller_get,
+             # We use predefined call to the controller delete
+             :delete_e => :controller_delete
+            )
+
+  obj_needs :data, :student_name, :for => [:create_e], :mapping => :name
+end

data/lorj.gemspec

@@ -11,6 +11,7 @@ less_than_two = ruby_conf['MAJOR'].to_i < 2
 Gem::Specification.new do |spec|
   spec.name          = 'lorj'
   spec.version       = Lorj::VERSION
+  spec.date          = Lorj::DATE
   spec.authors       = ['forj team']
   spec.email         = ['forj@forj.io']
   spec.summary       = 'Process Controllers framework system'
@@ -35,10 +36,7 @@ Gem::Specification.new do |spec|
     '--title Lorj - The Process Controllers framework system' << \
     '--main README.md'
 
-  #  spec.add_runtime_dependency 'thor', '~>0.16.0'
-  #  spec.add_runtime_dependency 'nokogiri', '~>1.5.11'
-  #  spec.add_runtime_dependency 'fog', '~>1.19.0'
-  #  spec.add_runtime_dependency 'hpcloud', '~>2.0.9'
+  spec.add_runtime_dependency 'config_layers', '~>0.1.0'
   #  spec.add_runtime_dependency 'git', '>=1.2.7'
   #  spec.add_runtime_dependency 'rbx-require-relative', '~>0.0.7'
   spec.add_runtime_dependency 'highline', '~> 1.6.21'

data/spec/05_lorj_keypath_spec.rb

@@ -0,0 +1,78 @@
+#!/usr/bin/env ruby
+# encoding: UTF-8
+
+# (c) Copyright 2014 Hewlett-Packard Development Company, L.P.
+#
+#    Licensed under the Apache License, Version 2.0 (the "License");
+#    you may not use this file except in compliance with the License.
+#    You may obtain a copy of the License at
+#
+#        http://www.apache.org/licenses/LICENSE-2.0
+#
+#    Unless required by applicable law or agreed to in writing, software
+#    distributed under the License is distributed on an "AS IS" BASIS,
+#    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#    See the License for the specific language governing permissions and
+#    limitations under the License.
+
+# require 'byebug'
+
+$LOAD_PATH << File.join(File.dirname(__FILE__), '..', 'lib/core')
+
+require 'lorj_keypath'
+
+describe 'Lorj::KeyPath,' do
+  context 'initialize with :test' do
+    before(:all) do
+      @o_key = Lorj::KeyPath.new(:test)
+    end
+    it 'Test method #to_s' do
+      expect(@o_key.to_s).to eq('test')
+    end
+    it 'Test method #key' do
+      expect(@o_key.key).to eq(:test)
+    end
+    it 'Test method #key(0)' do
+      expect(@o_key.key(0)).to eq(:test)
+    end
+    it 'Test method #key(1)' do
+      expect(@o_key.key(1)).to eq(nil)
+    end
+    it 'Test method #fpath' do
+      expect(@o_key.fpath).to eq(':test')
+    end
+    it 'Test method #tree' do
+      expect(@o_key.key).to eq(:test)
+    end
+    it 'Test method #key_tree' do
+      expect(@o_key.key).to eq(:test)
+    end
+  end
+
+  context 'initialize with [:test,:test2,:test3]' do
+    before(:all) do
+      @o_key = Lorj::KeyPath.new([:test, :test2, :test3])
+    end
+    it 'Test method #to_s' do
+      expect(@o_key.to_s).to eq('test/test2/test3')
+    end
+    it 'Test method #key' do
+      expect(@o_key.key).to eq(:test3)
+    end
+    it 'Test method #key(0)' do
+      expect(@o_key.key(0)).to eq(:test)
+    end
+    it 'Test method #key(1)' do
+      expect(@o_key.key(1)).to eq(:test2)
+    end
+    it 'Test method #fpath' do
+      expect(@o_key.fpath).to eq(':test/:test2/:test3')
+    end
+    it 'Test method #tree' do
+      expect(@o_key.tree).to eq([:test, :test2, :test3])
+    end
+    it 'Test method #key_tree' do
+      expect(@o_key.key_tree).to eq(':test/:test2/:test3')
+    end
+  end
+end

data/spec/20_lorj_meta_spec.rb

@@ -237,7 +237,7 @@ YAMLDOC
        'returns :option1 => :value1' do
       expect(@metadata.where?(:any, :kind_of, :data1, :option1)).to equal(false)
       expect(@metadata.set(:any, :kind_of, :data1, :option1 => :value1
-                           )).to eq(:option1 => :value1)
+                          )).to eq(:option1 => :value1)
       expect(@metadata.where?(:any, :kind_of, :data1,
                               :option1)).to eq(['controller'])
     end

data/spec/21_lorj_processes_spec.rb

@@ -0,0 +1,115 @@
+#!/usr/bin/env ruby
+# encoding: UTF-8
+
+# (c) Copyright 2014 Hewlett-Packard Development Company, L.P.
+#
+#    Licensed under the Apache License, Version 2.0 (the "License");
+#    you may not use this file except in compliance with the License.
+#    You may obtain a copy of the License at
+#
+#        http://www.apache.org/licenses/LICENSE-2.0
+#
+#    Unless required by applicable law or agreed to in writing, software
+#    distributed under the License is distributed on an "AS IS" BASIS,
+#    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#    See the License for the specific language governing permissions and
+#    limitations under the License.
+
+# require 'rubygems'
+#  require 'byebug'
+#  require 'debugger'
+# require 'bundler/setup'
+
+app_path = File.dirname(__FILE__)
+
+$LOAD_PATH << File.join(app_path, '..', 'lib')
+
+require 'lorj' # Load lorj framework
+
+describe 'Lorj::Process,' do
+  context 'with mock initialized,' do
+    before(:all) do
+      @lorj_spec = 'lorj-spec'
+      @process_path = File.expand_path(File.join(app_path, '..', @lorj_spec))
+    end
+
+    it 'default initialization is ok' do
+      process_file = File.join(@process_path, 'process', 'mock_process.rb')
+      controllers = { 'mock' => File.join(@process_path, 'controllers',
+                                          'mock', 'mock.rb') }
+      default = File.join(@process_path, 'defaults.yaml')
+      data = File.join(@process_path, 'data.yaml')
+      process_data = Lorj::ProcessResource.new('mock', File.join(app_path,
+                                                                 '..',
+                                                                 @lorj_spec))
+      expect(process_data).to be
+      expect(process_data.name).to eq('mock')
+      expect(process_data.process).to eq(process_file)
+      expect(process_data.controllers).to eq(controllers)
+      expect(process_data.defaults_file).to eq(default)
+      expect(process_data.data_file).to eq(data)
+    end
+
+    it 'reports missing elements not set' do
+      process_data = Lorj::ProcessResource.new('mock', app_path)
+      expect(process_data).to be
+      expect(process_data.name).to equal(nil)
+      expect(process_data.process).to equal(nil)
+      expect(process_data.controllers).to equal(nil)
+      expect(process_data.defaults_file).to equal(nil)
+      expect(process_data.data_file).to equal(nil)
+    end
+
+    it 'accepts symbol as name, but converted.' do
+      process_file = File.join(@process_path, 'process', 'mock_process.rb')
+      controllers = { 'mock' => File.join(@process_path, 'controllers',
+                                          'mock', 'mock.rb') }
+      default = File.join(@process_path, 'defaults.yaml')
+      data = File.join(@process_path, 'data.yaml')
+      process_data = Lorj::ProcessResource.new(:mock, File.join(app_path, '..',
+                                                                @lorj_spec))
+      expect(process_data).to be
+      expect(process_data.name).to eq('mock')
+      expect(process_data.process).to eq(process_file)
+      expect(process_data.controllers).to eq(controllers)
+      expect(process_data.defaults_file).to eq(default)
+      expect(process_data.data_file).to eq(data)
+    end
+
+    it 'initialization with :controllers_dir is ok' do
+      process_file = File.join(@process_path, 'process', 'mock_process.rb')
+      controllers = { 'mock2' => File.join(@process_path, 'providers',
+                                           'mock2', 'mock2.rb') }
+      default = File.join(@process_path, 'defaults.yaml')
+      data = File.join(@process_path, 'data.yaml')
+      process_data = Lorj::ProcessResource.new('mock', @process_path,
+                                               :controllers_dir => 'providers')
+      expect(process_data).to be
+      expect(process_data.name).to eq('mock')
+      expect(process_data.process).to eq(process_file)
+      expect(process_data.controllers).to eq(controllers)
+      expect(process_data.defaults_file).to eq(default)
+      expect(process_data.data_file).to eq(data)
+    end
+
+    it 'can declare a module process' do
+      expect(Lorj.declare_process('mock', @process_path)).to be
+    end
+
+    it 'kept module in Lorj.processes' do
+      expect(Lorj.processes.key?('mock')).to equal(true)
+      expect(Lorj.processes['mock'].class).to equal(Lorj::ProcessResource)
+    end
+
+    it 'can declare several module processes' do
+      expect(Lorj.declare_process('mock', @process_path)).to be
+      expect(Lorj.declare_process(:mock2, @process_path)).to be
+      expect(Lorj.declare_process('mock3', @process_path)).to equal(nil)
+    end
+
+    it 'all kept module processes in Lorj.processes not duplicated.' do
+      expect(Lorj.processes.length).to eq(2)
+      expect(Lorj.processes.keys).to eq(%w(mock mock2))
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lorj
 version: !ruby/object:Gem::Version
-  version: 1.0.9
+  version: 1.0.10
 platform: ruby
 authors:
 - forj team
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-04-02 00:00:00.000000000 Z
+date: 2015-04-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -80,6 +80,20 @@ dependencies:
     - - '>='
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: config_layers
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.1.0
 - !ruby/object:Gem::Dependency
   name: highline
   requirement: !ruby/object:Gem::Requirement
@@ -134,6 +148,7 @@ extra_rdoc_files: []
 files:
 - .gitignore
 - .gitreview
+- .rspec
 - .rubocop.yml
 - Gemfile
 - LICENSE.txt
@@ -187,23 +202,7 @@ files:
 - lib/core/lorj_baseprocess.rb
 - lib/core/lorj_data.rb
 - lib/core/lorj_keypath.rb
-- lib/core_process/cloud/process/common.rb
-- lib/core_process/cloud/process/connection.rb
-- lib/core_process/cloud/process/external_network.rb
-- lib/core_process/cloud/process/flavor.rb
-- lib/core_process/cloud/process/images.rb
-- lib/core_process/cloud/process/internet_network.rb
-- lib/core_process/cloud/process/internet_server.rb
-- lib/core_process/cloud/process/keypairs.rb
-- lib/core_process/cloud/process/network.rb
-- lib/core_process/cloud/process/public_ip.rb
-- lib/core_process/cloud/process/router.rb
-- lib/core_process/cloud/process/rules.rb
-- lib/core_process/cloud/process/security_groups.rb
-- lib/core_process/cloud/process/server.rb
-- lib/core_process/cloud/process/server_log.rb
-- lib/core_process/cloud/process/subnetwork.rb
-- lib/core_process/cloud_process.rb
+- lib/core/process.rb
 - lib/img/.directory
 - lib/img/account_data_access.png
 - lib/img/config_data_access.png
@@ -217,37 +216,25 @@ files:
 - lib/lorj_meta.rb
 - lib/overview.md
 - lib/prc.rb
-- lib/prc_base_config.rb
-- lib/prc_core_config.rb
-- lib/prc_section_config.rb
-- lib/providers/hpcloud/compute.rb
-- lib/providers/hpcloud/hpcloud.rb
-- lib/providers/hpcloud/network.rb
-- lib/providers/hpcloud/security_groups.rb
 - lib/providers/mock/mock.rb
-- lib/providers/openstack/openstack.rb
-- lib/providers/openstack/openstack_create.rb
-- lib/providers/openstack/openstack_delete.rb
-- lib/providers/openstack/openstack_get.rb
-- lib/providers/openstack/openstack_process.rb
-- lib/providers/openstack/openstack_query.rb
-- lib/providers/openstack/openstack_update.rb
 - lib/providers/templates/compute.rb
 - lib/providers/templates/mycloud.rb
 - lib/providers/templates/network.rb
-- lib/rh.rb
+- lorj-spec/controllers/mock/mock.rb
+- lorj-spec/data.yaml
 - lorj-spec/defaults.yaml
+- lorj-spec/process/mock2_process.rb
+- lorj-spec/process/mock_process.rb
+- lorj-spec/providers/mock2/mock2.rb
 - lorj.gemspec
-- spec/01_hash_rh_spec.rb
-- spec/02_prc_base_config_spec.rb
-- spec/03_prc_section_config_spec.rb
-- spec/04_prc_core_config_spec.rb
+- spec/05_lorj_keypath_spec.rb
 - spec/09_prc_spec.rb
 - spec/10_lorj_log_spec.rb
 - spec/11_lorj_defaults_spec.rb
 - spec/12_lorj_config_spec.rb
 - spec/13_lorj_account_spec.rb
 - spec/20_lorj_meta_spec.rb
+- spec/21_lorj_processes_spec.rb
 homepage: https://github.com/forj-oss/lorj
 licenses:
 - Apache License, Version 2.0.
@@ -275,14 +262,12 @@ signing_key:
 specification_version: 4
 summary: Process Controllers framework system
 test_files:
-- spec/01_hash_rh_spec.rb
-- spec/02_prc_base_config_spec.rb
-- spec/03_prc_section_config_spec.rb
-- spec/04_prc_core_config_spec.rb
+- spec/05_lorj_keypath_spec.rb
 - spec/09_prc_spec.rb
 - spec/10_lorj_log_spec.rb
 - spec/11_lorj_defaults_spec.rb
 - spec/12_lorj_config_spec.rb
 - spec/13_lorj_account_spec.rb
 - spec/20_lorj_meta_spec.rb
+- spec/21_lorj_processes_spec.rb
 has_rdoc: 

data/lib/core_process/cloud/process/common.rb

@@ -1,60 +0,0 @@
-#!/usr/bin/env ruby
-# encoding: UTF-8
-
-# (c) Copyright 2014 Hewlett-Packard Development Company, L.P.
-#
-#    Licensed under the Apache License, Version 2.0 (the "License");
-#    you may not use this file except in compliance with the License.
-#    You may obtain a copy of the License at
-#
-#        http://www.apache.org/licenses/LICENSE-2.0
-#
-#    Unless required by applicable law or agreed to in writing, software
-#    distributed under the License is distributed on an "AS IS" BASIS,
-#    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-#    See the License for the specific language governing permissions and
-#    limitations under the License.
-
-# It requires Core objects to be defined + default ForjProcess functions.
-
-# Common definition
-class Lorj::BaseDefinition # rubocop: disable Style/ClassAndModuleChildren
-  # All objects used by this process are built from a Controller
-  process_default :use_controller => true
-end
-
-# Class to manage retry on errors before failing
-class SSLErrorMgt
-  def initialize(iMaxRetry = 5)
-    @retry = 0
-    @max_retry = iMaxRetry
-  end
-
-  def wait(message, issue = nil)
-    if @retry < @max_retry
-      sleep(2)
-      @retry += 1
-      if PrcLib.level == 0
-        msg = format('%s/%s try... ', @retry, @max_retry)
-        msg += issue unless issue.nil?
-        print msg
-      end
-      return false
-    else
-      PrcLib.error('Too many retry. %s', message)
-      return true
-    end
-  end
-
-  def error_detected(message, backtrace, e)
-    if message.match('SSLv2/v3 read server hello A: unknown protocol')
-      return wait(message, "'unknown protocol' SSL Error")
-    elsif e.is_a?(Excon::Errors::InternalServerError)
-      return wait(message, ANSI.red(e.class))
-    else
-      PrcLib.error("Exception %s: %s\n%s", e.class, message,
-                   backtrace.join("\n"))
-      return true
-    end
-  end
-end

data/lib/core_process/cloud/process/connection.rb

@@ -1,92 +0,0 @@
-#!/usr/bin/env ruby
-# encoding: UTF-8
-
-# (c) Copyright 2014 Hewlett-Packard Development Company, L.P.
-#
-#    Licensed under the Apache License, Version 2.0 (the "License");
-#    you may not use this file except in compliance with the License.
-#    You may obtain a copy of the License at
-#
-#        http://www.apache.org/licenses/LICENSE-2.0
-#
-#    Unless required by applicable law or agreed to in writing, software
-#    distributed under the License is distributed on an "AS IS" BASIS,
-#    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-#    See the License for the specific language governing permissions and
-#    limitations under the License.
-
-# It requires Core objects to be defined + default ForjProcess functions.
-
-# rubocop: disable Style/ClassAndModuleChildren
-
-# Connection process code
-class CloudProcess
-  def connect(sCloudObj, hParams)
-    ssl_error_obj = SSLErrorMgt.new # Retry object
-    PrcLib.debug("%s:%s Connecting to '%s' "\
-                 "- Project '%s'",
-                 self.class, sCloudObj, config[:provider], hParams[:tenant])
-    begin
-      controller_connect(sCloudObj)
-   rescue => e
-     retry unless ssl_error_obj.error_detected(e.message, e.backtrace, e)
-
-     PrcLib.error('%s:%s: Unable to connect.\n%s',
-                  self.class, sCloudObj, e.message)
-     nil
-    end
-  end
-end
-
-# Define services model
-class Lorj::BaseDefinition
-  # predefined list of objects.
-  # Links between objects is not predefined. To do it, use needs declaration
-  # in your provider class.
-
-  # object to get list of services
-  # Defines Process handler to call
-  define_obj(:services,
-
-             :create_e => :connect
-             )
-  obj_needs :data, :auth_uri
-  obj_needs :data, :account_id
-  obj_needs :data, :account_key
-  obj_needs :data, :tenant
-
-  undefine_attribute :id    # Do not return any predefined ID
-  undefine_attribute :name  # Do not return any predefined NAME
-end
-
-# compute_connection
-class Lorj::BaseDefinition
-  define_obj(:compute_connection,
-
-             :create_e => :connect # Will call ForjProcess connect
-             )
-  obj_needs :data, :account_id
-  obj_needs :data, :account_key
-  obj_needs :data, :auth_uri
-  obj_needs :data, :tenant
-  obj_needs :data, :compute
-
-  undefine_attribute :id    # Do not return any predefined ID
-  undefine_attribute :name  # Do not return any predefined NAME
-end
-
-# network_connection
-class Lorj::BaseDefinition
-  define_obj(:network_connection,
-
-             :create_e => :connect
-             )
-  obj_needs :data, :account_id
-  obj_needs :data, :account_key
-  obj_needs :data, :auth_uri
-  obj_needs :data, :tenant
-  obj_needs :data, :network
-
-  undefine_attribute :id    # Do not return any predefined ID
-  undefine_attribute :name  # Do not return any predefined NAME
-end

data/lib/core_process/cloud/process/external_network.rb

@@ -1,90 +0,0 @@
-# encoding: UTF-8
-
-# (c) Copyright 2014 Hewlett-Packard Development Company, L.P.
-#
-#    Licensed under the Apache License, Version 2.0 (the "License");
-#    you may not use this file except in compliance with the License.
-#    You may obtain a copy of the License at
-#
-#        http://www.apache.org/licenses/LICENSE-2.0
-#
-#    Unless required by applicable law or agreed to in writing, software
-#    distributed under the License is distributed on an "AS IS" BASIS,
-#    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-#    See the License for the specific language governing permissions and
-#    limitations under the License.
-
-# It requires Core objects to be defined + default ForjProcess functions.
-
-# rubocop: disable Style/ClassAndModuleChildren
-
-# External network process attached to a network
-class CloudProcess
-  def forj_get_or_create_ext_net(sCloudObj, hParams)
-    PrcLib.state("Checking router '%s' gateway", hParams[:router, :name])
-
-    router_obj = hParams[:router]
-    router_name = hParams[:router, :name]
-    network_id = hParams[:router, :gateway_network_id]
-    if network_id
-      external_network = forj_query_external_network(sCloudObj,
-                                                     { :id => network_id },
-                                                     hParams)
-      PrcLib.info("Router '%s' is attached to the "\
-                  "external gateway '%s'.", router_name,
-                  external_network[:name])
-    else
-      PrcLib.info("Router '%s' needs to be attached to an "\
-                  'external gateway.', router_name)
-      PrcLib.state('Attaching')
-      external_network = forj_query_external_network(:network, {}, hParams)
-      if !external_network.empty?
-        router_obj[:gateway_network_id] = external_network[:id]
-        controller_update(:router, router_obj)
-        PrcLib.info("Router '%s' attached to the "\
-                    "external network '%s'.",
-                    router_name, external_network[:name])
-      else
-        PrcLib.fatal(1, "Unable to attach router '%s' to an external gateway. "\
-                        'Required for boxes to get internet access. ',
-                     get_data(:router, :name))
-      end
-    end
-
-    # Need to keep the :network object as :external_network object type.
-    external_network.type = sCloudObj
-    external_network
-  end
-
-  def forj_query_external_network(_sCloudObj, sQuery, _hParams)
-    PrcLib.state('Identifying External gateway')
-    begin
-      # Searching for external network
-      query = sQuery.merge(:external => true)
-      info = {
-        :notfound => 'No external network found',
-        :checkmatch => 'Found 1 %s. Checking if it is an %s.',
-        :nomatch => 'No %s identified as %s match',
-        :found => "Found external %s '%s'.",
-        :more => 'Found several %s. Searching for the first one to be an %s.'
-      }
-      networks = query_single(:network, query, 'external network', info)
-      return Lorj::Data.new if networks.length == 0
-      networks[0]
-    rescue => e
-      PrcLib.error("%s\n%s", e.message, e.backtrace.join("\n"))
-    end
-  end
-end
-
-# Identify an external network thanks to the network router.
-class Lorj::BaseDefinition
-  define_obj(:external_network,
-
-             :create_e => :forj_get_or_create_ext_net,
-             :query_e => :forj_query_external_network
-             )
-
-  obj_needs :CloudObject,  :network_connection
-  obj_needs :CloudObject,  :router
-end