2015-01-30 12:47:03 +00:00
|
|
|
# -*- coding: utf-8 -*-
|
|
|
|
'''
|
|
|
|
:codeauthor: :email:`Rupesh Tare <rupesht@saltstack.com>`
|
|
|
|
'''
|
|
|
|
|
2015-01-30 23:36:34 +00:00
|
|
|
# Import Python libs
|
2018-01-20 18:13:46 +00:00
|
|
|
from __future__ import absolute_import, print_function, unicode_literals
|
2015-01-30 23:36:34 +00:00
|
|
|
|
2015-01-30 12:47:03 +00:00
|
|
|
# Import Salt Testing Libs
|
2017-02-19 15:35:30 +00:00
|
|
|
from tests.support.mixins import LoaderModuleMockMixin
|
2017-02-27 13:58:07 +00:00
|
|
|
from tests.support.unit import TestCase, skipIf
|
|
|
|
from tests.support.mock import (
|
2015-01-30 12:47:03 +00:00
|
|
|
MagicMock,
|
|
|
|
patch,
|
|
|
|
NO_MOCK,
|
|
|
|
NO_MOCK_REASON
|
|
|
|
)
|
|
|
|
|
|
|
|
# Import Salt Libs
|
Use explicit unicode strings + break up salt.utils
This PR is part of what will be an ongoing effort to use explicit
unicode strings in Salt. Because Python 3 does not suport Python 2's raw
unicode string syntax (i.e. `ur'\d+'`), we must use
`salt.utils.locales.sdecode()` to ensure that the raw string is unicode.
However, because of how `salt/utils/__init__.py` has evolved into the
hulking monstrosity it is today, this means importing a large module in
places where it is not needed, which could negatively impact
performance. For this reason, this PR also breaks out some of the
functions from `salt/utils/__init__.py` into new/existing modules under
`salt/utils/`. The long term goal will be that the modules within this
directory do not depend on importing `salt.utils`.
A summary of the changes in this PR is as follows:
* Moves the following functions from `salt.utils` to new locations
(including a deprecation warning if invoked from `salt.utils`):
`to_bytes`, `to_str`, `to_unicode`, `str_to_num`, `is_quoted`,
`dequote`, `is_hex`, `is_bin_str`, `rand_string`,
`contains_whitespace`, `clean_kwargs`, `invalid_kwargs`, `which`,
`which_bin`, `path_join`, `shlex_split`, `rand_str`, `is_windows`,
`is_proxy`, `is_linux`, `is_darwin`, `is_sunos`, `is_smartos`,
`is_smartos_globalzone`, `is_smartos_zone`, `is_freebsd`, `is_netbsd`,
`is_openbsd`, `is_aix`
* Moves the functions already deprecated by @rallytime to the bottom of
`salt/utils/__init__.py` for better organization, so we can keep the
deprecated ones separate from the ones yet to be deprecated as we
continue to break up `salt.utils`
* Updates `salt/*.py` and all files under `salt/client/` to use explicit
unicode string literals.
* Gets rid of implicit imports of `salt.utils` (e.g. `from salt.utils
import foo` becomes `import salt.utils.foo as foo`).
* Renames the `test.rand_str` function to `test.random_hash` to more
accurately reflect what it does
* Modifies `salt.utils.stringutils.random()` (née `salt.utils.rand_string()`)
such that it returns a string matching the passed size. Previously
this function would get `size` bytes from `os.urandom()`,
base64-encode it, and return the result, which would in most cases not
be equal to the passed size.
2017-07-25 01:47:15 +00:00
|
|
|
from salt.ext import six
|
|
|
|
import salt.utils.stringutils
|
2017-03-21 17:15:36 +00:00
|
|
|
import salt.modules.launchctl as launchctl
|
2015-01-30 12:47:03 +00:00
|
|
|
|
|
|
|
|
|
|
|
@skipIf(NO_MOCK, NO_MOCK_REASON)
|
2017-02-19 15:35:30 +00:00
|
|
|
class LaunchctlTestCase(TestCase, LoaderModuleMockMixin):
|
2015-01-30 12:47:03 +00:00
|
|
|
'''
|
|
|
|
Test cases for salt.modules.launchctl
|
|
|
|
'''
|
2017-03-22 12:12:36 +00:00
|
|
|
def setup_loader_modules(self):
|
|
|
|
return {launchctl: {}}
|
2017-02-19 15:35:30 +00:00
|
|
|
|
2015-01-30 12:47:03 +00:00
|
|
|
def test_get_all(self):
|
|
|
|
'''
|
|
|
|
Test for Return all installed services
|
|
|
|
'''
|
|
|
|
with patch.dict(launchctl.__salt__,
|
|
|
|
{'cmd.run': MagicMock(return_value='A\tB\tC\t\n')}):
|
|
|
|
with patch.object(launchctl,
|
|
|
|
'_available_services',
|
|
|
|
return_value={'A': 'a', 'B': 'b'}):
|
|
|
|
self.assertEqual(launchctl.get_all(), ['A', 'B', 'C'])
|
|
|
|
|
|
|
|
def test_available(self):
|
|
|
|
'''
|
|
|
|
Test for Check that the given service is available.
|
|
|
|
'''
|
|
|
|
with patch.object(launchctl,
|
|
|
|
'_service_by_name', return_value=True):
|
|
|
|
self.assertTrue(launchctl.available('job_label'))
|
|
|
|
|
|
|
|
def test_missing(self):
|
|
|
|
'''
|
|
|
|
Test for The inverse of service.available
|
|
|
|
'''
|
|
|
|
with patch.object(launchctl,
|
|
|
|
'_service_by_name', return_value=True):
|
|
|
|
self.assertFalse(launchctl.missing('job_label'))
|
|
|
|
|
|
|
|
def test_status(self):
|
|
|
|
'''
|
|
|
|
Test for Return the status for a service
|
|
|
|
'''
|
2016-01-19 16:28:37 +00:00
|
|
|
launchctl_data = '''<?xml version="1.0" encoding="UTF-8"?>
|
|
|
|
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
|
|
|
|
<plist version="1.0">
|
|
|
|
<dict>
|
|
|
|
<key>Label</key>
|
|
|
|
<string>salt-minion</string>
|
|
|
|
<key>LastExitStatus</key>
|
|
|
|
<integer>0</integer>
|
|
|
|
<key>LimitLoadToSessionType</key>
|
|
|
|
<string>System</string>
|
|
|
|
<key>OnDemand</key>
|
|
|
|
<false/>
|
|
|
|
<key>PID</key>
|
|
|
|
<integer>71</integer>
|
|
|
|
<key>ProgramArguments</key>
|
|
|
|
<array>
|
|
|
|
<string>/usr/local/bin/salt-minion</string>
|
|
|
|
</array>
|
|
|
|
<key>TimeOut</key>
|
|
|
|
<integer>30</integer>
|
|
|
|
</dict>
|
|
|
|
</plist>'''
|
2015-01-30 12:47:03 +00:00
|
|
|
with patch.object(launchctl,
|
|
|
|
'_service_by_name',
|
|
|
|
return_value={'plist':
|
|
|
|
{'Label': 'A'}}):
|
2016-07-19 21:40:44 +00:00
|
|
|
if six.PY3:
|
Use explicit unicode strings + break up salt.utils
This PR is part of what will be an ongoing effort to use explicit
unicode strings in Salt. Because Python 3 does not suport Python 2's raw
unicode string syntax (i.e. `ur'\d+'`), we must use
`salt.utils.locales.sdecode()` to ensure that the raw string is unicode.
However, because of how `salt/utils/__init__.py` has evolved into the
hulking monstrosity it is today, this means importing a large module in
places where it is not needed, which could negatively impact
performance. For this reason, this PR also breaks out some of the
functions from `salt/utils/__init__.py` into new/existing modules under
`salt/utils/`. The long term goal will be that the modules within this
directory do not depend on importing `salt.utils`.
A summary of the changes in this PR is as follows:
* Moves the following functions from `salt.utils` to new locations
(including a deprecation warning if invoked from `salt.utils`):
`to_bytes`, `to_str`, `to_unicode`, `str_to_num`, `is_quoted`,
`dequote`, `is_hex`, `is_bin_str`, `rand_string`,
`contains_whitespace`, `clean_kwargs`, `invalid_kwargs`, `which`,
`which_bin`, `path_join`, `shlex_split`, `rand_str`, `is_windows`,
`is_proxy`, `is_linux`, `is_darwin`, `is_sunos`, `is_smartos`,
`is_smartos_globalzone`, `is_smartos_zone`, `is_freebsd`, `is_netbsd`,
`is_openbsd`, `is_aix`
* Moves the functions already deprecated by @rallytime to the bottom of
`salt/utils/__init__.py` for better organization, so we can keep the
deprecated ones separate from the ones yet to be deprecated as we
continue to break up `salt.utils`
* Updates `salt/*.py` and all files under `salt/client/` to use explicit
unicode string literals.
* Gets rid of implicit imports of `salt.utils` (e.g. `from salt.utils
import foo` becomes `import salt.utils.foo as foo`).
* Renames the `test.rand_str` function to `test.random_hash` to more
accurately reflect what it does
* Modifies `salt.utils.stringutils.random()` (née `salt.utils.rand_string()`)
such that it returns a string matching the passed size. Previously
this function would get `size` bytes from `os.urandom()`,
base64-encode it, and return the result, which would in most cases not
be equal to the passed size.
2017-07-25 01:47:15 +00:00
|
|
|
launchctl_data = salt.utils.stringutils.to_bytes(launchctl_data)
|
2015-01-30 12:47:03 +00:00
|
|
|
with patch.object(launchctl, '_get_launchctl_data',
|
2016-01-19 16:28:37 +00:00
|
|
|
return_value=launchctl_data):
|
2015-01-30 12:47:03 +00:00
|
|
|
self.assertTrue(launchctl.status('job_label'))
|
|
|
|
|
|
|
|
def test_stop(self):
|
|
|
|
'''
|
|
|
|
Test for Stop the specified service
|
|
|
|
'''
|
|
|
|
with patch.object(launchctl,
|
|
|
|
'_service_by_name',
|
|
|
|
return_value={'file_path': 'A'}):
|
|
|
|
with patch.dict(launchctl.__salt__,
|
|
|
|
{'cmd.retcode': MagicMock(return_value=False)}):
|
|
|
|
self.assertTrue(launchctl.stop('job_label'))
|
|
|
|
|
|
|
|
with patch.object(launchctl,
|
|
|
|
'_service_by_name',
|
|
|
|
return_value=None):
|
|
|
|
self.assertFalse(launchctl.stop('job_label'))
|
|
|
|
|
|
|
|
def test_start(self):
|
|
|
|
'''
|
|
|
|
Test for Start the specified service
|
|
|
|
'''
|
|
|
|
with patch.object(launchctl,
|
|
|
|
'_service_by_name',
|
|
|
|
return_value={'file_path': 'A'}):
|
|
|
|
with patch.dict(launchctl.__salt__,
|
|
|
|
{'cmd.retcode': MagicMock(return_value=False)}):
|
|
|
|
self.assertTrue(launchctl.start('job_label'))
|
|
|
|
|
|
|
|
with patch.object(launchctl,
|
|
|
|
'_service_by_name',
|
|
|
|
return_value=None):
|
|
|
|
self.assertFalse(launchctl.start('job_label'))
|
|
|
|
|
|
|
|
def test_restart(self):
|
|
|
|
'''
|
|
|
|
Test for Restart the named service
|
|
|
|
'''
|
|
|
|
with patch.object(launchctl, 'stop', return_value=None):
|
|
|
|
with patch.object(launchctl, 'start', return_value=True):
|
|
|
|
self.assertTrue(launchctl.restart('job_label'))
|