Code refactoring - Watcher Decision Engine package

This patchset is there to change the code structure.
The objective is to flatten the project file tree by merging
'api/' and 'framework/' into a single package. This also contains
some tidy ups in package naming (like using only singular nouns).

This should only affect file/folder names and their subsequent
import paths wherever they were used.

Change-Id: Ie903ba20ca5cf03b0b42efa60131d1b919b0c2c9

watcher/decision_engine/solution/base.py

@@ -0,0 +1,62 @@
+# -*- encoding: utf-8 -*-
+# Copyright (c) 2015 b<>com
+#
+# Authors: Jean-Emile DARTOIS <jean-emile.dartois@b-com.com>
+#
+# 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.
+#
+import abc
+import six
+
+
+@six.add_metaclass(abc.ABCMeta)
+class Solution(object):
+    def __init__(self):
+        self._origin = None
+        self._model = None
+        self._efficiency = 0
+
+    @property
+    def efficiency(self):
+        return self._efficiency
+
+    @efficiency.setter
+    def efficiency(self, e):
+        self._efficiency = e
+
+    @property
+    def model(self):
+        return self._model
+
+    @model.setter
+    def model(self, m):
+        self._model = m
+
+    @property
+    def origin(self):
+        return self._origin
+
+    @origin.setter
+    def origin(self, m):
+        self._origin = m
+
+    @abc.abstractmethod
+    def add_change_request(self, r):
+        raise NotImplementedError(
+            "Should have implemented this")  # pragma:no cover
+
+    @abc.abstractproperty
+    def meta_actions(self):
+        raise NotImplementedError(
+            "Should have implemented this")  # pragma:no cover

watcher/decision_engine/solution/default.py

@@ -0,0 +1,43 @@
+# -*- encoding: utf-8 -*-
+# Copyright (c) 2015 b<>com
+#
+# Authors: Jean-Emile DARTOIS <jean-emile.dartois@b-com.com>
+#
+# 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.
+#
+from oslo_log import log
+from watcher.decision_engine.solution.base import Solution
+
+LOG = log.getLogger(__name__)
+
+
+class DefaultSolution(Solution):
+    def __init__(self):
+        self._meta_actions = []
+
+    def add_change_request(self, r):
+        self._meta_actions.append(r)
+
+    def __str__(self):
+        val = ""
+        for action in self._meta_actions:
+            val += str(action) + "\n"
+        return val
+
+    @property
+    def meta_actions(self):
+        """Get the current meta-actions of the solution
+
+        """
+        return self._meta_actions

watcher/decision_engine/solution/solution_comparator.py

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+# Copyright (c) 2015 b<>com
+#
+# Authors: Jean-Emile DARTOIS <jean-emile.dartois@b-com.com>
+#
+# 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.
+#
+import abc
+import six
+
+
+@six.add_metaclass(abc.ABCMeta)
+class Solution(object):
+    @abc.abstractmethod
+    def compare(self, sol1, sol2):
+        raise NotImplementedError(
+            "Should have implemented this")  # pragma:no cover

watcher/decision_engine/solution/solution_evaluator.py

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+# Copyright (c) 2015 b<>com
+#
+# Authors: Jean-Emile DARTOIS <jean-emile.dartois@b-com.com>
+#
+# 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.
+#
+import abc
+import six
+
+
+@six.add_metaclass(abc.ABCMeta)
+class SolutionEvaluator(object):
+    @abc.abstractmethod
+    def evaluate(self, solution):
+        raise NotImplementedError(
+            "Should have implemented this")  # pragma:no cover