core/component_factory.py

   1 # Copyright 2015-2016 Intel Corporation.
   2 #
   3 # Licensed under the Apache License, Version 2.0 (the "License");
   4 # you may not use this file except in compliance with the License.
   5 # You may obtain a copy of the License at
   6 #
   7 #   http://www.apache.org/licenses/LICENSE-2.0
   8 #
   9 # Unless required by applicable law or agreed to in writing, software
  10 # distributed under the License is distributed on an "AS IS" BASIS,
  11 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12 # See the License for the specific language governing permissions and
  13 # limitations under the License.
  14
  15 """Functions for creating controller objects based on deployment or traffic
  16 """
  17
  18 from core.traffic_controller_rfc2544 import TrafficControllerRFC2544
  19 from core.vswitch_controller_p2p import VswitchControllerP2P
  20 from core.vswitch_controller_pvp import VswitchControllerPVP
  21 from core.vswitch_controller_pvvp import VswitchControllerPVVP
  22 from core.vswitch_controller_op2p import VswitchControllerOP2P
  23 from core.vnf_controller import VnfController
  24 from core.pktfwd_controller import PktFwdController
  25 from tools.load_gen.stress.stress import Stress
  26 from tools.load_gen.stress_ng.stress_ng import StressNg
  27 from tools.load_gen.dummy.dummy import DummyLoadGen
  28
  29
  30 def __init__():
  31     """Finds and loads all the modules required.
  32
  33     Very similar code to load_trafficgens().
  34     """
  35     pass
  36
  37 def create_traffic(traffic_type, trafficgen_class):
  38     """Return a new IVSwitchController for the traffic type.
  39
  40     The returned traffic controller has the given traffic type and traffic
  41     generator class.
  42
  43     traffic_types: 'rfc2544_throughput'
  44
  45     :param traffic_type: Name of traffic type
  46     :param trafficgen_class: Reference to traffic generator class to be used.
  47     :return: A new ITrafficController
  48     """
  49     return TrafficControllerRFC2544(trafficgen_class)
  50
  51
  52 def create_vswitch(deployment_scenario, vswitch_class, traffic):
  53     """Return a new IVSwitchController for the deployment_scenario.
  54
  55     The returned controller is configured with the given vSwitch class.
  56
  57     Deployment scenarios: 'p2p', 'pvp'
  58
  59     :param deployment_scenario: The deployment scenario name
  60     :param vswitch_class: Reference to vSwitch class to be used.
  61     :param traffic: Dictionary with traffic specific details
  62     :return: IVSwitchController for the deployment_scenario
  63     """
  64     deployment_scenario = deployment_scenario.lower()
  65     if deployment_scenario.find("p2p") == 0:
  66         return VswitchControllerP2P(vswitch_class, traffic)
  67     elif deployment_scenario.find("pvp") >= 0:
  68         return VswitchControllerPVP(vswitch_class, traffic)
  69     elif deployment_scenario.find("pvvp") >= 0:
  70         return VswitchControllerPVVP(vswitch_class, traffic)
  71     elif deployment_scenario.find("op2p") >= 0:
  72         return VswitchControllerOP2P(vswitch_class, traffic)
  73
  74 def create_vnf(deployment_scenario, vnf_class):
  75     """Return a new VnfController for the deployment_scenario.
  76
  77     The returned controller is configured with the given VNF class.
  78
  79     Deployment scenarios: 'p2p', 'pvp'
  80
  81     :param deployment_scenario: The deployment scenario name
  82     :param vswitch_class: Reference to vSwitch class to be used.
  83     :return: VnfController for the deployment_scenario
  84     """
  85     return VnfController(deployment_scenario, vnf_class)
  86
  87 def create_collector(collector_class, result_dir, test_name):
  88     """Return a new Collector of the given class
  89
  90     :param collector_class: The collector class to be used.
  91     :param result_dir: Directory with test results
  92     :param test_name: Test to be run
  93     :return: A new CollectorController.
  94     """
  95     return collector_class(result_dir, test_name)
  96
  97 def create_loadgen(loadgen_type, loadgen_cfg):
  98     """Return a new ILoadGenerator for the loadgen type.
  99
 100     The returned load generator has the given loadgen type and loadgen
 101     generator class.
 102
 103     :param loadgen_type: Name of loadgen type
 104     :param loadgen_class: Reference to load generator class to be used.
 105     :return: A new ILoadGenerator class
 106     """
 107     loadgen_type = loadgen_type.lower()
 108     if loadgen_type.find("dummy") >= 0:
 109         return DummyLoadGen(loadgen_cfg)
 110     elif loadgen_type.find("stress-ng") >= 0:
 111         return StressNg(loadgen_cfg)
 112     elif loadgen_type.find("stress") >= 0:
 113         return Stress(loadgen_cfg)
 114
 115 def create_pktfwd(pktfwd_class):
 116     """Return a new packet forwarder controller
 117
 118     The returned controller is configured with the given
 119     packet forwarder class.
 120
 121     :param pktfwd_class: Reference to packet forwarder class to be used.
 122     :return: packet forwarder controller
 123     """
 124     return PktFwdController(pktfwd_class)