Issue #538 - Adding unix-mv command (#681)

* Issue #538 - Adding unix-mv command

Added files:
f5/bigip/tm/util/Unix_Mv.py
f5/bigip/tm/util/test/test_unix_mv.py
test/functional/tm/util/test_unix_mv.py

Updated file:
f5/bigip/tm/util/__init__.py

* Issue #538 - reformatted to avoid carriage return in string

Updated file:
test/function/tm/util/test_unix_mv.py

Author: f5-rahm

f5/bigip/tm/util/Unix_Mv.py

@@ -0,0 +1,56 @@
+# coding=utf-8
+#
+# Copyright 2016 F5 Networks Inc.
+#
+# 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.
+#
+"""BIG-IP® utility module
+
+REST URI
+    ``http://localhost/mgmt/tm/util/unix-mv``
+
+GUI Path
+    N/A
+
+REST Kind
+    ``tm:util:unix-mv:*``
+"""
+
+from f5.bigip.mixins import CommandExecutionMixin
+from f5.bigip.resource import UnnamedResource
+from f5.utils.util_exceptions import UtilError
+
+
+class Unix_Mv(UnnamedResource, CommandExecutionMixin):
+
+    def __init__(self, util):
+        super(Unix_Mv, self).__init__(util)
+        self._meta_data['required_command_parameters'].update(('utilCmdArgs',))
+        self._meta_data['required_json_kind'] = 'tm:util:unix-mv:runstate'
+        self._meta_data['allowed_commands'].append('run')
+
+    def _exec_cmd(self, command, **kwargs):
+        kwargs['command'] = command
+        self._check_exclusive_parameters(**kwargs)
+        requests_params = self._handle_requests_params(kwargs)
+        self._check_command_parameters(**kwargs)
+        session = self._meta_data['bigip']._meta_data['icr_session']
+        response = session.post(
+            self._meta_data['uri'], json=kwargs, **requests_params)
+        self._local_update(response.json())
+
+        if 'commandResult' in self.__dict__:
+            if self.commandResult.startswith('/bin/mv'):
+                raise UtilError('%s' % self.commandResult.split(' ', 1)[1])
+        else:
+            return self

f5/bigip/tm/util/__init__.py

@@ -28,12 +28,14 @@
 """
 
 from f5.bigip.resource import PathElement
+from f5.bigip.tm.util.Unix_Mv import Unix_Mv
 from f5.bigip.tm.util.Unix_Rm import Unix_Rm
 
 
 class Util(PathElement):
     def __init__(self, bigip):
         super(Util, self).__init__(bigip)
         self._meta_data['allowed_lazy_attributes'] = [
+            Unix_Mv,
             Unix_Rm
         ]

f5/bigip/tm/util/test/test_unix_mv.py

@@ -0,0 +1,48 @@
+# Copyright 2016 F5 Networks Inc.
+#
+# 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 mock
+import pytest
+
+from f5.bigip import ManagementRoot
+from f5.bigip.tm.util.Unix_Mv import Unix_Mv
+
+
+@pytest.fixture
+def FakeUnixMv():
+    fake_sys = mock.MagicMock()
+    fake_mv = Unix_Mv(fake_sys)
+    return fake_mv
+
+
+@pytest.fixture
+def FakeiControl(fakeicontrolsession):
+    mr = ManagementRoot('host', 'fake_admin', 'fake_admin')
+    mock_session = mock.MagicMock()
+    mock_session.post.return_value.json.return_value = {}
+    mr._meta_data['icr_session'] = mock_session
+    return mr.tm.util.unix_mv
+
+
+class TestUnixMvCommand(object):
+    def test_command_unix_mv(self, FakeiControl):
+        FakeiControl.exec_cmd('run',
+                              utilCmdArgs='/var/tmp/tf1.txt /var/tmp/tf2.txt')
+        session = FakeiControl._meta_data['bigip']._meta_data['icr_session']
+        assert session.post.call_args == mock.call(
+            'https://host:443/mgmt/tm/util/unix-mv/',
+            json={'utilCmdArgs': '/var/tmp/tf1.txt /var/tmp/tf2.txt',
+                  'command': 'run'}
+        )

test/functional/tm/util/test_unix_mv.py

@@ -0,0 +1,47 @@
+
+# Copyright 2016 F5 Networks Inc.
+#
+# 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 pytest
+
+from f5.utils.util_exceptions import UtilError
+import os
+from tempfile import NamedTemporaryFile
+
+
+def test_E_unix_mv(mgmt_root):
+    ntf = NamedTemporaryFile(delete=False)
+    ntf_basename = os.path.basename(ntf.name)
+    ntf.write('text for test file')
+    ntf.seek(0)
+    mgmt_root.shared.file_transfer.uploads.upload_file(ntf.name)
+    tpath_name = '/var/config/rest/downloads'
+
+    fm1 = mgmt_root.tm.util.unix_mv.exec_cmd(
+        'run',
+        utilCmdArgs='{0}/{1} {0}/testmove.txt'.format(
+            tpath_name, ntf_basename))
+
+    # validate object was created
+    assert fm1.utilCmdArgs == '{0}/{1} {0}/testmove.txt'.format(tpath_name,
+                                                                ntf_basename)
+
+    # if command was successful, commandResult should not be present
+    assert 'commandResult' not in fm1.__dict__
+
+    # UtilError should be raised when non-existent file is mentioned
+    with pytest.raises(UtilError):
+        mgmt_root.tm.util.unix_mv.exec_cmd(
+            'run', utilCmdArgs='{0}/mf.txt'.format(tpath_name))