test_supervisorctl.py 37 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022
  1. import sys
  2. import unittest
  3. from StringIO import StringIO
  4. from supervisor.tests.base import DummyRPCServer
  5. class ControllerTests(unittest.TestCase):
  6. def _getTargetClass(self):
  7. from supervisor.supervisorctl import Controller
  8. return Controller
  9. def _makeOne(self, options):
  10. return self._getTargetClass()(options)
  11. def test_ctor(self):
  12. options = DummyClientOptions()
  13. controller = self._makeOne(options)
  14. self.assertEqual(controller.prompt, options.prompt + '> ')
  15. def test__upcheck(self):
  16. options = DummyClientOptions()
  17. controller = self._makeOne(options)
  18. result = controller.upcheck()
  19. self.assertEqual(result, True)
  20. def test__upcheck_wrong_server_version(self):
  21. options = DummyClientOptions()
  22. options._server.supervisor.getVersion = lambda *x: '1.0'
  23. controller = self._makeOne(options)
  24. controller.stdout = StringIO()
  25. result = controller.upcheck()
  26. self.assertEqual(result, False)
  27. value = controller.stdout.getvalue()
  28. self.assertEqual(value, 'Sorry, this version of supervisorctl expects '
  29. 'to talk to a server with API version 3.0, but the remote version is '
  30. '1.0.\n')
  31. def test__upcheck_unknown_method(self):
  32. options = DummyClientOptions()
  33. from xmlrpclib import Fault
  34. from supervisor.xmlrpc import Faults
  35. def getVersion():
  36. raise Fault(Faults.UNKNOWN_METHOD, 'duh')
  37. options._server.supervisor.getVersion = getVersion
  38. controller = self._makeOne(options)
  39. controller.stdout = StringIO()
  40. result = controller.upcheck()
  41. self.assertEqual(result, False)
  42. value = controller.stdout.getvalue()
  43. self.assertEqual(value, 'Sorry, supervisord responded but did not '
  44. 'recognize the supervisor namespace commands that supervisorctl '
  45. 'uses to control it. Please check that the '
  46. '[rpcinterface:supervisor] section is enabled in the '
  47. 'configuration file (see sample.conf).\n')
  48. def test__upcheck_catches_socket_error_ECONNREFUSED(self):
  49. options = DummyClientOptions()
  50. import socket
  51. import errno
  52. def raise_fault(*arg, **kw):
  53. raise socket.error(errno.ECONNREFUSED, 'nobody home')
  54. options._server.supervisor.getVersion = raise_fault
  55. controller = self._makeOne(options)
  56. controller.stdout = StringIO()
  57. result = controller.upcheck()
  58. self.assertEqual(result, False)
  59. output = controller.stdout.getvalue()
  60. self.assertTrue('refused connection' in output)
  61. def test__upcheck_catches_socket_error_ENOENT(self):
  62. options = DummyClientOptions()
  63. import socket
  64. import errno
  65. def raise_fault(*arg, **kw):
  66. raise socket.error(errno.ENOENT, 'nobody home')
  67. options._server.supervisor.getVersion = raise_fault
  68. controller = self._makeOne(options)
  69. controller.stdout = StringIO()
  70. result = controller.upcheck()
  71. self.assertEqual(result, False)
  72. output = controller.stdout.getvalue()
  73. self.assertTrue('no such file' in output)
  74. def test_onecmd(self):
  75. options = DummyClientOptions()
  76. controller = self._makeOne(options)
  77. controller.stdout = StringIO()
  78. plugin = DummyPlugin()
  79. controller.options.plugins = (plugin,)
  80. result = controller.onecmd('help')
  81. self.assertEqual(result, None)
  82. self.assertEqual(plugin.helped, True)
  83. def test_onecmd_multi_colonseparated(self):
  84. options = DummyClientOptions()
  85. controller = self._makeOne(options)
  86. controller.stdout = StringIO()
  87. plugin = DummyPlugin()
  88. controller.options.plugins = (plugin,)
  89. result = controller.onecmd('help; help')
  90. self.assertEqual(result, None)
  91. self.assertEqual(controller.cmdqueue, [' help'])
  92. self.assertEqual(plugin.helped, True)
  93. def test_completionmatches(self):
  94. options = DummyClientOptions()
  95. controller = self._makeOne(options)
  96. controller.stdout=StringIO()
  97. plugin = DummyPlugin()
  98. controller.options.plugin=(plugin,)
  99. for i in ['add','remove']:
  100. result = controller.completionmatches('',i+' ',1)
  101. self.assertEqual(result,['foo ','bar ','baz '])
  102. result = controller.completionmatches('','fg baz:')
  103. self.assertEqual(result,['baz_01 '])
  104. def test_nohelp(self):
  105. options = DummyClientOptions()
  106. controller = self._makeOne(options)
  107. self.assertEqual(controller.nohelp, '*** No help on %s')
  108. def test_do_help(self):
  109. options = DummyClientOptions()
  110. controller = self._makeOne(options)
  111. controller.stdout = StringIO()
  112. results = controller.do_help(None)
  113. helpval = controller.stdout.getvalue()
  114. self.assertEqual(results, None)
  115. self.assertEqual(helpval, 'foo helped')
  116. def test_get_supervisor_returns_serverproxy_supervisor_namespace(self):
  117. options = DummyClientOptions()
  118. controller = self._makeOne(options)
  119. proxy = controller.get_supervisor()
  120. expected = options.getServerProxy().supervisor
  121. self.assertEqual(proxy, expected)
  122. def test_get_server_proxy_with_no_args_returns_serverproxy(self):
  123. options = DummyClientOptions()
  124. controller = self._makeOne(options)
  125. proxy = controller.get_server_proxy()
  126. expected = options.getServerProxy()
  127. self.assertEqual(proxy, expected)
  128. def test_get_server_proxy_with_namespace_returns_that_namespace(self):
  129. options = DummyClientOptions()
  130. controller = self._makeOne(options)
  131. proxy = controller.get_server_proxy('system')
  132. expected = options.getServerProxy().system
  133. self.assertEqual(proxy, expected)
  134. class TestControllerPluginBase(unittest.TestCase):
  135. def _getTargetClass(self):
  136. from supervisor.supervisorctl import ControllerPluginBase
  137. return ControllerPluginBase
  138. def _makeOne(self, *arg, **kw):
  139. klass = self._getTargetClass()
  140. options = DummyClientOptions()
  141. ctl = DummyController(options)
  142. plugin = klass(ctl, *arg, **kw)
  143. return plugin
  144. def test_do_help_noarg(self):
  145. plugin = self._makeOne()
  146. results = plugin.do_help(None)
  147. self.assertEqual(plugin.ctl.stdout.getvalue(), '\n')
  148. self.assertEqual(len(plugin.ctl.topics_printed), 1)
  149. topics = plugin.ctl.topics_printed[0]
  150. self.assertEqual(topics[0], 'unnamed commands (type help <topic>):')
  151. self.assertEqual(topics[1], [])
  152. self.assertEqual(topics[2], 15)
  153. self.assertEqual(topics[3], 80)
  154. self.assertEqual(results, None)
  155. def test_do_help_witharg(self):
  156. plugin = self._makeOne()
  157. results = plugin.do_help('foo')
  158. self.assertEqual(plugin.ctl.stdout.getvalue(), 'no help on foo\n')
  159. self.assertEqual(len(plugin.ctl.topics_printed), 0)
  160. class TestDefaultControllerPlugin(unittest.TestCase):
  161. def _getTargetClass(self):
  162. from supervisor.supervisorctl import DefaultControllerPlugin
  163. return DefaultControllerPlugin
  164. def _makeOne(self, *arg, **kw):
  165. klass = self._getTargetClass()
  166. options = DummyClientOptions()
  167. ctl = DummyController(options)
  168. plugin = klass(ctl, *arg, **kw)
  169. return plugin
  170. def test_tail_toofewargs(self):
  171. plugin = self._makeOne()
  172. result = plugin.do_tail('')
  173. self.assertEqual(result, None)
  174. lines = plugin.ctl.stdout.getvalue().split('\n')
  175. self.assertEqual(lines[0], 'Error: too few arguments')
  176. def test_tail_toomanyargs(self):
  177. plugin = self._makeOne()
  178. result = plugin.do_tail('one two three four')
  179. self.assertEqual(result, None)
  180. lines = plugin.ctl.stdout.getvalue().split('\n')
  181. self.assertEqual(lines[0], 'Error: too many arguments')
  182. def test_tail_f_noprocname(self):
  183. plugin = self._makeOne()
  184. result = plugin.do_tail('-f')
  185. self.assertEqual(result, None)
  186. lines = plugin.ctl.stdout.getvalue().split('\n')
  187. self.assertEqual(lines[0], 'Error: tail requires process name')
  188. def test_tail_defaults(self):
  189. plugin = self._makeOne()
  190. result = plugin.do_tail('foo')
  191. self.assertEqual(result, None)
  192. lines = plugin.ctl.stdout.getvalue().split('\n')
  193. self.assertEqual(len(lines), 12)
  194. self.assertEqual(lines[0], 'output line')
  195. def test_tail_no_file(self):
  196. plugin = self._makeOne()
  197. result = plugin.do_tail('NO_FILE')
  198. lines = plugin.ctl.stdout.getvalue().split('\n')
  199. self.assertEqual(len(lines), 2)
  200. self.assertEqual(lines[0], 'NO_FILE: ERROR (no log file)')
  201. def test_tail_failed(self):
  202. plugin = self._makeOne()
  203. result = plugin.do_tail('FAILED')
  204. lines = plugin.ctl.stdout.getvalue().split('\n')
  205. self.assertEqual(len(lines), 2)
  206. self.assertEqual(lines[0], 'FAILED: ERROR (unknown error reading log)')
  207. def test_tail_bad_name(self):
  208. plugin = self._makeOne()
  209. result = plugin.do_tail('BAD_NAME')
  210. lines = plugin.ctl.stdout.getvalue().split('\n')
  211. self.assertEqual(len(lines), 2)
  212. self.assertEqual(lines[0], 'BAD_NAME: ERROR (no such process name)')
  213. def test_tail_bytesmodifier(self):
  214. plugin = self._makeOne()
  215. result = plugin.do_tail('-10 foo')
  216. self.assertEqual(result, None)
  217. lines = plugin.ctl.stdout.getvalue().split('\n')
  218. self.assertEqual(len(lines), 3)
  219. self.assertEqual(lines[0], 'tput line')
  220. def test_tail_explicit_channel_stdout_nomodifier(self):
  221. plugin = self._makeOne()
  222. result = plugin.do_tail('foo stdout')
  223. self.assertEqual(result, None)
  224. lines = plugin.ctl.stdout.getvalue().split('\n')
  225. self.assertEqual(len(lines), 12)
  226. self.assertEqual(lines[0], 'output line')
  227. def test_tail_explicit_channel_stderr_nomodifier(self):
  228. plugin = self._makeOne()
  229. result = plugin.do_tail('foo stderr')
  230. lines = plugin.ctl.stdout.getvalue().split('\n')
  231. self.assertEqual(len(lines), 12)
  232. self.assertEqual(lines[0], 'output line')
  233. def test_tail_explicit_channel_unrecognized(self):
  234. plugin = self._makeOne()
  235. result = plugin.do_tail('foo fudge')
  236. self.assertEqual(result, None)
  237. value = plugin.ctl.stdout.getvalue().strip()
  238. self.assertEqual(value, "Error: bad channel 'fudge'")
  239. def test_status_oneprocess(self):
  240. plugin = self._makeOne()
  241. result = plugin.do_status('foo')
  242. self.assertEqual(result, None)
  243. value = plugin.ctl.stdout.getvalue().strip()
  244. self.assertEqual(value.split(None, 2),
  245. ['foo', 'RUNNING', 'foo description'])
  246. def test_status_allprocesses(self):
  247. plugin = self._makeOne()
  248. result = plugin.do_status('')
  249. self.assertEqual(result, None)
  250. value = plugin.ctl.stdout.getvalue().split('\n')
  251. self.assertEqual(value[0].split(None, 2),
  252. ['foo', 'RUNNING', 'foo description'])
  253. self.assertEqual(value[1].split(None, 2),
  254. ['bar', 'FATAL', 'bar description'])
  255. self.assertEqual(value[2].split(None, 2),
  256. ['baz:baz_01', 'STOPPED', 'baz description'])
  257. def test_start_fail(self):
  258. plugin = self._makeOne()
  259. result = plugin.do_start('')
  260. self.assertEqual(result, None)
  261. expected = "Error: start requires a process name"
  262. self.assertEqual(plugin.ctl.stdout.getvalue().split('\n')[0], expected)
  263. def test_start_badname(self):
  264. plugin = self._makeOne()
  265. result = plugin.do_start('BAD_NAME')
  266. self.assertEqual(result, None)
  267. self.assertEqual(plugin.ctl.stdout.getvalue(),
  268. 'BAD_NAME: ERROR (no such process)\n')
  269. def test_start_no_file(self):
  270. plugin = self._makeOne()
  271. result = plugin.do_start('NO_FILE')
  272. self.assertEqual(result, None)
  273. self.assertEqual(plugin.ctl.stdout.getvalue(),
  274. 'NO_FILE: ERROR (no such file)\n')
  275. def test_start_not_executable(self):
  276. plugin = self._makeOne()
  277. result = plugin.do_start('NOT_EXECUTABLE')
  278. self.assertEqual(result, None)
  279. self.assertEqual(plugin.ctl.stdout.getvalue(),
  280. 'NOT_EXECUTABLE: ERROR (file is not executable)\n')
  281. def test_start_alreadystarted(self):
  282. plugin = self._makeOne()
  283. result = plugin.do_start('ALREADY_STARTED')
  284. self.assertEqual(result, None)
  285. self.assertEqual(plugin.ctl.stdout.getvalue(),
  286. 'ALREADY_STARTED: ERROR (already started)\n')
  287. def test_start_spawnerror(self):
  288. plugin = self._makeOne()
  289. result = plugin.do_start('SPAWN_ERROR')
  290. self.assertEqual(result, None)
  291. self.assertEqual(plugin.ctl.stdout.getvalue(),
  292. 'SPAWN_ERROR: ERROR (spawn error)\n')
  293. def test_start_one_success(self):
  294. plugin = self._makeOne()
  295. result = plugin.do_start('foo')
  296. self.assertEqual(result, None)
  297. self.assertEqual(plugin.ctl.stdout.getvalue(), 'foo: started\n')
  298. def test_start_many(self):
  299. plugin = self._makeOne()
  300. result = plugin.do_start('foo bar')
  301. self.assertEqual(result, None)
  302. self.assertEqual(plugin.ctl.stdout.getvalue(),
  303. 'foo: started\nbar: started\n')
  304. def test_start_group(self):
  305. plugin = self._makeOne()
  306. result = plugin.do_start('foo:')
  307. self.assertEqual(result, None)
  308. self.assertEqual(plugin.ctl.stdout.getvalue(),
  309. 'foo_00: started\nfoo_01: started\n')
  310. def test_start_all(self):
  311. plugin = self._makeOne()
  312. result = plugin.do_start('all')
  313. self.assertEqual(result, None)
  314. self.assertEqual(plugin.ctl.stdout.getvalue(),
  315. 'foo: started\nfoo2: started\nfailed: ERROR (spawn error)\n')
  316. def test_stop_fail(self):
  317. plugin = self._makeOne()
  318. result = plugin.do_stop('')
  319. self.assertEqual(result, None)
  320. expected = "Error: stop requires a process name"
  321. self.assertEqual(plugin.ctl.stdout.getvalue().split('\n')[0], expected)
  322. def test_stop_badname(self):
  323. plugin = self._makeOne()
  324. result = plugin.do_stop('BAD_NAME')
  325. self.assertEqual(result, None)
  326. self.assertEqual(plugin.ctl.stdout.getvalue(),
  327. 'BAD_NAME: ERROR (no such process)\n')
  328. def test_stop_notrunning(self):
  329. plugin = self._makeOne()
  330. result = plugin.do_stop('NOT_RUNNING')
  331. self.assertEqual(result, None)
  332. self.assertEqual(plugin.ctl.stdout.getvalue(),
  333. 'NOT_RUNNING: ERROR (not running)\n')
  334. def test_stop_failed(self):
  335. plugin = self._makeOne()
  336. result = plugin.do_stop('FAILED')
  337. self.assertEqual(result, None)
  338. self.assertEqual(plugin.ctl.stdout.getvalue(), 'FAILED\n')
  339. def test_stop_one_success(self):
  340. plugin = self._makeOne()
  341. result = plugin.do_stop('foo')
  342. self.assertEqual(result, None)
  343. self.assertEqual(plugin.ctl.stdout.getvalue(), 'foo: stopped\n')
  344. def test_stop_many(self):
  345. plugin = self._makeOne()
  346. result = plugin.do_stop('foo bar')
  347. self.assertEqual(result, None)
  348. self.assertEqual(plugin.ctl.stdout.getvalue(),
  349. 'foo: stopped\nbar: stopped\n')
  350. def test_stop_group(self):
  351. plugin = self._makeOne()
  352. result = plugin.do_stop('foo:')
  353. self.assertEqual(result, None)
  354. self.assertEqual(plugin.ctl.stdout.getvalue(),
  355. 'foo_00: stopped\nfoo_01: stopped\n')
  356. def test_stop_all(self):
  357. plugin = self._makeOne()
  358. result = plugin.do_stop('all')
  359. self.assertEqual(result, None)
  360. self.assertEqual(plugin.ctl.stdout.getvalue(),
  361. 'foo: stopped\nfoo2: stopped\nfailed: ERROR (no such process)\n')
  362. def test_restart_fail(self):
  363. plugin = self._makeOne()
  364. result = plugin.do_restart('')
  365. self.assertEqual(result, None)
  366. self.assertEqual(plugin.ctl.stdout.getvalue().split('\n')[0],
  367. 'Error: restart requires a process name')
  368. def test_restart_one(self):
  369. plugin = self._makeOne()
  370. result = plugin.do_restart('foo')
  371. self.assertEqual(result, None)
  372. self.assertEqual(plugin.ctl.stdout.getvalue(),
  373. 'foo: stopped\nfoo: started\n')
  374. def test_restart_all(self):
  375. plugin = self._makeOne()
  376. result = plugin.do_restart('all')
  377. self.assertEqual(result, None)
  378. self.assertEqual(plugin.ctl.stdout.getvalue(),
  379. ('foo: stopped\nfoo2: stopped\n'
  380. 'failed: ERROR (no such process)\n'
  381. 'foo: started\nfoo2: started\n'
  382. 'failed: ERROR (spawn error)\n'))
  383. def test_clear_fail(self):
  384. plugin = self._makeOne()
  385. result = plugin.do_clear('')
  386. self.assertEqual(result, None)
  387. expected = "Error: clear requires a process name"
  388. self.assertEqual(plugin.ctl.stdout.getvalue().split('\n')[0], expected)
  389. def test_clear_badname(self):
  390. plugin = self._makeOne()
  391. result = plugin.do_clear('BAD_NAME')
  392. self.assertEqual(result, None)
  393. self.assertEqual(plugin.ctl.stdout.getvalue(),
  394. 'BAD_NAME: ERROR (no such process)\n')
  395. def test_clear_one_success(self):
  396. plugin = self._makeOne()
  397. result = plugin.do_clear('foo')
  398. self.assertEqual(result, None)
  399. self.assertEqual(plugin.ctl.stdout.getvalue(), 'foo: cleared\n')
  400. def test_clear_many(self):
  401. plugin = self._makeOne()
  402. result = plugin.do_clear('foo bar')
  403. self.assertEqual(result, None)
  404. self.assertEqual(plugin.ctl.stdout.getvalue(),
  405. 'foo: cleared\nbar: cleared\n')
  406. def test_clear_all(self):
  407. plugin = self._makeOne()
  408. result = plugin.do_clear('all')
  409. self.assertEqual(result, None)
  410. self.assertEqual(plugin.ctl.stdout.getvalue(),
  411. 'foo: cleared\nfoo2: cleared\nfailed: ERROR (failed)\n')
  412. def test_open_fail(self):
  413. plugin = self._makeOne()
  414. result = plugin.do_open('badname')
  415. self.assertEqual(result, None)
  416. self.assertEqual(plugin.ctl.stdout.getvalue(),
  417. 'ERROR: url must be http:// or unix://\n')
  418. def test_open_succeed(self):
  419. plugin = self._makeOne()
  420. result = plugin.do_open('http://localhost:9002')
  421. self.assertEqual(result, None)
  422. value = plugin.ctl.stdout.getvalue().split('\n')
  423. self.assertEqual(value[0].split(None, 2),
  424. ['foo', 'RUNNING', 'foo description'])
  425. self.assertEqual(value[1].split(None, 2),
  426. ['bar', 'FATAL', 'bar description'])
  427. self.assertEqual(value[2].split(None, 2),
  428. ['baz:baz_01', 'STOPPED', 'baz description'])
  429. def test_version(self):
  430. plugin = self._makeOne()
  431. plugin.do_version(None)
  432. self.assertEqual(plugin.ctl.stdout.getvalue(), '3000\n')
  433. def test_reload_fail(self):
  434. plugin = self._makeOne()
  435. options = plugin.ctl.options
  436. options._server.supervisor._restartable = False
  437. result = plugin.do_reload('')
  438. self.assertEqual(result, None)
  439. self.assertEqual(options._server.supervisor._restarted, False)
  440. def test_reload(self):
  441. plugin = self._makeOne()
  442. options = plugin.ctl.options
  443. result = plugin.do_reload('')
  444. self.assertEqual(result, None)
  445. self.assertEqual(options._server.supervisor._restarted, True)
  446. def test_shutdown(self):
  447. plugin = self._makeOne()
  448. options = plugin.ctl.options
  449. result = plugin.do_shutdown('')
  450. self.assertEqual(result, None)
  451. self.assertEqual(options._server.supervisor._shutdown, True)
  452. def test_shutdown_catches_xmlrpc_fault_shutdown_state(self):
  453. plugin = self._makeOne()
  454. from supervisor import xmlrpc
  455. import xmlrpclib
  456. def raise_fault(*arg, **kw):
  457. raise xmlrpclib.Fault(xmlrpc.Faults.SHUTDOWN_STATE, 'bye')
  458. plugin.ctl.options._server.supervisor.shutdown = raise_fault
  459. result = plugin.do_shutdown('')
  460. self.assertEqual(result, None)
  461. self.assertEqual(plugin.ctl.stdout.getvalue(),
  462. 'ERROR: already shutting down\n')
  463. def test_shutdown_reraises_other_xmlrpc_faults(self):
  464. plugin = self._makeOne()
  465. from supervisor import xmlrpc
  466. import xmlrpclib
  467. def raise_fault(*arg, **kw):
  468. raise xmlrpclib.Fault(xmlrpc.Faults.CANT_REREAD, 'ouch')
  469. plugin.ctl.options._server.supervisor.shutdown = raise_fault
  470. self.assertRaises(xmlrpclib.Fault,
  471. plugin.do_shutdown, '')
  472. def test_shutdown_catches_socket_error_ECONNREFUSED(self):
  473. plugin = self._makeOne()
  474. import socket
  475. import errno
  476. def raise_fault(*arg, **kw):
  477. raise socket.error(errno.ECONNREFUSED, 'nobody home')
  478. plugin.ctl.options._server.supervisor.shutdown = raise_fault
  479. result = plugin.do_shutdown('')
  480. self.assertEqual(result, None)
  481. output = plugin.ctl.stdout.getvalue()
  482. self.assertTrue('refused connection (already shut down?)' in output)
  483. def test_shutdown_catches_socket_error_ENOENT(self):
  484. plugin = self._makeOne()
  485. import socket
  486. import errno
  487. def raise_fault(*arg, **kw):
  488. raise socket.error(errno.ENOENT, 'no file')
  489. plugin.ctl.options._server.supervisor.shutdown = raise_fault
  490. result = plugin.do_shutdown('')
  491. self.assertEqual(result, None)
  492. output = plugin.ctl.stdout.getvalue()
  493. self.assertTrue('no such file (already shut down?)' in output)
  494. def test_shutdown_reraises_other_socket_errors(self):
  495. plugin = self._makeOne()
  496. import socket
  497. import errno
  498. def raise_fault(*arg, **kw):
  499. raise socket.error(errno.EPERM, 'denied')
  500. plugin.ctl.options._server.supervisor.shutdown = raise_fault
  501. self.assertRaises(socket.error,
  502. plugin.do_shutdown, '')
  503. def test__formatChanges(self):
  504. plugin = self._makeOne()
  505. # Don't explode, plz
  506. plugin._formatChanges([['added'], ['changed'], ['removed']])
  507. plugin._formatChanges([[], [], []])
  508. def test_reread(self):
  509. plugin = self._makeOne()
  510. calls = []
  511. plugin._formatChanges = lambda x: calls.append(x)
  512. result = plugin.do_reread(None)
  513. self.assertEqual(result, None)
  514. self.assertEqual(calls[0], [['added'], ['changed'], ['removed']])
  515. def test_reread_Fault(self):
  516. plugin = self._makeOne()
  517. from supervisor import xmlrpc
  518. import xmlrpclib
  519. def raise_fault(*arg, **kw):
  520. raise xmlrpclib.Fault(xmlrpc.Faults.CANT_REREAD, 'cant')
  521. plugin.ctl.options._server.supervisor.reloadConfig = raise_fault
  522. plugin.do_reread(None)
  523. self.assertEqual(plugin.ctl.stdout.getvalue(),
  524. 'ERROR: cant\n')
  525. def test__formatConfigInfo(self):
  526. info = { 'group': 'group1',
  527. 'name': 'process1',
  528. 'inuse': True,
  529. 'autostart': True,
  530. 'process_prio': 999,
  531. 'group_prio': 999 }
  532. plugin = self._makeOne()
  533. result = plugin._formatConfigInfo(info)
  534. self.assertTrue('in use' in result)
  535. info = { 'group': 'group1',
  536. 'name': 'process1',
  537. 'inuse': False,
  538. 'autostart': False,
  539. 'process_prio': 999,
  540. 'group_prio': 999 }
  541. result = plugin._formatConfigInfo(info)
  542. self.assertTrue('avail' in result)
  543. def test_avail(self):
  544. calls = []
  545. plugin = self._makeOne()
  546. class FakeSupervisor(object):
  547. def getAllConfigInfo(self):
  548. return [{ 'group': 'group1', 'name': 'process1',
  549. 'inuse': False, 'autostart': False,
  550. 'process_prio': 999, 'group_prio': 999 }]
  551. plugin.ctl.get_supervisor = lambda : FakeSupervisor()
  552. plugin.ctl.output = calls.append
  553. result = plugin.do_avail('')
  554. self.assertEqual(result, None)
  555. def test_add(self):
  556. plugin = self._makeOne()
  557. result = plugin.do_add('foo')
  558. self.assertEqual(result, None)
  559. supervisor = plugin.ctl.options._server.supervisor
  560. self.assertEqual(supervisor.processes, ['foo'])
  561. def test_add_already_added(self):
  562. plugin = self._makeOne()
  563. result = plugin.do_add('ALREADY_ADDED')
  564. self.assertEqual(result, None)
  565. supervisor = plugin.ctl.options._server.supervisor
  566. self.assertEqual(plugin.ctl.stdout.getvalue(),
  567. 'ERROR: process group already active\n')
  568. def test_add_bad_name(self):
  569. plugin = self._makeOne()
  570. result = plugin.do_add('BAD_NAME')
  571. self.assertEqual(result, None)
  572. supervisor = plugin.ctl.options._server.supervisor
  573. self.assertEqual(plugin.ctl.stdout.getvalue(),
  574. 'ERROR: no such process/group: BAD_NAME\n')
  575. def test_remove(self):
  576. plugin = self._makeOne()
  577. supervisor = plugin.ctl.options._server.supervisor
  578. supervisor.processes = ['foo']
  579. result = plugin.do_remove('foo')
  580. self.assertEqual(result, None)
  581. self.assertEqual(supervisor.processes, [])
  582. def test_remove_bad_name(self):
  583. plugin = self._makeOne()
  584. supervisor = plugin.ctl.options._server.supervisor
  585. supervisor.processes = ['foo']
  586. result = plugin.do_remove('BAD_NAME')
  587. self.assertEqual(result, None)
  588. self.assertEqual(plugin.ctl.stdout.getvalue(),
  589. 'ERROR: no such process/group: BAD_NAME\n')
  590. def test_remove_still_running(self):
  591. plugin = self._makeOne()
  592. supervisor = plugin.ctl.options._server.supervisor
  593. supervisor.processes = ['foo']
  594. result = plugin.do_remove('STILL_RUNNING')
  595. self.assertEqual(result, None)
  596. self.assertEqual(plugin.ctl.stdout.getvalue(),
  597. 'ERROR: process/group still running: STILL_RUNNING\n')
  598. def test_update_not_on_shutdown(self):
  599. plugin = self._makeOne()
  600. supervisor = plugin.ctl.options._server.supervisor
  601. def reloadConfig():
  602. from supervisor import xmlrpc
  603. import xmlrpclib
  604. raise xmlrpclib.Fault(xmlrpc.Faults.SHUTDOWN_STATE, 'blah')
  605. supervisor.reloadConfig = reloadConfig
  606. supervisor.processes = ['removed']
  607. plugin.do_update('')
  608. self.assertEqual(supervisor.processes, ['removed'])
  609. def test_update_added_procs(self):
  610. plugin = self._makeOne()
  611. supervisor = plugin.ctl.options._server.supervisor
  612. calls = []
  613. def reloadConfig():
  614. return [[['new_proc'], [], []]]
  615. supervisor.reloadConfig = reloadConfig
  616. plugin.do_update('')
  617. self.assertEqual(supervisor.processes, ['new_proc'])
  618. def test_update_changed_procs(self):
  619. from supervisor import xmlrpc
  620. plugin = self._makeOne()
  621. supervisor = plugin.ctl.options._server.supervisor
  622. calls = []
  623. def reloadConfig():
  624. return [[[], ['changed_group'], []]]
  625. supervisor.reloadConfig = reloadConfig
  626. supervisor.startProcess = lambda x: calls.append(('start', x))
  627. supervisor.addProcessGroup('changed_group') # fake existence
  628. results = [{'name': 'changed_process',
  629. 'group': 'changed_group',
  630. 'status': xmlrpc.Faults.SUCCESS,
  631. 'description': 'blah'}]
  632. def stopProcessGroup(name):
  633. calls.append(('stop', name))
  634. return results
  635. supervisor.stopProcessGroup = stopProcessGroup
  636. plugin.do_update('')
  637. self.assertEqual(calls, [('stop', 'changed_group')])
  638. supervisor.addProcessGroup('changed_group') # fake existence
  639. calls[:] = []
  640. results[:] = [{'name': 'changed_process1',
  641. 'group': 'changed_group',
  642. 'status': xmlrpc.Faults.NOT_RUNNING,
  643. 'description': 'blah'},
  644. {'name': 'changed_process2',
  645. 'group': 'changed_group',
  646. 'status': xmlrpc.Faults.FAILED,
  647. 'description': 'blah'}]
  648. plugin.do_update('')
  649. self.assertEqual(calls, [('stop', 'changed_group')])
  650. supervisor.addProcessGroup('changed_group') # fake existence
  651. calls[:] = []
  652. results[:] = [{'name': 'changed_process1',
  653. 'group': 'changed_group',
  654. 'status': xmlrpc.Faults.FAILED,
  655. 'description': 'blah'},
  656. {'name': 'changed_process2',
  657. 'group': 'changed_group',
  658. 'status': xmlrpc.Faults.SUCCESS,
  659. 'description': 'blah'}]
  660. plugin.do_update('')
  661. self.assertEqual(calls, [('stop', 'changed_group')])
  662. def test_update_removed_procs(self):
  663. from supervisor import xmlrpc
  664. plugin = self._makeOne()
  665. supervisor = plugin.ctl.options._server.supervisor
  666. def reloadConfig():
  667. return [[[], [], ['removed_group']]]
  668. supervisor.reloadConfig = reloadConfig
  669. results = [{'name': 'removed_process',
  670. 'group': 'removed_group',
  671. 'status': xmlrpc.Faults.SUCCESS,
  672. 'description': 'blah'}]
  673. supervisor.processes = ['removed_group']
  674. def stopProcessGroup(name):
  675. return results
  676. supervisor.stopProcessGroup = stopProcessGroup
  677. plugin.do_update('')
  678. self.assertEqual(supervisor.processes, [])
  679. results[:] = [{'name': 'removed_process',
  680. 'group': 'removed_group',
  681. 'status': xmlrpc.Faults.NOT_RUNNING,
  682. 'description': 'blah'}]
  683. supervisor.processes = ['removed_group']
  684. plugin.do_update('')
  685. self.assertEqual(supervisor.processes, [])
  686. results[:] = [{'name': 'removed_process',
  687. 'group': 'removed_group',
  688. 'status': xmlrpc.Faults.FAILED,
  689. 'description': 'blah'}]
  690. supervisor.processes = ['removed_group']
  691. plugin.do_update('')
  692. self.assertEqual(supervisor.processes, ['removed_group'])
  693. def test_pid_supervisord(self):
  694. plugin = self._makeOne()
  695. result = plugin.do_pid('')
  696. options = plugin.ctl.options
  697. self.assertEqual(result, None)
  698. lines = plugin.ctl.stdout.getvalue().split('\n')
  699. self.assertEqual(len(lines), 2)
  700. self.assertEqual(lines[0], str(options._server.supervisor.getPID()))
  701. def test_pid_allprocesses(self):
  702. plugin = self._makeOne()
  703. result = plugin.do_pid('all')
  704. self.assertEqual(result, None)
  705. value = plugin.ctl.stdout.getvalue().strip()
  706. self.assertEqual(value.split(), ['11', '12', '13'])
  707. def test_pid_badname(self):
  708. plugin = self._makeOne()
  709. result = plugin.do_pid('BAD_NAME')
  710. self.assertEqual(result, None)
  711. value = plugin.ctl.stdout.getvalue().strip()
  712. self.assertEqual(value, 'No such process BAD_NAME')
  713. def test_pid_oneprocess(self):
  714. plugin = self._makeOne()
  715. result = plugin.do_pid('foo')
  716. self.assertEqual(plugin.ctl.stdout.getvalue().strip(), '11')
  717. def test_maintail_toomanyargs(self):
  718. plugin = self._makeOne()
  719. result = plugin.do_maintail('foo bar')
  720. val = plugin.ctl.stdout.getvalue()
  721. self.failUnless(val.startswith('Error: too many'), val)
  722. def test_maintail_minus_string_fails(self):
  723. plugin = self._makeOne()
  724. result = plugin.do_maintail('-wrong')
  725. val = plugin.ctl.stdout.getvalue()
  726. self.failUnless(val.startswith('Error: bad argument -wrong'), val)
  727. def test_maintail_wrong(self):
  728. plugin = self._makeOne()
  729. result = plugin.do_maintail('wrong')
  730. val = plugin.ctl.stdout.getvalue()
  731. self.failUnless(val.startswith('Error: bad argument wrong'), val)
  732. def test_maintail_dashf(self):
  733. plugin = self._makeOne()
  734. plugin.listener = DummyListener()
  735. result = plugin.do_maintail('-f')
  736. errors = plugin.listener.errors
  737. self.assertEqual(len(errors), 1)
  738. error = errors[0]
  739. self.assertEqual(plugin.listener.closed,
  740. 'http://localhost:65532/mainlogtail')
  741. self.assertEqual(error[0],
  742. 'http://localhost:65532/mainlogtail')
  743. for msg in ('Cannot connect', 'socket.error'):
  744. self.assertTrue(msg in error[1])
  745. def test_maintail_nobytes(self):
  746. plugin = self._makeOne()
  747. result = plugin.do_maintail('')
  748. self.assertEqual(plugin.ctl.stdout.getvalue(), 'mainlogdata\n')
  749. def test_maintail_dashbytes(self):
  750. plugin = self._makeOne()
  751. result = plugin.do_maintail('-100')
  752. self.assertEqual(plugin.ctl.stdout.getvalue(), 'mainlogdata\n')
  753. def test_maintail_readlog_error_nofile(self):
  754. plugin = self._makeOne()
  755. supervisor_rpc = plugin.ctl.get_supervisor()
  756. from supervisor import xmlrpc
  757. supervisor_rpc._readlog_error = xmlrpc.Faults.NO_FILE
  758. result = plugin.do_maintail('-100')
  759. self.assertEqual(plugin.ctl.stdout.getvalue(),
  760. 'supervisord: ERROR (no log file)\n')
  761. def test_maintail_readlog_error_failed(self):
  762. plugin = self._makeOne()
  763. supervisor_rpc = plugin.ctl.get_supervisor()
  764. from supervisor import xmlrpc
  765. supervisor_rpc._readlog_error = xmlrpc.Faults.FAILED
  766. result = plugin.do_maintail('-100')
  767. self.assertEqual(plugin.ctl.stdout.getvalue(),
  768. 'supervisord: ERROR (unknown error reading log)\n')
  769. def test_fg_too_few_args(self):
  770. plugin = self._makeOne()
  771. result = plugin.do_fg('')
  772. lines = plugin.ctl.stdout.getvalue().split('\n')
  773. self.assertEqual(result, None)
  774. self.assertEqual(lines[0], 'Error: no process name supplied')
  775. def test_fg_too_many_args(self):
  776. plugin = self._makeOne()
  777. result = plugin.do_fg('foo bar')
  778. line = plugin.ctl.stdout.getvalue()
  779. self.assertEqual(result, None)
  780. self.assertEqual(line, 'Error: too many process names supplied\n')
  781. def test_fg_badprocname(self):
  782. plugin = self._makeOne()
  783. result = plugin.do_fg('BAD_NAME')
  784. line = plugin.ctl.stdout.getvalue()
  785. self.assertEqual(result, None)
  786. self.assertEqual(line, 'Error: bad process name supplied\n')
  787. def test_fg_procnotrunning(self):
  788. plugin = self._makeOne()
  789. result = plugin.do_fg('bar')
  790. line = plugin.ctl.stdout.getvalue()
  791. self.assertEqual(result, None)
  792. self.assertEqual(line, 'Error: process not running\n')
  793. result = plugin.do_fg('baz_01')
  794. lines = plugin.ctl.stdout.getvalue().split('\n')
  795. self.assertEqual(result, None)
  796. self.assertEqual(lines[-2], 'Error: process not running')
  797. class DummyListener:
  798. def __init__(self):
  799. self.errors = []
  800. def error(self, url, msg):
  801. self.errors.append((url, msg))
  802. def close(self, url):
  803. self.closed = url
  804. class DummyPluginFactory:
  805. def __init__(self, ctl, **kw):
  806. self.ctl = ctl
  807. def do_help(self, arg):
  808. self.ctl.stdout.write('foo helped')
  809. class DummyClientOptions:
  810. def __init__(self):
  811. self.prompt = 'supervisor'
  812. self.serverurl = 'http://localhost:65532'
  813. self.username = 'chrism'
  814. self.password = '123'
  815. self.history_file = None
  816. self.plugins = ()
  817. self._server = DummyRPCServer()
  818. self.interactive = False
  819. self.plugin_factories = [('dummy', DummyPluginFactory, {})]
  820. def getServerProxy(self):
  821. return self._server
  822. class DummyController:
  823. nohelp = 'no help on %s'
  824. def __init__(self, options):
  825. self.options = options
  826. self.topics_printed = []
  827. self.stdout = StringIO()
  828. def upcheck(self):
  829. return True
  830. def get_supervisor(self):
  831. return self.get_server_proxy('supervisor')
  832. def get_server_proxy(self, namespace=None):
  833. proxy = self.options.getServerProxy()
  834. if namespace is None:
  835. return proxy
  836. else:
  837. return getattr(proxy, namespace)
  838. def output(self, data):
  839. self.stdout.write(data + '\n')
  840. def print_topics(self, doc_headers, cmds_doc, rows, cols):
  841. self.topics_printed.append((doc_headers, cmds_doc, rows, cols))
  842. class DummyPlugin:
  843. def __init__(self, controller=None):
  844. self.ctl = controller
  845. def do_help(self, arg):
  846. self.helped = True
  847. def test_suite():
  848. return unittest.findTestCases(sys.modules[__name__])
  849. if __name__ == '__main__':
  850. unittest.main(defaultTest='test_suite')