chg: config: Add option to connect to external tor

via control port.

docs/source/man_sbws.ini.rst

@@ -93,6 +93,10 @@ tor
     sbws's owned tor pid file. (Default: ~/.sbws/tor/sbws/tor.pid)
   log = STR
     sbws's owned tor directory log files. (Default: ~/.sbws/tor/log)
+  external_control_port = INT
+    tor control port to connect to. Useful to run integration tests with
+    chutney.
+    (Default: not set. If set, it takes preference over the control socket)
   extra_lines =
     sbws's tor extra configuration. (Default: None)
 

sbws/config.default.ini

@@ -66,6 +66,7 @@ control_socket = ${tor:run_dpath}/control
 pid = ${tor:run_dpath}/tor.pid
 # note this is a directory
 log = ${tor:datadir}/log
+external_control_port =
 extra_lines =
 
 [cleanup]

sbws/util/config.py

@@ -323,7 +323,9 @@ def _validate_tor(conf):
     sec = 'tor'
     err_tmpl = Template('$sec/$key ($val): $e')
     unvalidated_keys = [
-        'datadir', 'run_dpath', 'control_socket', 'pid', 'log', 'extra_lines']
+        'datadir', 'run_dpath', 'control_socket', 'pid', 'log',
+        'external_control_port', 'extra_lines',
+    ]
     all_valid_keys = unvalidated_keys
     errors.extend(_validate_section_keys(conf, sec, all_valid_keys, err_tmpl))
     return errors